[PATCH 1/2] [maint] Add a convenience target for checking manual pages.
James Youngman <[email protected]> Tue, 18 Nov 2025 09:15:58 +0000
| Newsgroups | gmane.comp.gnu.findutils.patches,gmane.comp.gnu.findutils.bugs |
|---|---|
| Message-ID | <[email protected]> |
* configure.ac: New recursive target, check-all-manpages, for convenience in lint-checking manual pages. * find/Makefile.am: Add new target check-all-manpages-local. This checks the manpages only. This is faster than invoking "make check" so it is convenient when working with manual page updates. * locate/Makefile.am: Likewise. * xargs/Makefile.am: Likewise. * po/Rules-findutils-no-ops: add dummy rules for the new recursive and local targets. These need to succeed, but Automake does not add these rules in po/ as it doesn't manage the Makefile there. --- configure.ac | 2 ++ find/Makefile.am | 4 +--- locate/Makefile.am | 4 +--- po/Rules-findutils-no-ops | 14 ++++++++++++++ xargs/Makefile.am | 4 +--- 5 files changed, 19 insertions(+), 9 deletions(-) create mode 100644 po/Rules-findutils-no-ops diff --git a/configure.ac b/configure.ac index 5f32c74f..f57d80dd 100644 --- a/configure.ac +++ b/configure.ac @@ -301,6 +301,8 @@ AC_ARG_VAR(GROFF,[Location of GNU groff]) AC_CHECK_PROGS([GROFF], [groff],[:]) +AM_EXTRA_RECURSIVE_TARGETS([check-all-manpages]) + # This is necessary so that .o files in LIBOBJS are also built via # the ANSI2KNR-filtering rules. #LIBOBJS=`echo $LIBOBJS|sed 's/\.o /\$U.o /g;s/\.o$/\$U.o/'` diff --git a/find/Makefile.am b/find/Makefile.am index 4d8bb2de..3df4ea74 100644 --- a/find/Makefile.am +++ b/find/Makefile.am @@ -40,8 +40,6 @@ SUBDIRS = . testsuite noinst_PROGRAMS = getlimits -check-local: findutils-check-manpages - # Clean coverage files generated by running binaries built with # gcc -fprofile-arcs -ftest-coverage coverage-clean: @@ -49,5 +47,5 @@ coverage-clean: clean-local: coverage-clean -findutils-check-manpages: +check-local check-all-manpages-local: env GROFF=$(GROFF) $(top_srcdir)/build-aux/man-lint.sh $(srcdir) $(man_MANS) diff --git a/locate/Makefile.am b/locate/Makefile.am index 183b9532..a78e5ceb 100644 --- a/locate/Makefile.am +++ b/locate/Makefile.am @@ -79,9 +79,7 @@ dblocation.texi: SUBDIRS = . testsuite -check-local: findutils-check-manpages - -findutils-check-manpages: +check-local check-all-manpages-local: env GROFF=$(GROFF) $(top_srcdir)/build-aux/man-lint.sh $(srcdir) $(man_MANS) # Clean coverage files generated by running binaries built with diff --git a/po/Rules-findutils-no-ops b/po/Rules-findutils-no-ops new file mode 100644 index 00000000..aa45f55d --- /dev/null +++ b/po/Rules-findutils-no-ops @@ -0,0 +1,14 @@ +# Rules-findutils-no-ops: Special Makefile rules for recursive make +# targets in findutils that don't need to do anything (but need not to +# fail). + +# IMPORTANT: if you modify this file (Rules-findutils-no-ops), you may +# need to manually run config.status (or configure) to re-generate the +# Makefile in this directory; the generated Makefile doesn't +# automatically incllude a rule for this. + + +.PHONY: check-all-manpages-local + +check-all-manpages check-all-manpages-local: + true diff --git a/xargs/Makefile.am b/xargs/Makefile.am index 2703cce5..bdfacdcf 100644 --- a/xargs/Makefile.am +++ b/xargs/Makefile.am @@ -25,9 +25,7 @@ SUBDIRS = . testsuite $(PROGRAMS): ../lib/libfind.a ../gl/lib/libgnulib.a -check-local: findutils-check-manpages - -findutils-check-manpages: +check-local check-all-manpages-local: env GROFF=$(GROFF) $(top_srcdir)/build-aux/man-lint.sh $(srcdir) $(man_MANS) # Clean coverage files generated by running binaries built with -- 2.39.5