Makefile: Add 'check-groff-warnings' target

Add a 'check-groff-warnings' target to check if groff
reports warnings (the underlying problem may be causing
words or sentences not to be displayed) from
http://lintian.debian.org/tags/manpage-has-errors-from-man.html
Some edits by mtk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Simon Paillard 2012-10-21 09:25:20 +02:00 committed by Michael Kerrisk
parent 075963263e
commit 251da60bbb
1 changed files with 13 additions and 0 deletions

View File

@ -55,5 +55,18 @@ install:
install -m 644 "$$i"/* $(DESTDIR)$(MANDIR)/"$$i" || exit $$?; \
done; \
# Check if groff reports warnings (may be words of sentances not displayed)
# from http://lintian.debian.org/tags/manpage-has-errors-from-man.html
GROFF_LOG := $(shell mktemp /tmp/manpages-checksXXXX)
check-groff-warnings:
for i in man?/*.[1-9]; \
do \
if grep -q 'SH.*NAME' $$i; then \
LC_ALL=en_US.UTF-8 MANWIDTH=80 man --warnings -E UTF-8 -l $$i > /dev/null 2>$(GROFF_LOG); \
[ -s $(GROFF_LOG) ] && ( echo "$$i: " ; cat $(GROFF_LOG) ; echo "" ); \
rm $(GROFF_LOG) 2>/dev/null; \
fi \
done
# someone might also want to look at /var/catman/cat2 or so ...
# a problem is that the location of cat pages varies a lot