[DRE-commits] [ruby-hikidoc] 02/06: auto-generate hikidoc.1 with help2man

[Caitlin Matos]

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

cm-guest pushed a commit to branch master
in repository ruby-hikidoc.

commit d5cb17073f55892e93ca0691326d824e1aaac7f8
Author: Caitlin Matos <caitlin.matos at zoho.com>
Date:   Thu Aug 7 19:34:57 2014 -0400

    auto-generate hikidoc.1 with help2man
    
    * create and install hikidoc.1 with help2man (override_dh_installman)
      - requires new BD on help2man
    * remove old hikidoc.1
---
 debian/control               |  2 +-
 debian/hikidoc.1             | 20 --------------------
 debian/hikidoc.h2m           |  8 ++++++++
 debian/ruby-hikidoc.manpages |  2 +-
 debian/rules                 | 11 +++++++++++
 5 files changed, 21 insertions(+), 22 deletions(-)

diff --git a/debian/control b/debian/control
index 90a2eb5..d704f6f 100644
--- a/debian/control
+++ b/debian/control
@@ -3,7 +3,7 @@ Section: ruby
 Priority: optional
 Maintainer: Debian Ruby Extras Maintainers <pkg-ruby-extras-maintainers at lists.alioth.debian.org>
 Uploaders: Youhei SASAKI <uwabami at gfd-dennou.org>, Caitlin Matos <caitlin.matos at zoho.com>
-Build-Depends: debhelper (>= 9), gem2deb (>= 0.2.5~)
+Build-Depends: debhelper (>= 9), gem2deb (>= 0.2.5~), help2man
 Standards-Version: 3.9.5
 Vcs-Git: git://anonscm.debian.org/pkg-ruby-extras/ruby-hikidoc.git
 Vcs-Browser: http://anonscm.debian.org/gitweb?p=pkg-ruby-extras/ruby-hikidoc.git;a=summary
diff --git a/debian/hikidoc.1 b/debian/hikidoc.1
deleted file mode 100644
index 7e4b7f8..0000000
--- a/debian/hikidoc.1
+++ /dev/null
@@ -1,20 +0,0 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.45.1.
-.TH HIKIDOC "1" "July 2014" "hikidoc 0.1.0" "hikidoc"
-.SH NAME
-hikidoc \- text-to-HTML conversion tool
-.SH SYNOPSIS
-.B hikidoc
-[\fIOPTIONS\fR] \fIFILE\fR
-.SH DESCRIPTION
-.TP
-\fB\-f\fR, \fB\-\-fragment\fR
-Output HTML fragments only
-.TP
-\fB\-t\fR, \fB\-\-template\fR=\fITEMPLATE\fR
-Specify a HTML template file
-.TP
-\fB\-\-no\-wikiname\fR
-Disable WikiName link
-.SH SEE ALSO
-.TP
-/usr/share/docs/ruby-hikidoc/TextFormattingRules.gz
diff --git a/debian/hikidoc.h2m b/debian/hikidoc.h2m
new file mode 100644
index 0000000..6a0a32b
--- /dev/null
+++ b/debian/hikidoc.h2m
@@ -0,0 +1,8 @@
+[NAME]
+HikiDoc - a text-to-HTML conversion tool for web writers
+
+[SEE ALSO]
+Further information about HikiDoc syntax is available under:
+.IP
+\fI/usr/share/docs/ruby-hikidoc/html/TextFormattingRules.html\fR.
+.PP
diff --git a/debian/ruby-hikidoc.manpages b/debian/ruby-hikidoc.manpages
index e2cc389..5919cea 100644
--- a/debian/ruby-hikidoc.manpages
+++ b/debian/ruby-hikidoc.manpages
@@ -1 +1 @@
-debian/hikidoc.1
+hikidoc.1
diff --git a/debian/rules b/debian/rules
index c56e139..caf2d9d 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,7 +1,18 @@
 #!/usr/bin/make -f
+
+UPSTREAM_VERSION = $(shell dpkg-parsechangelog | awk '{ if ($$1 == "Version:") { print($$2) } }' | cut -d - -f 1)
+
 %:
 	dh $@ --buildsystem=ruby --with ruby
 
+override_dh_installman:
+	INLINE_DIR=. help2man --no-info \
+		   --include=debian/hikidoc.h2m \
+		   --help-option="-I lib/ bin/hikidoc --help" \
+		   --version-string=$(UPSTREAM_VERSION) \
+		   /usr/bin/ruby >hikidoc.1
+	dh_installman
+
 override_dh_installdocs:
 	# Need to use hikidoc to correctly format the TextFormattingRules page!
 	ruby -I lib/ bin/hikidoc ./TextFormattingRules >| TextFormattingRules.html

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-ruby-extras/ruby-hikidoc.git