From 18cdb84969ac411eca2a1ba88f09ac33f427f886 Mon Sep 17 00:00:00 2001
From: Franco Fichtner <franco@lastsummer.de>
Date: Mon, 7 Oct 2013 22:16:43 +0200
Subject: [PATCH] bsd.man.mk: add temporary ``mandiff'' target

Show differences in ASCII output between groff(1) and mandoc(1).  This
will help generate uptream bug reports.  Also useful for spotting local
configuration quirks of both programs.
---
 Makefile               | 1 +
 share/mk/bsd.man.mk    | 9 +++++++++
 share/mk/bsd.subdir.mk | 1 +
 3 files changed, 11 insertions(+)

diff --git a/Makefile b/Makefile
index da4cde809b..14ad9a5a61 100644
--- a/Makefile
+++ b/Makefile
@@ -86,6 +86,7 @@ TGTS=	all all-man buildkernel quickkernel nativekernel \
 	backup-clean backup-auto-clean \
 	_obj _includes _libraries _depend _worldtmp \
 	_bootstrap-tools _build-tools _cross-tools
+TGTS+=	mandiff # XXX temporary target
 
 BITGTS=	files includes
 BITGTS:=${BITGTS} ${BITGTS:S/^/build/} ${BITGTS:S/^/install/}
diff --git a/share/mk/bsd.man.mk b/share/mk/bsd.man.mk
index 7cbf50f72f..beb1d9fbfa 100644
--- a/share/mk/bsd.man.mk
+++ b/share/mk/bsd.man.mk
@@ -240,9 +240,11 @@ _maninstall: ${MAN}
 .endif
 
 manlint:
+mandiff:
 .if defined(MAN) && !empty(MAN)
 .for page in ${MAN}
 manlint: ${page}lint
+mandiff: ${page}diff
 ${page}lint: ${page}
 .if defined(MANFILTER)
 	@${MANFILTER} < ${.ALLSRC} | ${MROFF_CMD} -ww -z
@@ -251,5 +253,12 @@ ${page}lint: ${page}
 	@${MROFF_CMD} -ww -z ${.ALLSRC}
 	@-mandoc -Tlint ${.ALLSRC}
 .endif
+${page}.out.groff: ${page}
+	@-groff -mandoc -Tascii -P -c ${.ALLSRC} 2>&1 > ${.TARGET}
+${page}.out.mandoc: ${page}
+	@-mandoc -Werror ${.ALLSRC} 2>&1 > ${.TARGET}
+${page}diff: ${page}.out.groff ${page}.out.mandoc
+	@-diff -au ${.ALLSRC}
+	@rm ${.ALLSRC}
 .endfor
 .endif
diff --git a/share/mk/bsd.subdir.mk b/share/mk/bsd.subdir.mk
index 14c1661cf1..2dd717a7a4 100644
--- a/share/mk/bsd.subdir.mk
+++ b/share/mk/bsd.subdir.mk
@@ -38,6 +38,7 @@ __targets= \
 	maninstall realinstall	\
 	lint manlint regress \
 	buildfiles buildincludes installfiles installincludes
+__targets+=	mandiff # XXX temporary target
 
 .for __target in ${__targets}
 
-- 
2.41.0