man-pages-6.05

[Xi Ruoyao]

New minor version.

[Xi Ruoyao]

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

[Bruce Dubbs]

Fixed at commit be5b2e03fc6e7382f8c012d9fdb8e29a9bbbf17c

[Bruce Dubbs]

Milestone renamed