linux-kernel - man-pages-6.02 released

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [day] [month] [year] [list]
Message-ID: <4b2d7cd7-da3e-9bd7-ef69-f59635ed1f69@gmail.com>
Date:   Thu, 22 Dec 2022 20:39:08 +0100
From:   Alejandro Colomar <alx.manpages@...il.com>
To:     linux-man <linux-man@...r.kernel.org>
Cc:     "linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
        GNU C Library <libc-alpha@...rceware.org>,
        groff <groff@....org>, Michael Kerrisk <mtk.manpages@...il.com>,
        Jonathan Corbet <corbet@....net>, Sam James <sam@...too.org>,
        Marcos Fouces <marcos@...ian.org>
Subject: man-pages-6.02 released

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@...il.com>
1092615079 <1092615079@...com>
Aaron Schrab <aaron@...rab.com>
Agostino Sarubbo <ago@...too.org>
Ahelenia Ziemiańska <nabijaczleweli@...ijaczleweli.xyz>
Alejandro Colomar <alx@...nel.org>
Alex Colomar <alx.manpages@...il.com>
Amir Goldstein <amir73il@...il.com>
Andrew Clayton <andrew@...ital-domain.net>
Andrew Pinski <pinskia@...il.com>
Andries E. Brouwer <aeb@....nl>
Darrick J. Wong <djwong@...nel.org>
Douglas McIlroy <douglas.mcilroy@...tmouth.edu>
Eric Biggers <ebiggers@...gle.com>
Florian Weimer <fweimer@...hat.com>
G. Branden Robinson <g.branden.robinson@...il.com>
Grigoriy <grigoriyremvar@...tonmail.com>
Grzegorz Szymaszek <gszymaszek@...rt.pl>
Helge Kreutzmann <debian@...gefjell.de>
Ian Abbott <abbotti@....co.uk>
Iker Pedrosa <ipedrosa@...hat.com>
Ingo Schwarze <schwarze@...nbsd.org>
Jakub Wilk <jwilk@...lk.net>
Jan Kara <jack@...e.cz>
JeanHeyd Meneide <wg14@...sis.org>
Jun Ishiguro <algon.0320@...il.com>
Luca Versari <veluca93@...il.com>
Luis Javier Merino <ninjalj@...il.com>
Mario Blättermann <mario.blaettermann@...il.com>
Martin Sebor <msebor@...hat.com>
Martin Uecker <uecker@...raz.at>
Matthew Bobrowski <repnop@...gle.com>
Michael Kerrisk <mtk.manpages@...il.com>
Michael Tokarev <mjt@....msk.ru>
Mike Frysinger <vapier@...too.org>
Mike Gilbert <floppym@...too.org>
Minchan Kim <minchan@...nel.org>
Nicolás A. Ortega Froysa <nicolas@...egas.org>
Pali Rohár <pali@...nel.org>
Pierre Labastie <pierre.labastie@...f.fr>
Sam James <sam@...too.org>
Serge Hallyn <serge@...lyn.com>
Stefan Puiu <stefan.puiu@...il.com>
Steve Izma <sizma@...den.net>
Suren Baghdasaryan <surenb@...gle.com>
Thomas Voss <mail@...masvoss.com>
Tycho Andersen <tycho@...ho.pizza>
Xi Ruoyao <xry111@...111.site>
Zach O'Keefe <zokeefe@...gle.com>
Zack Weinberg <zack@...folio.org>


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/>

Download attachment "OpenPGP_signature" of type "application/pgp-signature" (834 bytes)