_Generic.3: EXAMPLES: Silence indent warning

cpplint(1) complained about the previous indentation of the comment.
Oh well.

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

CPPLINT.cfg: Ignore warnings with false positives

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

checkpatch/config: Ignore warnings with false positives

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

pthread_setschedparam.3: EXAMPLES: Add const to function parameter

Just because we can.

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

pthread_getattr_np.3: EXAMPLES: Fix bug in comparison

size_t can't ever be `< 0`.  Instead, the intention was comparing to
`-1`, a sentinel value that was being converted to `SIZE_MAX`.
Comparing with `!= -1` we can keep the `-1` in the source code, which
will be more readable.

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

getaddrinfo_a.3: EXAMPLES: Handle *alloc(3) errors

-  Use reallocf(3bsd) to avoid memory leaks with misuses of realloc(3).
-  err(3bsd) on allocation errors.

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

cppcheck.suppress: knownConditionTrueFalse: Silence a warning with false positives

Link: <https://lore.kernel.org/linux-man/e13c74fb-e17a-ba14-f1fc-9c75f05090db@kernel.org/T/#u>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

cppcheck.suppress: constParameterCallback: Ignore false positives in libc callbacks

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

cppcheck.suppress: constParameter: Ignore false positives due to main() argv

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

pthread_getattr_default_np.3: EXAMPLES: Fix conversion specifier for size_t

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

man3/: EXAMPLES: Don't build programs that have UB on purpose

It doesn't make sense linting and building these, as we know they'll
yell at us.

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

*.mk: Don't include the main Makefile

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

man.7: Replace page with `so` of groff_man(7)

Suggested-by: Alejandro Colomar <alx@kernel.org>
Acked-by: Ingo Schwarze <schwarze@usta.de>
Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*.mk: man*ext: Make the variables actually usable

There were several important bugs regarding these variables that made
them unusable:

-  intro(*) pages were completely ignoring them.
-  The rules for non-intro pages were also ignoring them.

The variables were only being effectively used for updating the .so
links to other pages, but not the page filenames themselves.

Behavior prior to this patch:

$ rm -rf /tmp/dest;
$ echo '.so man2type/open_how.2type' >man2type/foo.2type;
$ echo '.so man2type/open_how.2type' >man2type/intro.2type;
$ make install-man2type install-manintro \
DESTDIR=/tmp/dest/dir \
man2typedir=/mantoo \
man2typeext=.twotype \
Z=.gz \
LINK_PAGES=symlink;
INSTALL /tmp/dest/dir/mantoo/
INSTALL /tmp/dest/dir/mantoo/foo.2type.gz
INSTALL /tmp/dest/dir/mantoo/open_how.2type.gz
INSTALL /tmp/dest/dir/usr/local/share/man/man1/
INSTALL /tmp/dest/dir/usr/local/share/man/man1/intro.1.gz
INSTALL /tmp/dest/dir/usr/local/share/man/man2type/
INSTALL /tmp/dest/dir/usr/local/share/man/man2type/intro.2type.gz
INSTALL /tmp/dest/dir/usr/local/share/man/man2/
INSTALL /tmp/dest/dir/usr/local/share/man/man2/intro.2.gz
INSTALL /tmp/dest/dir/usr/local/share/man/man3/
[...]
$ readlink /tmp/dest/dir/mantoo/foo.2type.gz;
../mantoo/open_how.twotype.gz
$ readlink /tmp/dest/dir/usr/local/share/man/man2type/intro.2type.gz;
../mantoo/open_how.twotype.gz

Notice the dead symlinks above.

Behavior after this patch:

$ rm -rf /tmp/dest;
$ echo '.so man2type/open_how.2type' >man2type/foo.2type;
$ echo '.so man2type/open_how.2type' >man2type/intro.2type;
$ make install-man2type install-manintro \
DESTDIR=/tmp/dest/dir \
man2typedir=/mantoo \
man2typeext=.twotype \
Z=.gz \
LINK_PAGES=symlink;
INSTALL /tmp/dest/dir/mantoo/
INSTALL /tmp/dest/dir/mantoo/foo.twotype.gz
INSTALL /tmp/dest/dir/mantoo/open_how.twotype.gz
INSTALL /tmp/dest/dir/usr/local/share/man/man1/
INSTALL /tmp/dest/dir/usr/local/share/man/man1/intro.1.gz
INSTALL /tmp/dest/dir/usr/local/share/man/man2/
INSTALL /tmp/dest/dir/usr/local/share/man/man2/intro.2.gz
INSTALL /tmp/dest/dir/mantoo/intro.twotype.gz
INSTALL /tmp/dest/dir/usr/local/share/man/man3/
[...]
$ readlink /tmp/dest/dir/mantoo/foo.twotype.gz;
../mantoo/open_how.twotype.gz
$ readlink /tmp/dest/dir/mantoo/intro.twotype.gz;
../mantoo/open_how.twotype.gz

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

*.mk: srcfix

Cosmetic changes in preparation for next commit.

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

*.mk: man*ext: Don't include $(Z) in $(man*ext)

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

*.mk: srcfix

For consistency, let's use $(MAN$(s)DIR).

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

strcpy.3, strncat.3, string_copying.7: tfix

Remove non-breaking space (0xC2A0) that accidentally landed in the
source of some string pages.  Replace by a normal space (0x20).

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

scripts/sortman: Treat [_-] as a space

This sorts 'cat-woman' next to 'cat', before 'catatonic'.

Suggested-by: Brian Inglis <Brian.Inglis@Shaw.ca>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*.mk: Use $(foreach ...) to reduce repetition

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

*.mk: gzip(1) doesn't need '-' to act as a filter

Remove the redundant special file name.  It would be better to specify
/dev/stdin, if we wanted to specify a file name.  But the command just
works as a filter without a filename, so there's no need for that at
all.  Remove this redundant code.

The other compressors are compatible with gzip(1) in that regard.  Do
the same.

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

*.mk: Pipe to install(1)

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

*.mk: help-variables: Document $(man*ext)

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

*.mk: MANSECTIONS: Deduce values from existing mandirs

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

*.mk: MANSECTIONS: Rename variable

For consistency with other $(MAN*) variables, remove the underscore.

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

*.mk: nothing: Add dummy target

It's useful to make literally nothing while debugging or testing the
Makefile.

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

*.mk: Remove 'V' variable

GNU Make (since version 4.4) provides the same functionality with
`--debug=print`.  Remove this custom variable, which is now redundant
with the new option.

-  Define .SILENT: unconditionally.

-  Define HIDE_ERR unconditionally, and let the user redefine it to an
   empty string.  Document this.

Cc: Paul Smith <psmith@gnu.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*.mk: Use $(foreach ..., $(eval ...) to reduce repetition

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

close.2: Warn more clearly about the risks of close(2) and record locks

The consequences of using close(2) together with advisory record locks
are quite serious.  Make the warning more explicit.

Signed-off-by: Tomáš Golembiovský <tgolembi@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

scripts/sortman: Sort 'cat' before 'catatonic'

Reported-by: Deri James <deri@chuzzlewit.myzen.co.uk>
Cc: Brian Inglis <Brian.Inglis@Shaw.ca>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc*.5: Make sashimi

[Merge tag 'proc-sashimi-v1' of <git://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git>]

proc(5) was a huge page, which was quite hard to maintain, extend, read,
and refer to.  Split the page into small pages for the different
directories and files within /proc.  Some pages are still too large
(e.g., proc_sys(5)), and will some day be split even more.

This split keeps the contents of the original page, without modifying
anything; not even the formatting.

The only thing that has been modified in this patches, is that
directories are consistently represented with a trailing slash.

For the file name of the pages, we've used the name of the interface
(e.g., /proc/pid/), removing the leading and trailing '/'s and then
translating the remaining ones as `tr / _` (e.g., proc_pid.5).  The
title of the pages (TH) is consistent with this.  The NAME of the pages,
however, is the actual path name of the interfaces.

The man page references have not been updated, as that was a more
complex and tedious work, so I expect that they'll be slowly updated as
we and users find out.

Link: <https://lore.kernel.org/linux-man/e3a5bc09-e835-9819-4aaa-12959495ac59@kernel.org/T/>
Acked-by: Oskari Pirhonen <xxc3ncoredxx@gmail.com>
Acked-by: Günther Noack <gnoack@google.com>
Acked-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Brian Inglis <Brian.Inglis@Shaw.ca>
Cc: Ingo Schwarze <schwarze@usta.de>
Cc: Colin Watson <cjwatson@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

*.mk: Allow any combination of common suffixes to manual pages

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

*.mk: Tighten regex for finding manual pages

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

INSTALL, README, RELEASE: Update references to GNUmakefile

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

GNUmakefile: tfix

Fixes: 6701269b7cd5 ("GNUmakefile: mv Makefile GNUmakefile")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

GNUmakefile: mv Makefile GNUmakefile

We require GNU Make.  Let's make it explicit by using the appropriate
GNU Make makefile name.  This will avoid users innocently running other
make(1) implementations and be confused by errors, as happened with Ingo
Schwarze long ago.

Cc: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

scripts/sortman: Tighten regex

This avoids misinterpreting file names like .../binutils-2.17/...

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

itimerspec.3type: This type is in POSIX.1-2001

And POSIX does not mention anything about <sys/timerfd.h>.

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

itimerspec.3type: tfix

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

clock_t.3type: tfix

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

proc.5: Clean up after making sashimi of this page

-  Remove outdated comments (they're on git, so it's not worth moving
   them to the appropriate pages).

-  Relicense with GPL-3.0-or-later, and add myself to copyleft.

-  Remove now-empty "Files and directories" subsection.

-  Remove now-irrelevant note about the page being a monster, which it
   is not anymore.

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

proc.5, proc_zoneinfo.5: Split /proc/zoneinfo from proc(5)

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

proc.5, proc_vmstat.5: Split /proc/vmstat from proc(5)

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

proc.5, proc_version.5: Split /proc/version from proc(5)

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

proc.5, proc_uptime.5: Split /proc/uptime from proc(5)

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

proc.5, proc_tty.5: Split /proc/tty from proc(5)

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

proc.5, proc_timer_stats.5: Split /proc/timer_stats from proc(5)

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

proc.5, proc_timer_list.5: Split /proc/timer_list from proc(5)

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

proc.5, proc_sysvipc.5: Split /proc/sysvipc/ from proc(5)

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

proc.5, proc_sysrq-trigger.5: Split /proc/sysrq-trigger from proc(5)

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

proc.5, proc_sys.5: Split /proc/sys/ from proc(5)

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

proc.5, proc_swaps.5: Split /proc/swaps from proc(5)

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

proc.5, proc_stat.5: Split /proc/stat from proc(5)

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

proc.5, proc_slabinfo.5: Split /proc/slabinfo from proc(5)

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

proc.5, proc_scsi.5: Split /proc/scsi/ from proc(5)

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

proc.5, proc_profile.5: Split /proc/profile from proc(5)

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

proc.5, proc_pci.5: Split /proc/pci from proc(5)

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

proc.5, proc_partitions.5: Split /proc/partitions from proc(5)

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

proc.5, proc_mtrr.5: Split /proc/mtrr from proc(5)

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

proc.5, proc_modules.5: Split /proc/modules from proc(5)

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

proc.5, proc_meminfo.5: Split /proc/meminfo from proc(5)

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

proc.5, proc_malloc.5: Split /proc/malloc from proc(5)

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

proc.5, proc_locks.5: Split /proc/locks from proc(5)

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

proc.5, proc_loadavg.5: Split /proc/loadavg from proc(5)

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

proc.5, proc_kpageflags.5: Split /proc/kpageflags from proc(5)

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

proc.5, proc_kpagecount.5: Split /proc/kpagecount from proc(5)

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

proc.5, proc_kpagecgroup.5: Split /proc/kpagecgroup from proc(5)

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

proc.5, proc_kmsg.5: Split /proc/kmsg from proc(5)

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

proc.5, proc_keys.5, proc_key-users.5: Split /proc/keys (and /proc/key-users) from proc(5)

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

proc.5, proc_kcore.5: Split /proc/kcore from proc(5)

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

proc.5, proc_kallsyms.5, proc_ksyms.5: Split /proc/kallsyms (and /proc/ksyms) from proc(5)

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

proc.5, proc_ioports.5: Split /proc/ioports from proc(5)

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

proc.5, proc_iomem.5: Split /proc/iomem from proc(5)

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

proc.5, proc_interrupts.5: Split /proc/interrupts from proc(5)

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

proc.5, proc_ide.5: Split /proc/ide/ from proc(5)

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

proc.5, proc_fs.5: Split /proc/fs/ from proc(5)

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

proc.5, proc_filesystems.5: Split /proc/filesystems from proc(5)

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

proc.5, proc_fb.5: Split /proc/fb from proc(5)

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

proc.5, proc_execdomains.5: Split /proc/execdomains from proc(5)

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

proc.5, proc_driver.5: Split /proc/driver/ from proc(5)

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

proc.5, proc_dma.5: Split /proc/dma from proc(5)

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

proc.5, proc_diskstats.5: Split /proc/diskstats from proc(5)

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

proc.5, proc_devices.5: Split /proc/devices from proc(5)

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

proc.5, proc_cpuinfo.5: Split /proc/cpuinfo from proc(5)

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

proc.5, proc_crypto.5: Split /proc/crypto from proc(5)

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

proc.5, proc_config.gz.5: Split /proc/config.gz from proc(5)

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

proc.5, proc_cmdline.5: Split /proc/cmdline from proc(5)

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

proc.5, proc_cgroups.5: Split /proc/cgroups from proc(5)

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

proc.5, proc_bus.5: Split /proc/bus/ from proc(5)

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

proc.5, proc_buddyinfo.5: Split /proc/buddyinfo from proc(5)

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

proc.5, proc_apm.5: Split /proc/apm from proc(5)

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

proc.5, proc_tid_children.5: Split /proc/TID/children from proc(5)

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

proc.5, proc_pid_task.5, proc_tid.5, proc_thread-self.5: Split /proc/PID/task/ (and /proc/TID/, /proc/thread-self/) from proc(5)

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

proc.5, proc_pid.5, proc_self.5: Split /proc/PID/ (and /proc/self/) from proc(5)

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

proc.5, proc_pid_wchan.5: Split /proc/PID/wchan from proc(5)

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

proc.5, proc_pid_timerslack_ns.5: Split /proc/PID/timerslack_ns from proc(5)

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

proc.5, proc_pid_timers.5: Split /proc/PID/timers from proc(5)

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

proc.5, proc_pid_syscall.5: Split /proc/PID/syscall from proc(5)

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

proc.5, proc_pid_status.5: Split /proc/PID/status from proc(5)

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

proc.5, proc_pid_statm.5: Split /proc/PID/statm from proc(5)

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