Hi Suren, On Mon, Apr 21, 2025 at 08:58:22PM -0700, Suren Baghdasaryan wrote: > > > Please re-send including linux-man@ in CC, as specified in > > > <https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING> > > > > Thanks for the reference. Will post the documentation update later today. > > Was planning to post today but I'm a bit rusty with the syntax. > Will try to send it out tomorrow
No problem.
> after verifying the results.
For verifying, you might want to try diffman-git(1). It's provided in
the man-pages repo. If the version of the man-pages package provided by
your distro is >=6.10, you may already have it in your system, and if
not, you can find it as <src/bin/diffman-git> in the repo.
It's documented in a manual page in the same repo, of course.
I don't know if you know about the build system, which also checks a few
common issues in the pages. You can check <CONTRIBUTING.d/lint>.
TL;DR:
$ make -R -j8 -k lint-man build-all check;
(You can ignore anything that's not about the page you're modifying. At
the moment, I see a few issues that I'll need to investigate in a few
pages. For seeing a clean list of what's failing, you can ignore
stderr; see below.)
$ make -R -j24 -k lint-man build-all check 2>/dev/null
TROFF .tmp/man/man2/statx.2.cat.set
TROFF .tmp/man/man2const/KEYCTL_SETPERM.2const.html.set
TROFF .tmp/man/man2const/KEYCTL_SETPERM.2const.pdf.set
TROFF .tmp/man/man2const/KEYCTL_SETPERM.2const.ps.set
GREP .tmp/man/man2/pipe.2.check-catman.touch
GREP .tmp/man/man3/ctime.3.check-catman.touch
GREP .tmp/man/man7/landlock.7.check-catman.touch
GREP .tmp/man/man7/rtnetlink.7.check-catman.touch
Have a lovely day!
Alex
--
<https://www.alejandro-colomar.es/>
signature.asc
Description: PGP signature

