Hi maintainer,

I've attached a patch that adds a simple manpage based on help2man. Note
that nscd.man is meant to be a symlink to unscd.man (this gets lost in
the patch, but the target in debian/rules would create it properly).

I've also put a diff of the unscd package which also adds a systemd unit
file (#795621) and upgrades to 0.52 (#795618) in addition to adding the
manpage here just in case that's helpful:
https://gist.github.com/chriskuehl/028df2a1b6ee183d104d

Obviously feel free to ignore my patches, just including in case they
are helpful.

Cheers,
Chris

On Wed, Jun 24, 2015 at 05:29:23PM -0700, Chris Kuehl wrote:
> Package: unscd
> Version: 0.51-1+b2
> Severity: wishlist
> 
> Howdy maintainer,
> 
> unscd provides the binary /usr/sbin/nscd but does not appear to provide
> a corresponding man page. It's my understanding from policy [1] that
> this warrants a bug.
> 
> Happy Wednesday, and thanks for your work on Debian!
> Chris
> 
> [1] https://www.debian.org/doc/debian-policy/ch-docs.html#s12.1
> 
> -- System Information:
> Debian Release: 8.1
>   APT prefers stable-updates
>   APT policy: (500, 'stable-updates'), (500, 'stable')
> Architecture: amd64 (x86_64)
> 
> Kernel: Linux 3.16.0-4-amd64 (SMP w/8 CPU cores)
> Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
> Shell: /bin/sh linked to /bin/dash
> Init: systemd (via /run/systemd/system)
> 
> Versions of packages unscd depends on:
> ii  libc6  2.19-18
> 
> unscd recommends no packages.
> 
> unscd suggests no packages.
> 
> -- Configuration Files:
> /etc/nscd.conf changed [not included]
> 
> -- no debconf information
diff -Nru unscd-0.51/debian/help2man unscd-0.52/debian/help2man
--- unscd-0.51/debian/help2man	1969-12-31 16:00:00.000000000 -0800
+++ unscd-0.52/debian/help2man	2015-08-15 13:49:59.000000000 -0700
@@ -0,0 +1,3 @@
+[authors]
+.B unscd
+was written primarily by Denys Vlasenko.
diff -Nru unscd-0.51/debian/manpages unscd-0.52/debian/manpages
--- unscd-0.51/debian/manpages	1969-12-31 16:00:00.000000000 -0800
+++ unscd-0.52/debian/manpages	2015-08-15 13:53:29.000000000 -0700
@@ -0,0 +1,2 @@
+debian/nscd.man
+debian/unscd.man
diff -Nru unscd-0.51/debian/nscd.man unscd-0.52/debian/nscd.man
--- unscd-0.51/debian/nscd.man	1969-12-31 16:00:00.000000000 -0800
+++ unscd-0.52/debian/nscd.man	2015-08-15 13:59:16.000000000 -0700
@@ -0,0 +1,29 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
+.TH UNSCD "1" "August 2015" "unscd - nscd which does not hang, v.0.52" "User Commands"
+.SH NAME
+unscd \- nscd which does not hang
+.SH SYNOPSIS
+.B nscd
+[\fI\,OPTION\/\fR...]
+.SH DESCRIPTION
+Name Service Cache Daemon
+.TP
+\fB\-d\fR,\-\-debug
+Do not daemonize; log to stderr (\fB\-dd\fR: more verbosity)
+.HP
+\fB\-f\fR,\-\-config\-file File to read configuration from
+.TP
+\fB\-i\fR,\-\-invalidate
+Invalidate cache
+.TP
+\fB\-K\fR,\-\-shutdown
+Shut the server down
+.TP
+\fB\-t\fR,\-\-nthreads
+Serve N requests in parallel
+.TP
+\fB\-V\fR,\-\-version
+Version
+.SH AUTHORS
+.B unscd
+was written primarily by Denys Vlasenko.
diff -Nru unscd-0.51/debian/rules unscd-0.52/debian/rules
--- unscd-0.51/debian/rules	2013-10-21 17:05:19.000000000 -0700
+++ unscd-0.52/debian/rules	2015-08-15 14:13:30.000000000 -0700
@@ -15,3 +15,10 @@
 	install -t debian/unscd/usr/sbin/ nscd
 	install -d debian/unscd/etc/
 	install -m644 -t debian/unscd/etc/ debian/nscd.conf
+
+manpage:
+	help2man --name 'nscd which does not hang' \
+		--include debian/help2man \
+		--no-info \
+		debian/unscd/usr/sbin/nscd > debian/unscd.man
+	ln -fs unscd.man debian/nscd.man
diff -Nru unscd-0.51/debian/unscd.man unscd-0.52/debian/unscd.man
--- unscd-0.51/debian/unscd.man	1969-12-31 16:00:00.000000000 -0800
+++ unscd-0.52/debian/unscd.man	2015-08-15 13:59:16.000000000 -0700
@@ -0,0 +1,29 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
+.TH UNSCD "1" "August 2015" "unscd - nscd which does not hang, v.0.52" "User Commands"
+.SH NAME
+unscd \- nscd which does not hang
+.SH SYNOPSIS
+.B nscd
+[\fI\,OPTION\/\fR...]
+.SH DESCRIPTION
+Name Service Cache Daemon
+.TP
+\fB\-d\fR,\-\-debug
+Do not daemonize; log to stderr (\fB\-dd\fR: more verbosity)
+.HP
+\fB\-f\fR,\-\-config\-file File to read configuration from
+.TP
+\fB\-i\fR,\-\-invalidate
+Invalidate cache
+.TP
+\fB\-K\fR,\-\-shutdown
+Shut the server down
+.TP
+\fB\-t\fR,\-\-nthreads
+Serve N requests in parallel
+.TP
+\fB\-V\fR,\-\-version
+Version
+.SH AUTHORS
+.B unscd
+was written primarily by Denys Vlasenko.

Reply via email to