Gidday!
I'm proud to announce:
man-pages-6.02 - manual pages for GNU/Linux
The release tarball is already available on <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/>
The most notable changes in this release are the following:
- Rewritten pages for string-copying functions. These now use
consistent language. Also added a new string_copying(7) page that
serves as an overview of all such functions, compares them, and
details which is appropriate for which uses.
- Use _Nullable for documenting which functions accept NULL as a
meaningful value in the function prototypes in the SYNOPSIS.
- Use VLA syntax for documenting function parameters that are treated
as arrays. This uses syntax not accepted by compilers.
- Rewritten repository documentation (README, CONTRIBUTING, INSTALL, ...).
- Documentation for new APIs, such as MADV_COLLAPSE in madvise(2).
Thank you all for contributing.
- There's also a repository change that is not part of this release: Historic
versions of the project going back to man-pages-1.0 have been added to the git
repository in a 'prehistory' branch.
Cheers,
Alex
==================== Changes in man-pages-6.02 ====================
Released: 2022-12-22, Aldaya
Contributors
------------
The following people contributed patches/fixes, reports, notes,
ideas, and discussions that have been incorporated in changes in
this release:
"G. Branden Robinson" <g.branden.robinson@xxxxxxxxx>
1092615079 <1092615079@xxxxxx>
Aaron Schrab <aaron@xxxxxxxxxx>
Agostino Sarubbo <ago@xxxxxxxxxx>
Ahelenia Ziemiańska <nabijaczleweli@xxxxxxxxxxxxxxxxxx>
Alejandro Colomar <alx@xxxxxxxxxx>
Alex Colomar <alx.manpages@xxxxxxxxx>
Amir Goldstein <amir73il@xxxxxxxxx>
Andrew Clayton <andrew@xxxxxxxxxxxxxxxxxx>
Andrew Pinski <pinskia@xxxxxxxxx>
Andries E. Brouwer <aeb@xxxxxx>
Darrick J. Wong <djwong@xxxxxxxxxx>
Douglas McIlroy <douglas.mcilroy@xxxxxxxxxxxxx>
Eric Biggers <ebiggers@xxxxxxxxxx>
Florian Weimer <fweimer@xxxxxxxxxx>
G. Branden Robinson <g.branden.robinson@xxxxxxxxx>
Grigoriy <grigoriyremvar@xxxxxxxxxxxxxx>
Grzegorz Szymaszek <gszymaszek@xxxxxxxx>
Helge Kreutzmann <debian@xxxxxxxxxxxxx>
Ian Abbott <abbotti@xxxxxxxxx>
Iker Pedrosa <ipedrosa@xxxxxxxxxx>
Ingo Schwarze <schwarze@xxxxxxxxxxx>
Jakub Wilk <jwilk@xxxxxxxxx>
Jan Kara <jack@xxxxxxx>
JeanHeyd Meneide <wg14@xxxxxxxxxx>
Jun Ishiguro <algon.0320@xxxxxxxxx>
Luca Versari <veluca93@xxxxxxxxx>
Luis Javier Merino <ninjalj@xxxxxxxxx>
Mario Blättermann <mario.blaettermann@xxxxxxxxx>
Martin Sebor <msebor@xxxxxxxxxx>
Martin Uecker <uecker@xxxxxxxxx>
Matthew Bobrowski <repnop@xxxxxxxxxx>
Michael Kerrisk <mtk.manpages@xxxxxxxxx>
Michael Tokarev <mjt@xxxxxxxxxx>
Mike Frysinger <vapier@xxxxxxxxxx>
Mike Gilbert <floppym@xxxxxxxxxx>
Minchan Kim <minchan@xxxxxxxxxx>
Nicolás A. Ortega Froysa <nicolas@xxxxxxxxxxx>
Pali Rohár <pali@xxxxxxxxxx>
Pierre Labastie <pierre.labastie@xxxxxxx>
Sam James <sam@xxxxxxxxxx>
Serge Hallyn <serge@xxxxxxxxxx>
Stefan Puiu <stefan.puiu@xxxxxxxxx>
Steve Izma <sizma@xxxxxxxxxx>
Suren Baghdasaryan <surenb@xxxxxxxxxx>
Thomas Voss <mail@xxxxxxxxxxxxxx>
Tycho Andersen <tycho@tycho.pizza>
Xi Ruoyao <xry111@xxxxxxxxxxx>
Zach O'Keefe <zokeefe@xxxxxxxxxx>
Zack Weinberg <zack@xxxxxxxxxxxx>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
man3/
static_assert.3
strcpy.3
stpncpy.3
strncat.3
man3const/
EOF.3const
EXIT_SUCCESS.3const
man7/
string_copying.7
Newly documented interfaces in existing pages
---------------------------------------------
ioctl_tty.2
TIOCSERGETLSR
TIOCSER_TEMT
madvise.2
MADV_COLLAPSE
syscall.2
loongarch
New and changed links
---------------------
man3/
_Static_assert.3 (static_assert(3))
stpcpy.3 (strcpy(3))
strcat.3 (strcpy(3))
strncpy.3 (stpncpy(3))
stpecpy.3 (string_copying(7))
stpecpyx.3 (string_copying(7))
ustpcpy.3 (string_copying(7))
ustr2stp.3 (string_copying(7))
zustr2stp.3 (string_copying(7))
zustr2ustp.3 (string_copying(7))
man3const/
EXIT_FAILURE.3const (EXIT_SUCCESS(3const))
Global changes
--------------
- Use correct letter case in manual page titles, instead of uppercase.
- Use \" t comments when appropriate (Lintian needs this).
- SYNOPSIS:
- Add _Nullable for functions that receive NULL as a meaningful
input.
- Use VLA syntax to clarify the meaning of size parameters, rather
than hiding it in possibly-confusing text. This syntax is not
accepted by any compilers, though.
- Use [[noreturn]] instead of noreturn, which will be deprecated
soon.
- Repository documentation:
- Added significant documentation about the repository and the
project in the root of the repository in different files.
Starting from the README, anyone passing by should be able to
understand how the project works and be directed to other
documentation files. These files also document the release
process.
- Michael has been busy lately, and he is no longer maintaining
the project. The in-repository documentation mentioned above has
been updated to reflect that.
Changes to individual pages
---------------------------
copy_file_range.2
Fix wrong kernel version information
process_madvise.2
Fix capability and ptrace requirements
madvise.2
Update Transparent Huge Pages file/shmem documentation for
Linux 5.4+.
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/>
Attachment:
OpenPGP_signature
Description: OpenPGP digital signature
