--- a/stx_libview2.st	Fri Apr 23 15:10:02 2010 +0200
+++ b/stx_libview2.st	Fri Apr 23 15:10:08 2010 +0200
@@ -42,7 +42,7 @@
 !
 
 extensionsVersion_CVS
-    ^ '$Header: /cvs/stx/stx/libview2/stx_libview2.st,v 1.42 2009-11-24 18:06:45 stefan Exp $'
+    ^ '$Header: /cvs/stx/stx/libview2/stx_libview2.st,v 1.43 2010-04-23 13:10:08 stefan Exp $'
 !
 
 extensionsVersion_SVN
@@ -52,22 +52,32 @@
 !stx_libview2 class methodsFor:'description'!
 
 excludedFromPreRequisites
+    "list all packages which should be ignored in the automatic
+     preRequisites scan. See #preRequisites for more."
+
     ^ #(
-        #'stx:libhtml'    "HTMLDocumentView - referenced by ToolApplicationModel>>openHTMLDocument: "
+        #'stx:goodies/webServer'    "HTTPServer - referenced by ApplicationModel class>>startAsWebService:onPort: "
+        #'stx:libcompat'    "TextAttributes - referenced by WindowBuilder>>resolveFont: "
+        #'stx:libhtml'    "HTMLDocumentView - referenced by ApplicationModel>>openDocumentationFile: "
         #'stx:libtool'    "AboutBox - referenced by ToolApplicationModel class>>openAboutSTX "
         #'stx:libtool2'    "ResourceSelectionBrowser - referenced by ResourceSpecEditor>>doLoad "
-        #'stx:libui'    "CompositeSpec - referenced by UIBuilder>>newComposite "
-        #'stx:libwidg'    "PopUpMenu - referenced by Menu>>asOldStylePopUpMenuFor: "
+        #'stx:libui'    "UISpecification - referenced by UIBuilder>>buildWindowFromSpec: "
+        #'stx:libwidg'    "Button - referenced by WindowBuilder>>resolveFont: "
         #'stx:libwidg2'    "MenuPanel - referenced by Menu>>showCenteredIn: "
-        #'stx:libcompat'    "TextAttributes - referenced by WindowBuilder>>resolveFont: "
-        #'stx:goodies/webServer'    "HTTPServer - referenced by ApplicationModel class>>startAsWebService:onPort: "
     )
 !
 
 preRequisites
+    "list all required packages.
+     This list can be maintained manually or (better) generated and
+     updated by scanning the superclass hierarchies and looking for
+     global variable accesses. (the browser has a menu function for that)
+     Howevery, often too much is found, and you may want to explicitely
+     exclude individual packages in the #excludedFromPrerequisites method."
+
     ^ #(
-        #'stx:libbasic'    "Object - superclass of AlignmentOrigin "
-        #'stx:libbasic2'    "PrinterStream - superclass of WinPrinterStream "
+        #'stx:libbasic'    "Object - superclass of PrinterContext "
+        #'stx:libbasic2'    "List - referenced by WindowBuilder>>listAspectFor: "
         #'stx:libview'    "SimpleView - superclass of ApplicationWindow "
     )
 ! !
@@ -205,6 +215,11 @@
 !stx_libview2 class methodsFor:'description - contents'!
 
 classNamesAndAttributes
+    "lists the classes which are to be included in the project.
+     Each entry in the list may be: a single class-name (symbol),
+     or an array-literal consisting of class name and attributes.
+     Attributes are: #autoload or #<os> where os is one of win32, unix,..."
+
     ^ #(
         "<className> or (<className> attributes...) in load order"
         (AVIReader autoload)
@@ -224,6 +239,7 @@
         (DisplayTransform autoload)
         DragAndDropManager
         DragHandler
+        DrawAdaptor
         DropContext
         DropObject
         DropSource
@@ -232,14 +248,13 @@
         ExternalTopView
         (FLIReader autoload)
         (FaceReader autoload)
-        (StrokingOrFillingWrapper autoload)
         (FillingWrapper autoload)
         GIFReader
         (GeometricWrapper autoload)
         (HersheyFont autoload)
         Icon
-        (ImageFrame autoload)
-        (ImageSequence autoload)
+        ImageFrame
+        ImageSequence
         InputView
         (Insets autoload)
         (IrisRGBReader autoload)
@@ -257,6 +272,7 @@
         (PBMReader autoload)
         (PCXReader autoload)
         (PICTReader autoload)
+        PNGReader
         (PluggableView autoload)
         PopUpBanner
         PrintConverter
@@ -267,16 +283,17 @@
         (ST80FormReader autoload)
         (ScreenLock autoload)
         StandardSystemController
+        (StrokingOrFillingWrapper autoload)
         (StrokingWrapper autoload)
         (SunRasterReader autoload)
         TIFFReader
-        PNGReader
         (TargaReader autoload)
         (TranslatingWrapper autoload)
         TransparentBox
         (ViewForwardingController autoload)
-        VisualComponent
         VisualRegion
+        (WinPrinterContext win32)
+        (WinPrinterStream win32)
         WindowBuilder
         WindowsIconReader
         (Wrapper autoload)
@@ -290,7 +307,7 @@
         Plug
         UIBuilder
         ValueModel
-        VisualPart
+        VisualComponent
         AlignmentOrigin
         BlockValue
         FlyByHelp
@@ -301,7 +318,10 @@
         SimpleDialog
         ToolApplicationModel
         ValueHolder
+        VisualPart
         AspectAdaptor
+        BooleanBlockValue
+        BooleanValueHolder
         BufferedValueHolder
         DictionaryAdaptor
         RangeAdaptor
@@ -309,15 +329,13 @@
         TriggerValue
         TypeConverter
         ValueHolderWithWeakDependents
-        (WinPrinterStream win32)
-        (WinPrinterContext win32)
-        BooleanValueHolder
-        BooleanBlockValue
-        DrawAdaptor
     )
 !
 
 extensionMethodNames
+    "lists the extension methods which are to be included in the project.
+     Entries are 2-element array literals, consisting of class-name and selector."
+
     ^ #(
         CharacterArray asMimeType
     )
@@ -348,9 +366,9 @@
 !stx_libview2 class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libview2/stx_libview2.st,v 1.42 2009-11-24 18:06:45 stefan Exp $'
+    ^ '$Header: /cvs/stx/stx/libview2/stx_libview2.st,v 1.43 2010-04-23 13:10:08 stefan Exp $'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libview2/stx_libview2.st,v 1.42 2009-11-24 18:06:45 stefan Exp $'
+    ^ '$Header: /cvs/stx/stx/libview2/stx_libview2.st,v 1.43 2010-04-23 13:10:08 stefan Exp $'
 ! !