string_copying.7: Document strndup(3)

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

elf.5, ld.so.8: Undeprecate DT_RPATH; explain DT_RPATH vs DT_RUNPATH

In elf.5 and ld.so.8, remove deprecation of DT_RPATH
In elf.5, amend the description of DT_RUNPATH and DT_RPATH.

Rationale:
There is no credible path towards removal of DT_RPATH.
Lots of software depend on DT_RPATH as is.
It is used e.g. for testing and in binary installers.

Cc: Joseph Myers <josmyers@redhat.com>
Cc: Mike Frysinger <vapier@gentoo.org>
Cc: <bug-binutils@gnu.org>
Signed-off-by: Joachim Wuttke <j.wuttke@fz-juelich.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: distcheck: Run 'check' after 'build'

In this project, it doesn't matter, but in some cases, it's useful that
check doesn't imply build, such as in liba2i.git.  Cherry-picking this
change reduces differences in build systems.

Signed-off-by: Alejandro Colomar <alx@kernel.org>
Cherry-picked-from: liba2i.git 7246995b3464 ("share/mk/: distcheck: 'check' must be run after 'build'")
Link: <https://git.kernel.org/pub/scm/libs/liba2i/liba2i.git/>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: $LD: Fix definition to include $CPPFLAGS

Signed-off-by: Alejandro Colomar <alx@kernel.org>
Cherry-picked-from: liba2i.git ecc5ea650c45 ("share/mk/: $LD: Fix definition to include $CPPFLAGS")
Link: <https://git.kernel.org/pub/scm/libs/liba2i/liba2i.git/>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

CONTRIBUTING.d/*: Add instructions for configuring git(1) for this project

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

locale_t.3type: Add page

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

mbsinit.3, mbstate_t.3type: Split page into one for the type and one for the function

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

wint_t.3type: Add page

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

wchar_t.3type: Add page

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

share/mk/: lint-c-iwyu: Add exception

Link: <https://github.com/include-what-you-use/include-what-you-use/pull/1533>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: EXAMPLES: Add missing includes

Link: <https://github.com/include-what-you-use/include-what-you-use/pull/1283>
Link: <https://github.com/include-what-you-use/include-what-you-use/pull/1344>
Reported-by: iwyu(1) (`make lint-c-iwyu`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>

etc/cppcheck/cppcheck.suppress: Add unusedStructMember

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

share/mk/: $CPPCHECKFLAGS: Add --check-level=exhaustive

This avoids warnings of the form:

...: information: Limiting analysis of branches. Use --check-level=exhaustive to analyze all branches. [normalCheckLevelMaxBranches]

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

man/, share/mk/: Move man*/ to man/

This is a scripted change:

$ mkdir man/;
$ mv man* man/;
$ ln -st . man/man*;
$ find share/mk/ -type f \
| xargs grep -l '^MANDIR *:=' \
| xargs sed -i '/^MANDIR *:=/s,$,/man,';
$ find share/mk/dist/ -type f \
| xargs grep -l man \
| xargs sed -i 's,man%,man/%,g';

Link: <https://lore.kernel.org/linux-man/YxcV4h+Xn7cd6+q2@pevik/T/>
Cc: Petr Vorel <pvorel@suse.cz>
Cc: Jakub Wilk <jwilk@jwilk.net>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

CONTRIBUTING.d/patches: Please provide a git-range-diff(1)

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

CONTRIBUTING.d/patches: Add git-send-email(1) configuration for To and Cc

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

CONTRIBUTING.d/mail: Recommend specific mutt(1) config

We want protected headers too.

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

mount_setattr.2: Update supported file-systems

Let's update the list with the latest file-systems that added support.

You can easily verify this by "git grep FS_ALLOW_IDMAP" on the given
Linux version to see that the fs is listed and then checkout the
previous Linux version to see that it is not listed, therefore it was
added in that version.

$ diff -w -U0 \
        <(git grep FS_ALLOW_IDMAP v6.8 | sed 's/^v6.8://') \
        <(git grep FS_ALLOW_IDMAP v6.9-rc4 | sed 's/^v6.9-rc4://') \
| tail -n+4;
+fs/hugetlbfs/inode.c:  .fs_flags               = FS_ALLOW_IDMAP,

$ diff -w -U0 \
        <(git grep FS_ALLOW_IDMAP v6.6 | sed 's/^v6.6://') \
        <(git grep FS_ALLOW_IDMAP v6.7 | sed 's/^v6.7://') \
| tail -n+4;
+fs/ceph/super.c:       .fs_flags       = FS_RENAME_DOES_D_MOVE | FS_ALLOW_IDMAP,
$ diff -w -U0 \
        <(git grep FS_ALLOW_IDMAP v6.2 | sed 's/^v6.2://') \
        <(git grep FS_ALLOW_IDMAP v6.3 | sed 's/^v6.3://') \
| tail -n+4;
+mm/shmem.c:    .fs_flags       = FS_USERNS_MOUNT | FS_ALLOW_IDMAP,
$ diff -w -U0 \
        <(git grep FS_ALLOW_IDMAP v6.1 | sed 's/^v6.1://') \
        <(git grep FS_ALLOW_IDMAP v6.2 | sed 's/^v6.2://') \
| tail -n+4;
+fs/squashfs/super.c:   .fs_flags = FS_REQUIRES_DEV | FS_ALLOW_IDMAP,

Signed-off-by: Rodrigo Campos <rodrigo@sdfg.com.ar>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

CONTRIBUTING.d/: Clarify how to send patches with git-send-email(1)

Cc: Simon Barth <simon.barth@gmx.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: build-html: Don't build mbind.2 and set_mempolicy.2

They have known warnings.

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

slist.3: wfix

This page is about singly linked lists, not doubly linked lists.

Signed-off-by: Simon Barth <simon.barth@gmx.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man2/: Add MPOL_WEIGHTED_INTERLEAVE documentation

Add documentation for the new MPOL_WEIGHTED_INTERLEAVE mode in the same
manual pages that mention MPOL_INTERLEAVE; namely, mbind(2),
set_mempolicy(2), and get_mempolicy(2).

Descriptions were based on the changes introduced in this patch:
<https://lore.kernel.org/all/20240202170238.90004-4-gregory.price@memverge.com/>

Which was upstreamed to 6.9 here:
<https://lore.kernel.org/linux-mm/20240313200532.34e4cff216acd3db8def4637@linux-foundation.org/>

Cc: gregory.price@memverge.com
Reviewed-by: "Huang, Ying" <ying.huang@intel.com>
Signed-off-by: Svetly Todorov <svetly.todorov@memverge.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

strchr.3: HISTORY: strchrnul(3) is present in FreeBSD and NetBSD

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

open.2: protected_* sysctls are defined in proc_sys_fs(5), not proc(5)

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

share/mk/: Fix includes

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

share/mk/: Split makefiles

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

share/mk/: build-fonts-tinos: Build TinosR from TinosR.afm

And use a consistent name for it: TinosR, not TINOR.  This removes the
last remaining huge generated file we had in the repository.

Link: <https://technicallywewrite.com/2023/09/16/addfonts>
Link: <https://www.schaffter.ca/mom/momdoc/appendices.html#fonts>
Cc: Jan Eden <tech@eden.one>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: Deri James <deri@chuzzlewit.myzen.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: build-fonts-tinos: Build TinosR.afm from Tinos-Regular.ttf

This will allow generating the font description file from it, which will
be done in the next commit.

Link: <https://technicallywewrite.com/2023/09/16/addfonts>
Link: <https://www.schaffter.ca/mom/momdoc/appendices.html#fonts>
Cc: Jan Eden <tech@eden.one>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: Deri James <deri@chuzzlewit.myzen.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: Remove unused variable

Co-developed-by: Deri James <deri@chuzzlewit.myzen.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: build-fonts: Use $FONTSDIR/devpdf/, and add the download file

See gropdf(1).

Reported-by: Deri <deri@chuzzlewit.myzen.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

syscalls.2: srcfix

Tweak input format of table text blocks to make a planned sed-driven
update simpler and more reliable.

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

getpagesize.2: tfix

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

share/mk/: build-pdf-book: Fix chapter bookmarks

So that they can be folded.

Suggested-by: Deri James <deri@chuzzlewit.myzen.co.uk>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: build-pdf-book: Add support for mdoc(7) pages, with -mandoc

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

share/mk/: build-pdf-book: Use -rC1, to have strictly increasing page numbers

Suggested-by: "G. Branden Robinson" <branden@debian.org>
Suggested-by: Deri James <deri@chuzzlewit.myzen.co.uk>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: Read files before 'if'

'if' turns off set -e.  We want to read files before 'if', so that if
they don't exist, the shell will error out.

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

GNUmakefile: Simplify the $SHELL

nixpkgs does not provide /usr/bin/env, so they had to work around it by
specifying just env.  Since make(1) accepts program names instead of
paths, we can as well use bash directly, which is simpler.

Link: <https://github.com/NixOS/nixpkgs/pull/300797>
Reported-by: Sergei Trofimovich <slyich@gmail.com>
Cc: Mario Rodas <https://github.com/marsam>
Cc: Eli Schwartz <eschwartz93@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: install-man: Don't pipe to install(1)

install(1) doesn't work well in Darwin.  It seems to be unable to handle
</dev/stdin>.  The problem seems to be that Darwin's stdin misbehaves.

I've only workarounded the install target, and not the dist target,
since it's unlikely that one would run it in such a broken system.  But
since installing the pages is a common operation that everybody needs,
let's work around it here.

Fixes: 30c38a8bf8ae ("*.mk: Pipe to install(1)")
Link: <https://github.com/NixOS/nixpkgs/pull/300797>
Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=218730>
Reported-by: Sergei Trofimovich <slyich@gmail.com>
Reported-by: Mario Rodas <https://github.com/marsam>
Cc: Eli Schwartz <eschwartz93@gmail.com>
Cc: Pádraig Brady <P@draigBrady.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: build-pdf-book: Use the system's man(7) macros

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

proc.5: Refer to split-out manual pages for detailed description

Back in August 2023 various parts of proc(5) were split out into
separate manpages.  The final cleanup in 92cdcec79df0 ("proc.5: Clean up
after making sashimi of this page") missed to as well refer to the split
out manpages and retained the wording that details are found further
below in the manpages for the various files.

Fixes: 92cdcec79df0 ("proc.5: Clean up after making sashimi of this page")
Signed-off-by: Salvatore Bonaccorso <carnil@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man3/, debian/debhelper.in/glibc-doc.links: Move link pages to their place

Scripted change:

$ cat debian/debhelper.in/glibc-doc.links \
| while read l; do \
echo $l \
| awk '{print $1}' \
| sed 's,usr/share/man/,.so ,' \
| sed 's,\.gz,,' \
> "$(echo $l \
| awk '{print $2}' \
| sed 's,usr/share/man/,,' \
| sed 's,\.gz,,')";
done;
$ rm debian/debhelper.in/glibc-doc.links

Link: <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1068188>
Link: <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1068166>
Link: <https://lore.kernel.org/linux-man/703ec07e-dd2b-bbc6-f1bc-f495e53b764f@gmail.com/T/>
Cc: Marcos Fouces <marcos@debian.org>
Cc: Sven Joachim <svenjoac@gmx.de>
Cc: Bas Couwenberg <sebastic@xs4all.nl>
Cc: Andreas Beckmann <anbe@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Revert "debian/debhelper.in/glibc-doc.{links,manpages}, debian/local/manpages/pthread_*: drop the man pages for libpthread functions, as they are now included in manpages-dev.  Closes: #1068188."

This reverts commit c75bae912ab3b138687060df3701a888388e3d09.

Import pthread_*.3 link pages' git history from debian/glibc.git

These are the link pages, which I forgot to import in 87183bb8e9ec
("Import debian/local/manpages/pthread_*.3 git history from debian/glibc")
They aren't files in the debian repository, but they were generated at
build time, which is the reason I missed them.

Here's the process:

$ git clone git@salsa.debian.org:glibc-team/glibc.git
$ cd glibc/
$ git filter-repo --path debian/debhelper.in/glibc-doc.links
$ git tag | xargs git tag -d
$ git branch | xargs git branch -D
$ git remote add man file:///home/alx/src/linux/man-pages/man-pages/.bare.git
$ git fetch man
$ git rebase man/contrib

Subsequent commits will move the pages to the appropriate place.

Fixes: 87183bb8e9ec ("Import debian/local/manpages/pthread_*.3 git history from debian/glibc")
Link: <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1068188>
Link: <https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1068166>
Link: <https://lore.kernel.org/linux-man/703ec07e-dd2b-bbc6-f1bc-f495e53b764f@gmail.com/T/>
Cc: Marcos Fouces <marcos@debian.org>
Cc: Sven Joachim <svenjoac@gmx.de>
Cc: Bas Couwenberg <sebastic@xs4all.nl>
Cc: Andreas Beckmann <anbe@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

debian/debhelper.in/glibc-doc.{links,manpages}, debian/local/manpages/pthread_*: drop the man pages for libpthread functions, as they are now included in manpages-dev.  Closes: #1068188.

  * Remove manpages now provided by manpages-dev (closes: bug#595194):
    - pthread_kill_other_threads_np (3)
    - pthread_sigmask (3)

svn path=/glibc-package/trunk/; revision=4409

  * Remove manpage that will be provided by manpages-dev.  Closes: bug#506515,
    bug#505784.

svn path=/glibc-package/branches/glibc-2.9/; revision=3223

  * debian/debhelper.in/glibc-doc.links: add missing manpages links for
    functions documented with others.  Closes: #413989.

svn path=/glibc-package/trunk/; revision=2114

update trunk to 2.5-1

svn path=/glibc-package/trunk/; revision=2040

 * Backport from experimental (thanks Denis):
   - Remove the GNU Libc Reference manual from glibc-doc because it is
     not DFSG-free. (Closes: #181494)
     The whole glibc-2.3.6/manual directory is removed from glibc-2.3.6.ds1.tar.bz2.
   - debian/control: Drop Build-Depends: texinfo, texi2html.
   - debian/control: Drop references to the antique libc-doc package.
   - all/cvs-manual-memory.diff: removed.
   - all/cvs-manual-string.diff: removed.

svn path=/glibc-package/trunk/; revision=1742

Remove sem_*.3 manual pages from glibc-doc, these manual pages are updated
and maintained in the manpages-dev package.  (Closes: #365547)

svn path=/glibc-package/trunk/; revision=1475

   - debian/debhelper.in/glibc-doc.links: add manpages links for sem_*.

svn path=/trunk/; revision=649

- debian/debhelper.in/glibc-doc.links: add missing links for
      pthread_mutex_*(), pthread_mutexattr_*(), pthread_cond_*(), and
      pthread_condattr_*().

svn path=/trunk/; revision=603

Files missed in merge.  Clean *.doc-base.

svn path=/trunk/; revision=564

share/mk/: Remove support for installing compressed pages

I don't like compressed pages: they make it more difficult/slow to grep
them.  This was added to make it easier for users to install compressed
pages even when installing from source, but probably nobody cares at all
these days about a few KiB per page; drive space got cheap.  Also, some
of the algorithms were added just for benchmarking (for demonstrating
that they were bad in this case), and not for real use.

This reduces a use of compression tools, which seem to be dangerous
these days.

Link: <https://tukaani.org/xz-backdoor/>
Link: <https://cmpct.info/~sam/blog/posts/automatic-manpage-compression/>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

S_ISBLK.3, S_ISCHR.3, S_ISDIR.3, S_ISFIFO.3, S_ISLNK.3, S_ISREG.3, S_ISSOCK.3: Add link pages to inode(7)

These function-like macros are described in inode(7).

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

share/mk/: build: Add exceptions

With the larger font size, these pages have warnings.

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

share/mk/: $TROFFFLAGS: Use a larger font size

Link: <https://journals.uc.edu/index.php/vl/article/view/5765>
Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Suggested-by: "G. Branden Robinson" <branden@debian.org>
Cc: "Thomas E. Dickey" dickey@his.com
Signed-off-by: Alejandro Colomar <alx@kernel.org>

init_module.2: Document MODULE_INIT_COMPRESS_FILE flag

finit_module() supports the MODULE_INIT_COMPRESS_FILE flag since
Linux 5.17. See commit b1ae6dc41eaaa ("module: add in-kernel support
for decompressing")

During implementation of a secure module loader in GyroidOS, we
wanted to filter unsafe module parameters. To verify that only the
two documented flags which are disabling sanity checks are unsafe,
we had a look in the current kernel implementation.

We discovered that this new flag MODULE_INIT_COMPRESS_FILE was added.
Having a deeper look at the code, we also discovered that a new error
code EOPNOTSUPP is possible within newer kernels.

The inital commit only supported gzip and xz compression algorithms.
Support for zstd was added in Linux 6.2 by commit 169a58ad824d8
("module/decompress: Support zstd in-kernel decompression")

Signed-off-by: Michael Weiß <michael.weiss@aisec.fraunhofer.de>
Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Cc: Stephen Boyd <swboyd@chromium.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

sigwait.3: Note sigprocmask(2) requirement, explicitly link sigtimedwait(2)/NOTES

This comes from a real user complaint. sigwait(3) is the most obvious
of the family, and it doesn't mention any of the usage details.
Most of these can be crosslinked, but not mentioning the sigprocmask(2)
requirement is malice.

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

getpagesize.2, syscalls.2: Modernization

Remove the HP-UX portability advice, since getpagesize() is a slightly
better option than sysconf() for Linux systems.

Explain why this function exists, and why this man page is in the wrong
section.  (The previous text tried to do both at the same, which was
confusing.) Also explain how the vast majority of architectures that
don't have a syscall (but do support multiple page sizes) actually work.

Also de-emphasize the glibc 2.0 bug, since most people don't need to
worry about compatibility with versions of glibc from 1997.

Finally, change "not on x86" in syscalls.2 to say where there _is_ a
syscall.

Co-developed-by: Elliott Hughes <enh@google.com>
Co-developed-by: Alejandro Colomar <alx@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

getgrouplist.3: EXAMPLES: Fix error handling for getpwnam(3)

Signed-off-by: Fedor Lapshin <fe.lap.prog@gmail.com>
Co-developed-by: Alejandro Colomar <alx@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: Useful Use of Cat

Simplify a pipeline, by using cat(1) to actually catenate stuff.

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

share/mk/: Reorganize files for generating the PDF book

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

share/mk/: Generate the fonts during the build

Suggested-by: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

etc/clang-tidy/config.yaml: -llvm-header-guard

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

etc/cpplint/cpplint.cfg: -build/header_guard

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

share/mk/: $CFLAGS: -Wno-reserved-identifier, -Wno-unused-macros

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

share/mk/: lint-c-iwyu: Add exceptions

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

shmop.2: EXAMPLES: ffix

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

man*/: EXAMPLES: Add include guards

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

man*/: EXAMPLES: Fix includes

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

share/mk/: lint-c: Lint headers from EXAMPLES

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

share/mk/: Sync with liba2i's build system

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

share/mk/: build-pdf*, install-pdf*: Rename targets for consistency

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

share/mk/, scripts/LinuxManBook/build.sh: Embed script in the makefiles

This is done for simplifying, and as a side effect, it also allows
much more control on the script (e.g., TROFFFLAGS).

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

share/mk/: [un]install-pdf: Add target to install the PDF book

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

share/mk/: $EXTRAVERSION: Add variable to append to the version

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

share/mk/: Derive $DISTNAME from $DISTVERSION

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

share/mk/: Reorganize build system

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

share/mk/: dist: Don't stamp the version on the manual pages

This will allow downstream packages to set their own version, just by
setting $DISTVERSION.

It will be stamped at `make install` time.

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

share/mk/: $MANPAGEDATECMD: Use a variable for setting the date of manual pages

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

share/mk/: build-*: Specify manual pages' version and date

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

share/mk/: Fix includes

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

share/mk/: build-man: Split rule

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

share/mk/: Use more robust regex

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

share/mk/: build-book, build-man, install-man: Specify version and date

Each page has its own date.

Add new 'build-man' target, which stamps the date and version in the
pages (in $builddir, not the source ones).

Build-system internal stuff:
$CURDIR will be used for the build system, while $srcdir will be
used for the project root of the repository.  This helps use
this build system in other projects.

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

scripts/LinuxManBook/prepare.pl: Use more robust pipelines

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

GNUmakefile: help: wfix

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

share/mk/: Reorganize dependencies

Use one directory per each (Debian) package, and one file per command.

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

GNUmakefile: help: Hide variables not meant for users

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

Start of man-pages-NEXT: Move Changes to Changes.old

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

lsm: Released 6.7

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

Changes: Ready for 6.7

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

Changes: git(1) already shows contributors

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

GNUmakefile, INSTALL, RELEASE: Expand 'make help' to document dependencies

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

GNUmakefile: help: Add a simple help

It documents how to actually get the targets and variables with a
pipeline.

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

GNUmakefile: Use a more portable $SHELL

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

GNUmakefile: Remove help

It gets out of date easily, and it's always more accurate to actually
read the makefiles, or run a command that parses them for us.
In the case of .PHONY targets, or available variables, here are two
commands that can help:

$ make nothing -p \
| grep '^\.PHONY:' \
| tr ' ' '\n' \
| grep -v '^\.PHONY:' \
| sort;

$ grep -rho '^[^[:space:]].*=' GNUmakefile share/mk/configure/;

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

share/lint, share/mk/: Move *.grep files

They're part of the build system, so put them under <share/mk/>.

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

share/mk/: Split long line

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