Gidday!

I'm proud to announce:

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

This release resulted from patches, bug reports, reviews, and comments
from around 145 contributors.  The release includes around 1245
commits, and changed all of the pages.

Tarball download:
     TBD - However, you should be able to generate locally
     a set of tarballs from the git repository with `make dist`,
     which will generate .tar, .tar.gz, and .tar.xz archives.
Git repository:
     https://git.kernel.org/cgit/docs/man-pages/man-pages.git/

The most notable of the changes in man-pages-6.00 are the following:

- A new set of man dirs: man2type/, man3const/, man3head/, and man3type.
   These hold new pages and pages splitted from system_data_types(7),
   which had become too big in the recent releases.

- An improved build system, which allows running linter programs that
   check the correctness of both the man(7) source and the C programs in
   EXAMPLES.

- A new LIBRARY section (mostly in sections 2 and 3).  There have also
   been other important changes to the title and other sections, such as
   the removal of the COLOPHON.

- We have added several new pages documenting new kernel features, such
   as landlock(7) and memfd_secret(2).

Especial mention to наб, with 58 commits to this release.

Thank you all for contributing.  Especially to those in the groff@
mailing list who helped me a lot in this release, and to Michael (mtk).

Cheers,

Alex

==================== Changes in man-pages-6.00 ====================

Released: 2022-10-09, València


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

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


"Darrick J. Wong" [off-list ref]
"Dr. Jürgen Sauermann" [off-list ref]
"Dr. Wolfgang Armbruster" [off-list ref]
"G. Branden Robinson" [off-list ref]
"M. Welinder" [off-list ref]
"Theodore Ts'o" [off-list ref]
"Todd C. Miller" [off-list ref]
"Valentin V. Bartenev" [off-list ref]
[off-list ref]
Adhemerval Zanella [off-list ref]
Ahelenia Ziemiańska (наб) [off-list ref]
Alejandro Colomar [off-list ref]
Aleksander Baranowski [off-list ref]
Alexander Viro [off-list ref]
Alexei Starovoitov [off-list ref]
Amir Goldstein [off-list ref]
Andrea Cervesato [off-list ref]
Andreas Dilger [off-list ref]
Andrew Morton [off-list ref]
Andrew Morton [off-list ref]
Andrew Persons [off-list ref]
Andrew Wock [off-list ref]
Anna Schumaker [off-list ref]
Arnd Bergmann [off-list ref]
Avinash Sonawane [off-list ref]
Axel Rasmussen [off-list ref]
Benjamin Peterson [off-list ref]
Benoit Lecocq [off-list ref]
Bjarni Ingi Gislason [off-list ref]
Brett Holman [off-list ref]
Carlos O'Donell [off-list ref]
Charan Teja Reddy [off-list ref]
Christian Aistleitner [off-list ref]
Christian Brauner [off-list ref]
Christoph Hellwig [off-list ref]
Cyril Hrubis [off-list ref]
Daniel Borkmann [off-list ref]
Dave Chinner [off-list ref]
Dave Kemper [off-list ref]
David Hildenbrand [off-list ref]
David Howells [off-list ref]
David Laight [off-list ref]
David Sletten [off-list ref]
David Ward [off-list ref]
Davide Benini [off-list ref]
Donald Buczek [off-list ref]
Elliott Hughes [off-list ref]
Eric Biggers [off-list ref]
Eric Dumazet [off-list ref]
Eugene Syromyatnikov [off-list ref]
Fabian [off-list ref]
Florian Weimer [off-list ref]
GUO Zihua [off-list ref]
Gabriel Krisman Bertazi [off-list ref]
Greg Banks [off-list ref]
Greg Kroah-Hartman [off-list ref]
Grzegorz Szpetkowski [off-list ref]
Günther Noack [off-list ref]
Heinrich Schuchardt [off-list ref]
Huang Pei [off-list ref]
Ian Abbott [off-list ref]
Ian Lance Taylor [off-list ref]
Ingo Schwarze [off-list ref]
Jakub Sitnicki [off-list ref]
Jakub Wilk [off-list ref]
Jan Kara [off-list ref]
Jann Horn [off-list ref]
Jayprakash Ray [off-list ref]
JeanHeyd Meneide [off-list ref]
Jeff Layton [off-list ref]
Jens Gustedt [off-list ref]
Jeremy Kerr [off-list ref]
Jesse Rosenstock [off-list ref]
Joseph Myers [off-list ref]
Kir Kolyshkin [off-list ref]
Klemens Nanni [off-list ref]
Kuniyuki Iwashima [off-list ref]
Linus Torvalds [off-list ref]
Lucien Gentis [off-list ref]
Luis Henriques [off-list ref]
Luis Lozano [off-list ref]
Marco Bonelli [off-list ref]
Masatake YAMATO [off-list ref]
Matheus Tavares [off-list ref]
Mathnerd314 [off-list ref]
Matthew Bobrowski [off-list ref]
Matthew Wilcox [off-list ref]
Melker Narikka [off-list ref]
Michael Kearney [off-list ref]
Michael Kerrisk [off-list ref]
Michal Hocko [off-list ref]
Mickaël Salaün [off-list ref]
Mike Frysinger [off-list ref]
Mike Kravetz [off-list ref]
Mike Rapoport [off-list ref]
Miklos Szeredi [off-list ref]
Nadav Amit [off-list ref]
NeilBrown [off-list ref]
Nicolas Boichat [off-list ref]
Nikola Forró [off-list ref]
Olga Kornievskaia [off-list ref]
Oscar Salvador [off-list ref]
Pali Rohár [off-list ref]
Pankaj Gupta [off-list ref]
Patrick Reader [off-list ref]
Paul Eggert [off-list ref]
Peter Xu [off-list ref]
Petr Vorel [off-list ref]
Pádraig Brady [off-list ref]
Quentin Monnet [off-list ref]
Ralf Baechle [off-list ref]
Ralph Corderoy [off-list ref]
Randall [off-list ref]
Rich Felker [off-list ref]
Robert Schneider [off-list ref]
Rumen Telbizov [off-list ref]
Sam James [off-list ref]
Samanta Navarro [off-list ref]
Sean Young [off-list ref]
Simon Branch [off-list ref]
Stefan Puiu [off-list ref]
Stephen Kitt [off-list ref]
Steve French [off-list ref]
Suren Baghdasaryan [off-list ref]
Theo de Raadt [off-list ref]
Theodore Dubois [off-list ref]
Tilman Schmidt [off-list ref]
Tobias Stoeckmann [off-list ref]
Topi Miettinen [off-list ref]
Trevor Woerner [off-list ref]
Trond Myklebust [off-list ref]
Vincent Lefevre [off-list ref]
Vito Caputo [off-list ref]
Walter Harms [off-list ref]
Wei Wang [off-list ref]
Yang Xu [off-list ref]
Yuchung Cheng [off-list ref]
Zack Weinberg [off-list ref]
enh [off-list ref]
glibg10b [off-list ref]
nick black [off-list ref]
zhangkui [off-list ref]
Ævar Arnfjörð Bjarmason [off-list ref]
Štěpán Němec [off-list ref]

Apologies if I missed anyone!


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

man2/
     landlock_add_rule.2
     landlock_create_ruleset.2
     landlock_restrict_self.2
     memfd_secret.2

man2type/
     open_how.2type

man3/
     _Generic.3

man3const/
     NULL.3const

man3head/
     sysexits.h.3head

man3type/
     aiocb.3type
     blkcnt_t.3type
     blksize_t.3type
     cc_t.3type
     clock_t.3type
     clockid_t.3type
     dev_t.3type
     div_t.3type
     double_t.3type
     epoll_event.3type
     fenv_t.3type
     id_t.3type
     intN_t.3type
     intmax_t.3type
     intptr_t.3type
     iovec.3type
     itimerspec.3type
     lconv.3type
     mode_t.3type
     off_t.3type
     ptrdiff_t.3type
     regex_t.3type
     size_t.3type
     sockaddr.3type
     stat.3type
     time_t.3type
     timer_t.3type
     timespec.3type
     timeval.3type
     tm.3type
     va_list.3type
     void.3type

man7/
     landlock.7


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

epoll_wait.2
     epoll_pwait2(2)

fanotify_init.2
     FAN_REPORT_PIDFD

fanotify_mark.2
     FAN_FS_ERROR
     FAN_MARK_EVICTABLE
     FAN_RENAME
     FAN_REPORT_TARGET_FID

madvise.2
     MADV_POPULATE_READ
     MADV_POPULATE_WRITE

pipe.2
     O_NOTIFICATION_PIPE

process_madvise.2
     MADV_WILLNEED

send.2
     MSG_FASTOPEN

userfaultfd.2
     UFFD_USER_MODE_ONLY

proc.5
     /proc/[pid]/pagemap    bit 57

fanotify.7
     /proc/sys/fs/fanotify/max_queued_events
     /proc/sys/fs/fanotify/max_user_group
     /proc/sys/fs/fanotify/max_user_marks

tcp.7
     TCP_FASTOPEN
     TCP_FASTOPEN_CONNECT


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

man3/
     strftime_l.3

man3type/
     epoll_data.3type
     epoll_data_t.3type
     fexcept_t.3type
     float_t.3type
     gid_t.3type
     imaxdiv_t.3type
     in6_addr.3type
     in_addr.3type
     in_addr_t.3type
     in_port_t.3type
     int16_t.3type
     int32_t.3type
     int64_t.3type
     int8_t.3type
     ldiv_t.3type
     lldiv_t.3type
     loff_t.3type
     off64_t.3type
     pid_t.3type
     regmatch_t.3type
     regoff_t.3type
     sa_family_t.3type
     sockaddr_in.3type
     sockaddr_in6.3type
     sockaddr_storage.3type
     sockaddr_un.3type
     socklen_t.3type
     speed_t.3type
     ssize_t.3type
     suseconds_t.3type
     tcflag_t.3type
     uid_t.3type
     uint16_t.3type
     uint32_t.3type
     uint64_t.3type
     uint8_t.3type
     uintN_t.3type
     uintmax_t.3type
     uintptr_t.3type
     useconds_t.3type


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

- Man dirs:

   - Move definitions of types to separate pages in man2type/ and
     man3type/.  Previously, they were spreaded (and duplicated) in other
     pages, or in system_data_types.7 (with links in man3/).

   - Add man3head/ for pages that document header files.

   - Add man3const/ for pages that document constants.

- Licenses:

   - Use SPDX-License-Indentiffier for licenses specified by SPDX
     (including the newly-added Linux-man-pages-copyleft).  This reduces
     the overhead text at the top of most manual page source files.
     License texts have been moved to LICENSES/.

- Build system:

   - Add several make(1) targets to lint the manual pages, and also lint
     and build the C programs contained in them.  Use of these targets
     requires unreleased versions of software, such as groff-1.23.0, so
     it's not yet intended to be used by the public.

   - Add targets to build tarballs of the repository.

- man(7) source:

   - Improve consistency of man(7) source.  Also, reduce the number of
     warnings that groff(1) and mandoc(7) emit when parsing the pages
     with the highest warning level.  Most of these fixes were found
     thanks to the new `make lint-man` target.

- Manual pages sections:

   - Title (.TH):

     - Remove 5th argument to TH (middle-header).

     - Specify "Linux man-pages" and the version in the 4th argument
       (left-footer).

   - Add the LIBRARY section.  This section standardizes a way to
     document the library that provides a given interface.

   - Add the CAVEATS section.  BUGS and NOTES were serving that purpose
     before, but CAVEATS is more appropriate.

   - Rename the CONFORMING TO section to STANDARDS for consistency with
     other projects, such as the BSDs.

   - SYNOPSIS:  Add the ISO C2X [[deprecated]] attribute for functions
     that have been deprecated or removed.

   - EXAMPLES:  Improve consistency of C source code.  Also, reduce the
     number of warnings that several linting tools emit.

   - COLOPHON:  Remove section (its purpose is now served by the title).

- Repository:

   - CONTRIBUTING, README, INSTALL:  Document important changes in the
     project organization.


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

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).


-- 
Alejandro Colomar; <http://www.alejandro-colomar.es/>
Linux man-pages maintainer; <http://www.kernel.org/doc/man-pages/>