Many pages: Use correct letter case in page titles (TH)

Scripted change:

$ find man* -type f \
  | xargs grep -L '\.so' \
  | while read f; do
      P=$(basename $f);
      T=$(grep '\.TH ' $f | cut -f2,3 -d' ' | sed 's/ /./');
      p=$(echo $P | tr '[:upper:]' '[:lower:]');
      t=$(echo $T | tr '[:upper:]' '[:lower:]');
      Tn=$(echo $T | sed 's/\.[^.]\+$//')
      Pn=$(echo $P | sed 's/\.[^.]\+$//')

      N=$(man_section $f NAME \
      | sed -n '/NAME/,/ - /p' \
      | sed 's/ - .*//' \
      | grep -v '^NAME$' \
      | tr ', ' '\n' \
      | grep -i "^$Pn$" \
      | head -n1)

      test $P = $T \
      && test -n $N \
      && continue;

      if test "x$p" != "x$t"; then
          echo 1 $P $T $N;
      elif test -z "$N"; then
          echo 2 $P $T $N;
      else
          sed -i "/\.TH /s/$Tn/$N/" $f;
      fi;
  done;

On 10/30/22 23:00, G. Branden Robinson wrote:
> For those to whom this change is coming as an unpleasant surprise, the
> forthcoming groff 1.23.0 features an option that will reverse this
> change at rendering time.
>
>  From groff_man(7):
>
>     -rCT=1 Capitalize titles, setting the man page title (the first
>            argument to .TH) in full capitals in headers and footers.
>            This transformation is off by default because it discards
>            case distinction information.
>
> This register can also be set in a site-local "man.local" file to force
> it on for all pages.  On Debian-based systems, this file is in
> /etc/groff.  The following line will do the trick.
>
> .nr CT 1
>
> The groff_man_style(7) man page offers further examples of such
> rendering customization.
>
>     /usr/local/share/groff/site-tmac/man.local
>            Put site‐local changes and customizations into this file.
>
>                   .\" Use narrower indentation on terminals and similar.
>                   .if n .nr IN 4n
>                   .\" Put only one space after the end of a sentence.
>                   .ss 12 0 \" See groff(7).
>                   .\" Keep pages narrow even on wide terminals.
>                   .if n .if \n[LL]>78n .nr LL 78n
>                   .\" Ensure hyperlinks are enabled for terminals.
>                   .nr U 1
>
>            On multi‐user systems, it is more considerate to users whose
>            preferences may differ from the administrator’s to be less
>            aggressive with such settings, or to permit their override
>            with a user‐specific man.local file.  This can be achieved by
>            placing one or both of following requests at the end of the
>            site‐local file.
>                   .soquiet \V[XDG_CONFIG_HOME]/man.local
>                   .soquiet \V[HOME]/.man.local
>            However, a security‐sandboxed man(1) program may lack
>            permission to open such files.

Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

madvise.2: document reliable probe for advice support

EINVAL is an overloaded error code for madvise(2) and it's not clear
under what context it means "advice is not valid" vs another error.

Explicitly document that madvise(0, 0, advice) can reliably be used to
probe for kernel support for "advice", returning zero iff "advice" is
supported by the kernel.

Signed-off-by: Zach O'Keefe <zokeefe@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

madvise.2: update THP file/shmem documentation for +5.4

Since Linux 5.4, Transparent Huge Pages now support both file-backed
memory and shmem memory. Update MADV_HUGEPAGE advice description to
reflect this.

Additionally, expand the description of requirements for memory to be
considered eligible for THP: alignment / mapping requirements, VMA
flags, prctl(2) settings, inode status, etc.

Signed-off-by: Zach O'Keefe <zokeefe@google.com>
[ alx: ffix ]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

FILE.3type: Move page to correct subsection

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Change alx's email address

Signed-off-by: Alejandro Colomar <alx@kernel.org>

ioctl_tty.2: Document TIOCSERGETLSR/TIOCSER_TEMT

Signed-off-by: Pali Rohár <pali@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man-pages.7: Document how to write lists

Reported-by: Mike Frysinger <vapier@gentoo.org>
Acked-by: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Many pages: Use a consistent style for lists

There are different kinds of lists:

Tagged paragraphs
These are fixed in a separate commit (the previous one).
They are used for a list of tags and their descriptions.
An example is this commit message itself.

Ordered lists
Elements are preceeded by a number in parentheses.
These represent a set of steps that have an order.

When there are substeps, they will be numbered like (4.2).

Positional lists
Elements are preceeded by a number in square brackets
(index).  These represent fields in a set.  The index will
start at:

0 fields of a C data structure, to be consistent
with arrays.
1 fields of a file, to be consistent with tools like
cut(1).

Alternatives list
Elements are preceeded by a letter in parentheses.
These represent a set of (normally) exclusive
alternatives.

Bullet lists
Elements are preceeded by bullet symbols.  Anything that
doesn't fit elsewhere usually is covered by this type of
list.

Notes
Not really a list, but the syntax is identical to
"positional lists".

There should always be 2 spaces between the list symbol and the
elements.  This doesn't apply to "tagged paragraphs", which use
the default indentation rules.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Cc: <groff@gnu.org>
Acked-by: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Many pages: Use .TP for tagged paragraphs

Reported-by: Mike Frysinger <vapier@gentoo.org>
Cc: <groff@gnu.org>
Acked-by: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ascii.7: Chase down History to earliest

Cf., well, the UNIX Programmer's Manual:
  https://www.tuhs.org/Archive/Distributions/Research/Dennis_v1/UNIX_ProgrammersManual_Nov71.pdf
PDF page 191; yes, the typographical convention here is insane, and
the contemprary-correct way to refer to this page from within the manual
would be /just/ "/etc/ascii", but, given the context, "/etc/ascii (VII)"
makes the most sense to me

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

st.4: srcfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

capabilities.7: ffix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

cpuset.7: tfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

locale.7: srcfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man-pages.7: ffix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

src.mk: Fix regex for manual page files

Without the $, vim(1) temporary files are also found.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man-pages.7: Use . consistently in bulleted list

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man-pages.7: Add missing . before macro

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

CONTRIBUTING: Rewrite and expand

Put most of the relevant information from the website in the repo.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

dist.mk: Force adding version to tarball man pagesat 'make dist'

When creating a tarball with 'make dist', force the addition of
the date and version to the pages.  Otherwise, if a tarball had
already been created from a previous commit, and the page hasn't
been touched, make will consider the one in the tarball
up-to-date, and will keep the old version.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

RELEASE: tfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Makefile: Remove unnecessary include

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Makefile: Remove installdirs* and builddirs* targets

Since our makefiles correctly state the dependencies of all
targets, and allow fully-parallel builds and installs, there's no
reason at all to allow creating the directories separately.  That
was an old recommendation for when makefiles were buggy, and you
couldn't fully trust in them not having races or incorrect
dependencies.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

README: tfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

RELEASE: ffix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

README, RELEASE, lsm: Rename man-pages.lsm to lsm

It's obvious that it belongs to man-pages, since it's inside the
repository tree.  Also, since the file is emailed to the LSM
project, it doesn't matter what name we give to it.  Let's
simplify the name.

Now only MANDIRS start with 'man*', which is a good thing.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

README: Remove version from LSM file name

Signed-off-by: Alejandro Colomar <alx@kernel.org>

RELEASE, man-pages.lsm: Remove version from LSM file name

It's not necessary, and removing it simplifies maintenance.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

RELEASE, man-pages-6.01.Announce: Remove .Announce file

Signed-off-by: Alejandro Colomar <alx@kernel.org>

README: Rewrite and expand

Let's start making the repository self-contained.  The README
should be enough to guide a user into everything that has to do
with the project.  The website should be a secondary source, for
those who don't know about the repository yet.

I merged some of the information found in the .Announce file,
which I'll remove.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

lsm: Fix Title and Description

Use the project name for the Title, and a descriptive Description.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

lsm: Author: Remove field

The parser failed to understand several.  Since there's nothing
useful we can put there that the parser would accept, just remove
the field.

Acked-by: Aaron Schrab <aaron@schrab.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

RELEASE: Remind to push the git tag

Signed-off-by: Alejandro Colomar <alx@kernel.org>

RELEASE: Add missing cd(1)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

INSTALL, RELEASE: Add RELEASE file with instructions for releasing

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes.old: tfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Revert "cmd.mk, install.mk: Avoid modifying existing directories at 'make install'"

This reverts commit 12b6045567037e783d0c3a79f276a15fd748d3a6.

There was no bug, since make(1) only tries to install the
directory if there was no directory at all.  I was confused.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

cmd.mk, install.mk: Avoid modifying existing directories at 'make install'

'install -d' has an issue compared to 'mkdir -p':  it doesn't
respect existing directories.  It will set the ownership, file
mode, and SELinux contexts (and any other property that would be
set by install(1) to a newly-created directory), overwriting any
existing properties of the existing directory.

'mkdir -p' doesn't have this issue:  it is a no-op if the
directory exists.  However, it's not an ideal solution either,
since it can't be used to set the properties (owner, mode, ...) of
a newly-created directory.

Therefore, the best solution is to use install(1), but only after
making sure that the directory doesn't exist with test(1).

Reported-by: Andrew Clayton <a.clayton@nginx.com>
Reported-by: Alejandro Colomar <alx@nginx.com>
Link: <https://github.com/nginx/unit/issues/769>
Signed-off-by: Alejandro Colomar <alx@nginx.com>

cmd.mk, install.mk: Move command definitions to cmd.mk

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Start of man-pages-NEXT: Move Changes to Changes.old

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Ready for 6.01

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes: Ready for 6.01

A few useful commands:

List of contributors:

$ git log man-pages-6.00..HEAD \
  | grep '<.*@.*>' \
  | sed 's/^ *//' \
  | sed 's/[^:]*: //' \
  | sort \
  | uniq;

List of new pages:

$ git diff man-pages-6.00..HEAD \
  | grep -A1 '^--- /dev/null' \
  | grep -v -e '\--' -e '\--- /dev/null' \
  | sed 's,+++ b/,,' \
  | grep '^man' \
  | xargs grep -l '^\.so ' \
  | sed 's,.*/,,';

List of new links:

$ git diff man-pages-6.00..HEAD \
  | grep -A1 '^--- /dev/null' \
  | grep -v -e '\--' -e '\--- /dev/null' \
  | sed 's,+++ b/,,' \
  | grep '^man' \
  | xargs grep -L '^\.so ' \
  | sed 's,.*/,,';

Signed-off-by: Alejandro Colomar <alx@kernel.org>

ferror.3: CAVEATS: Need to get EOF before calling these functions

Signed-off-by: Alejandro Colomar <alx@kernel.org>

EOF.3const: Add documentation for EOF

Reported-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Makefile: Document the V verbose variable

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Makefile, build-src.mk, dist.mk, verbose.mk, version.mk: Hide errors unless V is defined

Some commands run by the makefiles are not strictly needed by most
users or packagers.  Do not print errors if those fail spuriously.

However, since we still want to see those errors in some cases,
use the V variable to conditionally print those errors.

Reported-by: Pierre Labastie <pierre.labastie@neuf.fr>
Cc: Agostino Sarubbo <ago@gentoo.org>
Cc: Mike Gilbert <floppym@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

system_data_types.7: fix typo in regmatch_t description

The description of rm_eo in regmatch_t structure has a typo
which makes it difficult to understand. Fix this.

Reported-By: Nicolás A. Ortega Froysa <nicolas@ortegas.org>
Signed-off-By: Michael Tokarev <mjt@tls.msk.ru>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

feature_test_macros.7: document _TIME_BITS (time64)

Some notes:
* glibc is the only libc I'm aware of implementing _TIME_BITS for time64
compatibility. It was introduced in glibc-2.34;

* musl libc made a hard switch in 1.2.0, see https://musl.libc.org/time64.html;

* Using _TIME_BITS=64 with glibc requires _FILE_OFFSET_BITS=64 (which is used
for Large File Support)! Extraordinary claims require (some) evidence, so see
https://sourceware.org/git/?p=glibc.git;a=blob;f=sysdeps/unix/sysv/linux/features-time64.h;h=84d56ee3ff2ecfa0d2499385623f30606f84a1bf.

Reference: https://wiki.gentoo.org/wiki/Project:Toolchain/time64_migration
Reference: https://sourceware.org/pipermail/libc-alpha/2022-January/134985.html
Signed-off-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

time_t.3type: reference _TIME_BITS (time64)

Just like we do with _FILE_OFFSET_BITS in off_t.3type.

Reference: https://wiki.gentoo.org/wiki/Project:Toolchain/time64_migration
Reference: https://sourceware.org/pipermail/libc-alpha/2022-January/134985.html
Signed-off-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

feature_test_macros.7: document -D_FORTIFY_SOURCE=3

Reference: https://developers.redhat.com/blog/2021/04/16/broadening-compiler-checks-for-buffer-overflows-in-_fortify_source
Reference: https://developers.redhat.com/articles/2022/09/17/gccs-new-fortification-level
Signed-off-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

statx.2, open.2: document STATX_DIOALIGN

Document the STATX_DIOALIGN support for statx()
(https://git.kernel.org/linus/725737e7c21d2d25).

Reviewed-by: Darrick J. Wong <djwong@kernel.org>
Signed-off-by: Eric Biggers <ebiggers@google.com>
[ steve: wfix ]
Cc: Steve Izma <sizma@golden.net>
[ alx: srcfix ]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

dist.mk, All pages: .TH: Generate date at 'make dist'

Replace the date by a placeholder (date) in the repo, as we're
doing with the version (unreleased).  It will be filled when the
tarball is generated with 'make dist' (or equivalent) with the
date of the most recent git commit that modifies the page (as was
done previously by update_timestamps.sh, which has been removed).

Scripted change (mostly):

$ find man* -type f \
| xargs sed -Ei '/^\.TH /s/.TH +([^ ]+ +[^ ]+) +[^ ]+ +(.*)/.TH \1 (date) \2/'

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes: tfix

The past participle of "spread" is just "spread".

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

prctl.2: tfix

Escape hyphens.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

hier.7: tfix

Reported-by: Grigoriy <grigoriyremvar@protonmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fanotify_mark.2: Document FAN_MARK_IGNORE

A new flavor of FAN_MARK_IGNORED_MASK that helps to resolve the
ambiguity around the combination of event flags and ignore mask.

It is also more strict in the events and flags allowed to be
set in a non-directory inode mark mask and it mandates the use
of FAN_MARK_IGNORED_SURV_MODIFY flag on filesystem, mount and
directory inode marks.

Reviewed-by: Jan Kara <jack@suse.cz>
Reviewed-by: Matthew Bobrowski <repnop@google.com>
Signed-off-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Start of man-pages-NEXT: Move Changes to Changes.old

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Ready for 6.00

Signed-off-by: Alejandro Colomar <alx@kernel.org>

update_timestamps.sh: Ignore inexistent files

Signed-off-by: Alejandro Colomar <alx@kernel.org>

getent.1, iconv.1, intro.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, mtrace.1, pldd.1, sprof.1, time.1, _exit.2, _syscall.2, accept.2, access.2, acct.2, add_key.2, adjtimex.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, bpf.2, brk.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, close_range.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, exit_group.2, fallocate.2, fanotify_init.2, fanotify_mark.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl.2, ioctl_console.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_fslabel.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kexec_load.2, keyctl.2, kill.2, landlock_add_rule.2, landlock_create_ruleset.2, landlock_restrict_self.2, link.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, memfd_secret.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, mount_setattr.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, open_by_handle_at.2, openat2.2, outb.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pidfd_getfd.2, pidfd_open.2, pidfd_send_signal.2, pipe.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_madvise.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readv.2, reboot.2, recv.2, recvmmsg.2, remap_file_pages.2, removexattr.2, rename.2, request_key.2, restart_syscall.2, rmdir.2, rt_sigqueueinfo.2, s390_guarded_storage.2, s390_pci_mmio_write.2, s390_runtime_instr.2, s390_sthyi.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, seccomp.2, seccomp_unotify.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, sendmmsg.2, set_mempolicy.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, spu_create.2, spu_run.2, stat.2, statfs.2, statx.2, stime.2, subpage_prot.2, swapon.2, symlink.2, sync.2, sync_file_range.2, syscall.2, syscalls.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, open_how.2type, CPU_SET.3, FILE.3, INFINITY.3, MAX.3, MB_CUR_MAX.3, MB_LEN_MAX.3, _Generic.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, backtrace.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, bswap.3, btowc.3, btree.3, byteorder.3, bzero.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cexp2.3, cfree.3, cimag.3, circleq.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, dbopen.3, des_crypt.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, fileno.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fopencookie.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getusershell.3, getutent.3, getutmp.3, getw.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, group_member.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, index.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, isfdtype.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, list.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_hook.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setsigmask_np.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_mutex_consistent.3, pthread_mutexattr_getpshared.3, pthread_mutexattr_init.3, pthread_mutexattr_setrobust.3, pthread_rwlockattr_setkind_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_spin_init.3, pthread_spin_lock.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, readdir_r.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sincos.3, sinh.3, sleep.3, slist.3, sockatmark.3, sqrt.3, stailq.3, statvfs.3, stdarg.3, stdin.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tailq.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, NULL.3const, sysexits.h.3head, aiocb.3type, blkcnt_t.3type, blksize_t.3type, cc_t.3type, clock_t.3type, clockid_t.3type, dev_t.3type, div_t.3type, double_t.3type, epoll_event.3type, fenv_t.3type, id_t.3type, intN_t.3type, intmax_t.3type, intptr_t.3type, iovec.3type, itimerspec.3type, lconv.3type, mode_t.3type, off_t.3type, ptrdiff_t.3type, regex_t.3type, size_t.3type, sockaddr.3type, stat.3type, time_t.3type, timer_t.3type, timespec.3type, timeval.3type, tm.3type, va_list.3type, void.3type, cciss.4, console_codes.4, cpuid.4, dsp56k.4, fd.4, full.4, fuse.4, hd.4, hpsa.4, initrd.4, intro.4, lirc.4, loop.4, lp.4, mem.4, mouse.4, msr.4, null.4, pts.4, ram.4, random.4, rtc.4, sd.4, sk98lin.4, smartpqi.4, st.4, tty.4, ttyS.4, vcs.4, veth.4, wavelan.4, acct.5, charmap.5, core.5, dir_colors.5, elf.5, filesystems.5, ftpusers.5, gai.conf.5, group.5, host.conf.5, hosts.5, hosts.equiv.5, intro.5, issue.5, locale.5, motd.5, networks.5, nologin.5, nscd.conf.5, nss.5, nsswitch.conf.5, passwd.5, proc.5, protocols.5, repertoiremap.5, resolv.conf.5, rpc.5, securetty.5, services.5, shells.5, slabinfo.5, sysfs.5, termcap.5, tmpfs.5, ttytype.5, tzfile.5, utmp.5, intro.6, address_families.7, aio.7, armscii-8.7, arp.7, ascii.7, attributes.7, boot.7, bootparam.7, bpf-helpers.7, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, complex.7, cp1251.7, cp1252.7, cpuset.7, credentials.7, ddp.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, fifo.7, futex.7, glob.7, hier.7, hostname.7, icmp.7, inode.7, inotify.7, intro.7, ip.7, ipc_namespaces.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, kernel_lockdown.7, keyrings.7, koi8-r.7, koi8-u.7, landlock.7, libc.7, locale.7, mailaddr.7, man-pages.7, man.7, math_error.7, mount_namespaces.7, mq_overview.7, namespaces.7, netdevice.7, netlink.7, network_namespaces.7, nptl.7, numa.7, operator.7, packet.7, path_resolution.7, persistent-keyring.7, pid_namespaces.7, pipe.7, pkeys.7, posixoptions.7, process-keyring.7, pthreads.7, pty.7, queue.7, random.7, raw.7, regex.7, rtld-audit.7, rtnetlink.7, sched.7, sem_overview.7, session-keyring.7, shm_overview.7, sigevent.7, signal-safety.7, signal.7, sock_diag.7, socket.7, spufs.7, standards.7, suffixes.7, symlink.7, system_data_types.7, sysvipc.7, tcp.7, termio.7, thread-keyring.7, time.7, time_namespaces.7, udp.7, udplite.7, unicode.7, units.7, unix.7, uri.7, user-keyring.7, user-session-keyring.7, user_namespaces.7, utf-8.7, uts_namespaces.7, vdso.7, vsock.7, x25.7, xattr.7, iconvconfig.8, intro.8, ld.so.8, ldconfig.8, nscd.8, sln.8, tzselect.8: tstamp

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes: Ready for 6.00

Signed-off-by: Alejandro Colomar <alx@kernel.org>

pivot_root.2: Fix a typo/thinko

(To obtain a prefix of a given pathname, we have to append (suffix)
'/..' at its end.)

Signed-off-by: Štěpán Němec <stepnem@smrk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

memfd_create.2, mlock.2, poll.2, select.2, fopen.3, capabilities.7: tfix

Signed-off-by: Štěpán Němec <stepnem@smrk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc.5: tfix

"KernelPageSize" and "MMUPageSize" are repeated in the
/proc/[pid]/smaps format example.

Signed-off-by: Andrea Cervesato <andrea.cervesato@suse.com>
Fixes: 6861f8f0c7 "proc.5: Improve description of the KernelPageSize and [...]"
Signed-off-by: Alejandro Colomar <alx@kernel.org>

unix.7: fix section reference wrt length

The description of Linux path length handling has always been in the
BUGS section.  The commit that added this see-also note incorrectly
referred to the NOTES section instead.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

build-src.mk: Fix CPPFLAGS

'-D' flags also correspond to CPPFLAGS, not CFLAGS.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

wcsnlen.3: Fix off-by-one error

Same change as in 45323bbef7fb06eec3fa210ee6c1651bbc57c38d.

Cc: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

inet_net_pton.3: tfix

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

setxattr.2: ffix

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

kcmp.2: EXAMPLES: Make constant string be 'static const'

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Align variable declarations

Also, move some declarations to the top of functions.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getdents.2: EXAMPLES: Use size_t for an offset

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

cmd.mk, lint-man.mk: Use variables for commands

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

lint-man.mk: Support both UTF8 and non-UTF8 systems

Systems using the C locale can now also run 'make lint', and will
test the ascii device.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Remove unused variables

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Use unsigned types for loop iterators

Looping with unsigned types is safer.  See the link below.

When the iterators are used for accessing an array, use size_t;
otherwise, use the most appropriate unsigned type, which in most
cases is just 'unsigned int'.

Also adjust other variables that have to interact with the
iterators, to avoid comparison of integers of different
signedness.

Link: <https://gustedt.wordpress.com/2013/07/15/a-praise-of-size_t-and-other-unsigned-types/>
Cc: Jens Gustedt <jens.gustedt@inria.fr>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

envz_add.3: EXAMPLES: Fix type of variable

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

printf.3: SYNOPSIS: Remove incorrect header

Reported-by: Sam James <sam@gentoo.org>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

ipv6.7: wfix

Fixes: 77117f4fc55addbb657d1c87e2f86911d7e432c9
Reported-by: Donald Buczek <buczek@molgen.mpg.de>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

semop.2: Fix truncated comment on sempid

Fixes: bdd915e20f87346dc07b93f8f26386feb92d2c44
Reported-by: GUO Zihua <guozihua@huawei.com>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

mount_setattr.2: EXAMPLES: Remove unused include

Reported-by: iwyu(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

__ppc_get_timebase.3, if_nameindex.3, rtime.3: EXAMPLES: wsfix

Reported-by: cpplint(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

setbuf.3: Don't build example program

The example program is invalid on purpose; don't build it.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Remove unused variables

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

build-src.mk, cmd.mk: Add libbsd to the build of example programs

Some programs need libbsd for using errc(3).

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getdents.2: EXAMPLES: Sort includes

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

.checkpatch.conf: Ignore some warnings

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Use <err.h> functions

When reporting errors, prefer using conventional <err.h>
functions, rather than home-made macros.  Home-made macros are
necessary for portable programs, so in documentation about
portable functions, keep using the macros.  However, in the
documentation for functions that are only available in GNU/Linux
and/or BSD systems, prefer <err.h>, which is available in both
systems.

Do the same in example programs documenting portable functions but
in which we already require _GNU_SOURCE for some other reason.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

__ppc_get_timebase.3, __ppc_yield.3: Remove incorrect text

This was accidentally introduced in a scripted change.

Fixes: 45186a5da74285d72199744eb5d2888fe348f680
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Remove unused variables

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

matherr.3: EXAMPLES: Can't build program

The documented functions don't exist anymore.

Reported-by: clang(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getsubopt.3: EXAMPLES: Fix indentation

Fixes: 645259f4357baa3b3931ae24c79648baa155ebdf
Fixes: 35facf001e3682c0bafbdd139d8cfc6a8cb2a301
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getpwent_r.3: EXAMPLES: Add missing include

Reported-by: clang(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

fopencookie.3: EXAMPLES: Remove 'else' after 'return'

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

encrypt.3: SYNOPSIS: Mark functions as [[deprecated]]

These functions don't exist anymore.

Reported-by: clang(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Sort includes

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

config.yaml: Ignore some clang-tidy warnings

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

pthread_setschedparam.3: EXAMPLES: Remove trailing semicolon in macro definition

Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

mq_getattr.3: EXAMPLES: Octal permissions are more readable

Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Use %s __func__

Instead of hardcoding the function name.

Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>