xmlreaderimpl/stx_goodies_xmlsuite_xmlreaderimpl.st
changeset 300 b6d834208d33
parent 296 ea3dbc023c80
--- a/xmlreaderimpl/stx_goodies_xmlsuite_xmlreaderimpl.st	Mon Jan 25 16:38:30 2016 +0000
+++ b/xmlreaderimpl/stx_goodies_xmlsuite_xmlreaderimpl.st	Tue Feb 02 21:49:24 2016 +0000
@@ -1,5 +1,7 @@
 "{ Package: 'stx:goodies/xmlsuite/xmlreaderimpl' }"
 
+"{ NameSpace: Smalltalk }"
+
 LibraryDefinition subclass:#stx_goodies_xmlsuite_xmlreaderimpl
 	instanceVariableNames:''
 	classVariableNames:''
@@ -10,19 +12,27 @@
 
 !stx_goodies_xmlsuite_xmlreaderimpl class methodsFor:'description'!
 
-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)
-     However, often too much is found, and you may want to explicitely
-     exclude individual packages in the #excludedFromPreRequisites method."
+excludedFromPreRequisites
+    "list packages which are to be explicitely excluded from the automatic constructed
+     prerequisites list. If empty, everything that is found along the inheritance of any of
+     my classes is considered to be a prerequisite package."
 
     ^ #(
-        #'stx:goodies/xmlsuite/core'    "XMLv2::XMLReader - superclass of XMLv2::ExpatXMLReader "
-        #'stx:libbasic'    "Autoload - superclass of XMLv2::VWSAXBuilder "
+    )
+!
+
+mandatoryPreRequisites
+    "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/xml/vw'    "XML::NodeBuilder - superclass of XMLv2::VWSAXBuilder"
+        #'stx:goodies/xmlsuite/core'    "XMLv2::XMLReader - superclass of XMLv2::VWXMLReader"
+        #'stx:libbasic'    "LibraryDefinition - superclass of stx_goodies_xmlsuite_xmlreaderimpl"
     )
 !
 
@@ -60,105 +70,28 @@
 	"
 !
 
-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:goodies/xml/vw'    "XML::XMLParser - superclass of XMLv2::VWXMLReader::XMLParser "
-        #'stx:goodies/xmlsuite/core'    "XMLv2::XMLReader - superclass of XMLv2::ExpatXMLReader "
-        #'stx:libbasic'    "Object - superclass of XMLv2::VWXMLReader "
-        #'stx:libcomp'
-    )
-!
-
 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_goodies_xmlsuite_xmlreaderimpl class methodsFor:'description - compilation'!
-
-additionalLinkLibraries_bc_dot_mak
-    "allows for additional static libraries to be added to the bc.mak file.
-     Subclasses may redefine this"
-
-    "backward compatibilty with old projects"
-
-    ^'"support/expat-2.0.1/bcb5/release/libexpats_mtd.lib"'
-
-    "Created: / 09-01-2010 / 14:01:54 / Jan Vrany <jan.vrany@fit.cvut.cz>"
-!
-
-additionalLinkLibraries_make_dot_proto
-    "allows for additional static libraries to be added to the make.proto file."
-
-    ^ 'support/expat-2.0.1/build/lib/libexpat.a'
-
-    "Created: / 22-08-2006 / 23:53:33 / cg"
-!
-
-additionalRules_bc_dot_mak
-    "obsolete - kept for compatibility with old project files"
-    
-    ^ '
-support/expat-2.0.1/bcb5/release/libexpats_mtd.lib:
-        cd support/expat-2.0.1/bcb5
-        $(MAKE)
-        cd ..\..\..
-'
-
-    "Created: / 09-01-2010 / 14:03:20 / Jan Vrany <jan.vrany@fit.cvut.cz>"
-    "Modified: / 22-04-2013 / 16:38:27 / Jan Vrany <jan.vrany@fit.cvut.cz>"
 !
 
-additionalRules_make_dot_proto
-    "allows for additional rules to be added to the make.proto file."
-
-    ^ '
-support/expat-2.0.1/build/lib/libexpat.a:
-        mkdir support/expat-2.0.1/build && cd support/expat-2.0.1/build && CFLAGS=-m32 ../configure --prefix=$$PWD
-        $(MAKE) -C support/expat-2.0.1/build
-        $(MAKE) -C support/expat-2.0.1/build install
-'
-
-    "Created: / 22-08-2006 / 23:59:16 / cg"
-    "Modified: / 22-04-2013 / 16:38:40 / Jan Vrany <jan.vrany@fit.cvut.cz>"
-!
+subProjects
+    "list packages which are known as subprojects.
+     The generated makefile will enter those and make there as well.
+     However: they are not forced to be loaded when a package is loaded;
+     for those, redefine requiredPrerequisites."
 
-additionalTargets_bc_dot_mak
-    "obsolete - kept for compatibility with old project files"
-    
-    ^ 'support/expat-2.0.1/bcb5/release/libexpats_mtd.lib'
-
-    "Created: / 09-01-2010 / 14:02:14 / Jan Vrany <jan.vrany@fit.cvut.cz>"
-!
-
-additionalTargets_make_dot_proto
-    "allows for additional targets to be added to the make.proto file."
-
-    ^ 'support/expat-2.0.1/build/lib/libexpat.a'
-
-    "Created: / 22-08-2006 / 23:53:33 / cg"
-!
-
-localIncludes
-    "allow for the specification of additional include directories"
-
-    ^ '-Isupport/expat-2.0.1/lib'
-
-    "Created: / 09-01-2010 / 14:03:34 / Jan Vrany <jan.vrany@fit.cvut.cz>"
+    ^ #(
+    )
 ! !
 
 !stx_goodies_xmlsuite_xmlreaderimpl class methodsFor:'description - contents'!
@@ -171,16 +104,15 @@
 
     ^ #(
         "<className> or (<className> attributes...) in load order"
-        #'XMLv2::ExpatXMLReader'
-        (#'XMLv2::VWSAXBuilder' autoload)
-        (#'XMLv2::VWXMLReader' autoload)
+        #'XMLv2::VWSAXBuilder'
+        #'XMLv2::VWXMLReader'
         #'stx_goodies_xmlsuite_xmlreaderimpl'
     )
 !
 
 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."
+    "list class/selector pairs of extensions.
+     A correponding method with real names must be present in my concrete subclasses"
 
     ^ #(
     )
@@ -236,6 +168,10 @@
     ^'$Id$'
 !
 
+version_HG
+    ^ '$Changeset: <not expanded> $'
+!
+
 version_SVN
     ^ '$Id$'
 ! !