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/>

Attachment: signature.asc
Description: PGP signature

Reply via email to