2023-02-12 21:18:20

by Alejandro Colomar

[permalink] [raw]
Subject: man-pages-6.03 released

Gidday!

I'm proud to announce:

man-pages-6.03 - manual pages for GNU/Linux

The release tarball is already available at <kernel.org>.

Tarball download:
<https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/>
Git repository:
<https://git.kernel.org/cgit/docs/man-pages/man-pages.git/>
PDF book:
<https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/book/>

The most notable changes in this release are:

- We now have a hyperlinked PDF book of the Linux man-pages (see link above).

- C89 is now considered obsolescent by the man-pages, which means that
the STANDARDS section will only document C99 and later for ISO C
versions, with a few exceptions where relevant.

- Document glibc's <printf.h> in printf.h(3head).

- Document arc4random(3)

- New APIs have been added todocumented in perf_event_open(2) and
prctl(2).

Thank you all for contributing!

Cheers,

Alex

==================== Changes in man-pages-6.03 ====================

Released: 2023-02-12, Xulilla


Contributors
------------

The following people contributed patches/fixes, reports, notes,
ideas, and discussions that have been incorporated in changes in
this release:

Aaron Peter Bachmann <[email protected]>
Adhemerval Zanella <[email protected]>
Ahelenia Ziemiańska <[email protected]>
Alejandro Colomar <[email protected]>
Alex Colomar <[email protected]>
Arsen Arsenović <[email protected]>
Bernd Petrovitsch <[email protected]>
Brian Inglis <[email protected]>
Colin Cross <[email protected]>
Cristian Rodríguez <[email protected]>
Deri James <[email protected]>
Elliott Hughes <[email protected]>
Eric Biggers <[email protected]>
Florian Weimer <[email protected]>
"G. Branden Robinson" <[email protected]>
Günther Noack <[email protected]>
Helge Kreutzmann <[email protected]>
Ian Abbott <[email protected]>
Jakub Wilk <[email protected]>
Jan Engelhardt <[email protected]>
"Jason A. Donenfeld" <[email protected]>
Jonny Grant <[email protected]>
Joseph Myers <[email protected]>
Kees Cook <[email protected]>
Lennart Jablonka <[email protected]>
Mario Blaettermann <[email protected]>
Mark Galeck <[email protected]>
Namhyung Kim <[email protected]>
Nick Gregory <[email protected]>
Pasha Tatashin <[email protected]>
Paul Eggert <[email protected]>
<[email protected]>
Sam James <[email protected]>
Samanta Navarro <[email protected]>
"Serge E. Hallyn" <[email protected]>
Stefan Puiu <[email protected]>
Suren Baghdasaryan <[email protected]>
Thomas Weißschuh <[email protected]>
Walter Harms <[email protected]>
Wilco Dijkstra <[email protected]>
Zack Weinberg <[email protected]>

Apologies if I missed anyone!


New and rewritten pages
-----------------------

man3/
arc4random.3
powerof2.3
roundup.3

man3head/
printf.h.3head


Newly documented interfaces in existing pages
---------------------------------------------

perf_event_open.2
PERF_COUNT_SW_BPF_OUTPUT
PERF_COUNT_SW_CGROUP_SWITCHES
PERF_FORMAT_LOST
PERF_RECORD_MISC_MMAP_BUILD_ID
PERF_RECORD_MISC_SWITCH_OUT_PREEMPT
PERF_SAMPLE_CODE_PAGE_SIZE
PERF_SAMPLE_DATA_PAGE_SIZE
PERF_SAMPLE_WEIGHT_STRUCT

struct perf_event_attr::build_id
struct perf_event_attr::inherit_thread
struct perf_event_attr::remove_on_exec
struct perf_event_attr::sigtrap
struct perf_event_attr::aux_sample_size
struct perf_event_attr::sig_data

union perf_sample_weight

struct read_format::values[]::lost

struct::weight
struct::data_page_size
struct::code_page_size
struct::size
struct::data

struct:: ::build_id_size
struct:: ::build_id

prctl.2
PR_SET_VMA
PR_SET_VMA_ANON_NAME


New and changed links
---------------------

man3/
arc4random_buf.3 (arc4random(3))
arc4random_uniform.3 (arc4random(3))
register_printf_modifier.3 (printf.h(3head))
register_printf_specifier.3 (printf.h(3head))
register_printf_type.3 (printf.h(3head))

man3const/
PA_CHAR.3const (printf.h(3head))
PA_DOUBLE.3const (printf.h(3head))
PA_FLAG_LONG.3const (printf.h(3head))
PA_FLAG_LONG_DOUBLE.3const (printf.h(3head))
PA_FLAG_LONG_LONG.3const (printf.h(3head))
PA_FLAG_PTR.3const (printf.h(3head))
PA_FLAG_SHORT.3const (printf.h(3head))
PA_FLOAT.3const (printf.h(3head))
PA_INT.3const (printf.h(3head))
PA_LAST.3const (printf.h(3head))
PA_POINTER.3const (printf.h(3head))
PA_STRING.3const (printf.h(3head))
PA_WCHAR.3const (printf.h(3head))
PA_WSTRING.3const (printf.h(3head))

man3type/
printf_arginfo_size_function.3type (printf.h(3head))
printf_function.3type (printf.h(3head))
printf_info.3type (printf.h(3head))
printf_va_arg_function.3type (printf.h(3head))


Global changes
--------------

- Build system:
- Add scripts to produce a book of the Linux man-pages.
- Add lint-c-cppcheck to the make(1) targets to run the cppcheck(1)
linter.

- TH:
- Use correct letter case in page titles. This started in 6.02, but
there were still many cases left.

- SYNOPSIS:
- Mark some functions as deprecated.

- STANDARDS:
- Remove most references to ISO C89. We still document it in
standards(7), but it's an ancient language version that this
project
regards as obsolescent, so in the STANDARDS sections for APIs we
only take into account C99 and later and POSIX.1-2001 and later
(with few exceptions where older standards are relevant).

- ffix:
- Change \- to - where appropriate
- Improve readability of numbers:
- Show BCD magic numbers that are meaningful in hex as hex,
rather than weird decimal numbers.
- Use IEC multipliers.
- Format ranges consistently using interval notation: [min, max].

- srcfix:
- Use \[] escapes.


Changes to individual pages
---------------------------

timespec.3type
Update tv_nsec according to C2x.


The manual pages (and other files in the repository) have been improved
beyond what this changelog covers. To learn more about changes applied
to individual pages, use git(1).


--
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5


Attachments:
OpenPGP_signature (833.00 B)
OpenPGP digital signature