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

This is the release of man-pages-6.05.  The release tarball will soon be
avaliable at <kernel.org>.  A PDF version of the pages will also be
uploaded in the same page.

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
Changes.old: 6.04: Document the addition of `make check`

This caused trouble to the Debian packaging, since it runs `make check`
if the package supports it, and since we have a few pages that trigger
errors there, the packaging failed to work for 6.04.

Document the workaround.

Reported-by: Marcos Fouces <marcos@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
1 file changed