dh_icons: Improve documentation. Closes: #684895

1 files changed, 7 insertions, 2 deletions

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