2023-08-01 13:30:49

by Alejandro Colomar

[permalink] [raw]
Subject: man-pages-6.05 released

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" <[email protected]>
"G. Branden Robinson" <[email protected]>
A. Wilcox <[email protected]>
Adam Dobes <[email protected]>
Ahelenia Ziemiańska <[email protected]>
Alan Cox <[email protected]>
Alejandro Colomar <[email protected]>
Alexei Starovoitov <[email protected]>
Andreas Schwab <[email protected]>
Andrew Clayton <[email protected]>
Andrew Morton <[email protected]>
Avinesh Kumar <[email protected]>
Bastien Roucariès <[email protected]>
Bjarni Ingi Gislason <[email protected]>
Brian Inglis <[email protected]>
Bruno Haible <[email protected]>
Carsten Grohmann <[email protected]>
Colin Watson <[email protected]>
Cyril Hrubis <[email protected]>
DJ Delorie <[email protected]>
Daniel Verkamp <[email protected]>
David Howells <[email protected]>
Dirk Gouders <[email protected]>
Dmitry Goncharov <[email protected]>
Eli Zaretskii <[email protected]>
Elliott Hughes <[email protected]>
Eric Biggers <[email protected]>
Eric Blake <[email protected]>
Eric Wong <[email protected]>
Fangrui Song <[email protected]>
Florian Weimer <[email protected]>
Gavin Smith <[email protected]>
Guillem Jover <[email protected]>
Günther Noack <[email protected]>
Helge Kreutzmann <[email protected]>
Igor Sysoev <[email protected]>
Ingo Schwarze <[email protected]>
Jakub Jelinek <[email protected]>
Jakub Sitnicki <[email protected]>
Jakub Wilk <[email protected]>
Johannes Weiner <[email protected]>
John Gilmore <[email protected]>
John Hubbard <[email protected]>
John Scott <[email protected]>
Jonathan Corbet <[email protected]>
Jonathan Wakely <[email protected]>
Joseph Myers <[email protected]>
Josh Triplett <[email protected]>
Kirill A. Shutemov <[email protected]>
Larry McVoy <[email protected]>
Lennart Jablonka <[email protected]>
Linus Heckemann <[email protected]>
Lukas Javorsky <[email protected]>
Marcos Fouces <[email protected]>
Mario Blaettermann <[email protected]>
Martin (Joey) Schulze <[email protected]>
Masami Hiramatsu <[email protected]>
Masatake YAMATO <[email protected]>
Matthew House <[email protected]>
Matthew Wilcox (Oracle) <[email protected]>
Michael Kerrisk <[email protected]>
Michael Weiß <[email protected]>
Mickaël Salaün <[email protected]>
Mike Frysinger <[email protected]>
Mike Kravetz <[email protected]>
Mingye Wang <[email protected]>
Nadav Amit <[email protected]>
Nick Desaulniers <[email protected]>
Oskari Pirhonen <[email protected]>
Paul E. McKenney <[email protected]>
Paul Eggert <[email protected]>
Paul Floyd <[email protected]>
Paul Smith <[email protected]>
Philip Guenther <[email protected]>
Ralph Corderoy <[email protected]>
Reuben Thomas <[email protected]>
Rich Felker <[email protected]>
Richard Biener <[email protected]>
Sam James <[email protected]>
Serge Hallyn <[email protected]>
Seth David Schoen <[email protected]>
Siddhesh Poyarekar <[email protected]>
Simon Horman <[email protected]>
Stefan Puiu <[email protected]>
Steffen Nurpmeso <[email protected]>
Szabolcs Nagy <[email protected]>
Thomas Weißschuh <[email protected]>
Tom Schwindl <[email protected]>
Tomáš Golembiovský <[email protected]>
Torbjorn SVENSSON <[email protected]>
Ulrich Drepper <[email protected]>
Vahid Noormofidi <[email protected]>
Vlastimil Babka <[email protected]>
Wilco Dijkstra <[email protected]>
Xi Ruoyao <[email protected]>
Yang Xu <[email protected]>
Yedidyah Bar David <[email protected]>
Zack Weinberg <[email protected]>
Zijun Zhao <[email protected]>

Apologies if I missed anyone!


Thanks you all for contributing!

Cheers,
Alex

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


Attachments:
OpenPGP_signature (849.00 B)
OpenPGP digital signature

2023-08-02 04:59:56

by Luna Jernberg

[permalink] [raw]
Subject: Re: man-pages-6.05 released

Updated PKGBUILD for Arch Linux

Den tis 1 aug. 2023 kl 15:30 skrev Alejandro Colomar <[email protected]>:
>
> 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" <[email protected]>
> "G. Branden Robinson" <[email protected]>
> A. Wilcox <[email protected]>
> Adam Dobes <[email protected]>
> Ahelenia Ziemiańska <[email protected]>
> Alan Cox <[email protected]>
> Alejandro Colomar <[email protected]>
> Alexei Starovoitov <[email protected]>
> Andreas Schwab <[email protected]>
> Andrew Clayton <[email protected]>
> Andrew Morton <[email protected]>
> Avinesh Kumar <[email protected]>
> Bastien Roucariès <[email protected]>
> Bjarni Ingi Gislason <[email protected]>
> Brian Inglis <[email protected]>
> Bruno Haible <[email protected]>
> Carsten Grohmann <[email protected]>
> Colin Watson <[email protected]>
> Cyril Hrubis <[email protected]>
> DJ Delorie <[email protected]>
> Daniel Verkamp <[email protected]>
> David Howells <[email protected]>
> Dirk Gouders <[email protected]>
> Dmitry Goncharov <[email protected]>
> Eli Zaretskii <[email protected]>
> Elliott Hughes <[email protected]>
> Eric Biggers <[email protected]>
> Eric Blake <[email protected]>
> Eric Wong <[email protected]>
> Fangrui Song <[email protected]>
> Florian Weimer <[email protected]>
> Gavin Smith <[email protected]>
> Guillem Jover <[email protected]>
> Günther Noack <[email protected]>
> Helge Kreutzmann <[email protected]>
> Igor Sysoev <[email protected]>
> Ingo Schwarze <[email protected]>
> Jakub Jelinek <[email protected]>
> Jakub Sitnicki <[email protected]>
> Jakub Wilk <[email protected]>
> Johannes Weiner <[email protected]>
> John Gilmore <[email protected]>
> John Hubbard <[email protected]>
> John Scott <[email protected]>
> Jonathan Corbet <[email protected]>
> Jonathan Wakely <[email protected]>
> Joseph Myers <[email protected]>
> Josh Triplett <[email protected]>
> Kirill A. Shutemov <[email protected]>
> Larry McVoy <[email protected]>
> Lennart Jablonka <[email protected]>
> Linus Heckemann <[email protected]>
> Lukas Javorsky <[email protected]>
> Marcos Fouces <[email protected]>
> Mario Blaettermann <[email protected]>
> Martin (Joey) Schulze <[email protected]>
> Masami Hiramatsu <[email protected]>
> Masatake YAMATO <[email protected]>
> Matthew House <[email protected]>
> Matthew Wilcox (Oracle) <[email protected]>
> Michael Kerrisk <[email protected]>
> Michael Weiß <[email protected]>
> Mickaël Salaün <[email protected]>
> Mike Frysinger <[email protected]>
> Mike Kravetz <[email protected]>
> Mingye Wang <[email protected]>
> Nadav Amit <[email protected]>
> Nick Desaulniers <[email protected]>
> Oskari Pirhonen <[email protected]>
> Paul E. McKenney <[email protected]>
> Paul Eggert <[email protected]>
> Paul Floyd <[email protected]>
> Paul Smith <[email protected]>
> Philip Guenther <[email protected]>
> Ralph Corderoy <[email protected]>
> Reuben Thomas <[email protected]>
> Rich Felker <[email protected]>
> Richard Biener <[email protected]>
> Sam James <[email protected]>
> Serge Hallyn <[email protected]>
> Seth David Schoen <[email protected]>
> Siddhesh Poyarekar <[email protected]>
> Simon Horman <[email protected]>
> Stefan Puiu <[email protected]>
> Steffen Nurpmeso <[email protected]>
> Szabolcs Nagy <[email protected]>
> Thomas Weißschuh <[email protected]>
> Tom Schwindl <[email protected]>
> Tomáš Golembiovský <[email protected]>
> Torbjorn SVENSSON <[email protected]>
> Ulrich Drepper <[email protected]>
> Vahid Noormofidi <[email protected]>
> Vlastimil Babka <[email protected]>
> Wilco Dijkstra <[email protected]>
> Xi Ruoyao <[email protected]>
> Yang Xu <[email protected]>
> Yedidyah Bar David <[email protected]>
> Zack Weinberg <[email protected]>
> Zijun Zhao <[email protected]>
>
> Apologies if I missed anyone!
>
>
> Thanks you all for contributing!
>
> Cheers,
> Alex
>
> --
> <http://www.alejandro-colomar.es/>
> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5


Attachments:
PKGBUILD (1.70 kB)

2023-08-02 23:30:32

by Alejandro Colomar

[permalink] [raw]
Subject: man-pages-6.05.01 released

Gidday!

On 2023-08-01 15:19, Alejandro Colomar wrote:
> 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/>

There was a small problem while packaging for Debian. quilt(1)
produces a .pc/ dir in the root of the repository, and the patches
stored in there confuse the build system to try to lint those patches
as if they were manual pages. If you successfully packaged 6.05
without noticing this issue, you can safely ignore this bugfix
release. If you noticed the issue, or haven't yet started, I suggest
you package 6.05.01.

Changes since man-pages-6.05:

man-pages-6.05.01:

- Build system:
- Ignore dot-dirs within $MANDIR


Cheers,
Alex

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


Attachments:
OpenPGP_signature (849.00 B)
OpenPGP digital signature

2023-08-04 04:17:34

by Luna Jernberg

[permalink] [raw]
Subject: Re: man-pages-6.05.01 released

Hello!

Here comes and updated PKGBUILD for Arch Linux, sorry it took a while,
was watching Fedora Flock 2023 yesterday

Den tors 3 aug. 2023 kl 00:32 skrev Alejandro Colomar <[email protected]>:
>
> Gidday!
>
> On 2023-08-01 15:19, Alejandro Colomar wrote:
> > 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/>
>
> There was a small problem while packaging for Debian. quilt(1)
> produces a .pc/ dir in the root of the repository, and the patches
> stored in there confuse the build system to try to lint those patches
> as if they were manual pages. If you successfully packaged 6.05
> without noticing this issue, you can safely ignore this bugfix
> release. If you noticed the issue, or haven't yet started, I suggest
> you package 6.05.01.
>
> Changes since man-pages-6.05:
>
> man-pages-6.05.01:
>
> - Build system:
> - Ignore dot-dirs within $MANDIR
>
>
> Cheers,
> Alex
>
> --
> <http://www.alejandro-colomar.es/>
> GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5
>


Attachments:
PKGBUILD (1.70 kB)