man-pages-6.05 released

From: Alejandro Colomar
Date: Tue Aug 01 2023 - 09:20:02 EST


Gidday!

I'm proud to announce:

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

The release tarball is already available at <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/>

A change from man-pages-6.04 merits a mention in this release, as it
wasn't properly documented in the previous release notes:

- Add make(1) 'check' target. This has been split from 'lint'.
'lint' will check the source code, and 'check' will check the
rendered pages (as a user will read them). There are currently
several pages that fail this `make check`, and distributors that
depend on this can workaround it by touching a few files:

$ make check -k -j >/dev/null 2>/dev/null;
$ make check -k 2>/dev/null;
GREP .tmp/man/man1/memusage.1.check-catman.touch
TROFF .tmp/man/man2/fanotify_init.2.cat.set
TROFF .tmp/man/man2/gettimeofday.2.cat.set
TROFF .tmp/man/man2/s390_sthyi.2.cat.set
GREP .tmp/man/man3/mallopt.3.check-catman.touch
TROFF .tmp/man/man3/unlocked_stdio.3.cat.set
TROFF .tmp/man/man4/console_codes.4.cat.set
TROFF .tmp/man/man4/lirc.4.cat.set
GREP .tmp/man/man4/smartpqi.4.check-catman.touch
GREP .tmp/man/man4/veth.4.check-catman.touch
TROFF .tmp/man/man5/proc.5.cat.set
GREP .tmp/man/man5/slabinfo.5.check-catman.touch
TROFF .tmp/man/man5/tzfile.5.cat.set
TROFF .tmp/man/man7/address_families.7.cat.set
TROFF .tmp/man/man7/ascii.7.cat.set
TROFF .tmp/man/man7/bpf-helpers.7.cat.set
GREP .tmp/man/man7/keyrings.7.check-catman.touch
GREP .tmp/man/man7/uri.7.check-catman.touch
TROFF .tmp/man/man8/tzselect.8.cat.set
TROFF .tmp/man/man8/zdump.8.cat.set
TROFF .tmp/man/man8/zic.8.cat.set

After touching the previous files, `make check` will succeed:

$ make check -k 2>/dev/null | awk '{print $2}' | xargs touch;
$ make check -j >/dev/null;
$ echo $?
0

The most notable changes in this release (man-pages-6.05) are:

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

man2/
ioctl_pipe.2

man3/
regex.3

man5/
erofs.5

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

bpf.2
EAGAIN

ioctl_userfaultfd.2
UFFD_FEATURE_EXACT_ADDRESS

prctl.2
PR_GET_AUXV

recv.2
MSG_CMSG_CLOEXEC

statx.2
STAT_ATTR_MOUNT_ROOT

syscall.2
ENOSYS

resolv.conf.5
no-aaaa
RES_NOAAAA

tmpfs.5
CONFIG_TRANSPARENT_HUGEPAGE

ip.7
IP_LOCAL_PORT_RANGE

rtnetlink.7
IFLA_PERM_ADDRESS

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

man3type/
regex_t.3type (regex(3))
regmatch_t.3type (regex(3))
regoff_t.3type (regex(3))

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

- Types:
- Document functions using off64_t as if they used off_t (except
for lseek64()).

- Build system:
- Keep file modes in the release tarball.
- Fix symlink installation (`make install LINK_PAGES=symlink`).
- Add support for using bzip2(1), lzip(1), and xz(1) when installing
pages and creating release tarballs.
- Create reproducible release tarballs.
- Move makefiles from lib/ to share/mk/.
- Support mdoc(7) pages.
- Relicense Makefiles as GPL-3.0-or-later.
- Build PostScript and PDF manual pages.
- Add support for running our build system on arbitrary source
trees; this makes it possible to easily run our linters on another
project's manual pages as easily as `make lint MANDIR=~/src/groff`

- Licenses:
- Relicense ddp.7 from VERBATIM_ONE_PARA to Linux-man-pages-copyleft.
- Relicense dir_colors.5 from LDPv1 to GPL-2.0-or-later.
- Use new SPDX license identifiers:
- Linux-man-pages-1-para (was VERBATIM_ONE_PARA)
- Linux-man-pages-copyleft-2-para (was VERBATIM_TWO_PARA)
- Linux-man-pages-copyleft-var (was VERBATIM_PROF)

- ffix:
- use `\%`
- un-bracket tbl(1) tables


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

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

"David S. Miller" <davem@xxxxxxxxxxxxx>
"G. Branden Robinson" <g.branden.robinson@xxxxxxxxx>
A. Wilcox <AWilcox@xxxxxxxxxxxxxxx>
Adam Dobes <adobes@xxxxxxxxxx>
Ahelenia Ziemiańska <nabijaczleweli@xxxxxxxxxxxxxxxxxx>
Alan Cox <alan@llwyncelyn.cymru>
Alejandro Colomar <alx@xxxxxxxxxx>
Alexei Starovoitov <ast@xxxxxxxxxx>
Andreas Schwab <schwab@xxxxxxx>
Andrew Clayton <andrew@xxxxxxxxxxxxxxxxxx>
Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
Avinesh Kumar <akumar@xxxxxxx>
Bastien Roucariès <rouca@xxxxxxxxxx>
Bjarni Ingi Gislason <bjarniig@xxxxxxxxx>
Brian Inglis <Brian.Inglis@xxxxxxx>
Bruno Haible <bruno@xxxxxxxxx>
Carsten Grohmann <carstengrohmann@xxxxxx>
Colin Watson <cjwatson@xxxxxxxxxx>
Cyril Hrubis <chrubis@xxxxxxx>
DJ Delorie <dj@xxxxxxxxxx>
Daniel Verkamp <daniel@xxxxxx>
David Howells <dhowells@xxxxxxxxxx>
Dirk Gouders <dirk@xxxxxxxxxxx>
Dmitry Goncharov <dgoncharov@xxxxxxxxxxxx>
Eli Zaretskii <eliz@xxxxxxx>
Elliott Hughes <enh@xxxxxxxxxx>
Eric Biggers <ebiggers@xxxxxxxxxx>
Eric Blake <eblake@xxxxxxxxxx>
Eric Wong <e@xxxxxxxxx>
Fangrui Song <maskray@xxxxxxxxxx>
Florian Weimer <fweimer@xxxxxxxxxx>
Gavin Smith <gavinsmith0123@xxxxxxxxx>
Guillem Jover <guillem@xxxxxxxxxxx>
Günther Noack <gnoack@xxxxxxxxxx>
Helge Kreutzmann <debian@xxxxxxxxxxxxx>
Igor Sysoev <igor@xxxxxxxxx>
Ingo Schwarze <schwarze@xxxxxxxxxxx>
Jakub Jelinek <jakub@xxxxxxxxxx>
Jakub Sitnicki <jakub@xxxxxxxxxxxxxx>
Jakub Wilk <jwilk@xxxxxxxxx>
Johannes Weiner <hannes@xxxxxxxxxxx>
John Gilmore <gnu@xxxxxxxx>
John Hubbard <jhubbard@xxxxxxxxxx>
John Scott <jscott@xxxxxxxxxx>
Jonathan Corbet <corbet@xxxxxxx>
Jonathan Wakely <jwakely@xxxxxxxxxx>
Joseph Myers <joseph@xxxxxxxxxxxxxxxx>
Josh Triplett <josh@xxxxxxxxxxxxxxxx>
Kirill A. Shutemov <kirill.shutemov@xxxxxxxxxxxxxxx>
Larry McVoy <lm@xxxxxxxxx>
Lennart Jablonka <humm@xxxxxxxxx>
Linus Heckemann <git@xxxxxxxxxxxxxx>
Lukas Javorsky <ljavorsk@xxxxxxxxxx>
Marcos Fouces <marcos@xxxxxxxxxx>
Mario Blaettermann <mario.blaettermann@xxxxxxxxx>
Martin (Joey) Schulze <joey@xxxxxxxxxxxx>
Masami Hiramatsu <mhiramat@xxxxxxxxxx>
Masatake YAMATO <yamato@xxxxxxxxxx>
Matthew House <mattlloydhouse@xxxxxxxxx>
Matthew Wilcox (Oracle) <willy@xxxxxxxxxxxxx>
Michael Kerrisk <mtk.manpages@xxxxxxxxx>
Michael Weiß <michael.weiss@xxxxxxxxxxxxxxxxxxx>
Mickaël Salaün <mic@xxxxxxxxxxx>
Mike Frysinger <vapier@xxxxxxxxxx>
Mike Kravetz <mike.kravetz@xxxxxxxxxx>
Mingye Wang <arthur200126@xxxxxxxxx>
Nadav Amit <namit@xxxxxxxxxx>
Nick Desaulniers <ndesaulniers@xxxxxxxxxx>
Oskari Pirhonen <xxc3ncoredxx@xxxxxxxxx>
Paul E. McKenney <paulmck@xxxxxxxxxx>
Paul Eggert <eggert@xxxxxxxxxxx>
Paul Floyd <pjfloyd@xxxxxxxxxx>
Paul Smith <psmith@xxxxxxx>
Philip Guenther <guenther@xxxxxxxxx>
Ralph Corderoy <ralph@xxxxxxxxxxxxxxx>
Reuben Thomas <rrt@xxxxxxxx>
Rich Felker <dalias@xxxxxxxx>
Richard Biener <richard.guenther@xxxxxxxxx>
Sam James <sam@xxxxxxxxxx>
Serge Hallyn <serge@xxxxxxxxxx>
Seth David Schoen <schoen@xxxxxxxxxxx>
Siddhesh Poyarekar <siddhesh@xxxxxxxxxx>
Simon Horman <simon.horman@xxxxxxxxxxxx>
Stefan Puiu <stefan.puiu@xxxxxxxxx>
Steffen Nurpmeso <steffen@xxxxxxxxxx>
Szabolcs Nagy <nsz@xxxxxxxxxx>
Thomas Weißschuh <thomas@xxxxxxxx>
Tom Schwindl <schwindl@xxxxxxxxx>
Tomáš Golembiovský <tgolembi@xxxxxxxxxx>
Torbjorn SVENSSON <torbjorn.svensson@xxxxxxxxxxx>
Ulrich Drepper <drepper@xxxxxxxxxx>
Vahid Noormofidi <vnoormof@xxxxxxxxxx>
Vlastimil Babka <vbabka@xxxxxxx>
Wilco Dijkstra <Wilco.Dijkstra@xxxxxxx>
Xi Ruoyao <xry111@xxxxxxxxxxx>
Yang Xu <xuyang2018.jy@xxxxxxxxxxx>
Yedidyah Bar David <didi@xxxxxxxxxx>
Zack Weinberg <zack@xxxxxxxxxxxx>
Zijun Zhao <zijunzhao@xxxxxxxxxx>

Apologies if I missed anyone!


Thanks you all for contributing!

Cheers,
Alex

--
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

Attachment: OpenPGP_signature
Description: OpenPGP digital signature