[mlpack] 03/09: work around txt2man failing to \-escape initial-' lines

[Barak A. Pearlmutter]

This is an automated email from the git hooks/post-receive script.

bap pushed a commit to branch master
in repository mlpack.

commit 1b8eba5ab7537a9554679c001fc624b671fc5b06
Author: Barak A. Pearlmutter <barak+git at cs.nuim.ie>
Date:   Mon Apr 7 11:06:35 2014 +0100

    work around txt2man failing to \-escape initial-' lines
    
    W: mlpack-bin: manpage-has-errors-from-man usr/share/man/man1/fastmks.1.gz 23: warning: macro `query.csv',' not defined
    W: mlpack-bin: manpage-has-errors-from-man usr/share/man/man1/nca.1.gz 38: warning: macro `Denominator' not defined
    
    Add debian/rules code to prepend a backslash escape on generated man
    pages displaying this pathology.
    
    Relevant snippet: sed "s:^[']:\\\\':"
---
 debian/mlpack-bin.install |  1 -
 debian/rules              | 20 ++++++++++++++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/debian/mlpack-bin.install b/debian/mlpack-bin.install
index 29d4c1d..1317f86 100644
--- a/debian/mlpack-bin.install
+++ b/debian/mlpack-bin.install
@@ -1,3 +1,2 @@
-
 /usr/bin
 /usr/share/man/man1
diff --git a/debian/rules b/debian/rules
index 4554782..af82c51 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,5 +1,7 @@
 #!/usr/bin/make -f
 
+# export DH_VERBOSE=1
+
 %:
 	dh $@ --parallel
 
@@ -9,9 +11,27 @@ override_dh_auto_build:
 	cd obj-*/doc/latex && \
 	 sed --in-place 's:usepackage\[utf8\]{inputenc}:usepackage[utf8x]{inputenc}:' refman.tex && \
 	 $(MAKE) pdf
+	@echo txt2man should backslash-escape lines starting with a single quote.
+	cd obj-*/share/man &&				\
+	 for f in fastmks.1 nca.1; do			\
+	  gunzip --force --keep $$f.gz &&		\
+	  sed --in-place "s:^[']:\\\\':" $$f &&		\
+	  gzip --force $$f ;				\
+	 done
 
 override_dh_auto_test:
 	@echo do not ask do not tell do not test
 
+override_dh_auto_install:
+	dh_auto_install
+	@echo txt2man should backslash-escape lines starting with a single quote.
+	@echo These are re-generated during installation so we re-fix them here.
+	cd debian/tmp/usr/share/man/man1 &&		\
+	 for f in fastmks.1 nca.1; do			\
+	  gunzip --force --keep $$f.gz &&		\
+	  sed --in-place "s:^[']:\\\\':" $$f &&		\
+	  gzip --force $$f ;				\
+	 done
+
 override_dh_compress:
 	dh_compress -Xrefman.pdf -Xdoc/html/

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/mlpack.git