=head1 NAME
-dh_installemacsen - register an emacs add on package
+dh_installemacsen - register an Emacs add on package
=cut
=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. The commands are added to
-the maintainer scripts by dh_installdeb. 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
=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
=cut
-init();
+init(options => {
+ "flavor=s" => \$dh{FLAVOR},
+});
if (! defined $dh{PRIORITY}) {
$dh{PRIORITY}=50;