X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installmime;h=998d6bad33d6c7f99a713b1cb003fa42143f923d;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hp=42f2f823eea83a5c77257bb743b8362950c886e1;hpb=982e8935d2259eacf196e2b8d3364d0286e953ca;p=debhelper.git

diff --git a/dh_installmime b/dh_installmime
index 42f2f82..998d6ba 100755
--- a/dh_installmime
+++ b/dh_installmime
@@ -15,31 +15,42 @@ B<dh_installmime> [S<I<debhelper options>>] [B<-n>]
 
 =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.  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.
 
@@ -57,7 +68,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 		}
 		doit("install","-p","-m644",$mime,"$tmp/usr/lib/mime/packages/$package");
 	}
-	# Check wether we have to call update-mime (either upstream already
+	# Check whether we have to call update-mime (either upstream already
 	# installs a MIME information file or Debian provides one)
 	if ((! $dh{NOSCRIPTS}) && (-d "$tmp/usr/lib/mime/packages")) {
 		autoscript($package,"postinst","postinst-mime");
@@ -72,7 +83,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 		}
 		doit("install", "-p", "-m644", $sharedmimeinfo, "$tmp/usr/share/mime/packages/$package.xml");
 	}
-	# check wether we have to call update-mime-database (either upstream
+	# check whether we have to call update-mime-database (either upstream
 	# already installs a shared MIME information file or Debian provides
 	# one)
 	if ((! $dh{NOSCRIPTS}) && (-d "$tmp/usr/share/mime/packages")) {