Add FILES sections to man pages. Closes: #545041

[debhelper.git] / dh_installdebconf

diff --git a/dh_installdebconf b/dh_installdebconf
index f12c7dad9d4e351e6d6515c7d037d69caf198846..ff49f8ea132bdf9f603df60425c819e12d8cb1b1 100755 (executable)
--- a/dh_installdebconf
+++ b/dh_installdebconf
@@ -16,36 +16,47 @@ B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]
 =head1 DESCRIPTION
 
 dh_installdebconf is a debhelper program that is responsible for installing
-files used by the debconf package into package build directories.
+files used by debconf into package build directories.
 
 It also automatically generates the postrm commands needed to interface
 with debconf. The commands are added to the maintainer scripts by
 dh_installdeb. See L<dh_installdeb(1)> for an explanation of how that
 works.
 
-Files named debian/package.config and debian/package.templates are
-installed into the DEBIAN directory in the package build directory.
-If a file named debian/package.config.debhelper exists, the contents
-of that file are merged into the config 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 may be created 
-by other debhelper programs, and are shell script fragments.
-
 Note that if you use debconf, your package probably needs to depend on it
 (it will be added to ${misc:Depends} by this program).
 
 Note that for your config script to be called by dpkg, your postinst
 needs to source debconf's confmodule. dh_installdebconf does not
-install this statement into postinst automatically as it it too hard to
-do it right.
+install this statement into the postinst automatically as it it too
+hard to do it right.
+
+=head1 FILES
+
+=over 4
+
+=item debian/I<package>.config
+
+This is the debconf config script, and is installed into the DEBIAN
+directory in the package build directory.
 
-=head1 LOCALIZED TEMPLATE FILES
+Inside the script, the token B<#DEBHELPER#> is replaced with
+shell script snippets generated by other debhelper commands.
 
-This program will look to see if you have a debian/po directory and if so
-will automatically call L<po2debconf(1)> to generate a merged templates
-file containing the translations. For this to work, your package should
-build-depend on po-debconf.
+=item debian/I<package>.templates
+
+This is the debconf templates file, and is installed into the DEBIAN
+directory in the package build directory.
+
+=item debian/po/
+
+If this directory is present, this program will automatically use
+L<po2debconf(1)> to generate merged templates
+files that include the translations from there.
+
+For this to work, your package should build-depend on po-debconf.
+
+=back
 
 =head1 OPTIONS