Hi Matteo,

On Wed, Jun 11, 2025 at 04:11:37PM +0200, Matteo Croce wrote:

quoted

        MANDOC          .tmp/man/man2/cachestat.2.lint-man.mandoc.touch
        mandoc: .tmp/man/man2/cachestat.2:60:3: ERROR: skipping unknown macro:  If
        mandoc: .tmp/man/man2/cachestat.2:27:2: STYLE: fill mode already disabled, skipping: nf

Oh nice, didn't know about mandoc. I'm using it to validate the man page with:

mandoc -W base,stop man/man2/cachestat.2

I use `mandoc -Tlint man/man2/cachestat.2` (except that I ignore a few
of those warnings).  Here's the exact command that runs in the build
system (and thus in my CI):

	$ make lint-man-mandoc -R --debug=print |& head -n8
	make: warning: undefined variable 'GNUMAKEFLAGS'
	MANDOC		.tmp/man/man2/ioctl_fs.2.lint-man.mandoc.touch
	! (mandoc -Tlint  .tmp/man/man2/ioctl_fs.2 2>&1 \
	   | grep -v -f '/srv/alx/src/linux/man-pages/man-pages/master/share/mk/lint/man/mandoc.ignore.grep' \
	   || true; \
	) \
	| grep ^ >&2
	touch .tmp/man/man2/ioctl_fs.2.lint-man.mandoc.touch

You can run `make -R -j4 lint-man-mandoc` to lint it with the usual
exceptions that I configured.  Or `make -R -j4 lint build-all check` to
run even more checks.  Help about those is under CONTRIBUTING.d/ and
with `make -R help`.

I'm fixing these errors now, have a lovely day too!

:-)

Cheers,
Alex

-- 
<https://www.alejandro-colomar.es/>