r423: podized man page

[debhelper.git] / dh_installmanpages.1

diff --git a/dh_installmanpages.1 b/dh_installmanpages.1
index efd4afa2ef9fb679383abab5ad4ad36857e2ae31..a95f463c73107c776c275175eeaa1f12c0572c8c 100644 (file)
--- a/dh_installmanpages.1
+++ b/dh_installmanpages.1
@@ -1,6 +1,6 @@
 .TH DH_INSTALLMANPAGES 1 "" "Debhelper Commands" "Debhelper Commands"
 .SH NAME
-dh_installmanpages \- install man pages into package build directories
+dh_installmanpages \- old-style man page installer
 .SH SYNOPSIS
 .B dh_installmanpages
 .I "[debhelper options] [file ...]"
@@ -9,6 +9,11 @@ dh_installmanpages is a debhelper program that is responsible for
 automatically installing man pages into usr/share/man/ and usr/X11R6/man/ in
 package build directories.
 .P
+This is a DWIM-style program, with an interface unlike the rest of
+debhelper. You are encouraged to use
+.BR dh_installman (1)
+instead.
+.P
 dh_installmanpages scans the current directory and all subdirectories for
 filenames that look like man pages. (Note that only real files are looked
 at; symlinks are ignored.) It uses
@@ -43,10 +48,11 @@ See
 for a list of environment variables that affect all debhelper commands.
 .SH "SEE ALSO"
 .BR debhelper (1)
+.BR dh_installman (1)
 .SH BUGS
 Man pages with the extension
 .B .man
-are not automatically installed. 
+are not automatically installed.
 .P
 Files specified as parameters that contain spaces in their filenames will
 not be processed properly.