Add a manpage to the Debian package

Dockerfile

@@ -1,10 +1,16 @@
 FROM debian:jessie
 
 MAINTAINER Chris Kuehl <ckuehl@yelp.com>
+
+# Install the bare minimum dependencies necessary for working with Debian
+# packages. Build dependencies should be added under "Build-Depends" inside
+# debian/control instead.
 RUN DEBIAN_FRONTEND=noninteractive apt-get update && \
     apt-get install -y --no-install-recommends \
         build-essential devscripts equivs && \
     apt-get clean
 WORKDIR /mnt
 
-ENTRYPOINT mk-build-deps -i --tool 'apt-get --no-install-recommends -y' && make builddeb
+ENTRYPOINT apt-get update && \
+    mk-build-deps -i --tool 'apt-get --no-install-recommends -y' && \
+    make builddeb

debian/.gitignore

@@ -3,3 +3,4 @@
 files
 substvars
 dumb-init/
+dumb-init.man

debian/control

@@ -4,7 +4,7 @@ Priority: extra
 Maintainer: Chris Kuehl <ckuehl@yelp.com>
 Uploaders: Kent Wills <rkwills@yelp.com>
 Build-Depends: debhelper (>= 7), gcc, fakeroot, python, python-pytest,
- python-mock
+ python-mock, help2man
 Standards-Version: 3.9.6
 
 Package: dumb-init

debian/help2man

@@ -0,0 +1,7 @@
+[authors]
+.B dumb-init
+was primarily developed at Yelp.
+.br
+.br
+For a full list of contributors, see
+https://github.com/Yelp/dumb-init/graphs/contributors

debian/manpages

@@ -0,0 +1 @@
+debian/dumb-init.man

debian/rules

@@ -2,6 +2,14 @@
 %:
 	dh $@
 
+override_dh_auto_build:
+	dh_auto_build $@
+	help2man --name 'a minimal init system for Linux containers' \
+		--no-discard-stderr \
+		--include debian/help2man \
+		--no-info \
+		./dumb-init > debian/dumb-init.man
+
 override_dh_builddeb:
 	dh_builddeb -- -Zgzip