dh_icons: Improve documentation. Closes: #684895

diff --git a/debian/changelog b/debian/changelog
index e397be9c28d7013178e613dc79521ef12d40c80a..dd7b9a12b5a7785a466d6e33ab2b1c546d4ecc39 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -10,6 +10,7 @@ debhelper (9.20120609) UNRELEASED; urgency=low
     Thanks, Charles Plessy
   * python distutils buildsystem: Propigate failure of pyversions.
     Closes: #683551 Thanks, Clint Byrum
+  * dh_icons: Improve documentation. Closes: #684895
 
  -- Joey Hess <joeyh@debian.org>  Thu, 05 Jul 2012 08:51:07 -0600
 

diff --git a/dh_icons b/dh_icons
index 3ac091afb4d4f7f4b3fe0f91cf703c23cd288db1..05d63d1f953e2a5199cad8e7b3a4a68da205b29f 100755 (executable)
--- a/dh_icons
+++ b/dh_icons
@@ -19,8 +19,13 @@ B<dh_icons> [S<I<debhelper options>>] [B<-n>]
 B<dh_icons> is a debhelper program that updates Freedesktop icon caches
 when needed, using the B<update-icon-caches> program provided by GTK+2.12.
 Currently this program does not handle installation of the files, though it
-may do so at a later date. It takes care of adding maintainer script
-fragments to call B<update-icon-caches>.
+may do so at a later date, so should be run after icons are installed in
+the package build directories. 
+
+It takes care of adding maintainer script fragments to call
+B<update-icon-caches> for icon directories. (This is not done for gnome and
+hicolor icons, as those are handled by triggers.)
+These commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
 
 =head1 OPTIONS