Add FILES sections to man pages. Closes: #545041

1 files changed, 29 insertions, 18 deletions

diff --git a/dh_installdeb b/dh_installdeb
index 93198ae5..386640b7 100755
--- a/dh_installdeb
+++ b/dh_installdeb
@@ -19,27 +19,38 @@ dh_installdeb is a debhelper program that is responsible for installing
 files into the DEBIAN directories in package build directories with the
 correct permissions.
 
-dh_installdeb automatically installs the following files from debian/ into
-the DEBIAN directory:
-  package.postinst
-  package.preinst
-  package.postrm
-  package.prerm
-  package.shlibs
-  package.conffiles
-  package.triggers
-
-The postinst, preinst, postrm, and prerm are handled specially: If a
-corresponding file named debian/package.script.debhelper exists, the contents
-of that file are merged into the script as follows: If the script exists,
-then anywhere in it that "#DEBHELPER#" appears, the text of the .debhelper
-file is inserted. If the script does not exist, then a script is generated
-from the .debhelper file. The .debhelper files are created by other debhelper
-programs, such as L<dh_installmenu(1)>, and are shell script fragments.
+=head1 FILES
+
+=over 4
+
+=item I<package>.postinst
+
+=item I<package>.preinst
+
+=item I<package>.postrm
+
+=item I<package>.prerm
+
+These maintainer scripts are installed into the DEBIAN directory.
+
+Inside the scripts, the token B<#DEBHELPER#> is replaced with
+shell script snippets generated by other debhelper commands.
+
+=item I<package>.triggers
+
+=item I<package>.shlibs
+
+These control files are installed into the DEBIAN directory.
+
+=item I<package>.conffiles
+
+This control file will be installed into the DEBIAN directory.
 
 In V3 compatibility mode and higher, all files in the etc/ directory in a
 package will automatically be flagged as conffiles by this program, so
-there is no need to list them manually in package.conffiles.
+there is no need to list them manually here.
+
+=back
 
 =cut