strsep.3: STANDARDS: It's available in the BSDs (as it originated there)

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

landlock_add_rule.2: ERRORS: Document missing reason for EINVAL

This documents a missing reason for why EINVAL might be returned.
The documented behavior exists since the first version of Landlock.

Reviewed-by: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Günther Noack <gnoack@google.com>
Message-ID: <20240719133801.3541732-5-gnoack@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

landlock_create_ruleset.2: Update docs for landlock_ruleset_attr

This updates the documentation for struct landlock_ruleset_attr
in line with the changed kernel documentation (see link below).

Link: <https://lore.kernel.org/all/20240711165456.2148590-2-gnoack@google.com/>
Reviewed-by: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Günther Noack <gnoack@google.com>
Message-ID: <20240719133801.3541732-4-gnoack@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

landlock.7, landlock_*.2: wfix

* Various wording fixes
* List the same error code multiple times,
  if it can happen for multiple reasons.

Reviewed-by: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Günther Noack <gnoack@google.com>
Message-ID: <20240719133801.3541732-3-gnoack@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fanotify_init.2: Support for FA_* flags has been backported to LTS kernels

Cc: <linux-fsdevel@vger.kernel.org>
Signed-off-by: Chuck Lever <chuck.lever@oracle.com>
Message-ID: <20240713181548.38002-3-cel@kernel.org>
Reviewed-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fanotify.7: Document changes backported to LTS kernels

Cc: <linux-fsdevel@vger.kernel.org>
Signed-off-by: Chuck Lever <chuck.lever@oracle.com>
Message-ID: <20240713181548.38002-4-cel@kernel.org>
Reviewed-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fanotify_mark.2: Support for FA_* flags has been backported to LTS kernels

Cc: <linux-fsdevel@vger.kernel.org>
Reviewed-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Chuck Lever <chuck.lever@oracle.com>
Message-ID: <20240713181548.38002-2-cel@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

listmount.2: Add page

Cc: Christian Brauner <brauner@kernel.org>
Cc: Miklos Szeredi <mszeredi@redhat.com>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <kernel-team@fb.com>
Signed-off-by: Josef Bacik <josef@toxicpanda.com>
Message-ID: <2d72a44fa49f47bd7258d7efb931926b26de4004.1720549824.git.josef@toxicpanda.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: Skip expected warnings

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

prctl.2: Add PR_RISCV_SET_ICACHE_FLUSH_CTX

Document the PR_RISCV_SET_ICACHE_FLUSH_CTX flag for prctl(2) that is
supported as of Linux 6.10.

Cc: Alexandre Ghiti <alexghiti@rivosinc.com>
Signed-off-by: Charlie Jenkins <charlie@rivosinc.com>
Message-ID: <20240709-fencei_prctl-v5-1-a0391069f746@rivosinc.com>
[alx: ffix + consistent line breaks]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: Silence spurious warnings

Those write(2) calls are unimportant, and we don't want to check errors.

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

shm_open.3: EXAMPLES: Add missing error handling

Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>

getutent.3: EXAMPLES: Add missing error handling

Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>

pipe.2: EXAMPLES: Add missing error handling

Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>

perf_event_open.2: EXAMPLES: Add missing error handling

GCC now enables -Wunused-result by default.

Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: Silence spurious warnings

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

share/mk/: Reduce the work of 'make && make install'

Distros expect 'make' to build only what they need.  While we want to
build more stuff upstream, for various reasons (mainly, for extra
diagnostics), packagers only want what they'll use, and don't want to
waste CPU time with that.

Also, distros expect 'make install' to only install what they'll use,
which is just the manual pages.

For that, repurpose the build and install targets to do precisely that,
and add build-all and install-all targets that do all that can be done.

Reported-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Cherry-picked-from: liba2i.git 791f163b1a72 (2024-07-18, "share/mk/: Reduce the work of 'make && make install'")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: CPPFLAGS: Only define _FORTIFY_SOURCE if it's not already defined

Some distros patch GCC to have that definition built in.  Redefining it
ourselves would result in a redefinition, and consequently a diagnostic.

Reported-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Cherry-picked-from: liba2i.git 31bfd8f14a11 (2024-07-17, "share/mk/: CPPFLAGS: Only define _FORTIFY_SOURCE if it's not already defined")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/, share/tests/: Refactor *FLAGS and LDLIBS variables

Standard behavior is that setting these variables should append, not
overwrite.

Add variables to allow overwriting, with a trailing '_'.

While at it, put CPPFLAGS after CFLAGS consistently (previously, there
was a mix).

Link: <https://lists.gnu.org/archive/html/help-make/2024-07/msg00001.html>
Reported-by: Sam James <sam@gentoo.org>
Reported-by: Đoàn Trần Công Danh <congdanhqx@gmail.com>
Suggested-by: Sébastien Hinderer <Sebastien.Hinderer@inria.fr>
Suggested-by: Paul Smith <psmith@gnu.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Cherry-picked-from: liba2i.git 5613b2846104 (2024-07-16, "share/mk/, share/tests/: Refactor *FLAGS and LDLIBS variables")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: CPPFLAGS: -D_FORTIFY_SOURCE=2

Signed-off-by: Alejandro Colomar <alx@kernel.org>
Cherry-picked-from: liba2i.git 828dd1d21b30 (2024-07-15, "share/mk/: CPPFLAGS: -D_FORTIFY_SOURCE=2")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: Cosmetic

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

landlock_*.2: Mention -1 return code on failure

Mention -1 return code on failure for landlock_add_rule(2),
landlock_create_ruleset(2) and landlock_restrict_self(2).

Although it's a common rule to return -1 on error, it's better to be
explicit (as the other man pages are).

Fixes: a01d04a69 ("landlock_add_rule.2: Document new syscall")
Fixes: ca5163697 ("landlock_create_ruleset.2: Document new syscall")
Fixes: 3f7e4f808 ("landlock_restrict_self.2: Document new syscall")
Reviewed-by: Günther Noack <gnoack@google.com>
Cc: Mickaël Salaün <mic@linux.microsoft.com>
Cc: Mickaël Salaün <mic@digikod.net>
Cc: <linux-security-module@vger.kernel.org>
Signed-off-by: Petr Vorel <pvorel@suse.cz>
Message-ID: <20240712172246.151258-2-pvorel@suse.cz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: RETURN VALUE: Unify error wording

Follow the pattern to replace "to indicate the cause of the error"
with "to indicate the error".

Suggested-by: Alejandro Colomar <alx@kernel.org>
Acked-by: Günther Noack <gnoack@google.com>
Cc: Mickaël Salaün <mic@linux.microsoft.com>
Cc: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Petr Vorel <pvorel@suse.cz>
Message-ID: <20240712172246.151258-1-pvorel@suse.cz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fnmatch.3: Update FNM_CASEFOLD availability, FNM_IGNORECASE alias

Every system I looked at already had FNM_CASEFOLD,
so calling it "GNU" is misleading at best;
Solaris (and the illumos gate) call it FNM_IGNORECASE
but also provide FNM_CASEFOLD as an alias.

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

utime.2: ERRORS: Add EFAULT

Signed-off-by: Ma Xinjian <maxj.fnst@fujitsu.com>
Message-ID: <20240710081926.10913-1-maxj.fnst@fujitsu.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

sigaction.2: setitimer(2)/alarm(2) timers yield si_code=SI_TIMER too

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

statmount.2: Add page

Cc: Christian Brauner <brauner@kernel.org>
Cc: Miklos Szeredi <mszeredi@redhat.com>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <kernel-team@fb.com>
Signed-off-by: Josef Bacik <josef@toxicpanda.com>
Message-ID: <5b4a8408a21970d0ee4bea5cee4c74cb39851c0d.1720549824.git.josef@toxicpanda.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

printf.3: the overall syntax is "%argnum$...", not "%$..."

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

FIONREAD.2const: tfix

Fix a copy-paste error in SYNOPSIS:
FIONREAD was mentioned twice,
but another IOCTL was missing.

Fixes: c6267fb68309 ("ioctl_tty.2, FIONREAD.2const, TIOC{IN,OUT}Q.2const, TCFLSH.2const, TIOCSERGETLSR.2const: Split from ioctl_tty(2)")
Signed-off-by: Günther Noack <gnoack@google.com>
Message-ID: <20240705142844.1142998-1-gnoack@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

clone.2: ffix

Signed-off-by: Ma Xinjian <maxj.fnst@fujitsu.com>
Message-ID: <20240704064108.27257-1-maxj.fnst@fujitsu.com>
[alx: Remove comment]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

__riscv_flush_icache.3, riscv_flush_icache.2: Add page (and link page)

riscv_flush_icache() has been present in syscall.2, but had no page for
itself.  Add the page for this syscall.

The syscall is named riscv_flush_icache(), but the glibc function is
named __riscv_flush_icache().  To handle this, name the syscall page
riscv_flush_icache.2 and point to the libc page __riscv_flush_icache.3.

Signed-off-by: Charlie Jenkins <charlie@rivosinc.com>
Message-ID: <20240701-flush_icache-v2-1-15f7a35a0d13@rivosinc.com>
[alx: ffix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

perf_event_open.2: Document combining inherit and cpus = -1 preventing the use of mmap

After calling perf_event_open() with cpus == -1 and the inherit bit,
using mmap on the perf file descriptor to create a ring-buffer fails
with EINVAL.  This behavior wasn't previously documented in the man
page and is caused by the following lines in the perf_mmap function in
<kernel/events/core.c>:
/*
 * Don't allow mmap() of inherited per-task counters. This would
 * create a performance issue due to all children writing to the
 * same rb.
 */
if (event->cpu == -1 && event->attr.inherit)
        return -EINVAL;

Signed-off-by: Mikołaj Kołek <kolek.mikolaj@gmail.com>
Message-ID: <CAHGiy6-nx0PwBi6xwoG8PN5qND-krGh_rvpfmVc31-QSv04C6g@mail.gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fmod.3: EXAMPLES: Fix calculation

Fixes: ce23e8188f8f ("fmod.3: Add example section")
Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=219017>
Reported-by: Benjamin Otte <otte@gnome.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

printf.3: Rework '

As it stands, this is worse than useless
(defined as: I had to test it explicitly against strfmon() and look at
             POSIX myself to make sure the manual wasn't lying to me
 https://101010.pl/@nabijaczleweli/112694726416515899):

No-one cares if some compiler doesn't understand something from 1994.
(Careful readers will note it's been 30 years.)

"SUSv2 doesn't have this, SUSv3 does" is reefer-induced:
this figures in SUSv1 (XPG Issue 4 Version 2)
and the CHANGE HISTORY clearly notes ' was added in i4, not i4v2.

It's important that these aren't actually grouped by the thousand,
but, instead, by "what the locale says".

Each locale has two groupings: monetary and non-monetary,
and it's paramount to indicate which is which
(hi_IN  is 3,2... monetary and 3... non-monetary;
 mjw_IN is 3,2... both).

It waxes poetic for way too long about "how to set a locale".

Also replace "The Single UNIX Specification adds" with "POSIX adds".
The SUS is, on a good day, a profile of POSIX you pay 300$ for.
Maybe you could swing this back when it was an "extension"
(so, only required in the SUS profile)
but it's just shaded CX ("this is intentionally different from C")
in Issue 8.  It's really irrelevant here.

Also add this to HISTORY
(and call it something sane there;
 the Proper nomenclature is absolutely meaningless to normal people).
The most important bit for every HISTORY reader is the 1994 date.

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

wcscasecmp.3, wcsncasecmp.3: Merge

This mirrors str[n]casecmp and is much more useful,
but more importantly these didn't crosslink at all.

The RETURN VALUE section is now copied from strncasecmp.3.

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

proc_sysrq-trigger.5: ffix

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

statx.2: Document STATX_SUBVOL

Document the new statx.stx_subvol field.

This would be clearer if we had a proper API for walking subvolumes that
we could refer to, but that's still coming.

Link: https://lore.kernel.org/linux-fsdevel/20240308022914.196982-1-kent.overstreet@linux.dev/
Signed-off-by: Kent Overstreet <kent.overstreet@linux.dev>
[jpg: mention supported FSes and formatting improvements]
Signed-off-by: John Garry <john.g.garry@oracle.com>
Cc: Eric Biggers <ebiggers@kernel.org>
Cc: <linux-fsdevel@vger.kernel.org>
Message-ID: <20240620130017.2686511-1-john.g.garry@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: ffix (Use TQ where appropriate)

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

man2/: ffix

Put the subsection title in the .SS line.

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

statx.2: Document STATX_MNT_ID_UNIQUE

Linux 6.8 added STATX_MNT_ID_UNIQUE support.

Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=98d2b43081972>
Signed-off-by: Josef Bacik <josef@toxicpanda.com>
Cc: Christian Brauner <brauner@kernel.org>
Cc: Miklos Szeredi <mszeredi@redhat.com>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <kernel-team@fb.com>
Message-ID: <a45b2623a25357f33978b49963dad5f99b984386.1719341580.git.josef@toxicpanda.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

string_copying.7: wfix

Fixes: b17819960602 ("string_copying.7: wfix")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

string_copying.7: wfix

Say 'length-bounded' instead of 'known-lenght'.  Eric Blake used that
term in an email, and I think it's more clear than the old one.

Link: <https://lore.kernel.org/linux-man/lpqjinqeylacuismlzsnnhy7hiuv7so6dlcccnclzmmjknnlux@asvvn6j4qrl2/T/>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Revert "keyrings.7: ffix"

This reverts commit fa2ca6f2e080a16eebd528defef9deaea6145477.

The groff(1) bug that required that workaround has been fixed.

Link: <https://savannah.gnu.org/bugs/?65894>
Link: <https://lists.gnu.org/archive/html/groff/2024-06/msg00036.html>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ioperm.2: Fix wrong section reference

The man page says:

> Permissions are inherited by the child created by fork (2)
> (but see NOTES).

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the relevant information is in HISTORY.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240618173524.1797697-1-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

wait.2: Fix wrong section reference

The man page says:

> This is the glibc and POSIX interface; see
> NOTES for information on the raw system call.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-17-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

uname.2: Fix wrong section reference

The man page says:

> The length of the arrays in a struct utsname is unspecified (see NOTES);

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS and
HISTORY.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-16-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

semctl.2: Fix wrong section reference

The man page says:

> GETPID
>  Return the sempid value for the semnum-th semaphore of
> the set. This is the PID of the process that last
>  performed an operation on that semaphore (but see NOTES).

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-15-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

readdir.2: Fix wrong section reference

The man page says:

> There is no definition of struct old_linux_dirent; see NOTES.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-14-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

open.2: Fix wrong section reference

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about O_SYNC and O_DSYNC
is now under VERSIONS / Synchronized I/O.

While at it, fix the typesetting.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-13-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

nice.2: Fix wrong section reference

The man page says:

> On success, the new nice value is returned (but see NOTES below).

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-12-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

mmap.2: Fix wrong section reference

The man page says:

> See NOTES for information on feature test macro requirements.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-11-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

mkdir.2: Fix wrong section reference

The man page says:

> Whether other mode bits are honored for the created directory depends
> on the operating system. For Linux, see VERSIONS below.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about permission
inheritance is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-10-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

kill.2: Fix wrong section reference

The man page says:

> (Historically, the rules were different; see NOTES.)

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the historical rules moved to HISTORY.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-9-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

gettimeofday.2: Fix wrong section reference

The man page says:

> The use of the timezone structure is obsolete; the tz argument should
> normally be specified as NULL. (See NOTES below.)

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-7-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

getpriority.2: Move info from NOTES to HISTORY

In the spirit of commit 4131356cd ("man*/, man-pages.7: VERSIONS,
STANDARDS, HISTORY: Reorganize sections"), move the historical
information about EPERM error from NOTES to HISTORY, and fix the
section reference accordingly.

Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-6-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

gethostname.2: Fix section reference

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-5-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

execve.2: Fix wrong section reference

The man page says:

> For portable use, optional-arg should either be absent, or be
> specified as a single word (i.e., it should not contain white
> space); see NOTES below.

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about optional-arg is in
VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-4-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

clone.2: Fix wrong section reference

The man page says:

> For the prototype of the raw clone() system call, see NOTES

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this prototype is in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-3-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

cacheflush.2: Fix section reference

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-2-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes.old: Document some renamed pages from man-pages-6.9

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>

lsm: Released 6.9.1

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

Changes: Ready for 6.9.1

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

rlim_t.3type, rlimit.3type: Add link pages

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

signal.7: Fix wrong mention of sigprocmask

The handler is registered with sigaction(2), not sigprocmask(2).  Even
if the purpose of writing sigprocmask(2) here was to mention blocked
signals, the statement currently concerns the "addition" of blocked
signals; signals blocked through sigprocmask(2) would already be present
in the thread context of blocked signals.

Fixes: e7a5700f2313 (getcontext.3, signal.7: tfix)
Signed-off-by: Dev Jain <dev.jain@arm.com>
Reviewed-by: Mark Brown <broonie@kernel.org>
Cc: Ingo Molnar <mingo@kernel.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Ryan Roberts <ryan.roberts@arm.com>
Cc: Suzuki Poulouse <suzuki.poulose@arm.com>
Cc: Anshuman Khandual <anshuman.khandual@arm.com>
Cc: <DeepakKumar.Mishra@arm.com>
Cc: Aneesh Kumar K.V <aneesh.kumar@kernel.org>
Cc: <linux-kernel@vger.kernel.org>
Message-ID: <20240611090823.820724-3-dev.jain@arm.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

signal.7: Clearly describe ucontext kernel dump to user space

The set of blocked signals is updated from struct sigaction after the
kernel dumps ucontext. Mention this to avoid misunderstanding.

Signed-off-by: Dev Jain <dev.jain@arm.com>
Cc: Ingo Molnar <mingo@kernel.org>
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Mark Rutland <mark.rutland@arm.com>
Cc: Ryan Roberts <ryan.roberts@arm.com>
Cc: Mark Brown <broonie@kernel.org>
Cc: Suzuki Poulouse <suzuki.poulose@arm.com>
Cc: Anshuman Khandual <anshuman.khandual@arm.com>
Cc: <DeepakKumar.Mishra@arm.com>
Cc: Aneesh Kumar K.V <aneesh.kumar@kernel.org>
Cc: <linux-kernel@vger.kernel.org>
Message-ID: <20240611090823.820724-2-dev.jain@arm.com>
[alx: semantic newlines; ffix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

intro.1: wfix

Message-ID: <20240616233931.53760-1-jeremy@baxters.nz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/, share/mk/: Fix nested EX/EE within nf/fi

EX/EE can't be nested within nf/ni.  The mandoc(1) reports weren't
spurious.

Re-enable the mandoc(1) warnings, and fix the code.

Fixes: 31203a0c8dbf ("share/mk/: Globally disable two spurious mandoc(1) warnings")
Link: <https://lists.gnu.org/archive/html/groff/2024-06/msg00019.html>
Reported-by: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

setjmp.3: Fix section references

Commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections") results in a few problems with setjmp(3):

 1. "Feature Test Macro Requirements for glibc" refers to NOTES, while
    those macros are now described in HISTORY.

 2. The discussion about saving signal mask is now split between HISTORY
    and NOTES.

Fix the references accordingly.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616201946.1663626-1-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

readdir.3: Fix wrong section references

There are references to NOTES section, but since the commit 4131356cd
("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize
sections") the relevant information is in VERSIONS.

While at it, unify the "see XXX" style.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616201323.1662948-1-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

keyrings.7: ffix

This workarounds a groff -Thtml bug.

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

keyrings.7: ffix

-  Move description of files to FILES section.
-  Use linux.git/... for Linux documentation files in SEE ALSO.
-  Remove old names of Linux documentation files.

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

strtod.3, strtol.3, strtoul.3: SYNOPSIS: Document _Nullable parameters

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

man/, share/mk/: srcfix, and remove corresponding XFAIL exceptions

And remove them from XFAIL, since they don't fail anymore.

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

share/mk/: Globally disable two spurious mandoc(1) warnings

And remove the XFAIL exceptions that were triggering these warnings.

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

strtod.3, strtol.3, strtoul.3: VERSIONS, CAVEATS: Reorganize sections

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

strtod.3: Fix wrong section reference

Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections"), the discussion about n-char-sequence refers to
NOTES, while the relevant information is now in VERSIONS.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-12-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

strtok.3: SYNOPSIS: Document _Nullable parameters

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

strtok.3: Fix section reference

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-11-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

stailq.3: Fix section reference

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-10-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

sigpause.3: Fix section reference

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Currently, the relevant information is kind of split between VERSIONS
and HISTORY, but VERSIONS is somewhat more relevant.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-9-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

getrlimit.2: SYNOPSIS: Add struct rlimit and rlim_t

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

getdtablesize.3: Fix section reference

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-6-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ceil.3, floor.3, rint.3, round.3: POSIX.1-2008 doesn't define errors

Cc: Kir Kolyshkin <kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ceil.3, rint.3, round.3: mv NOTES section to HISTORY

Commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections") removed the NOTES section from floor(3), moving
the explanation of overflow errors to HISTORY.

The very same explanation is also there in ceil(3), rint(3), and
round(3). Let's move it to HISTORY as well, for uniformity.

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-5-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

posix_fallocate.3: Fix section references

There are references to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-3-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

exec.3: Fix section reference

There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").

Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-2-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

CONTRIBUTING.d/patches: Specify the git repository when mentioning commits

It might be linux.git, glibc.git, or some other, so let's clarify.

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

CONTRIBUTING.d/patches: wfix

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

CONTRIBUTING.d/patches: Clarify that [PATCH v1] is also valid

And actually, preferable.  Thus, use it in all examples.

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

CONTRIBUTING.d/patches: Say [PATCH] instead of [patch]

Patches are usually generated by git-format-patch(1), which says
[PATCH], not [patch].  To avoid confusion, use the same form here.

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

CONTRIBUTING.d/mail: Remove broken links

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

man/: ffix

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

man/: srcfix: Use \[rs] instead of \e

Scripted change:

$ find man -type f \
| xargs grep -l '\\e' \
| xargs sed -i 's/\\e/\\[rs]/g';

Link: <https://lore.kernel.org/linux-man/20240611122453.qn6jyl4go4bvwkqm@illithid/>
Suggested-by: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: lint-man-so: Skip man.7

We purposefully point to groff_man(7), which is not in this project.

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

share/mk/: lint-man-so: Check that .so link pages point to an existing file

Cc: Adam Sampson <ats@offog.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: lint-man: Merge linting of man(7) and mdoc(7) pages

This simplifies some code, and is also in preparation for the following
commit, which will add more linting operations on both types of manual
pages.

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

share/mk/: $CUT: Add dependency on cut(1)

We'll need it for checking the .so link pages.

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

FICLONERANGE.2const: Update .so for renamed file

Fixes: 733e3228017b ("ioctl.2, ioctl_ficlone*.2, FICLONE{,RANGE}.2const: Move page to FICLONE.2const")
Signed-off-by: Adam Sampson <ats@offog.org>
Message-ID: <20240615132948.20625-1-ats@offog.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes.old: Fix some mistakes

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