scanf.3: Clarify ll and L modifiers

Relevant documents:

POSIX:
<https://pubs.opengroup.org/onlinepubs/9699919799/functions/fscanf.html>

glibc:
<https://www.gnu.org/software/libc/manual/html_mono/libc.html#Numeric-Input-Conversions>

ISO C2x:
<http://www.open-std.org/JTC1/SC22/WG14/www/docs/n2731.pdf#subsubsection.7.21.6.2>

Still, from the documentation linked above, it seems to me that
"%Ln" is supported as a glibc extension, and doesn't fall into
"either no effect or undefined behavior" as says the GCC warning
shown in the bugzilla report.  I didn't modify the documentation
regarding %n, and recommend investigating a possible GCC bug.

Reported-by: Avinash Sonawane <rootkea@gmail.com>
Link: bugzilla <https://bugzilla.kernel.org/show_bug.cgi?id=215844>
Cc: glibc <libc-alpha@sourceware.org>
Cc: GCC <gcc@gcc.gnu.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

timerfd_create.2: tfix

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

uri.7: Be more precise in RFC reference

RFC 7595 points to RFC 3986.  Let's refer to where the info actually is.

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

undocumented.3: Add thrd_*() C11 functions

Reported-by: Avinash Sonawane <rootkea@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

scripts/bash_aliases: grep_syscall[_def](): Fix bug that couldn't find syscalls with 0 args

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

fork.2: EXAMPLES: Add simple example using fork(2) without wait(2)

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

Revert "uri.7: The term URL is deprecated, in favor of URI"

This reverts commit 97bf2b7a7287b8e1672967f2df31f4a80a43edae.

That commit was incorrect, as Jakub pointed out.

Link: linux-man@ <https://lore.kernel.org/linux-man/36b89bec-1def-e87c-5477-c87f2f0e48e9@gmail.com/T/>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

uri.7: Update RFC reference (2718 -> 7595)

There's no significant change that affects this paragraph,
so simply update the reference to the obsolete RFC,
to refer to the current one.

Cc: NGINX Unit <unit@nginx.org>
Cc: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

uri.7: The term URL is deprecated, in favor of URI

See RFCs 4395 (obsoleted by 7595) and 7595.

So, since URI and URL have been used as synonims and it wasn't
clear to most people what the difference was, the RFCs seem to
have explicitly avoided URL, and now use URI as the only term,
which still means what it meant (so now URL is just a synonim for
URI).

This commit replaces (almost all) occurences of URL by URI,
except when it is referring to the old term itself.  Keep some
legacy info just for readers to understand this.

Cc: NGINX Unit <unit@nginx.org>
Cc: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

uri.7: Update RFC reference (2279 -> 3629)

There's no significant change that affects the manual page,
so simply update the reference to refer to the new one.

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

ioctl_userfaultfd.2: Corrections for returned .ioctls members

Support for the `UFFDIO_WRITEPROTECT` operation is not indicated in the
`ioctls` member of `struct uffdio_api`.  It is indicated in the `ioctls`
member of `struct uffdio_register` along with indications of support for
the `UFFDIO_COPY`, `UFFDIO_WAKE` and `UFFDIO_ZEROPAGE` operations (and
also the `UFFDIO_CONTINUE` operation supported since Linux 5.13 but
that is not documented by this man page yet.)

Fixes: f559fa36a678 ("ioctl_userfaultfd.2: Add write-protect mode docs")
Signed-off-by: Ian Abbott <abbotti@mev.co.uk>
Acked-by: Peter Xu <peterx@redhat.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

console_codes.4: ffix

Fix up the busted OSC command list (reset palette and
set palette). Remove CSI prefix from the list of non-CSI
escapes. End all items of said list with periods,
matching other sections of the page.

Link: <https://lore.kernel.org/linux-man/Yjg4VHMhrabggl88@schwarzgerat.orthanc/T/>
Signed-off-by: nick black <nickblack@linux.com>
Acked-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

cacosh.3, catan.3, catanh.3: EXAMPLES: Fix variable use in formulas

The cacosh, catan, and catanh man pages include examples using a
non-existant f2 variable. Replacing the f2 references with f fixes the
examples.

Signed-off-by: Stephen Kitt <steve@sk2.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

membarrier.2: EXAMPLES: Remove unused parameters to main()

`int main(void)` is a valid signature for main().  Since we're not
using any of its parameters, use that.

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

Makefile: lint: Skip link pages (.so ...)

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

glob.7: ffix

Fix error accidentally introduced in 7b97eb9ff04e

Suggested-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Makefile: Remove old 'check-groff-warnings' target

Use 'lint-groff' instead, which show the same groff(1) warnings,
but also shows more warnings (CHECKSTYLE).  It also runs
incrementally, so it only reruns for modified pages.

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

Makefile: GROFFFLAGS: Enable all warnings with -ww

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

Many pages: Fix style issues reported by `make lint-mandoc`

Plus some other found in the process.

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

Makefile: lint-mandoc: Add new target to run mandoc as a linter

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

checkstyle.tmac: Silence groff CHECKSTYLE warning for blank lines

Code examples contain many blank lines.
That warning, although sometimes valid, is too noisy.

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

Many pages: Fix style issues reported by `make lint-groff`

Plus some other found in the process.

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

ioctl_tty.2: ffix

Use \~ for the space between a type and the '*' pointer symbol.

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

Makefile: Add -t to GROFFFLAGS to run tbl(1)

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

Makefile: Consistency fixes to naming of variables

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

Makefile, etc/groff/tmac/deadly.tmac: Add lint and lint-groff targets

'lint' is a metatarget that triggers all lint-* targets (currently
that is just 'lint-groff').
'lint-groff' is a target that runs groff -rCHECKSTYLE to check
manual pages' groff(7) correctness.

etc/groff/tmac/deadly.tmac is a file written by Branden, to make
groff(1) abort when it finds a style problem, which then causes
make(1) to also abort.

CC: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Makefile: Use the $(V).SILENT trick instead of --silent

Hardcoding --silent into MAKEFLAGS makes it impossible to print
the commands used while running make.  Instead, use the special
target .SILENT, masked by a dummy variable V, which when given any
value (e.g., V=1) will make the target non-special, and will not
silence the make invocation.

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

.gitignore, Makefile: Use builddir to contain htmlbuilddir

This will simplify make clean when adding other tmp dirs for other
purposes, such as building PDF pages, or linting the groff files.

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

Makefile: Build HTML pages incrementally

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

madvise.2: update EINVAL return info

MADV_COLD and MADV_PAGEOUT advises on an address range which includes
locked, Huge TLB pages or VM_PFNMAP pages can return EINVAL. Update the
man pages accordingly.

Reported-by: Nadav Amit <nadav.amit@gmail.com>
Signed-off-by: Charan Teja Reddy <quic_charante@quicinc.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

uintptr_t.3: Update link page to point to intptr_t.3

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

stat.2, statx.2: Fix descriptions for AT_NO_AUTOMOUNT

fstatat(..., AT_NO_AUTOMOUNT) has had the following history in Linux:
  v2.6.37-7314-g6f45b65672c8
    add AT_NO_AUTOMOUNT and fstatat honors it
  v3.1-rc7-68-gb6c8069d3577
    ignore AT_NO_AUTOMOUNT since default operation now less eagerly mounts
  v4.10-11255-ga528d35e8bfc
    adds statx which reinstated 2.6.38 behavior for fstatat (not released)
  v4.11-rc7-14-gdeccf497d804
    adjust fstatat so that AT_NO_AUTOMOUNT always specified (to statx)

* man2/stat.2:
Adjust AT_NO_AUTOMOUNT description for fstatat.2 as per the above,
to indicate AT_NO_AUTOMOUNT should be avoided with fstatat() since
it's ignored since 3.1 and implied since 4.11.

Don't mention commit v4.13-9318-g42f461482178 as it was reverted,
and moot anyway since we can't adjust AT_NO_AUTOMOUNT since 3.1.

* man2/statx.2:
Mention that stat(), lstat(), and fstatat() imply AT_NO_AUTOMOUNT.

Signed-off-by: Pádraig Brady <P@draigBrady.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

nscd.conf.5: Add debug level description

With only the default debug level documented, neither the possible
range of the debug levels nor their purpose was apparent. This made it
hard to use debug levels. So we add a short description of them.

Signed-off-by: Christian Aistleitner <christian@quelltextlich.at>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Various pages: Add LIBRARY section (libc)

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

dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3: Add LIBRARY section (libdl)

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

crypt.3, encrypt.3: Add LIBRARY section (libcrypt)

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

getaddrinfo_a.3: Add LIBRARY section (libanl)

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

Various pages: Add LIBRARY section (libc)

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

FILE.3: Add LIBRARY section (libc)

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

Various pages: Add LIBRARY section (libc)

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

getdate.3: SYNOPSIS: Remove redundant include

It was a residue from old code, before the FTM subsection.

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

Various pages: Add LIBRARY section (libc)

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

INFINITY.3, double_t.3: Add LIBRARY section (libm)

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

Many pages: LIBRARY: srcfix

Escape '-' in -l option to cc(1).

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

inet_net_pton.3: Add LIBRARY section (libresolv)

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

Various pages: Add LIBRARY section (libm)

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

clock_getcpuclockid.3: Add LIBRARY section (librt)

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

Various pages: Add LIBRARY section (librt)

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

login.3: Add LIBRARY section (libutil)

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

Various pages: Add LIBRARY section (libc)

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

Various pages: Add LIBRARY section (libc)

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

iswcntrl.3: Add LIBRARY section (libc)

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

iswctype.3: Add LIBRARY section (libc)

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

iswdigit.3: Add LIBRARY section (libc)

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

iswgraph.3: Add LIBRARY section (libc)

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

iswlower.3: Add LIBRARY section (libc)

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

iswprint.3: Add LIBRARY section (libc)

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

iswpunct.3: Add LIBRARY section (libc)

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

iswspace.3: Add LIBRARY section (libc)

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

iswupper.3: Add LIBRARY section (libc)

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

iswxdigit.3: Add LIBRARY section (libc)

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

key_setsecret.3: Add LIBRARY section (libc)

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

killpg.3: Add LIBRARY section (libc)

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

lconv-struct.3: Add LIBRARY section (libc)

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

list.3: Add LIBRARY section (libc)

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

localeconv.3: Add LIBRARY section (libc)

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

lockf.3: Add LIBRARY section (libc)

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

j0.3: Add LIBRARY section (libm)

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

lgamma.3: Add LIBRARY section (libm)

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

log10.3: Add LIBRARY section (libm)

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

log1p.3: Add LIBRARY section (libm)

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

log2.3: Add LIBRARY section (libm)

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

log.3: Add LIBRARY section (libm)

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

logb.3: Add LIBRARY section (libm)

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

lrint.3: Add LIBRARY section (libm)

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

lround.3: Add LIBRARY section (libm)

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

matherr.3: Add LIBRARY section (libm)

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

modf.3: Add LIBRARY section (libm)

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

nan.3: Add LIBRARY section (libm)

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

nextafter.3: Add LIBRARY section (libm)

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

nextup.3: Add LIBRARY section (libm)

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

pow10.3: Add LIBRARY section (libm)

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

pow.3: Add LIBRARY section (libm)

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

lsearch.3: Add LIBRARY section (libc)

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

lseek64.3: Add LIBRARY section (libc)

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

makecontext.3: Add LIBRARY section (libc)

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

makedev.3: Add LIBRARY section (libc)

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

mallinfo.3: Add LIBRARY section (libc)

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

malloc.3: Add LIBRARY section (libc)

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

malloc_get_state.3: Add LIBRARY section (libc)

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

malloc_hook.3: Add LIBRARY section (libc)

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

malloc_info.3: Add LIBRARY section (libc)

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

malloc_stats.3: Add LIBRARY section (libc)

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

malloc_trim.3: Add LIBRARY section (libc)

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

malloc_usable_size.3: Add LIBRARY section (libc)

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

mallopt.3: Add LIBRARY section (libc)

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

MAX.3: Add LIBRARY section (libc)

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

mblen.3: Add LIBRARY section (libc)

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

MB_CUR_MAX.3: Add LIBRARY section (libc)

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

MB_LEN_MAX.3: Add LIBRARY section (libc)

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