X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installemacsen;h=ee6421229ba27e1ccf5b0feb1bc0b9f1347d5206;hb=e2a6d4cec4a7ee952cf6a7f250d80f1d75a38f95;hp=b6b511ad6594fb6880994934fae499323d3c12b8;hpb=066f9dda63f48950863310a8e507adb397ae7e5a;p=debhelper.git

diff --git a/dh_installemacsen b/dh_installemacsen
index b6b511a..ee64212 100755
--- a/dh_installemacsen
+++ b/dh_installemacsen
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-dh_installemacsen - register an emacs add on package
+dh_installemacsen - register an Emacs add on package
 
 =cut
 
@@ -11,26 +11,39 @@ 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
 
-dh_installemacsen is a debhelper program that is responsible for installing
-files used by the debian emacsen-common package into package build
+B<dh_installemacsen> is a debhelper program that is responsible for installing
+files used by the Debian B<emacsen-common> package into package build
 directories.
 
-It also automatically generates the postinst and prerm commands needed to
-register a package as an emacs add on package. See L<dh_installdeb(1)>
+It also automatically generates the F<postinst> and F<prerm> commands needed to
+register a package as an Emacs add on package. The commands are added to
+the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)>
 for an explanation of how this works.
 
-If a file named debian/package.emacsen-install exists, then it is installed
-into
-usr/lib/emacsen-common/packages/install/package in the package build
-directory. Similarly, debian/package.emacsen-remove is installed into
-usr/lib/emacsen-common/packages/remove/package . And similarly,
-debian/package.emacsen-startup is installed into
-etc/emacs/site-start.d/50<package>.el (by default).
+=head1 FILES
+
+=over 4
+
+=item debian/I<package>.emacsen-install
+
+Installed into F<usr/lib/emacsen-common/packages/install/package> in the
+package build directory.
+
+=item debian/I<package>.emacsen-remove
+
+Installed into F<usr/lib/emacsen-common/packages/remove/package> in the
+package build directory.
+
+=item debian/I<package>.emacsen-startup
+
+Installed into etc/emacs/site-start.d/50I<package>.el in the package
+build directory. Use B<--priority> to use a different priority than 50.
+
+=back
 
 =head1 OPTIONS
 
@@ -38,28 +51,30 @@ etc/emacs/site-start.d/50<package>.el (by default).
 
 =item B<-n>, B<--noscripts>
 
-Do not modify postinst/prerm scripts.
+Do not modify F<postinst>/F<prerm> scripts.
 
 =item B<--priority=>I<n>
 
-Sets the priority number of a site-start.d file. Default is 50.
+Sets the priority number of a F<site-start.d> file. Default is 50.
 
 =item B<--flavor=>I<foo>
 
-Sets the flavor a site-start.d file will be installed in. Default is
-"emacs", alternatives include "xemacs" and "emacs20".
+Sets the flavor a F<site-start.d> file will be installed in. Default is
+B<emacs>, alternatives include B<xemacs> and B<emacs20>.
 
 =back
 
 =head1 NOTES
 
-Note that this command is not idempotent. "dh_clean -k" should be called
+Note that this command is not idempotent. L<dh_prep(1)> should be called
 between invocations of this command. Otherwise, it may cause multiple
 instances of the same text to be added to maintainer scripts.
 
 =cut
 
-init();
+init(options => {
+	"flavor=s" => \$dh{FLAVOR},
+});
 
 if (! defined $dh{PRIORITY}) {
 	$dh{PRIORITY}=50;
@@ -108,7 +123,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 
 =head1 SEE ALSO
 
-L<debhelper(1)>
+L<debhelper(7)>
 
 This program is a part of debhelper.