dh_icons: Improve documentation. Closes: #684895

2 files changed, 8 insertions, 2 deletions

diff --git a/debian/changelog b/debian/changelog
index e397be9c..dd7b9a12 100644
--- 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 3ac091af..05d63d1f 100755
--- 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