Skip to content

Moar granular linting of manual pages

Alejandro Colomar linux-man 1 version New

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest6 patches 0 repliesNew

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/6lint-man.mk: make-lint-tbl: ffixlib/lint-man.mk+1 -10 replies
2/6Makefile, lint-man.mk: lint-man-groff-tbl: Split target from lint-man-groffMakefile lib/lint-man.mk+14 -40 replies
3/6Makefile, lint-man.mk: lint-man-groff-eqn: Split target from lint-man-groffMakefile lib/lint-man.mk+12 -30 replies
4/6Makefile, lint-man.mk: lint-man-groff-troff: Split target from lint-man-groffMakefile lib/lint-man.mk+14 -50 replies
5/6Makefile, lint-man.mk: lint-man-groff-grotty: Split target from lint-man-groffMakefile lib/lint-man.mk+13 -40 replies
6/6Makefile, lint-man.mk: lint-man-groff-col, lint-man-groff-grep: Split targets from lint-man-groffMakefile lib/lint-man.mk+18 -40 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH 0/6] Moar granular linting of manual pages

Hi,

I'm working on getting the linters run by the Debian packaging through override_dh_atuo_test (and hopefully other distros will do something similar; and hopefully other projects will be interested, and will also add some linting to their projects' manual pages, so we have better manual pages overall, but I know I'm hoping too much with that).

One of the issues was that there are still many warnings in many pages for most linters, so I wanted to have a large subset that would have little to no warnings. The only one that has no warnings at all is 'lint-man-tbl', and then there's 'lint-man-mandoc' which only has warnings in two (external) pages.

To reduce that issue, and be able to pass more linters to the pages, I'm splitting the 'lint-man-groff' pipeline into its elements, so I can hopefully run most of them without warnings. After this patch, we will be able to run part of this pipeline in the packaging tests, since they have no warnings, so we have some more testing.

And as a very nice side effect, we will have a complete set of intermediate files produced by the pipeline, which allows one to inspect any step without any manual intervention: just running the 'lint-man-groff' target will produce the entire set of intermediate files used in the groff(1) pipeline (and also the output of col(1)).

This will help debug groff(1) when a problem arises.

Cheers,

Alex

Alejandro Colomar (6):
lint-man.mk: make-lint-tbl: ffix
Makefile, lint-man.mk: lint-man-groff-tbl: Split target from
lint-man-groff
Makefile, lint-man.mk: lint-man-groff-eqn: Split target from
lint-man-groff
Makefile, lint-man.mk: lint-man-groff-troff: Split target from
lint-man-groff
Makefile, lint-man.mk: lint-man-groff-grotty: Split target from
lint-man-groff
Makefile, lint-man.mk: lint-man-groff-col, lint-man-groff-grep: Split
targets from lint-man-groff

 Makefile        |  8 ++++++-
 lib/lint-man.mk | 63 ++++++++++++++++++++++++++++++++++++++++++-------
 2 files changed, 61 insertions(+), 10 deletions(-)
Signature · 1 line
2.39.2