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