=head1 DESCRIPTION
-dh_installmime is a debhelper program that is responsible for installing
+B<dh_installmime> is a debhelper program that is responsible for installing
mime files into package build directories.
-It also automatically generates the postinst and postrm commands needed to
-interface with the debian mime-support and shared-mime-info packages. These
-commands are inserted into the maintainer scripts by dh_installdeb. See
-L<dh_installdeb(1)> for an explanation of how this works.
+It also automatically generates the F<postinst> and F<postrm> commands needed to
+interface with the debian B<mime-support> and B<shared-mime-info> packages. These
+commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
-If files named debian/package.mime or debian/package.sharedmimeinfo exist, then
-they are installed into usr/lib/mime/packages/package and
-/usr/share/mime/packages/package.xml (respectively) in the package build
+=head1 FILES
+
+=over 4
+
+=item debian/I<package>.mime
+
+Installed into usr/lib/mime/packages/I<package> in the package build
directory.
+=item debian/I<package>.sharedmimeinfo
+
+Installed into /usr/share/mime/packages/I<package>.xml in the package build
+directory.
+
+=back
+
=head1 OPTIONS
=over 4
=item B<-n>, B<--noscripts>
-Do not modify postinst/postrm scripts.
+Do not modify F<postinst>/F<postrm> scripts.
=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.