diff --git a/data/trident/cities.spec b/data/trident/cities.spec
@@ -15,6 +15,13 @@
 ; The maximum number of images is only limited by the maximum size of a city
 ; (currently MAX_CITY_SIZE = 255).
 ;
+; For providing custom citizen icons for the city style, use tags of the form
+; 'citizen.<tag>.<citizen_type>_<index>'
+; where <tag> is citizens_graphic tag from the styles.ruleset,
+; <citizen_type> is type like 'content', same ones as
+; misc/small.spec has for the default citizen icons, and
+; <index> is a running number for alternative sprites.
+;
 
 [spec]
 

diff --git a/data/webperimental/styles.ruleset b/data/webperimental/styles.ruleset
@@ -57,7 +57,6 @@ name = _("?style:Celtic")
 ;                    more info on city tiles
 ; citizens_graphic = group of citizens tiles to use, see citizens/small
 ;                    spec for more info on citizens tiles
-;                    FIXME: this is currently not used!
 ; reqs             = requirements for this city style (see README.effects)
 ;
 ; */ <-- avoid gettext warnings