*.mk: License consistently with GPL-3.0-or-later

Also, use consistent formatting for the license and copyright.

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

*.mk: check-catman: Support mdoc(7) pages

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

*.mk: build-catman-troff, build-catman-troff-man, build-catman-troff-mdoc: Support mdoc(7) pages

Split the old build-catman-troff target into two subtargets; the ...-man
one supports man(7) pages, while the ...-mdoc one supports mdoc(7) pages.

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

catman.mk: build-catman-troff: Fail if troff(1) writes to stderr

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

*.mk: lint, lint-mdoc, lint-mdoc-mandoc: Support mdoc(7) pages

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

Makefile: Update and remove comments

-  We don't use %/. for directories anymore.

-  %/ targets are obviously directories; no need to say.

-  Don't need to document how we create directories.  That should be
   obvious from the code.

Fixes: ac288b42c ("*.mk: Remove unnecessary '.' after directory names (but keep the '/')")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

regex.3: srcfix

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

regex.3: We rewrote most of the page

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

sockaddr.3type: POSIX Issue 8 will solve strict-aliasing issues with these types

Link: <https://austingroupbugs.net/view.php?id=1641>
Reported-by: Bastien Roucariès <rouca@debian.org>
Reported-by: Alejandro Colomar <alx@kernel.org>
Reviewed-by: Eric Blake <eblake@redhat.com>
Cc: glibc <libc-alpha@sourceware.org>
Cc: GCC <gcc@gcc.gnu.org>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Cc: Igor Sysoev <igor@sysoev.ru>
Cc: Rich Felker <dalias@libc.org>
Cc: Andrew Clayton <andrew@digital-domain.net>
Cc: Richard Biener <richard.guenther@gmail.com>
Cc: Zack Weinberg <zack@owlfolio.org>
Cc: Florian Weimer <fweimer@redhat.com>
Cc: Joseph Myers <joseph@codesourcery.com>
Cc: Jakub Jelinek <jakub@redhat.com>
Cc: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

build-catman.mk: Use .set suffix for troff(1) output

Suggested-by: Ralph Corderoy <ralph@inputplus.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

regex.3: Destandardeseify Match offsets

This section reads like it were (and pretty much is) lifted from POSIX.
That's hard to read, because POSIX is horrendously verbose, as usual.

Instead, synopsise it into something less formal but more reasonable,
and describe the resulting range with a range instead of a paragraph.

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

regex.3: Desoupify regerror() description

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

regex.3: SYNOPSIS: Remove superfluous comments

This has the benefit that we can use proportional-width fonts in the
SYNOPSIS without misalignment in the structures.

Cc: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Cc: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

regex.3: Further clarify the sole purpose of REG_NOSUB

Link: <https://lore.kernel.org/linux-man/3459b2a0-6a07-40fc-1e66-db906c3f62ac@gmail.com/T/#mb50a957359e029c611d6e0b8f1b1a20101aae670>
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

regex.3: Finalise move of reg*.3type

They're inextricably linked, not cross-referenced at all,
and not used anywhere else.

Now that they (realistically) exist to the reader, add a note
on how big nmatch can be; POSIX even says "The application developer
should note that there is probably no reason for using a value of
nmatch that is larger than preg−>re_nsub+1.".

Also remove the now-duplicate regmatch_t declaration.

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

regex.3, regex_t.3type, regmatch_t.3type, regoff_t.3type: Move & link regex_t.3type into regex.3

Move-only commit.

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

dl_iterate_phdr.3: EXAMPLES: Alignment should match open parenthesis

Reported-by: checkpatch(1) (`make lint-c-checkpatch`)
Reported-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

EXIT_SUCCESS.3const: EXAMPLES: Do not use assignment in if condition

Reported-by: checkpatch(1) (`make lint-c-checkpatch`)
Reported-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

regex.3: Desoupify regfree() description

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

regex.3: Improve REG_STARTEND

Explicitly spell out the ranges involved. The original wording always
confused me, but it's actually very sane.

Remove "this doesn't change R_NOTBOL & R_NEWLINE" ‒ so does it change
R_NOTEOL? No. That's weird and confusing.

String largeness doesn't matter, known-lengthness does.

Explicitly spell out the influence on returned matches
(relative to string, not start of range).

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

regex.3: Desoupify regexec() description

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

syscall.2: Document ENOSYS error

Link: <https://lore.kernel.org/linux-man/31ecebc5-1b97-b610-a097-f260ec4d4c8d@gmail.com/>
Suggested-by: Alejandro Colomar <alx@kernel.org>
Signed-off-by: Günther Noack <gnoack3000@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

regex.3: SYNOPSIS: Add _Nullable qualifier to regerror()'s errbuf

Passing NULL there means that the function returns the size needed for a
copy without actually copying (possibly useful before allocating a
buffer large enough).

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

regex.3: Desoupify regcomp() description

Behold:
  regerror() is passed the error code, errcode, the pattern buffer,
  preg, a pointer to a character string buffer, errbuf, and the size
  of the string buffer, errbuf_size.

Absolute soup.  This reads to me like an ill-conceived copy from a very
early standard version.  It looks fine in source form but is horrific to
read as running text.

Instead, replace all of these with just the descriptions of what they do
with their arguments.  What the arguments are is very clearly noted in
big bold in the prototypes.

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

regex.3: Fix subsection headings

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

regex.3: SYNOPSIS: Add _Nullable qualifier

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

man*/: ffix, wfix

Use "bitwise OR" instead of "bitwise-or" (with fonts).
No other pages spell it like this.

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

regex.3: wfix

"Not in POSIX.2", so is it in POSIX.1-2008?  POSIX.1-2001?
(or any other combination of standards from this millenion
not mentioned on this page?)  It's not: just say POSIX.

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

regex.3: ffix

We never bold POSIX, not even anywhere else on this page.

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

regex.3: Note that pmatch is still used if REG_NOSUB if REG_STARTEND

In the regexec() signature
  regmatch_t pmatch[restrict .nmatch],
is a simplification. It's actually
  regmatch_t pmatch[restrict
    ((.preg->flags & REG_NOSUB) ? 0 : .nmatch) ?:
     !!(.eflags & REG_STARTEND)],

But speccing that would be insane.

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

landlock.7: Return instead of exit() if Landlock is unusable

When following a best effort approach,
we should not fail when Landlock is unusable,
but we should fall back to doing nothing.

Link: <https://lore.kernel.org/linux-man/5d90e3b0-1577-7efd-03b8-f94b6e50fbc1@digikod.net/>
Suggested-by: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Günther Noack <gnoack3000@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

landlock.7: wfix: Error message wording in code example

Link: <https://lore.kernel.org/linux-man/5d90e3b0-1577-7efd-03b8-f94b6e50fbc1@digikod.net/>
Suggested-by: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Günther Noack <gnoack3000@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

landlock.7: Use LANDLOCK_* constants for compatibility table

Link: <https://lore.kernel.org/linux-man/5d90e3b0-1577-7efd-03b8-f94b6e50fbc1@digikod.net/>
Cc: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Günther Noack <gnoack3000@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

landlock.7: Check syscall result with == -1 instead of <= 0

Link: <https://lore.kernel.org/linux-man/5d90e3b0-1577-7efd-03b8-f94b6e50fbc1@digikod.net/>
Reported-by: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Günther Noack <gnoack3000@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man*/: ffix

Escape dashes on UUIDs, URLs, and file and package names.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

landlock.7: Explain the best-effort fallback mechanism in the example

Signed-off-by: Günther Noack <gnoack3000@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

INSTALL: Fix references to lib/ -> share/mk/

Fixes: edaa12e6b ("*.mk: Move makefiles from lib/ to share/mk/")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc.5: tfix

Use Ctrl-Alt-Del instead of ctrl-alt-del, as used in all other
instances.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc.5: Document that /proc/PID/oom_adj is no longer present

See kernel commit 01dc52ebdf472f77cca623ca693ca24cfc0f1bbe.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc.5: A process can increase its own /proc/PID/oom_adj setting

See kernel commit 8fb4fc68ca391862b061b3d358a288ccf6abed39.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc.5: Document exact /proc/PID/exe behavior on unlinked pathnames

Add the space which gets appended before the "(deleted)" marker.

Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ip.7: ffix

Fixes: 51f5698d3ce9 "...: ffix: replace .sp by .PP"
Fixes: 6545cc56e02e "...: ffix"
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ip.7: Add "Special and reserved addresses" section

Break out the discussion of special and reserved IPv4 addresses into
a subsection, formatted as a pair of definition lists, and briefly
describing three cases in which Linux no longer treats addresses
specially, where other systems do or did.

Also add a specific example to the NOTES paragraph that discourages
the use of IP broadcasting, so people can more easily understand
what they are supposed to do instead.

Suggested-by: John Gilmore <gnu@toad.com>
Signed-off-by: Seth David Schoen <schoen@loyalty.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*.mk, INSTALL: build-src-c: Optimize pipeline

Calling man(1) is slow.  Since we only need to format the page, calling
mandoc(1) is faster and simpler (we could also use groff(1), but
mandoc(1) is probably faster and simpler than groff(1) too).  This
brings times down ~3x in my system.

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

src.mk: Optimize pipeline

This pipeline is run for every make(1) invokation, and it was very slow,
due to running a new sed(1) process for every manual page.  Remove the
while loop, and rewrite so that all the commands in the pipeline are
only run once.  This brings times down ~10x in my system, from 1.5 s, to
just 0.14 s.

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

resolv.conf.5: Add option no-aaaa

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

*.mk: Move makefiles from lib/ to share/mk/

According to the FHS, lib/ is for arch-dependent files, while share/ is
for arch-independent files.

While moving, create a more organized directory structure.

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

build.mk: srcfix

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

Makefile: help-variables: Make .PHONY

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

Makefile: tfix

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

*.mk: $Z: Support installing xz(1) compressed pages

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

*.mk: Add *FLAGS variables for compression commands

Also, document the LZIP variable.

Fixes: 69ad95988f40 ("*.mk: dist, dist-lz: Create tarballs compressed with lzip(1)")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*.mk: $Z: Support installing lzip(1) compressed pages

Suggested-by: Ralph Corderoy <ralph@inputplus.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*.mk: dist, dist-lz: Create tarballs compressed with lzip(1)

Suggested-by: Ralph Corderoy <ralph@inputplus.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

dist.mk, version.mk: Create reproducible tarballs

Anyone can create a tarball from a release tag, and it should be
identical to the release tarball, so that the PGP signature made at the
release matches.  This is useful for distributors.

Suggested-by: Marcos Fouces <marcos@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fts.3: SYNOPSIS: Fix nullability

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

fts.3: Note fts_open() behaviour with empty strings

This is undocumented in BSD, too, and present in the original SCCS
check-in (5.1 (Berkeley) 12/30/89).

This is very surprising, since in most other cases FTS is rather quite
sane about error reporting, but /any/ empty string in the input vector
blows out the creation entirely.

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

dist.mk: dist: Don't pollute stderr unnecessarily

When running 'make dist' from a tarball (so we don't have git), we'll
see tons of errors saying we're not in a git tree.  However, that's not
meaningful, because that command is a no-op in such a scenario: the
(date) placeholder is not there anymore to be replaced.  Let's hide the
errors, unless V=1.

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

dist.mk: dist-bz2: Use a timestamp newer than the .tar

Otherwise, make(1) goes crazy.

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

RELEASE, dist.mk: Use make(1)'s -B to force recreation of the dist files

Using FORCE unnecessarily restarts the entire build, even if we _know_
nothing changed.  That's boring.  Trust ourselves, and write the
commands in the RELEASE file as using '-B', to remind ourselves.
Forgetting to use -B will result in incorrect timestamps or versioning
in the distributed pages, so don't forget it ;).

While we're at it, let's also use -j4 directly, so I don't read the
paragraph reminding me to use -j _after_ I've already run it.  Let's
write -j4 instead of -j so that we don't crash some innocent's system.

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

bpf-helpers.7: Refresh page (Linux 6.2)

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

scanf.3: srcfix

That extra whitespace cuased issues to the Debian packaging tool that
autodetects the licenses from the SPDX header.

Cc: Marcos Fouces <marcos@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

CONTRIBUTING: Remove old links

I removed those pages from the website.

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

README: Reorganize, and add some info

-  Add "History" section, with a link to aeb's website with
   man-pages-1.* tarballs.
-  Move "Maintainers" to a subsection in the new "History" section.
-  Organize "Versions" into subsections ("Tarballs", "Git", and
   "Online pages").
-  Add links to the cgit websites of the git repositories.
-  Add link to the PDF online man-pages book.
-  wsfix in mtk's entry.

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

README: See also: Add 'Downstream packages', and 'Related projects'

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

CONTRIBUTING: Add Linux API mailing list

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

erofs.5: Minor tweaks to наб's patch

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

filesystems.5, erofs.5: add erofs documentation

Modelled after tmpfs(5) ‒ there's a listing of mount options, and a
summary of limitations.  The feature flags are described in mkfs.erofs,
and they're versioned and maintained upstream quite well there, so no
need to duplicate those, since you only care on image creation.

The real value add is the mount options, but I cannot figure out how
device_id and fsid interact with the system at large, so I just noted
they're there.

State as of Linux 6.3-rc5.

Also, remove explicit .TP indent in filesystems.5 since we're already
touching this hunk: all entries sans iso9660 and Reiserfs fall within
the default prevailing indent, so no need to specify a wide one.

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

dist.mk: dist, dist-bz2: Create tarballs compressed with bzip2(1)

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

Makefile: help-variables: Document $CP command variable

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

*.mk: $Z: Support installing bzip2 compressed pages

Gentoo currently installs pages compressed with this format.

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

install-man.mk: tfix

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

install-man.mk: Fix symlink installation

Some pages have not only an '.so ' line, but also comments; ignore the
comments.

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

ioctl_pipe.2: Add page

Cc: David Howells <dhowells@redhat.com>
Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ioctl_userfaultfd.2: Add UFFD_FEATURE_EXACT_ADDRESS

Describe the new UFFD_FEATURE_EXACT_ADDRESS API feature.

Signed-off-by: Nadav Amit <namit@vmware.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

personality.2: review, update for Linux 6.2

Settle on "no effect", concretify vaguely-described behaviours;
both [to be documented]s replaced with documentation
(these match my 6.2 checkout, if there were subtleties in the history
 they got lost).

Added the full system names to the PER_s that lacked them.

Didn't validate or chase down the versions except for PER_RISCOS.

Having these be sorted instead of in the original enumeration order is
really more trouble than it's worth.

Cf. the UAPI definition:
  /*
   * Personality types.
   *
   * These go in the low byte.  Avoid using the top bit, it will
   * conflict with error returns.
   */
  enum {
          PER_LINUX =             0x0000,
          PER_LINUX_32BIT =       0x0000 | ADDR_LIMIT_32BIT,
          PER_LINUX_FDPIC =       0x0000 | FDPIC_FUNCPTRS,
          PER_SVR4 =              0x0001 | STICKY_TIMEOUTS | MMAP_PAGE_ZERO,
          PER_SVR3 =              0x0002 | STICKY_TIMEOUTS | SHORT_INODE,
          PER_SCOSVR3 =           0x0003 | STICKY_TIMEOUTS |
                                           WHOLE_SECONDS | SHORT_INODE,
          PER_OSR5 =              0x0003 | STICKY_TIMEOUTS | WHOLE_SECONDS,
          PER_WYSEV386 =          0x0004 | STICKY_TIMEOUTS | SHORT_INODE,
          PER_ISCR4 =             0x0005 | STICKY_TIMEOUTS,
          PER_BSD =               0x0006,
          PER_SUNOS =             0x0006 | STICKY_TIMEOUTS,
          PER_XENIX =             0x0007 | STICKY_TIMEOUTS | SHORT_INODE,
          PER_LINUX32 =           0x0008,
          PER_LINUX32_3GB =       0x0008 | ADDR_LIMIT_3GB,
          PER_IRIX32 =            0x0009 | STICKY_TIMEOUTS,/* IRIX5 32-bit */
          PER_IRIXN32 =           0x000a | STICKY_TIMEOUTS,/* IRIX6 new 32-bit */
          PER_IRIX64 =            0x000b | STICKY_TIMEOUTS,/* IRIX6 64-bit */
          PER_RISCOS =            0x000c,
          PER_SOLARIS =           0x000d | STICKY_TIMEOUTS,
          PER_UW7 =               0x000e | STICKY_TIMEOUTS | MMAP_PAGE_ZERO,
          PER_OSF4 =              0x000f,                  /* OSF/1 v4 */
          PER_HPUX =              0x0010,
          PER_MASK =              0x00ff,
  };

PER_LINUX is a base personality, PER_LINUX_{32BIT,FDPIC} are
PER_LINUX|ADDR_LIMIT_32BIT and PER_LINUX|FDPIC_FUNCPTRS, resp.

PER_BSD is a base personality, PER_SUNOS is PER_BSD|STICKY_TIMEOUTS.

PER_LINUX32 is a base personality, PER_LINUX32_3GB is
PER_LINUX32|ADDR_LIMIT_3GB.

I updated these all to be "Same as {base personality},
but implies {...}.". PER_SCOSVR3 has an "also", since it's the only one
where the base case PER_OSR5 has a list.

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

rtnetlink.7: Document IFLA_PERM_ADDRESS

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

stat.3type: tfix

Signed-off-by: Daniel Verkamp <daniel@drv.nu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

mlock.2: wfix

Signed-off-by: Avinesh Kumar <akumar@suse.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc.5: note effective removal of /proc/execdomains in v4.1

The file was turned into a fixed string in upstream commit
973f911f55a0e510dd6db8bbb29cd82ff138d3c0 ("Remove execution domain
support"); the entire mechanism was fully removed in a patchset by
Weinberger ending at commit 720d70716d137c0cb83b9a5279c384286c02a1c0
("sparc: Fix execution domain removal").

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

malloc_usable_size.3: The returned value should not be trusted

It might very well return a value larger than the actual usable size, so
writing to the excess bytes is Undefined Behavior.  There's absolutely
no promise about the value, except that it is no less than the size
that was once passed to malloc(3).

Link: <https://github.com/systemd/systemd/issues/22801#issuecomment-1343041481>
Link: <https://inbox.sourceware.org/libc-alpha/20221124213258.305192-1-siddhesh@gotplt.org/T/>
Reported-by: Mingye Wang <arthur200126@gmail.com>
Reported-by: Siddhesh Poyarekar <siddhesh@gotplt.org>
Cc: DJ Delorie <dj@redhat.com>
Cc: Sam James <sam@gentoo.org>
Cc: Florian Weimer <fweimer@redhat.com>
Cc: Andreas Schwab <schwab@linux-m68k.org>
Cc: Zack Weinberg <zack@owlfolio.org>
Cc: Wilco Dijkstra <Wilco.Dijkstra@arm.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

bash_aliases: Optimize man_section()

mandoc(1) renders pages much faster than groff(1), which is itself much
faster than using man(1).  This might seem irrelevant for a single page,
but this function is called in a loop in man_lsfunc() and man_lsvar(),
where this brings times down considerably.  For comparison,
`time man_lsfunc man*` took around 55 s (on my system) before this
change.  With groff(1), it would take around 14 s, and with mandoc(1)
(this patch), it takes 4 s.

Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Gavin Smith <gavinsmith0123@gmail.com>
Cc: Dirk Gouders <dirk@gouders.net>
Cc: Colin Watson <cjwatson@debian.org>
Cc: Eli Zaretskii <eliz@gnu.org>
Cc: Larry McVoy <lm@mcvoy.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

removexattr.2: srcfix

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

feature_test_macros.7: Document Clang fortify support

This commit lists both gcc and clang versions. It also happens to fix
the "glibc 4.0" mistake in b324e17d3208c940622ab192609b836928d5aa8d.

Fixes: b324e17d3208 ("Many pages: wfix")
Signed-off-by: Mingye Wang <arthur200126@gmail.com>
Acked-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man*/: srcfix

Reported-by: mandoc(1) (`make lint-man-mandoc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>

cmd.mk, dist.mk: Keep file modes in the tarball

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>

Changes: 6.04 documented also LANDLOCK_ACCESS_FS_TRUNCATE

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

lsm: Released 6.04

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

Changes: Ready for 6.04

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

difftime.3: Don't suggest redefining a reserved identifier

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

getopt.3: Remove const from argv

It is unnecessary to let readers believe it's const.  Keep it as a
detail in VERSIONS, which will only be found by those who need it.  It
is better to believe it's non-const, and rarely will one need to know
that it isn't true.

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

man2/: Remove repetitive documentation of [s]size_t

We already have an entire page for the types.

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

man2/, sockaddr.3type: Move text to sockaddr.3type

Move text about socklen_t to its own page, and remove repetitive
references to read accept(2) (except from the type page itself).

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

epoll_ctl.2: ffix

Reported-by: `make check-catman`
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man*/: ffix

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

scripts/LinuxManBook/: Make the title consistent with the name of the project

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

*.mk: Simplify build tree

Reuse $_MANDIR (.tmp/man/) for most stuff we build (with the exception
of `make dist`).

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

verbose.mk: Fix warning from GNU Make 4.4

While '$(V).SILENT:' is a common idiom in make, it may be more explicit
to put '.SILENT:' inside a conditional.  Since we already used the
conditional for something else, it's not a big change.  As a nice side
effect, vim now recognizes it and highlights it as a special target.

With the old code, GNU Make 4.4 reported a warning about undefined
variables:

lib/verbose.mk:18: warning: undefined variable 'V'

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

landlock.7: Fix warnings

Reported-by: `make lint check`
Signed-off-by: Alejandro Colomar <alx@kernel.org>