On Tue, Apr 22, 2025 at 12:20 AM Alejandro Colomar <a...@kernel.org> wrote: > > 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 >
Thanks for the detailed instructions, Alex! Posted the patch at https://lore.kernel.org/all/20250423011203.2559210-1-sur...@google.com/ and hopefully I did not miss something important. Cheers, Suren. > > Have a lovely day! > Alex > > -- > <https://www.alejandro-colomar.es/>
