man/man3/strcmp.3: CAVEATS: Add section

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

man/man3/streq.3: Describe in terms of memeq(3)

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

man/man3/strndup.3: Don't describe in terms of strdup(3)

Rather, use wording similar to strncat(3).

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

man/man3/strndup[a].3: Rename parameter

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

man/man3head/memory.h.3head: Add stpncpy(3)

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

man/man3/st[rp]ncpy.3: Split strncpy(3) from stpncpy(3)

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

man/man3/wmempcpy.3: Document equivalence

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

man/man3/mempcpy.3: Document in terms of memcpy(3)

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

man/man3/[w]mempcpy.3: Split wmempcpy(3) from mempcpy(3)

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

man/man3/memmove.3: Document in terms of memcpy(3)

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

man/man3head/memory.h.3head: Document memset_explicit(3)

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

man/man3/memset_explicit.3: Add page

It's not implemented, but it's standard.  Having this page helps point
out that memset(3) suffers from issues, and that the solution involves
this function.

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

man/man3/memset.3: CAVEATS: Add section

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

man/man3/memset.3: Rename function parameter

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

man/man3/explicit_bzero.3: Rename section NOTES => CAVEATS

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

man/man3/bzero.3: CAVEATS: Add section

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

man/man3/bzero.3: wfix

bzero(3) doesn't erase; it just writes zeros.  For erasing,
explicit_bzero(3) is the right function.

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

man/man3/index.3: Reduce text

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

man/man3/b*.3: NAME: Explain the names

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

man/man3/index.3: NAME: Sync with strchr(3)

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

man/man3/explicit_bzero.3: HISTORY: wsfix

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

man/man3/*bzero.3: Split explicit_bzero(3) from bzero(3)

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

man/man3/bzero.3: SYNOPSIS: See memory.h(3head)

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

man/man3head/memory.h.3head: Add explicit_bzero(3)

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

man/man3/strnlen.3: wfix

Clarify that if strn is a string, the containing array need not have
n characters.

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

man/man3/strdupa.3: CAVEATS: Add section

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

man/man3/strnlen.3: Rewrite to not talk about strings

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

man/man3/strlen.3: NOTES: Remove section

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

man/man3/str[n]dup.3: ERRORS: Refer to malloc(3)

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

man/man3/streq.3: Add another equivalent expression

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

man/man3/stpcpy.3: Add another equivalent expression

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

man/man3/st*.3: SEE ALSO: Reduce references

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

man/man3/bstring.3: Link to memory.h(3head)

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

man/man3/: SEE ALSO: Reduce references

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

man/: Document memory.h(3head) for memeq(3)

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

man/man3/strncasecmp.3: SYNOPSIS: tfix

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

man/man3/str[n]casecmp.3: Split strncasecmp(3) from strcasecmp(3)

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

man/man3/{str,mem}cmp.3: Move VERSIONS from strcmp(3) to memcmp(3)

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

man/man3/str[n]cmp.3: Split strncmp(3) from strcmp(3)

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

man/man3/strndupa.3: tfix

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

man/man3/str[n]dupa.3: Split strndupa(3) from strdupa(3)

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

man/man3/str[n]dup.3: Split strndup(3) from strdup(3)

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

man/man5/elf.5: Fix description of e_flags

Processor-specific e_flags are defined by the ABI supplements of many
architectures (e.g., EF_RISCV_RVC, EF_ARM_EABI_VER5), and glibc's
<elf.h> currently defines over 150 EF_* constants.  Replace the
incorrect statement with one that does not depend on the current set
of defined flags.

Signed-off-by: Ryota Saito <saito.ryota.23@shizuoka.ac.jp>
Message-ID: <20260803130543.590173-1-saito.ryota.23@shizuoka.ac.jp>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

README: See also: Add link to musl libc

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

README: See also: Add link to Bionic libc

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

README: wsfix

Use tabs.

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

man/man3head/memory.h.3head: wfix

Remove superfluous world.

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

man/man3head/memory.h.3head: STANDARDS: wfix

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

man/man3head/memory.h.3head: STANDARDS: wfix

strncat(3), for example, necessarily operates on a string in $1.
For that reason, 'always' is a bit more appropriate than 'necessarily'.

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

man/man3head/memory.h.3head: STANDARDS: Neutralize the tone

Reported-by: DJ Delorie <dj@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/: SYNOPSIS: Reduce comment about <memory.h>

A simple reference to see memory.h(3head) should be enough.

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

man/man3/: SYNOPSIS: Move all <memory.h> to comments

For consistency.

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

man/man3/: Put first <string.h> in SYNOPSIS, then comment about <memory.h>

This is a compromise between the fact that <string.h> is the standard
header and (only slightly) most portable header file for these
functions, while hinting at the fact that it might be more appropriate
to use <memory.h> where possible.

Remove the STANDARDS and NOTES about this, since now the SYNOPSIS
contains all the necessary information.  The extra info is in
memory.h(3head), which is linked to in the SYNOPSIS.

In non-standard functions, as an exception, use the inverse order: first
put <memory.h>, and then comment about <string.h>.

Cc: Joseph Myers <josmyers@redhat.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Keith Bostic <keith@bostic.com>
Cc: Sam James <sam@gentoo.org>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: "Serge E. Hallyn" <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: "Evgeny Grin (Karlson2k)" <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3head/memory.h.3head: HISTORY: Add details about SVID1 and XPG3

Reported-by: Joseph Myers <josmyers@redhat.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Keith Bostic <keith@bostic.com>
Cc: Sam James <sam@gentoo.org>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: "Serge E. Hallyn" <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: "Evgeny Grin (Karlson2k)" <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/ttyslot.3: SYNOPSIS: Update comment referring to NOTES => HISTORY

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

man/man3head/memory.h.3head: VERSIONS: Illumos doesn't provide all the functions in <memory.h>

Microsoft's CRT is similar.

All the modern BSDs and glibc,musl,Bionic have a generous <memory.h>.

Link: <https://github.com/illumos/illumos-gate/blob/master/usr/src/head/memory.h>
Reported-by: Mark Harris <mark.hsj@gmail.com>
Message-ID: <CAMdZqKGRJuR_Jyt7TapMQFQ-6wz=OF5DROFhXkZLQNAn2vyimQ@mail.gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3head/memory.h.3head: HISTORY: Both Bionic and Illumos provide <memory.h>

Illumos's header doesn't provide all these functions, though.  I'll
document that in a separate commit.

Mark also claims that Microsoft's CRT provides <memory.h>i, similar to
Illumos (so, mem*() functions only).

Link: <https://github.com/illumos/illumos-gate/blob/master/usr/src/head/memory.h>
Reported-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Message-ID: <20260803160902.5edjmpxaqr5uudbu@illithid>
Reported-by: Mark Harris <mark.hsj@gmail.com>
Message-ID: <CAMdZqKGRJuR_Jyt7TapMQFQ-6wz=OF5DROFhXkZLQNAn2vyimQ@mail.gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/stpncpy.3: EXAMPLES: Remove 'SRC' BEGIN/END comments

This example is incomplete, and won't build.

Fixes: 10f9e349c888 (2026-08-03; "man/man3/stpncpy.3: EXAMPLES: Use a more realistic example")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/stpncpy.3: EXAMPLES: Use a more realistic example

Cc: Keith Bostic <keith@bostic.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Sam James <sam@gentoo.org>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/stpncpy.3: CAVEATS: Remove unreal recommendation

This is not a use case that happens enough to recomment anything.
If one encounters such a use case, they're probably deep enough
that they know what to do.  Casual users should keep it simple.

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

man/man3/memccpy.3: CAVEATS: Document that this function is not appropriate for strings

Cc: Keith Bostic <keith@bostic.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Sam James <sam@gentoo.org>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/strncat.3: CAVEATS: Clarify that this function doesn't truncate the input nonstring

Cc: Keith Bostic <keith@bostic.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Sam James <sam@gentoo.org>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Remove references to 'Shlemiel the painter'

Compilers are able to optimize this out.

Programmers should aim for simplicity, and leave this optimization to
the compiler.

Cc: Keith Bostic <keith@bostic.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Sam James <sam@gentoo.org>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/standards.7: Specify SVr1 for System V release 1

Cc: Keith Bostic <keith@bostic.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Sam James <sam@gentoo.org>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3head/memory.h.3: STANDARDS, HISTORY: Document some history about <string.h> and <memory.h>

This text is an adaptation of text suggested by Keith and Branden.

Suggested-by: Keith Bostic <keith@bostic.com>
Suggested-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Sam James <sam@gentoo.org>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man*/{string.3,memory.h.3head}: Move functions to a new page memory.h(3head)

See previous commit.

Cc: Keith Bostic <keith@bostic.com>
Cc: Sam James <sam@gentoo.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/: SYNOPSIS: Document {mem,strn}*() functions as provided by <memory.h>

They've been provided there since forever, and that's a more appropriate
header.

The standard mixes functions for handling strings, functions for
handling bytes, and other hybrids, all in a single header file:
<string.h>.

This has historically caused confusion, for example leading to believe
that strncpy(3) is appropriate to handle strings.

It turns out that mem*() functions haven't been always in <string.h>.
These functions were first introduced in 1983 in System V, and were
added in a separate <memory.h> file.  Very soon, they were added to
4.3BSD in 1986 for compatibility to System V, also in <memory.h>.

Most modern-day POSIX-compatible libc implementations still provide this
header file for backwards compatibility reasons:

$ find ~/src/bsd/freebsd/main/ | grep /include/memory.h
/home/alx/src/bsd/freebsd/main/include/memory.h
$ find ~/src/bsd/netbsd/trunk/ | grep /include/memory.h
/home/alx/src/bsd/netbsd/trunk/include/memory.h
$ find ~/src/bsd/openbsd/master/ | grep /include/memory.h
/home/alx/src/bsd/openbsd/master/include/memory.h
$ find ~/src/gnu/glibc/master/ | grep /include/memory.h
/home/alx/src/gnu/glibc/master/include/memory.h
$ find ~/src/musl/libc/master/ | grep /include/memory.h
/home/alx/src/musl/libc/master/include/memory.h

It seems that it was C89 that moved the mem*() functions to <string.h>,
even though the Rationale document for C89 doesn't mention it at all.

This was a huge mistake --we can see the consequences in the many
misuses of these functions, and programmers that believe they are
appropriate for uses for which they are unappropriate-- that we try
to undo now.

Let's document these as provided by <memory.h>, which is still true;
all POSIX-ish libc implementations I've consulted provide the <memory.h>
header with mem*() functions, except two: Illumos gate, and gnulib.
Let's ignore them, or rather, hope they will follow suit eventually.

This will signal to programmers that this is the header file they should
be using.  The C Committee is discussing the possibility of
standardizing the good old <memory.h> header file, so let's give it a
little bump.

Let's also move the strn*() functions there, since modern libc
implementations also provide them there.  And they certainly don't
belong in <string.h>, so <memory.h> is more adequate.

After this change, <string.h> is documented only in the SYNOPSIS of
functions that exclusively handle (and require) strings.

Link: <https://lore.kernel.org/linux-man/am0RdPxvbIYUKAL-@devuan/T/#t>
Cc: Keith Bostic <keith@bostic.com>
Cc: Sam James <sam@gentoo.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: Nevin Liber <nevin@cplusplusguy.com>
Cc: Collin Funk <collin.funk1@gmail.com>
Cc: JeanHeyd Meneide <phdofthehouse@gmail.com>
Cc: Christopher Bazley <chris.bazley.wg14@gmail.com>
Cc: Bruno Haible <bruno@clisp.org>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Cc: Serge Hallyn <serge@hallyn.com>
Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Evgeny Grin <k2k@drgrin.dev>
Cc: Kees Cook <keescook@chromium.org>
Cc: Steve Summit <scs@eskimo.com>
Cc: "Maciej W. Rozycki" <macro@orcam.me.uk>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: bug-gnulib@gnu.org
Cc: libc-alpha@sourceware.org
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man8/ldconfig.8: Add tunables options

Message-ID: <d85795998b72ab686a683f13d08f24d98d8c1a51.1785522144.git.dj@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man8/ld.so.8: Note that ld.so.cache includes tunables

Message-ID: <bcaddcd0fb8f60276973ae28f091c158332e20c6.1785522144.git.dj@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/ld.so.conf.5: Document 'include' syntax

Message-ID: <ae9c2cc67047902f68f64d05ca454da0e6d008b3.1785522144.git.dj@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man4/console_codes.4: Document more xterm codes

Signed-off-by: Jan Engelhardt <jengelh@inai.de>
Message-ID: <20260718153631.55879-1-jengelh@inai.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/[b]string.3: Rewrite and merge

Let's have a single page with an organized list of functions.

Cc: "Serge E. Hallyn" <serge@hallyn.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/mem*.3: NAME: Explain the names

Reported-by: "Serge E. Hallyn" <serge@hallyn.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Acked-by: Serge Hallyn <sergeh@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/strpbrk.3: BUGS: Clarify the NAME

Cc: Mark Harris <mark.hsj@gmail.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Acked-by: Serge Hallyn <sergeh@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/str*.3: NAME: Explain the names

Reported-by: "Serge E. Hallyn" <serge@hallyn.com>
Cc: Mark Harris <mark.hsj@gmail.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man4/console_codes.4: Mention caveats for xterm(1)'s ESC ] 50 command

Fonts are only settable if xterm(1) was launched with the right options
(or X11 resources) that would allow this operation.

Signed-off-by: Jan Engelhardt <jengelh@inai.de>
Message-ID: <20260710221035.26529-1-jengelh@inai.de>
[alx: wfix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/landlock.7: wfix

Use the current wording of the equivalent paragraph in
"linux.git/Documentation/userspace-api/landlock.rst".

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

man/man2/memfd_secret.2: tfix

Fixes: ac5edfeb1dd6 (2021-08-27; "memfd_secret.2: New page describing memfd_secret() system call")
Cc: Mike Rapoport <rppt@linux.ibm.com>
Signed-off-by: Štěpán Němec <stepnem@smrk.net>
Message-ID: <20260713121111.372487-1-stepnem@smrk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/proc_pid_fdinfo.5: Document that 'ino' and 'mnt_id' are decimal numbers

Signed-off-by: Maja Kądziołka <maya@compilercrim.es>
Cc: Kalesh Singh <kaleshsingh@google.com>
Message-ID: <7eeaa92f7a7cc14024a6474d4cc117e875185f6d.1784211190.git.maya@compilercrim.es>
[alx: split commit]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/proc_pid_fdinfo.5: Document the 'ino' field

Also expands the tabs into spaces where relevant, in order to ensure
proper alignment between the fields when rendered by man.

Signed-off-by: Maja Kądziołka <maya@compilercrim.es>
Cc: Kalesh Singh <kaleshsingh@google.com>
Message-ID: <7eeaa92f7a7cc14024a6474d4cc117e875185f6d.1784211190.git.maya@compilercrim.es>
[alx: split commit]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man?/intro.[01]: Split part of intro(1) into a new intro(0)

Let's keep intro(1) for introducing just the man1 section, and move the
more general introduction of the entire manual to a new intro(0).

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

man0: Add symlink

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

man/man8/ld.so.8: ffix

Fixes: cce97466d5ed (2023-10-18; "ld.so.8: Describe the --list-diagnostics loader option")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: srcfix

Add missing closing EE for EX.

Reported-by: DJ Delorie <dj@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man9/strscpy.9: NAME: Clarify both etymology and actual semantics

The function is called strscpy() with an 's' for 'safe', but it
should actually be called strtcpy() with a 't' for 'truncation'.

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

man/man3/strlcat.3: Add link page

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

man/man3/strlcpy.3: Add page

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

man9: Add symlink

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

man/man9/strscpy.9: Add page

This function is well-known, and while it isn't available in
user space, it's good to have documentation for it, so that
users that want to talk about it can refer to this manual page.

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

man/man8/ld*.8: Refer to ld.so.conf(5)

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

man/man5/ld.so.conf.5: Add page

Cc: DJ Delorie <dj@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/pipe.7: Note kernel commit of the soft limit triggered cap increase

7543e84442d7 did reference the kernel commit in its commit
message, but the convention to include it in the man page
source as well is helpful to wider audience.

Fixes: 7543e84442d7 (2024-08-29; "pipe.7: Document change to default pipe size when soft limit is exceeded")
Signed-off-by: Štěpán Němec <stepnem@smrk.net>
Message-ID: <20260709153422.210312-2-stepnem@smrk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man4/console_codes.4: Rephrase description for xterm's ESC ] 10 command

The term "dynamic" text color is too unspecific.
Since xterm has more codes for tuning colors, all colors
could be considered "dynamic".

Signed-off-by: Jan Engelhardt <jengelh@inai.de>
Message-ID: <20260708121458.46465-2-jengelh@inai.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man4/console_codes.4: Rephrase description for xterm's ESC ] 4 command

The \e]4 code is capable of modifying xterm's entire 256-slot palette,
not just the ANSI sub-portion thereof.

Signed-off-by: Jan Engelhardt <jengelh@inai.de>
Message-ID: <20260708121458.46465-1-jengelh@inai.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man4/console_codes.4: wsfix

The space character is used as a visual aid in the escape code
sequences.  A few lines had spacing inconsistent with the rest of the
document, so make them consistent.

Signed-off-by: Jan Engelhardt <jengelh@inai.de>
Message-ID: <20260708104303.39708-1-jengelh@inai.de>
[alx: tweak commit message]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: check-catman-grep: Ignore diagnostics in landlock.7

An example is too long, and we can't make it shorter without reducing
readability.

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

man/man7/landlock.7: Document LANDLOCK_ACCESS_FS_RESOLVE_UNIX (ABI v9)

Document the new LANDLOCK_ACCESS_FS_RESOLVE_UNIX filesystem access right,
which controls lookups of pathname UNIX domain sockets.  Restricts both
connect(2) and sendmsg(2) with an explicit recipient address to UNIX
sockets created outside the Landlock domain (same semantics as
LANDLOCK_SCOPE_* flags).  Denied attempts return EACCES.

Available since Linux 7.1 (Landlock ABI version 9).

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

man/: Make sashimi of termios(3)

Suggested-by: "H. Peter Anvin" <hpa@zytor.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Update old termios(3) references

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

man/man?/termios.?: Move termios(3) to man7

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