Friday, August 27, 2021

man-pages-5.13 released

Alex Colomar and I have released released man-pages-5.13. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

This release resulted from patches, bug reports, reviews, and comments from 40 contributors. The release includes around 200 commits that changed around 120 manual pages.

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

  • A new mount_setattr(2) page, written by Christian Brauner, that documents the mount_setattr() system call added in Linux 5.12.
  • I added documentation of the /proc/PID/projid_map file to the user_namespaces(7) page.
  • I added a greatly expanded description of the concept of locked mounts in the mount_namespaces(7) page.

Special thanks again to Alex, who kept track of a lot of patches while I was unavailable.

Tuesday, June 22, 2021

man-pages-5.12 released

Alex Colomar and I have released released man-pages-5.12. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

This release resulted from patches, bug reports, reviews, and comments from around 40 contributors. The release includes more than 300 commits that changed around 180 manual pages.

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

  • A very large number of global edits by Alex Colomar to the SYNOPSIS section of many manual pages. These include changes to the way the system calls that have no wrapper function in glibc are documented, as well more precise information about which header files are needed, and why, by various APIs.
  • A new seccomp_unotify(2) page, written by me (with help from Tycho Andersen, Jann Horn, Kees Cook, Christian Brauner, and Sargun Dhillon), that documents the seccomp user-space notification feature.
  • Alex Colomar wrote a new MAX(3) manual page documenting the MAX() and MIN() functions provided by glibc.
  • Alex Colomar added a documentation of a number of further types to the system_data_types(7) page.

Special thanks to Alex, who was once again the largest contributor in this release!

Monday, March 22, 2021

man-pages-5.11 is released

Alex Colomar and I have released released man-pages-5.11. The release tarball is available on kernel.org. The browsable online pages can be found on man7.org. The Git repository for man-pages is available on kernel.org.

This release resulted from patches, bug reports, reviews, and comments from around 40 contributors. A number of wide-ranging global edits by Alex and me have resulted in one of the largest releases since I became involved with man-pages some 20 years ago. The release includes around 480 commits that changed around 950 (more than 90% of the) manual pages. The diff runs to more than 50k lines (which makes it the third largest release measured by lines changed).

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

  • A new close_range(2) page, written by Stephen Kitt and me, documents the close_range() system call that was added in Linux 5.9.
  • A new process_madvise(2) page, written by Suren Baghdasaryan and Minchan Kim, documents the process_madvise() system call that was added in Linux 5.10.
  • Alex Colomar made a long overdue global fix to the manual pages, adding the restrict keyword to function signatures in the SYNOPSIS of all manual pages that required it. This resulted in changes to around 135 pages!
  • Alex Colomar removed the <sys/types.h> header file from the SYNOPSIS of many pages where that header is no longer required. (The standard removed such requirements 20+ years ago.)
  • Willem de Bruijn added documentation of the epoll_pwait2() system call (new in Linux 5.11) to the epoll_wait(2) page.
  • Gabriel Krisman Bertazi added documentation of the Syscall User Dispatch mechanism to the prctl(2) page.
  • I added documentation of the mallinfo2() function (new in glibc 2.33) to the mallinfo(3) page.
  • I have made global edits to improve consistency and layout in the SYNOPSIS (feature test macros), RETURN VALUE, and ATTRIBUTES in a large number of pages. A summary of many of these changes has been captured in the new FORMATTING AND WORDING CONVENTIONS section in man-pages(7).
  • A new fileno(3) manual page  has been created by extracting content formerly in the ferror(3) page. This change reflects the fact that ferror() is in various ways different from the other functions documented in ferror(3).