r496: * Man page cleanups, Closes: #119335

40 files changed, 45 insertions, 42 deletions

diff --git a/debhelper.pod b/debhelper.pod
index 676ad0d0..82ced753 100644
--- a/debhelper.pod
+++ b/debhelper.pod
@@ -4,7 +4,7 @@ debhelper - the debhelper tool suite
 
 =head1 SYNOPSIS
 
-  dh_* [-v] [-a] [-i] [-s] [--no-act] [-ppackage] [-Npackage] [-Ptmpdir]
+B<dh_>I<*> [B<-v>] [B<-a>] [B<-i>] [B<-s>] [B<--no-act>] [B<-ppackage>] [B<-Npackage] [-Ptmpdir>]
 
 =head1 DESCRIPTION
 
diff --git a/debian/changelog b/debian/changelog
index 9d0b5846..4a9aafab 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+debhelper (3.0.51) unstable; urgency=low
+
+  * Man page cleanups, Closes: #119335
+
+ -- Joey Hess <joeyh@debian.org>  Sat, 17 Nov 2001 21:04:15 -0500
+
 debhelper (3.0.50) unstable; urgency=low
 
   * dh_undocumented: check for existing uncompressed man pages. Closes: #87972
diff --git a/dh_builddeb b/dh_builddeb
index 162cda86..180d0df1 100755
--- a/dh_builddeb
+++ b/dh_builddeb
@@ -11,8 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_builddeb [debhelper options] [--destdir=directory] 
-              [--name=filename] [-uparams] [-- params]
+B<dh_builddeb> [S<I<debhelper options>>] [B<--destdir=>I<directory>] [B<name=>I<filename>] [S<B<--> I<params>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_clean b/dh_clean
index 388f913c..6e482118 100755
--- a/dh_clean
+++ b/dh_clean
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_clean [debhelper options] [-k] [-d] [file ...] [-Xitem]
+B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_compress b/dh_compress
index e12cc486..6fc20b19 100755
--- a/dh_compress
+++ b/dh_compress
@@ -12,7 +12,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_compress [debhelper options] [-Xitem] [-A] [file ...]
+B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_fixperms b/dh_fixperms
index 5d982ad3..6b58bab7 100755
--- a/dh_fixperms
+++ b/dh_fixperms
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_fixperms [debhelper options] [-Xitem]
+B<dh_fixperms> [S<I<debhelper options>>] [B<-X>I<item>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_gencontrol b/dh_gencontrol
index ae8605a6..fcb91845 100755
--- a/dh_gencontrol
+++ b/dh_gencontrol
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_gencontrol [debhelper options] [-uparams] [-- params]
+B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installchangelogs b/dh_installchangelogs
index b0c6c50e..dc9b5a05 100755
--- a/dh_installchangelogs
+++ b/dh_installchangelogs
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installchangelogs [debhelper options] [-k] [upstream]
+B<dh_installchangelogs> [<S<I<debhelper options>>] [B<-k>] [I<upstream>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installcron b/dh_installcron
index 9813f6e0..5b3ac84e 100755
--- a/dh_installcron
+++ b/dh_installcron
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installcron [debhelper options]
+B<dh_installcron> [S<B<debhelper options>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installdeb b/dh_installdeb
index 1b363a9f..289970d0 100755
--- a/dh_installdeb
+++ b/dh_installdeb
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installdeb [debhelper options]
+B<dh_installdeb> [S<I<debhelper options>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installdebconf b/dh_installdebconf
index b6348baf..5833fbc7 100755
--- a/dh_installdebconf
+++ b/dh_installdebconf
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installdebconf [debhelper options] [-n]
+B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installdirs b/dh_installdirs
index 4f5cab3c..9d27b1b2 100755
--- a/dh_installdirs
+++ b/dh_installdirs
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installdirs [debhelper options] [-A] [dir ...]
+B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installdocs b/dh_installdocs
index 1796c0e3..2920446a 100755
--- a/dh_installdocs
+++ b/dh_installdocs
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installdocs debhelper [options] [-A] [-n] [file ...]
+B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-n>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installemacsen b/dh_installemacsen
index b6b511ad..3f8a9f79 100755
--- a/dh_installemacsen
+++ b/dh_installemacsen
@@ -11,8 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installemacsen [debhelper options] [-n] [--priority=n]
-                    [--flavor=foo]
+B<dh_installemacsen> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] [B<--flavor=>I<foo>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installexamples b/dh_installexamples
index 7c004265..fae33012 100755
--- a/dh_installexamples
+++ b/dh_installexamples
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installexamples [debhelper options] [-A] [file ...]
+B<dh_installexamples> [S<I<debhelper options>>] [B<-A>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installinfo b/dh_installinfo
index edaabf04..4232229a 100755
--- a/dh_installinfo
+++ b/dh_installinfo
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installinfo [debhelper options] [-A] [-n] [file ...]
+B<dh_installinfo> [S<I<debhelper options>>] [B<-A>] [B<-n>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installinit b/dh_installinit
index 835b955f..d8ab80b8 100755
--- a/dh_installinit
+++ b/dh_installinit
@@ -11,8 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installinit [debhelper options] [--init-script=scriptname] 
-                 [-n] [-r] [-d] [-uparams] -- [params]
+B<dh_installinit> [S<I<debhelper options>>] [B<--init-script=>I<scriptname>] [B<-n>] [B<-r>] [B<-d>] [S<B<--> I<params>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installlogrotate b/dh_installlogrotate
index 24531523..6aec670f 100755
--- a/dh_installlogrotate
+++ b/dh_installlogrotate
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installlogrotate [debhelper options]
+B<dh_installlogrotate> [S<I<debhelper options>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installman b/dh_installman
index a01f63d1..c6b90f74 100755
--- a/dh_installman
+++ b/dh_installman
@@ -12,7 +12,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installman [debhelper options] [manpage ...]
+B<dh_installman> [S<I<debhelper options>>] [S<I<manpage ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installmanpages b/dh_installmanpages
index cbde23c3..1f946739 100755
--- a/dh_installmanpages
+++ b/dh_installmanpages
@@ -12,7 +12,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installmanpages [debhelper options] [file ...]
+B<dh_installmanpages> [S<I<debhelper options>>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installmenu b/dh_installmenu
index bfddb16c..522f6269 100755
--- a/dh_installmenu
+++ b/dh_installmenu
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installmenu [debhelper options] [-n]
+B<dh_installmenu> [S<B<debhelper options>>] [B<-n>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installmime b/dh_installmime
index 9eeab7ba..c8a7e804 100755
--- a/dh_installmime
+++ b/dh_installmime
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installmime [debhelper options] [-n]
+B<dh_installmime> [S<I<debhelper options>>] [B<-n>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installmodules b/dh_installmodules
index f17780a3..a67b80a8 100755
--- a/dh_installmodules
+++ b/dh_installmodules
@@ -13,7 +13,7 @@ use File::Find;
 
 =head1 SYNOPSIS
 
-  dh_installmodules [debhelper options] [-n]
+B<dh_installmodules> [S<I<debhelper options>>] [B<-n>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installpam b/dh_installpam
index 527f7ced..065263d5 100755
--- a/dh_installpam
+++ b/dh_installpam
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installpam [debhelper options] [-n]
+B<dh_installpam> [S<I<debhelper options>>] [B<-n>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installwm b/dh_installwm
index 6199c0ac..11768563 100755
--- a/dh_installwm
+++ b/dh_installwm
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installwm [debhelper options] [-n] [--priority=n] [wm ...]
+B<dh_installwm> [S<I<debhelper options>>] [B<-n>] [B<--priority=>I<n>] [S<I<wm ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installxaw b/dh_installxaw
index 3bda1fa0..fed5f2d4 100755
--- a/dh_installxaw
+++ b/dh_installxaw
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installxaw [debhelper options] [-n]
+B<dh_installxaw> [S<I<debhelper options>>] [B<-n>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_installxfonts b/dh_installxfonts
index df85cec8..6c699611 100755
--- a/dh_installxfonts
+++ b/dh_installxfonts
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_installxfonts [debhelper options]
+B<dh_installxfonts> [S<I<debhelper options>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_link b/dh_link
index 8a2805ee..771eae0f 100755
--- a/dh_link
+++ b/dh_link
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_link [debhelper options] [-A] [source destination ...]
+B<dh_link> [S<I<debhelper options>>] [B<-A>] [S<I<source destination ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_listpackages b/dh_listpackages
index 846fa547..804461c5 100755
--- a/dh_listpackages
+++ b/dh_listpackages
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_listpackages [debhelper options]
+B<dh_listpackages> [S<I<debhelper options>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_makeshlibs b/dh_makeshlibs
index 01dd082f..8f0045a8 100755
--- a/dh_makeshlibs
+++ b/dh_makeshlibs
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_makeshlibs [debhelper options] [-mmajor] [-V[dependancies]] [-n] [-Xitem]
+B<dh_makeshlibs> [S<I<debhelper options>>] [B<-m>I<major>] [B<-V>I<[dependancies]>] [B<-n>] [B<-X>I<item>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_md5sums b/dh_md5sums
index 992de40d..ef8697cf 100755
--- a/dh_md5sums
+++ b/dh_md5sums
@@ -12,7 +12,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_md5sums [debhelper options] [-x] [-Xitem] [--include-conffiles]
+B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] [B<--include-conffiles>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_movefiles b/dh_movefiles
index afed17ca..cef89101 100755
--- a/dh_movefiles
+++ b/dh_movefiles
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_movefiles [debhelper options] [--sourcedir=dir] [file ...]
+B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] [S<I<file ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_perl b/dh_perl
index 4292029c..facad8d6 100755
--- a/dh_perl
+++ b/dh_perl
@@ -13,7 +13,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_perl [debhelper options] [-d] [library dirs ...]
+B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs ...>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_shlibdeps b/dh_shlibdeps
index 744aa5bf..b3648e51 100755
--- a/dh_shlibdeps
+++ b/dh_shlibdeps
@@ -12,7 +12,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_shlibdeps [debhelper options] [-ldirectory] [-Xitem] [-- params]
+B<dh_shlibdeps> [S<I<debhelper options>>] [B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_strip b/dh_strip
index a7052871..49f37230 100755
--- a/dh_strip
+++ b/dh_strip
@@ -12,7 +12,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_strip [debhelper options] [-Xitem]
+B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_suidregister b/dh_suidregister
index 64c98b73..05db06e1 100755
--- a/dh_suidregister
+++ b/dh_suidregister
@@ -6,7 +6,7 @@ dh_suidregister - obsolete suid registration program
 
 =head1 SYNOPSIS
 
-  Do not run
+Do not run!
 
 =head1 DESCRIPTION
 
diff --git a/dh_testdir b/dh_testdir
index 52cc1829..cb3acc7d 100755
--- a/dh_testdir
+++ b/dh_testdir
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
-  dh_testdir [debhelper options] [file ...]
+B<dh_testdir> [S<I<debhelper options>>] [S<I<file ...>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_testroot b/dh_testroot
index dc36c253..b97b13bb 100755
--- a/dh_testroot
+++ b/dh_testroot
@@ -6,7 +6,7 @@ dh_testroot - ensure that a package is built as root
 
 =head1 SYNOPSIS
 
-  dh_testroot [debhelper options]
+B<dh_testroot> [S<I<debhelper options>>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_testversion b/dh_testversion
index 93832c1b..b915dd14 100755
--- a/dh_testversion
+++ b/dh_testversion
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Version; # contains the version number of debhelper.
 
 =head1 SYNOPSIS
 
-  dh_testversion [debhelper options] [operator] [version]
+B<dh_testversion> [S<I<debhelper options>>] [I<operator>] [I<version>]
 
 =head1 DESCRIPTION
 
diff --git a/dh_undocumented b/dh_undocumented
index da96473e..7d98b207 100755
--- a/dh_undocumented
+++ b/dh_undocumented
@@ -11,7 +11,7 @@ use Debian::Debhelper::Dh_Lib;
 
 =head1 SYNOPSIS
 
- dh_undocumented [debhelper options] [-A] [manpage ...]
+B<dh_undocumented> [S<I<debhelper options>>] [B<-A>] [S<I<manpage ...>>]
 
 =head1 DESCRIPTION