man-pages-6.16

[Xi Ruoyao]

New minor version.

[Xi Ruoyao]

This release adds two build dependencies:

• awk/awk
• pcre2-utils/pcre2grep

New and rewritten pages

man2/

fsconfig.2 fsmount.2 fsopen.2 fspick.2 move_mount.2 open_tree.2

man2const/

PR_FUTEX_HASH_GET_SLOTS.2const PR_FUTEX_HASH_SET_SLOTS.2const

man2type/

mount_attr.2type (split from mount_setattr(2))

man3/

_Fork.3 countof.3 memeq.3 streq.3

Newly documented interfaces in existing pages

---

man2/

mount_setattr.2

glibc wrapper

pidfd_open.2

PIDFD_THREAD

pidfd_send_signal.2

PIDFD_SIGNAL_THREAD PIDFD_SIGNAL_THREAD_GROUP PIDFD_SIGNAL_PROCESS_GROUP

quotactl.2

quotactl_fd(2)

readv.2

RWF_DONTCACHE

sigaction.2

SI_ASYNCNL FPE_FLTUNK FPE_CONDTRAP SEGV_ACCADI SEGV_ADIDERR SEGV_ADIPERR SEGV_MTEAERR SEGV_MTESERR SEGV_CPERR TRAP_UNK TRAP_PERF SYS_USER_DISPATCH EMT_TAGOVF

man3/

abs.3

umaxabs(3)

opendir.3

ENAMETOOLONG

man7/

operator.7

(type){} alignof _Countof

rtnetlink.7

RTAX_UNSPEC RTAX_LOCK RTAX_MTU RTAX_WINDOW RTAX_RTT RTAX_RTTVAR RTAX_SSTHRESH RTAX_CWND RTAX_ADVMSS RTAX_REORDERING RTAX_HOPLIMIT RTAX_INITCWND RTAX_FEATURES RTAX_RTO_MIN RTAX_INITRWND RTAX_QUICKACK RTAX_CC_ALGO RTAX_FASTOPEN_NO_COOKIE

sched.7

CONFIG_PREEMPT CONFIG_PREEMPT_LAZY

tcp.7

TCP_SAVE_SYN TCP_SAVED_SYN

New and changed links

man2/

open_tree_attr.2 (open_tree(2)) quotactl_fd.2 (quotactl(2))

man3/

umaxabs.3 (abs(3))

Global changes

• man/
  • Update documentation for POSIX.1-2024 (still more work to do).
  • SYNOPSIS: Use GNU forward-declarations of parameters for sizes of

array parameters.

• Improve style of source code for tbl(1) tables.
• man2/: Use the common name 'fd' instead of 'fildes'.
• Use semantic newlines.
• EXAMPLES
  • Use err(3) and errc(3bsd) instead of similar macros.
  • Fix includes (thanks to iwyu(1)).
  • Use NITEMS() consistently.
  • Don't name unused parameters.

• share/mk/
  • Add support for the chapter man3attr.
  • help: Document the usual targets.
  • lint-man-blank: Add target to lint about blank lines.
  • lint-man-ws: Diagnose spurious use of white space.
  • lint-man-quote: Diagnose an unmatched quote.
  • lint-man-poems: Diagnose (lack of) semantic newlines.
  • lint-man-dash: Diagnose unescaped dashes
  • Merge handling of man(7) and mdoc(7) pages.
  • lint, build, check: Move exceptions to separate files.
  • Remove unused variables.
  • Unify local variable names.
  • Silence diagnostics about unnamed parameters.
  • configure/build-depends/:
    • Add awk/awk.
    • Add pcre2-utils/pcre2grep.

Changes to individual files

• src/bin/
  • sortman(1): Fix order of intro(*) pages for subsections.
  • diffman-git(1): Show sections as hunk context.

[Xi Ruoyao]

Replying to Xi Ruoyao:

This release adds two build dependencies:

• awk/awk
• pcre2-utils/pcre2grep

I moved pcre2grep away and the installation still succeeded. It looks like the "build dependencies" here means something useful for the developers of man-pages, not the distros. So we do not need to move man-pages after pcre2.

The mansect script indeed uses pcre2grep but it does not require pcre2grep when we install it (i.e. it's only a runtime dependency).