lint-man.mk: Force groff(1) to use 80 columns

Cc: Ralph Corderoy <ralph@inputplus.co.uk>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

pthread_setname_np.3: Rename 'len' to 'size'

The parameter doesn't represent a string length (strlen(3)), but a
buffer size (sizeof()).  Use a more proper name.

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

confstr.3: Rename 'len' to 'size'

The parameter doesn't represent a string length (strlen(3)), but a
buffer size (sizeof()).  Use a more proper name.

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

Various pages: Fit rendered pages in 80 columns

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

wcswidth.3, wcwidth.3, veth.4: Fix accidents in .TH

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

lint-man.mk: Check that rendered pages don't go past 80 column

Until groff(1) or mandoc(1) add such a warning, this is good
enough.

Link: <https://lists.gnu.org/archive/html/groff/2022-08/msg00197.html>
Link: <https://stackoverflow.com/a/24005600/6872717>
Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Dave Kemper <saint.snit@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

CONTRIBUTING: Add more information about the mailing list

Put the 'Mailing list' section the first one, since it's the most
important, and rewrite it to be more informative (so we don't need
to redirect to the website for everything).  Also reorganize a
little bit around that change.

Reported-by: Jakub Wilk <jwilk@jwilk.net>
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Revert "Many pages: Document fixed-width types with ISO C naming"

This reverts commit 2294974b3a1341e457edb682c08c5f4b2d14675e.

Reported-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Many pages: Document fixed-width types with ISO C naming

Kernel __u64 and similar types are ABI-compatible, and mostly
API-compatible with ISO C types.  User-space programmers don't
care about kernel details, and should only use libc types.
Document syscalls and structures provided by the Linux kernel as
if they used libc types.

There's work in the kernel to remove this small API
incompatibility, which is only for pointers or printf specifiers.

Since I couldn't find any structure that uses pointers, there
shouldn't be any issues here.  Also, the only pointer I found was
in a syscall parameter, but since syscall(2) doesn't check its
arguments' types, we're also safe there.

This patch doesn't go without controversy.  Check the discussions
in the links below.

Found with:

$ grep -rn '\b_*[su][8136][624]*\b' man* \
  | grep -v -e /bpf-helpers.7 -e /proc.5 -e /epoll_event.3type -e /wcscmp.3 \
            -e /crypt.3 -e /mempcpy.3 -e /memcmp.3 -e /string.3 -e /wcsncmp.3 \
            -e /wcscasecmp.3 -e /wmemcmp.3 -e /strcasecmp.3 -e /bcmp.3 \
            -e /bstring.3 -e /endian.3 -e /strverscmp.3 -e /wcsncasecmp.3 \
            -e /strcoll.3 -e /strcmp.3 \
  | tee /dev/tty \
  | wc -l;

Link: <https://lore.kernel.org/linux-man/20210423230609.13519-1-alx.manpages@gmail.com/T/>
Link: <https://lore.kernel.org/lkml/YZvIlz7J6vOEY+Xu@yuki/T/>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Nacked-by: Alexei Starovoitov <ast@kernel.org>
Nacked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Nacked-by: Daniel Borkmann <daniel@iogearbox.net>
Acked-by: Zack Weinberg <zackw@panix.com>
Cc: LKML <linux-kernel@vger.kernel.org>
Cc: glibc <libc-alpha@sourceware.org>
Cc: GCC <gcc-patches@gcc.gnu.org>
Cc: bpf <bpf@vger.kernel.org>
Cc: LTP List <ltp@lists.linux.it>
Cc: Linux API <linux-api@vger.kernel.org>
Cc: linux-arch <linux-arch@vger.kernel.org>
Cc: David Laight <David.Laight@ACULAB.COM>
Cc: Joseph Myers <joseph@codesourcery.com>
Cc: Florian Weimer <fweimer@redhat.com>
Cc: Daniel Borkmann <daniel@iogearbox.net>
Cc: Cyril Hrubis <chrubis@suse.cz>
Cc: David Howells <dhowells@redhat.com>
Cc: Arnd Bergmann <arnd@arndb.de>
Cc: Florian Weimer <fweimer@redhat.com>
Cc: Rich Felker <dalias@libc.org>
Cc: Adhemerval Zanella <adhemerval.zanella@linaro.org>

print_encoding.sh: Remove unused script

It considers every page as utf-8, so it doesn't provide any useful
information.

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

check_unbalanced_macros.sh: This script's functionality is already covered by 'make lint-man'

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

_Generic.3: EXAMPLES: Use a constant expression

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

append_COLOPHON.sh, remove_COLOPHON.sh: Remove COLOPHON section.

Users should use their distribution's standard tools to know where
a given page comes from and to know how to report a bug.  That'll
create a small barrier to bug reporters, but that'll hopefully
help improve the quality of the reports.

It'll also make the pages cleaner, by removing stuff that is
obvious to those who know how to use their tools.

We still keep part of the information of the COLOPHON,
specifically the project name and the version, in the .TH line.

Reported-by: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

utime.2, utimensat.2: explicitly mention ctime changing.

utime and related calls always change the ctime.  It is worth making
this explicit.
This is clear from the code (vfs_utimes() in fs/utimes.c always sets
ATTR_CTIME) and is documented in
  <https://pubs.opengroup.org/onlinepubs/007904875/functions/utimes.html>

Signed-off-by: NeilBrown <neilb@suse.de>
Reviewed-by: Jeff Layton <jlayton@kernel.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

_Generic.3: intmax_t can't be int

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

man-pages.7: Document recent changes to .TH

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Jakub Wilk <jwilk@jwilk.net>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Ingo Schwarze <schwarze@openbsd.de>
Cc: Michael Kerrisk <mtk.manpages@gmail.com>

All pages: Remove the 5th argument to .TH

Now that we have the LIBRARY section, and a 4th argument that
already tells that it's a page from the Linux man-pages project,
the 5th argument isn't telling any information that the default
value wouldn't.  So let's just remove it.

Scripted change:

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

Acked-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Ingo Schwarze <schwarze@openbsd.de>
Cc: Michael Kerrisk <mtk.manpages@gmail.com>

dist.mk, version.mk: dist: Add version to .TH

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

All pages: Replace the 4th argument to .TH by "Linux man-pages (unreleased)"

On 8/20/22 13:57, Alejandro Colomar wrote:
> On 8/20/22 07:43, G. Branden Robinson wrote:
>>
>> In my opinion it would benefit readers of the Linux man-pages if the
>> fourth argument to `TH` were what it is in many other man pages: an
>> identifier for the name and version number of the release originating
>> them.  In every page it would be clear what version of the man-pages was
>> being viewed.  Little sophistication would be demanded of the user to
>> check the Web to determine the relative age of the pages, independently
>> of the modification date of the particular page.  Such usage would be
>> congruent with the argument's purpose in AT&T and BSD Unix, where this
>> datum was "7th Edition", "System III", or "4.2 Berkeley Distribution",
>> or similar.
>
> I thought about it in the past...  That field was the only thing that
> said where a function came from.  If we removed GNU (or something else),
> how would someone know where does the function or whatever comes from??
>
> I guess that's also why the colophon was appended to the pages by
> Michael.  Since we couldn't use the 4th field for that, we had to have a
> COLOPHON section.
>
> However, the addition of the LIBRARY section seems to fix this issue,
> and so now we have an even more precise way to determine where a given
> function comes from (including the library file name, and the linker
> option).
>
> This gives me another argument for those who don't like to have a
> LIBRARY section for libc stuff (since -lc is unnecessary), and consider
> it noise.
>
>>
>> Further, as the libc-related man pages in this project expand coverage
>> to other libcs than GNU's, the alternatives to the empty string
>> proferred in man-pages(7) seem less and less appropriate.
>
> Agree.  LIBRARY seems much more appropriate for that purpose.
>
> And this helps remove the COLOPHON section (or at least, we don't need
> to autogenerate it, since the version number now comes in .TH, and the
> COLOPHON is static; so I can even move it to a smaller REPORTING BUGS
> section).

Scripted change:

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

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

$ git restore man5/tzfile.5
$ git restore man8/zdump.8
$ git restore man8/zic.8
$ git restore man7/bpf-helpers.7

Link: <https://lore.kernel.org/linux-man/20220819180323.dbsgxh5qvcjabjm6@jwilk.net/T/#u>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Reported-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Ingo Schwarze <schwarze@openbsd.de>
Cc: Michael Kerrisk <mtk.manpages@gmail.com>

_Generic.3: New page documenting _Generic()

Also add a hint of how intmax(3) and other functions using
[u]intmax_t types could be better defined by ISO C, by requiring
that they're implemented as type-generic macros, to avoid having
problems with the ABI.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: JeanHeyd Meneide <wg14@soasis.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Ingo Schwarze <schwarze@openbsd.de>

build.mk: clean: Show some output

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

fanotify_init.2: srcfix

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

fanotify_init.2: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

build-src.mk: Fix appending -Wstrict-prototypes

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

tcp.7: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

fanotify.7: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

tm.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

timespec.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

itimerspec.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

dev_t.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

clockid_t.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

memfd_secret.2: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

landlock_restrict_self.2: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

clang-tidy/config.yaml: Ignore a useless warning

-readability-identifier-length

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

spufs.7: tfix

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

spufs.7: wfix + ffix

Reported-by: Ingo Schwartze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getaddrinfo_a.3: actually gnu.cz => gnu.org

Fixes: a2feb3e14f51a0e74daeb6f0217887ca31799967 ("getaddrinfo_a.3:
 gnu.cz => gnu.org")
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

futex.2, futex.7: {ftp://ftp => https://mirrors}.kernel.org

The former doesn't exist; the latter is the new location with seemingly
compatible data

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getaddrinfo_a.3: {ftp.us => mirrors}.kernel.org, likewise for IP

Make the address consistent between 128.30.2.36
(some address in MIT space) and 139.178.88.99 (valid, current)

ftp.us.kernel.org EAI_NONAMEs: turn it into mirrors.kernel.org,
because the new text uses 139.178.88.99 which is mirrors.kernel.org

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

mount.2: tfix

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

cgroups.7: Document memory_recursiveprot mount option

Signed-off-by: Brett Holman <bholman.devel@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

proc.5: Document idle state in /proc/pid/stat

Signed-off-by: Brett Holman <bholman.devel@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

poll.2: tfix

Fixes: 0bdda5d08e82 ("poll.2: Note that poll() equivalent code for ppoll() is not quite equivalent")
Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getaddrinfo_a.3: gnu.cz => gnu.org

gnu.cz exists at a different address (but is unreachable there),
and the address we had is an unassigned coolhousing one

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getline.3: wfix.

Clarify in the RETURN VALUE section that it's necessary to free the
buffer, since at least one person missed this up at the start of the
DESCRIPTION.

Signed-off-by: Elliott Hughes <enh@google.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getline.3: srcfix.

Signed-off-by: Elliott Hughes <enh@google.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

nsswitch.conf.5: Mention subid database

shadow-utils use nsswitch.conf for configuring delegation of
subordinate uids/gids.

See also subuid(5) and subgid(5).

Link: https://github.com/shadow-maint/shadow/blob/3ec32f9975f262073f8fbdecd2bfaee4a1d3db48/lib/nss.c
Signed-off-by: Nikola Forró <nforro@redhat.com>
[alx: ffix]
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

lirc.4: document lirc changes in the kernel

Linux 5.17 makes LIRC_SET_REC_TIMEOUT_REPORTS an no-op and 5.18
introduces LIRC_OVERFLOW. Also some rewording to clarify.

Signed-off-by: Sean Young <sean@mess.org>
[alx: ffix]
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

random.4: tfix

Reported-by: Eric Biggers <ebiggers@kernel.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

random.4: Update description about O_NONBLOCK flag

The O_NONBLOCK flag has been ignored since Linux 5.6 and this patch
states this change in man page.

The commit that introduced this change in the Linux kernel is
30c08efec888 ("random: make /dev/random be almost like /dev/urandom")

Signed-off-by: GUO Zihua <guozihua@huawei.com>
Reviewed-by: Petr Vorel <pvorel@suse.cz>
Cc: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

spufs.7: ffix

Use tbl(1) instead of a magic sequence of spaces and tabs to get a
nice formatting.  This fixes the following warnings:

mandoc: man7/spufs.7:748:7: WARNING: tab in filled text
mandoc: man7/spufs.7:748:14: WARNING: tab in filled text
mandoc: man7/spufs.7:748:22: WARNING: tab in filled text
mandoc: man7/spufs.7:748:32: WARNING: tab in filled text
mandoc: man7/spufs.7:748:34: WARNING: tab in filled text

Reported-by: 'make lint-man'
Reported-by: mandoc(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

iovec.3type, regex_t.3type: srcfix

mandoc: man3type/iovec.3type:19:14: STYLE: unterminated quoted argument
mandoc: man3type/regex_t.3type:23:28: STYLE: unterminated quoted argument
mandoc: man3type/regex_t.3type:25:28: STYLE: unterminated quoted argument

Reported-by: 'make lint-man'
Reported-by: mandoc(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

argz_add.3: srcfix

mandoc: man3/argz_add.3:20:77: STYLE: unterminated quoted argument

Reported-by: 'make lint-man'
Reported-by: mandoc(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

fanotify_init.2, mount_setattr.2: ffix

mandoc: man2/fanotify_init.2:332:2: WARNING: skipping paragraph macro: PP empty
mandoc: man2/mount_setattr.2:677:2: WARNING: skipping paragraph macro: PP empty

Reported-by: 'make lint-man'
Reported-by: mandoc(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getgrent_r.3, psignal.3: ffix

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

ioctl_userfaultfd.2, fanotify.7: ffix

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

man-pages.7: ffix

Use tables to represent tables.
Use .EX/.EE to represent a code example.
Use \& to prevent .SS of being interpreted as man(7) source.

an.tmac:man7/man-pages.7:900: style: 5 leading space(s) on input line
an.tmac:man7/man-pages.7:901: style: 5 leading space(s) on input line
an.tmac:man7/man-pages.7:902: style: 5 leading space(s) on input line
an.tmac:man7/man-pages.7:903: style: 5 leading space(s) on input line
an.tmac:man7/man-pages.7:965: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:966: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:967: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:968: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:969: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:970: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:978: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:979: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:980: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:981: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:982: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:983: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:984: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:985: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:986: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:987: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:988: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:989: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:990: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:991: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:992: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:993: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:994: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:995: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:996: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:997: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:1003: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:1004: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:1005: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:1006: style: 4 leading space(s) on input line
an.tmac:man7/man-pages.7:1137: style: 4 leading space(s) on input line

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

proc.5: ffix

an.tmac:man5/proc.5:2010: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2011: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2012: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2013: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2014: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2015: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2016: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2017: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2018: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2019: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2020: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2021: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2022: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2023: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2024: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2025: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2026: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2027: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2028: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2029: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2030: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2031: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2032: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2033: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2034: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2035: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2036: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2037: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2038: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2039: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2040: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:2041: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3332: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3333: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3334: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3335: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3336: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3337: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3338: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3339: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3340: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3341: style: 5 leading space(s) on input line
an.tmac:man5/proc.5:3342: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3343: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3344: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3345: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3346: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3347: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3348: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3349: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3350: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3351: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3352: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3353: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3354: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3355: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3357: style: 4 leading space(s) on input line
an.tmac:man5/proc.5:3359: style: 4 leading space(s) on input line

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

st.4: ffix

an.tmac:man4/st.4:715: style: use of deprecated macro: .HP
an.tmac:man4/st.4:721: style: use of deprecated macro: .HP
an.tmac:man4/st.4:727: style: use of deprecated macro: .HP
an.tmac:man4/st.4:730: style: use of deprecated macro: .HP
an.tmac:man4/st.4:736: style: use of deprecated macro: .HP
an.tmac:man4/st.4:739: style: use of deprecated macro: .HP
an.tmac:man4/st.4:744: style: use of deprecated macro: .HP
an.tmac:man4/st.4:749: style: use of deprecated macro: .HP
an.tmac:man4/st.4:753: style: use of deprecated macro: .HP
an.tmac:man4/st.4:756: style: use of deprecated macro: .HP
an.tmac:man4/st.4:764: style: use of deprecated macro: .HP

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

console_codes.4: ffix

Reformat .HP paragraphs with .TP and .TQ.

an.tmac:man4/console_codes.4:89: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:91: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:94: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:97: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:101: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:103: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:105: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:107: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:109: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:111: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:113: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:604: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:606: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:608: style: use of deprecated macro: .HP
an.tmac:man4/console_codes.4:610: style: use of deprecated macro: .HP

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

cciss.4: ffix

an.tmac:man4/cciss.4:100: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:101: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:102: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:103: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:104: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:105: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:106: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:107: style: 4 leading space(s) on input line
an.tmac:man4/cciss.4:281: style: 4 leading space(s) on input line

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

__setfpucw.3: ffix

an.tmac:man3/__setfpucw.3:58: style: 5 leading space(s) on input line
an.tmac:man3/__setfpucw.3:59: style: 5 leading space(s) on input line
an.tmac:man3/__setfpucw.3:60: style: 5 leading space(s) on input line

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

__setfpucw.3: pfix

\- is unnecessary here.  As a list enumerator, any character is
good.  Simplify.

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

membarrier.2: ffix

Format the table using tbl(1), to fix the following warnings.

an.tmac:man2/membarrier.2:222: style: 23 leading space(s) on input line
an.tmac:man2/membarrier.2:223: style: 7 leading space(s) on input line
an.tmac:man2/membarrier.2:224: style: 7 leading space(s) on input line
an.tmac:man2/membarrier.2:225: style: 7 leading space(s) on input line

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getrlimit.2: srcfix

an.tmac:man2/getrlimit.2:246: style: 4 leading space(s) on input line

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getrlimit.2: Use MIN(3)

min() doesn't exist, but MIN(3) exists.  Use it.

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

chown.2: srcfix

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

timer_settime.2, timerfd_create.2, itimerspec.3type: Document itimerspec in a new page

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

ioctl_ns.2: EXAMPLES: Add missing include

Instead of redefining stuff, add the necessary header.

Reported-by: 'make lint-c'
Reported-by: iwyu(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

byteorder.3: STANDARDS: Simplify

No current systems require the inclusion of <netinet/in.h>
anymore.  POSIX.1-2001 has been around for more than 20 years, so
let's simplify.

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

bind.2, process_vm_readv.2: EXAMPLES: Add necessary includes and ftm(7)

Reported-by: 'make lint-c'
Reported-by: clang(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

.checkpatch.conf, CPPLINT.cfg: Ignore some warnings from 'make lint-c'

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

Various pages: EXAMPLES: tfix

Use escape sequences that produce the correct output, suitable for
copy&paste into real C programs.

Reported-by: 'make lint-c'
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

xattr.7: wfix

(My original intention was to just fix the grammar ("an attribute names
is"), but, on second thought, the whole sentence didn't read very well.)

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

poll.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

sigaction.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

syslog.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

mremap.2: wfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getrlimit.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Makefile: Disable builtin rules and variables

We don't use them at all, so by disabling them, the debug output
of make(1) will be smaller.

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

Makefile, src.mk, *.mk: Move some definitions to a helper Makefile

To be able to explicitly include the file with the definitions,
wherever it is needed.

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

Makefile, cmd.mk, *.mk: Allow using different names for basic commands

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

dist.mk: Create tarballs with a top-level directory

Need to use a trick with sed(1) to avoid tar(1) modifying the
symlinks.

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

README: man0 is not used anymore

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

sa_family_t.3type, sockaddr.3type: Document sa_family_t

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

sockaddr.3type, timer_t.3type, void.3type: wfix

Replace "shall" wordings by simpler text, to not resemble a
standards document.

When saying something like "According to POSIX/ISO C, ...", if
the mentioned standard is the same one described in STANDARDS,
remove that text (it is redundant).  However, if ISO C is the
main standard that describes a type, but POSIX applies further
restrictions, keep that text.

Remove pedantic notes that may only be interesting to compiler
writers.

Reported-by: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

ptrdiff_t.3type, size_t.3type, time_t.3type, va_list.3type, void.3type: ffix

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

Various pages: wfix

Replace "shall" wordings by simpler text, to not resemble a
standards document.

When saying something like "According to POSIX/ISO C, ...", if
the mentioned standard is the same one described in STANDARDS,
remove that text (it is redundant).  However, if ISO C is the
main standard that describes a type, but POSIX applies further
restrictions, keep that text.

Remove pedantic notes that may only be interesting to compiler
writers.

Reported-by: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

sysexits.h.3head: Add LIBRARY section

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

Makefile, install-man.mk: Support man3head, and remove support for man0

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

sysexits.h.3head: Move header page to a new man3head section

Use man3head, as other Unix systems already use.
As Ingo said, man0 is not the right place for header files.

Also, this patch does some changes to the page itself:

Expand the SYNOPSIS to have together all of the values.  Also, add
a small comment about the constant (taken from the header file).

Link: <https://lore.kernel.org/linux-man/11110a04-f96b-0d32-53e3-adcce618c543@gmail.com/>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getrlimit.2: RLIMIT_NPROC also ignored for ruid 0

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

Many pages: Use STANDARDS instead of CONFORMING TO

STANDARDS seems to be much more extended than CONFORMING TO.  For
consistency across the whole manual pages corpus, let's try to
unify, by following the most commonly used section name.

On 7/27/22 12:49, Ingo Schwarze wrote:
> Alejandro Colomar wrote on Tue, Jul 26, 2022 at 02:02:56PM +0200:
> > We use CONFORMING TO in Linux.  Don't know why; just history, I guess.
> > See man-pages(7).
>
> Weird.
>
> I failed to find a single instance of "CONFORMING TO" in AT&T UNIX
> (including v6, PWB, v7, 32v, v8, v10, System III, SVR1, SVR2) nor in
> any version of UCB CSRG BSD.  So considering that System V and BSD are
> widely considered the two main original branches of the development
> of Unix-like operating systems and Linux is often considered to have
> drawn inspiration from both, the section name "CONFORMING TO" does
> not appear to be a UNIX thing.  For example, Aeleen Frisch, "Essential
> System Administration", O'Reilly, Cambridge 1995, considers Linux
> as slightly more influenced by 4.3BSD than by System V Release 3.
>
> STANDARDS, on the other hand, is present since 4.3BSD-Reno (June 1990).
>
> 4.3BSD-Reno predates the first version of the Linux kernel by more than
> a year, and the first Linux manual pages probably for longer than that.
>
> So i have no idea where "CONFORMING TO" may have come from.

Scripted change:

$ find man* -type f | xargs sed -i 's/CONFORMING TO/STANDARDS/'

plus a few manual fixes to the following files:

- man2/getrlimit.2
- man3/syslog.3
- scripts/bash_aliases

Reported-by: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getsid.2: deduplicate getsid(0) case

The first sentence in
  getsid(0) returns the session ID of the calling process.
  getsid() returns the session ID of the process with process ID pid.
  If pid is 0, getsid() returns the session ID of the calling process.
blames to beginning of git, duplicates the third one,
and doesn't stylistically match current formatting

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

man-pages.7: Document CAVEATS section

CAVEATS is an interesting section.  There's a slight difference
between CAVEATS and BUGS.  We usually have a hard time fitting
what would go into CAVEATS into other sections (usually BUGS and
NOTES); it would be easier if we had the section.  Let's add it.

This section has been used in manual pages by authors from a wide
range of projects including AT&T, Korn shell, Perl, GNU and BSD
since the early 1980s.  Using the section was first officially
recommended in 2002 by the file </usr/share/misc/mdoc.template> in
NetBSD and OpenBSD.

Reported-by: Ingo Schwarze <schwarze@usta.de>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

strsignal.3: fix str(d)abbrev typo

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

man-pages.7: The linker flag is not always necessary

See for example pages for types

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

man-pages.7: Document LIBRARY section

Reported-by: "Theodore Ts'o" <tytso@mit.edu>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

size_t.3type: tfix

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

regex_t.3type, regmatch_t.3type, regoff_t.3type, system_data_types.7: Move regex_t, regmatch_t, and regoff_t to a separate page

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