stx_libtool.st
changeset 15375 16cd14cdcc73
parent 15350 4437804fc062
child 15424 3715bc7817c6
--- a/stx_libtool.st	Mon Feb 23 15:26:45 2015 +0100
+++ b/stx_libtool.st	Mon Feb 23 15:26:46 2015 +0100
@@ -119,37 +119,39 @@
 !
 
 mandatoryPreRequisites
-    "list all required mandatory packages.
-     Packages are mandatory, if they contain superclasses of the package's classes
-     or classes which are extended by this package.
-     This list can be maintained manually or (better) generated and
-     updated by scanning the superclass hierarchies
-     (the browser has a menu function for that)"
+    "list packages which are mandatory as a prerequisite.
+     This are packages containing superclasses of my classes and classes which
+     are extended by myself.
+     They are mandatory, because we need these packages as a prerequisite for loading and compiling.
+     This method is generated automatically,
+     by searching along the inheritance chain of all of my classes."
 
     ^ #(
-        #'stx:goodies/refactoryBrowser/parser'    "RBProgramNodeVisitor - superclass of CodeGenerator "
-        #'stx:libbasic'    "AbstractTime - extended "
-        #'stx:libbasic2'    "Iterator - extended "
-        #'stx:libbasic3'    "Change - extended "
-        #'stx:libcomp'    "AbstractSyntaxHighlighter - extended "
-        #'stx:libui'    "ComponentSpec - superclass of EditFieldWithCompletionSpec "
-        #'stx:libview'    "Color - extended "
-        #'stx:libview2'    "ApplicationModel - superclass of AbstractDirectoryBrowser "
-        #'stx:libwidg'    "Button - superclass of ViewWithAcceptAndCancelBar::AcceptAndCancelBar::ButtonWithHelpText "
-        #'stx:libwidg2'    "ComboBoxView - superclass of FilenameEditFieldV2 "
+        #'stx:goodies/refactoryBrowser/parser'    "RBProgramNodeVisitor - superclass of CodeGenerator"
+        #'stx:libbasic'    "AbstractTime - extended"
+        #'stx:libbasic2'    "Iterator - extended"
+        #'stx:libbasic3'    "Change - extended"
+        #'stx:libcomp'    "AbstractSyntaxHighlighter - extended"
+        #'stx:libui'    "ComponentSpec - superclass of EditFieldWithCompletionSpec"
+        #'stx:libview'    "AbstractBackground - superclass of DiffTextView::DiffTextScrollerBackground"
+        #'stx:libview2'    "ApplicationModel - superclass of AbstractDirectoryBrowser"
+        #'stx:libwidg'    "Button - superclass of ViewWithAcceptAndCancelBar::AcceptAndCancelBar::ButtonWithHelpText"
+        #'stx:libwidg2'    "ComboBoxView - superclass of FilenameEditFieldV2"
     )
 !
 
 referencedPreRequisites
-    "list all packages containing classes referenced by the packages's members.
-     This list can be maintained manually or (better) generated and
-     updated by looking for global variable accesses
-     (the browser has a menu function for that)
-     However, often too much is found, and you may want to explicitely
-     exclude individual packages in the #excludedFromPreRequisites method."
+    "list packages which are a prerequisite, because they contain
+     classes which are referenced by my classes.
+     We do not need these packages as a prerequisite for compiling or loading,
+     however, a class from it may be referenced during execution and having it
+     unloaded then may lead to a runtime doesNotUnderstand error, unless the caller
+     includes explicit checks for the package being present.
+     This method is generated automatically,
+     by searching all classes (and their packages) which are referenced by my classes."
 
     ^ #(
-        #'stx:libwidg3'    "ClockView - referenced by WorkspaceApplication>>addStopWatch "
+        #'stx:libwidg3'    "ClockView - referenced by WorkspaceApplication>>addStopWatch"
     )
 !
 
@@ -229,7 +231,6 @@
         MemoryMonitorView
         MemoryUsageView
         MultiViewToolApplication
-        ParseTreeIndex
         PerforceSourceCodeManagerUtilities
         ProcessMonitorV2
         SyntaxElement
@@ -294,9 +295,7 @@
         AbstractFileFinderApplicationComponent
         AbstractSourceCodeManagementSettingsAppl
         BookmarkMenuBuilder
-        (ChangeSetBrowser autoload)
         ClassInspectorView
-        (ColorInspectorView autoload)
         ContextInspectorView
         DictionaryInspectorView
         Diff3ExclusiveVisitor
@@ -308,6 +307,7 @@
         ImageInspectorView
         NewLauncher
         OrderedCollectionInspectorView
+        ParseTreeIndex
         SetInspectorView
         SettingsDialog
         SmalltalkCodeGeneratorTool
@@ -374,6 +374,8 @@
         #'Tools::HierarchicalChangeList'
         #'Tools::HierarchicalPackageFilterList'
         #'Tools::InheritanceClassList'
+        (ChangeSetBrowser autoload)
+        (ColorInspectorView autoload)
         (NewChangesBrowser autoload)
         (XTermView autoload)
         (AbstractVersionDiffBrowserItem autoload)
@@ -420,8 +422,8 @@
 !
 
 extensionMethodNames
-    "lists the extension methods which are to be included in the project.
-     Entries are pairwise elements, consisting of class-name and selector."
+    "list class/selector pairs of extensions.
+     A correponding method with real names must be present in my concrete subclasses"
 
     ^ #(
         Breakpoint icon
@@ -635,10 +637,10 @@
 !stx_libtool class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libtool/stx_libtool.st,v 1.122 2015-02-21 11:49:46 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libtool/stx_libtool.st,v 1.123 2015-02-23 14:26:46 mb Exp $'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libtool/stx_libtool.st,v 1.122 2015-02-21 11:49:46 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libtool/stx_libtool.st,v 1.123 2015-02-23 14:26:46 mb Exp $'
 ! !