--- a/GenericToolbarIconLibrary.st	Tue Nov 10 17:33:39 2009 +0100
+++ b/GenericToolbarIconLibrary.st	Wed Nov 11 11:52:39 2009 +0100
@@ -39,12 +39,21 @@
     A common place to keep commonly used icons.
     (also: VW compatibility)
 
+    Every method found here returns as value an image instance, which can be
+    directly used for labels, menus, etc.
+    The use of external files for bitmap images is no longer considered good style,
+    and all uses of them within st/x are replaced by internal icons over the time.
+    (the reason is that it makes packaging, deployment etc. much easier. Also,
+    systems which have a poor disk performance for small files (aka Windows) suffer from
+    accessing many small bitmap files. So performance is improved there).
+
     Notice: now, ToolbarIconLibrary is a reference to the actual IconLibrary,
     which will refer to either this class (GenericToolbarIconLibrary) or
     one of its subclasses (especially: XPToolbarIconLibrary).
 
-    The iconLibrary class is specified in the styleSheet (see mswindowsXP.style
-    as an example).
+    The choice of which concrete iconLibrary class is actually used 
+    is done in the styleSheet, where the global variable ToolbarIconLibrary
+    is set (see mswindowsXP.style as an example).
 "
 ! !
 
@@ -8014,11 +8023,11 @@
 !GenericToolbarIconLibrary class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libwidg/GenericToolbarIconLibrary.st,v 1.110 2009-11-07 20:24:00 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libwidg/GenericToolbarIconLibrary.st,v 1.111 2009-11-11 10:52:39 cg Exp $'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libwidg/GenericToolbarIconLibrary.st,v 1.110 2009-11-07 20:24:00 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libwidg/GenericToolbarIconLibrary.st,v 1.111 2009-11-11 10:52:39 cg Exp $'
 ! !
 
 GenericToolbarIconLibrary initialize!