]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
2 years agotermios.3: mention the integer types in SEE ALSO
наб [Mon, 29 Aug 2022 21:46:50 +0000 (23:46 +0200)] 
termios.3: mention the integer types in SEE ALSO

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agocc_t.3type, speed_t.3type, tcflag_t.3type: document all together
наб [Mon, 29 Aug 2022 22:33:52 +0000 (00:33 +0200)] 
cc_t.3type, speed_t.3type, tcflag_t.3type: document all together

speed_t and tcflag_t were both unmentioned in general

Issue 7 has this to say:
  The <termios.h> header shall define the following data types through typedef:
    cc_t     Used for terminal special characters.
    speed_t  Used for terminal baud rates.
    tcflag_t Used for terminal modes.
  The above types shall be all unsigned integer types.

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Redirect groff output to stderr
Alejandro Colomar [Sun, 28 Aug 2022 11:30:42 +0000 (13:30 +0200)] 
lint-man.mk: Redirect groff output to stderr

groff(1) is being used to warn.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agocmd.mk, lint-man.mk: Use MANWIDTH instead of a hardcoded 80
Alejandro Colomar [Sun, 28 Aug 2022 11:18:54 +0000 (13:18 +0200)] 
cmd.mk, lint-man.mk: Use MANWIDTH instead of a hardcoded 80

Also need another variable set to MANWIDTH - 2, since troff needs
room for two extra characters for some reason.

Cc: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Use ascii instead of utf8
Alejandro Colomar [Sun, 28 Aug 2022 10:56:49 +0000 (12:56 +0200)] 
lint-man.mk: Use ascii instead of utf8

This is relevant for tables, which will now use ASCIIart, instead
of pretty multi-byte characters which interfere with the
calculation of the line width.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Use grep through its command variable
Alejandro Colomar [Sun, 28 Aug 2022 10:55:05 +0000 (12:55 +0200)] 
lint-man.mk: Use grep through its command variable

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Remove highlighting in a more robust way
Alejandro Colomar [Sun, 28 Aug 2022 10:53:11 +0000 (12:53 +0200)] 
lint-man.mk: Remove highlighting in a more robust way

'grotty -c | col -bx' is more reliable, and far more readable.

Suggested-by: Ralph Corderoy <ralph@inputplus.co.uk>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Specify the output device through a variable
Alejandro Colomar [Sun, 28 Aug 2022 10:34:25 +0000 (12:34 +0200)] 
lint-man.mk: Specify the output device through a variable

Suggested-by: Ralph Corderoy <ralph@inputplus.co.uk>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Use a pipeline instead of the groff(1) wrapper
Alejandro Colomar [Sat, 27 Aug 2022 18:55:41 +0000 (20:55 +0200)] 
lint-man.mk: Use a pipeline instead of the groff(1) wrapper

This more explicitly shows how stuff really works, and allows
inspecting some intermediate steps in case it may be necessary.

Cc: Ralph Corderoy <ralph@inputplus.co.uk>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: <groff@gnu.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Use UTF-8 output
Alejandro Colomar [Sat, 27 Aug 2022 19:07:18 +0000 (21:07 +0200)] 
lint-man.mk: Use UTF-8 output

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agoman7/regex.7: change "\o'o\(ha'"to a real character "\(^o" (o circumflex)
Bjarni Ingi Gislason [Fri, 26 Aug 2022 22:11:51 +0000 (22:11 +0000)] 
man7/regex.7: change "\o'o\(ha'"to a real character "\(^o" (o circumflex)

  Use real accented characters instead of producing them by overstriking
the letter with the diacritic mark.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@vortex.is>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Force groff(1) to use 80 columns
Alejandro Colomar [Fri, 26 Aug 2022 19:23:35 +0000 (21:23 +0200)] 
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>
2 years agopthread_setname_np.3: Rename 'len' to 'size'
Alejandro Colomar [Thu, 25 Aug 2022 22:04:12 +0000 (00:04 +0200)] 
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>
2 years agoconfstr.3: Rename 'len' to 'size'
Alejandro Colomar [Thu, 25 Aug 2022 20:15:17 +0000 (22:15 +0200)] 
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>
2 years agoVarious pages: Fit rendered pages in 80 columns
Alejandro Colomar [Thu, 25 Aug 2022 19:55:00 +0000 (21:55 +0200)] 
Various pages: Fit rendered pages in 80 columns

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agowcswidth.3, wcwidth.3, veth.4: Fix accidents in .TH
Alejandro Colomar [Thu, 25 Aug 2022 19:53:24 +0000 (21:53 +0200)] 
wcswidth.3, wcwidth.3, veth.4: Fix accidents in .TH

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolint-man.mk: Check that rendered pages don't go past 80 column
Alejandro Colomar [Thu, 25 Aug 2022 19:38:18 +0000 (21:38 +0200)] 
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>
2 years agoCONTRIBUTING: Add more information about the mailing list
Alejandro Colomar [Thu, 25 Aug 2022 11:11:45 +0000 (13:11 +0200)] 
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>
2 years agoRevert "Many pages: Document fixed-width types with ISO C naming"
Alejandro Colomar [Thu, 25 Aug 2022 07:39:55 +0000 (09:39 +0200)] 
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>
2 years agoMany pages: Document fixed-width types with ISO C naming man-pages-6.0-rc1
Alejandro Colomar [Sun, 21 Aug 2022 22:49:53 +0000 (00:49 +0200)] 
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>
2 years agoprint_encoding.sh: Remove unused script
Alejandro Colomar [Wed, 24 Aug 2022 18:32:18 +0000 (20:32 +0200)] 
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>
2 years agocheck_unbalanced_macros.sh: This script's functionality is already covered by 'make...
Alejandro Colomar [Wed, 24 Aug 2022 18:22:58 +0000 (20:22 +0200)] 
check_unbalanced_macros.sh: This script's functionality is already covered by 'make lint-man'

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years ago_Generic.3: EXAMPLES: Use a constant expression
Alejandro Colomar [Wed, 24 Aug 2022 11:47:21 +0000 (13:47 +0200)] 
_Generic.3: EXAMPLES: Use a constant expression

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agoappend_COLOPHON.sh, remove_COLOPHON.sh: Remove COLOPHON section.
Alejandro Colomar [Wed, 24 Aug 2022 15:37:35 +0000 (17:37 +0200)] 
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>
2 years agoutime.2, utimensat.2: explicitly mention ctime changing.
NeilBrown [Wed, 24 Aug 2022 01:21:34 +0000 (11:21 +1000)] 
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>
2 years ago_Generic.3: intmax_t can't be int
Alejandro Colomar [Sun, 21 Aug 2022 15:12:52 +0000 (17:12 +0200)] 
_Generic.3: intmax_t can't be int

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agoman-pages.7: Document recent changes to .TH
Alejandro Colomar [Sun, 21 Aug 2022 12:22:48 +0000 (14:22 +0200)] 
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>
2 years agoAll pages: Remove the 5th argument to .TH
Alejandro Colomar [Sun, 21 Aug 2022 12:10:16 +0000 (14:10 +0200)] 
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>
2 years agodist.mk, version.mk: dist: Add version to .TH
Alejandro Colomar [Sat, 20 Aug 2022 16:14:25 +0000 (18:14 +0200)] 
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>
2 years agoAll pages: Replace the 4th argument to .TH by "Linux man-pages (unreleased)"
Alejandro Colomar [Sat, 20 Aug 2022 11:48:02 +0000 (13:48 +0200)] 
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>
2 years ago_Generic.3: New page documenting _Generic()
Alejandro Colomar [Sat, 20 Aug 2022 16:57:51 +0000 (18:57 +0200)] 
_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>
2 years agobuild.mk: clean: Show some output
Alejandro Colomar [Sun, 21 Aug 2022 11:41:22 +0000 (13:41 +0200)] 
build.mk: clean: Show some output

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agofanotify_init.2: srcfix
Alejandro Colomar [Sun, 21 Aug 2022 11:25:52 +0000 (13:25 +0200)] 
fanotify_init.2: srcfix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agofanotify_init.2: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:50 +0000 (21:08 +0200)] 
fanotify_init.2: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agobuild-src.mk: Fix appending -Wstrict-prototypes
Jakub Wilk [Fri, 19 Aug 2022 18:24:31 +0000 (20:24 +0200)] 
build-src.mk: Fix appending -Wstrict-prototypes

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agotcp.7: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:59 +0000 (21:08 +0200)] 
tcp.7: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agofanotify.7: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:58 +0000 (21:08 +0200)] 
fanotify.7: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agotm.3type: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:57 +0000 (21:08 +0200)] 
tm.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agotimespec.3type: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:56 +0000 (21:08 +0200)] 
timespec.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agoitimerspec.3type: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:55 +0000 (21:08 +0200)] 
itimerspec.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agodev_t.3type: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:54 +0000 (21:08 +0200)] 
dev_t.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agoclockid_t.3type: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:53 +0000 (21:08 +0200)] 
clockid_t.3type: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agomemfd_secret.2: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:52 +0000 (21:08 +0200)] 
memfd_secret.2: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agolandlock_restrict_self.2: tfix
Jakub Wilk [Fri, 19 Aug 2022 19:08:51 +0000 (21:08 +0200)] 
landlock_restrict_self.2: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
2 years agoclang-tidy/config.yaml: Ignore a useless warning
Alejandro Colomar [Wed, 17 Aug 2022 13:31:31 +0000 (15:31 +0200)] 
clang-tidy/config.yaml: Ignore a useless warning

-readability-identifier-length

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agospufs.7: tfix
Alejandro Colomar [Mon, 15 Aug 2022 22:03:15 +0000 (00:03 +0200)] 
spufs.7: tfix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agospufs.7: wfix + ffix
Alejandro Colomar [Mon, 15 Aug 2022 21:54:14 +0000 (23:54 +0200)] 
spufs.7: wfix + ffix

Reported-by: Ingo Schwartze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agogetaddrinfo_a.3: actually gnu.cz => gnu.org
наб [Mon, 15 Aug 2022 21:33:49 +0000 (23:33 +0200)] 
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>
3 years agofutex.2, futex.7: {ftp://ftp => https://mirrors}.kernel.org
наб [Mon, 15 Aug 2022 21:33:44 +0000 (23:33 +0200)] 
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>
3 years agogetaddrinfo_a.3: {ftp.us => mirrors}.kernel.org, likewise for IP
наб [Mon, 15 Aug 2022 21:33:38 +0000 (23:33 +0200)] 
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>
3 years agomount.2: tfix
Alejandro Colomar [Mon, 15 Aug 2022 21:45:38 +0000 (23:45 +0200)] 
mount.2: tfix

Reported-by: glibg10b <pugonfireyt@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agocgroups.7: Document memory_recursiveprot mount option
Brett Holman [Mon, 8 Aug 2022 21:22:50 +0000 (15:22 -0600)] 
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>
3 years agoproc.5: Document idle state in /proc/pid/stat
Brett Holman [Mon, 8 Aug 2022 20:14:05 +0000 (14:14 -0600)] 
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>
3 years agopoll.2: tfix
Štěpán Němec [Mon, 8 Aug 2022 15:07:46 +0000 (17:07 +0200)] 
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>
3 years agogetaddrinfo_a.3: gnu.cz => gnu.org
наб [Tue, 2 Aug 2022 17:28:22 +0000 (19:28 +0200)] 
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>
3 years agogetline.3: wfix.
enh [Fri, 29 Jul 2022 20:13:10 +0000 (13:13 -0700)] 
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>
3 years agogetline.3: srcfix.
enh [Fri, 29 Jul 2022 20:13:10 +0000 (13:13 -0700)] 
getline.3: srcfix.

Signed-off-by: Elliott Hughes <enh@google.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agonsswitch.conf.5: Mention subid database
Nikola Forró [Fri, 22 Jul 2022 13:06:33 +0000 (15:06 +0200)] 
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>
3 years agolirc.4: document lirc changes in the kernel
Sean Young [Mon, 23 May 2022 08:04:06 +0000 (09:04 +0100)] 
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>
3 years agorandom.4: tfix
Alejandro Colomar [Fri, 5 Aug 2022 19:02:29 +0000 (21:02 +0200)] 
random.4: tfix

Reported-by: Eric Biggers <ebiggers@kernel.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agorandom.4: Update description about O_NONBLOCK flag
GUO Zihua [Wed, 3 Aug 2022 07:45:55 +0000 (15:45 +0800)] 
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>
3 years agospufs.7: ffix
Alejandro Colomar [Tue, 2 Aug 2022 15:31:41 +0000 (17:31 +0200)] 
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>
3 years agoiovec.3type, regex_t.3type: srcfix
Alejandro Colomar [Mon, 1 Aug 2022 23:07:08 +0000 (01:07 +0200)] 
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>
3 years agoargz_add.3: srcfix
Alejandro Colomar [Mon, 1 Aug 2022 22:49:07 +0000 (00:49 +0200)] 
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>
3 years agofanotify_init.2, mount_setattr.2: ffix
Alejandro Colomar [Mon, 1 Aug 2022 22:35:56 +0000 (00:35 +0200)] 
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>
3 years agogetgrent_r.3, psignal.3: ffix
Alejandro Colomar [Mon, 1 Aug 2022 22:35:24 +0000 (00:35 +0200)] 
getgrent_r.3, psignal.3: ffix

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agoioctl_userfaultfd.2, fanotify.7: ffix
Alejandro Colomar [Mon, 1 Aug 2022 22:35:10 +0000 (00:35 +0200)] 
ioctl_userfaultfd.2, fanotify.7: ffix

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agoman-pages.7: ffix
Alejandro Colomar [Mon, 1 Aug 2022 22:23:55 +0000 (00:23 +0200)] 
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>
3 years agoproc.5: ffix
Alejandro Colomar [Mon, 1 Aug 2022 21:57:55 +0000 (23:57 +0200)] 
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>
3 years agost.4: ffix
Alejandro Colomar [Mon, 1 Aug 2022 21:52:58 +0000 (23:52 +0200)] 
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>
3 years agoconsole_codes.4: ffix
Alejandro Colomar [Mon, 1 Aug 2022 21:46:17 +0000 (23:46 +0200)] 
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>
3 years agocciss.4: ffix
Alejandro Colomar [Mon, 1 Aug 2022 21:37:23 +0000 (23:37 +0200)] 
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>
3 years ago__setfpucw.3: ffix
Alejandro Colomar [Mon, 1 Aug 2022 21:22:25 +0000 (23:22 +0200)] 
__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>
3 years ago__setfpucw.3: pfix
Alejandro Colomar [Mon, 1 Aug 2022 21:18:51 +0000 (23:18 +0200)] 
__setfpucw.3: pfix

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

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agomembarrier.2: ffix
Alejandro Colomar [Mon, 1 Aug 2022 21:15:46 +0000 (23:15 +0200)] 
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>
3 years agogetrlimit.2: srcfix
Alejandro Colomar [Mon, 1 Aug 2022 21:08:53 +0000 (23:08 +0200)] 
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>
3 years agogetrlimit.2: Use MIN(3)
Alejandro Colomar [Mon, 1 Aug 2022 21:04:32 +0000 (23:04 +0200)] 
getrlimit.2: Use MIN(3)

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

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agochown.2: srcfix
Alejandro Colomar [Mon, 1 Aug 2022 20:42:15 +0000 (22:42 +0200)] 
chown.2: srcfix

Reported-by: 'make lint-man'
Reported-by: groff(1)
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agotimer_settime.2, timerfd_create.2, itimerspec.3type: Document itimerspec in a new...
Alejandro Colomar [Mon, 1 Aug 2022 20:28:49 +0000 (22:28 +0200)] 
timer_settime.2, timerfd_create.2, itimerspec.3type: Document itimerspec in a new page

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agoioctl_ns.2: EXAMPLES: Add missing include
Alejandro Colomar [Mon, 1 Aug 2022 20:04:49 +0000 (22:04 +0200)] 
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>
3 years agobyteorder.3: STANDARDS: Simplify
Alejandro Colomar [Mon, 1 Aug 2022 19:45:30 +0000 (21:45 +0200)] 
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>
3 years agobind.2, process_vm_readv.2: EXAMPLES: Add necessary includes and ftm(7)
Alejandro Colomar [Mon, 1 Aug 2022 14:59:39 +0000 (16:59 +0200)] 
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>
3 years ago.checkpatch.conf, CPPLINT.cfg: Ignore some warnings from 'make lint-c'
Alejandro Colomar [Mon, 1 Aug 2022 14:57:53 +0000 (16:57 +0200)] 
.checkpatch.conf, CPPLINT.cfg: Ignore some warnings from 'make lint-c'

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agoVarious pages: EXAMPLES: tfix
Alejandro Colomar [Mon, 1 Aug 2022 14:55:55 +0000 (16:55 +0200)] 
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>
3 years agoxattr.7: wfix
Štěpán Němec [Fri, 29 Jul 2022 11:45:04 +0000 (13:45 +0200)] 
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>
3 years agopoll.2: tfix
Štěpán Němec [Fri, 29 Jul 2022 11:45:06 +0000 (13:45 +0200)] 
poll.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agosigaction.2: tfix
Štěpán Němec [Fri, 29 Jul 2022 11:45:05 +0000 (13:45 +0200)] 
sigaction.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agosyslog.2: tfix
Štěpán Němec [Fri, 29 Jul 2022 11:45:03 +0000 (13:45 +0200)] 
syslog.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agomremap.2: wfix
Štěpán Němec [Fri, 29 Jul 2022 11:45:02 +0000 (13:45 +0200)] 
mremap.2: wfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agogetrlimit.2: tfix
Štěpán Němec [Fri, 29 Jul 2022 11:45:01 +0000 (13:45 +0200)] 
getrlimit.2: tfix

Signed-off-by: Štěpán Němec <stepnem@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agoMakefile: Disable builtin rules and variables
Alejandro Colomar [Sun, 31 Jul 2022 12:19:26 +0000 (14:19 +0200)] 
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>
3 years agoMakefile, src.mk, *.mk: Move some definitions to a helper Makefile
Alejandro Colomar [Sat, 30 Jul 2022 19:06:53 +0000 (21:06 +0200)] 
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>
3 years agoMakefile, cmd.mk, *.mk: Allow using different names for basic commands
Alejandro Colomar [Sat, 30 Jul 2022 18:57:13 +0000 (20:57 +0200)] 
Makefile, cmd.mk, *.mk: Allow using different names for basic commands

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agodist.mk: Create tarballs with a top-level directory
Alejandro Colomar [Sat, 30 Jul 2022 18:31:40 +0000 (20:31 +0200)] 
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>
3 years agoREADME: man0 is not used anymore
Alejandro Colomar [Sun, 31 Jul 2022 11:20:18 +0000 (13:20 +0200)] 
README: man0 is not used anymore

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agosa_family_t.3type, sockaddr.3type: Document sa_family_t
Alejandro Colomar [Fri, 29 Jul 2022 22:29:31 +0000 (00:29 +0200)] 
sa_family_t.3type, sockaddr.3type: Document sa_family_t

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agosockaddr.3type, timer_t.3type, void.3type: wfix
Alejandro Colomar [Fri, 29 Jul 2022 22:19:27 +0000 (00:19 +0200)] 
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>
3 years agoptrdiff_t.3type, size_t.3type, time_t.3type, va_list.3type, void.3type: ffix
Alejandro Colomar [Fri, 29 Jul 2022 22:12:34 +0000 (00:12 +0200)] 
ptrdiff_t.3type, size_t.3type, time_t.3type, va_list.3type, void.3type: ffix

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
3 years agoVarious pages: wfix
Alejandro Colomar [Fri, 29 Jul 2022 15:50:35 +0000 (17:50 +0200)] 
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>
3 years agosysexits.h.3head: Add LIBRARY section
Alejandro Colomar [Fri, 29 Jul 2022 13:32:31 +0000 (15:32 +0200)] 
sysexits.h.3head: Add LIBRARY section

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