common/stx_libscm_common.st
changeset 903 3c6c268d7395
parent 864 c854577212b8
child 909 993b38cb97dd
--- a/common/stx_libscm_common.st	Tue Nov 19 13:29:27 2019 +0000
+++ b/common/stx_libscm_common.st	Wed May 27 13:37:06 2020 +0100
@@ -1,8 +1,8 @@
-"{ Encoding: utf8 }"
-
 "
 stx:libscm - a new source code management library for Smalltalk/X
 Copyright (C) 2012-2015 Jan Vrany
+Copyright (C) 2020 Jan Vrany
+Copyright (C) 2020 LabWare
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -20,6 +20,8 @@
 "
 "{ Package: 'stx:libscm/common' }"
 
+"{ NameSpace: Smalltalk }"
+
 LibraryDefinition subclass:#stx_libscm_common
 	instanceVariableNames:''
 	classVariableNames:''
@@ -33,6 +35,8 @@
 "
 stx:libscm - a new source code management library for Smalltalk/X
 Copyright (C) 2012-2015 Jan Vrany
+Copyright (C) 2020 Jan Vrany
+Copyright (C) 2020 LabWare
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -78,14 +82,15 @@
     "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, beacuse we need these packages as a prerequisite for loading and compiling.
+     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."
+     by searching along the inheritance chain of all of my classes.
+     Please take a look at the #referencedPreRequisites method as well."
 
     ^ #(
-        #'stx:libbasic'    "Collection - extended "
-        #'stx:libbasic3'    "AbstractSourceCodeManager - superclass of SCMAbstractSourceCodeManager "
-        #'stx:libview2'    "ApplicationModel - superclass of SCMAbstractCommitDialog "
+        #'stx:libbasic'    "Behavior - extended"
+        #'stx:libbasic3'    "AbstractSourceCodeManager - superclass of SCMAbstractSourceCodeManager"
+        #'stx:libview2'    "ApplicationModel - superclass of SCMAbstractCommitDialog"
     )
 !
 
@@ -111,17 +116,21 @@
 referencedPreRequisites
     "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 loading or compiling.
+     These packages are NOT needed 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."
+     by searching all classes (and their packages) which are referenced by my classes.
+     Please also take a look at the #mandatoryPreRequisites method"
 
     ^ #(
-        #'stx:libjava'    "JavaVM - referenced by SCMAbstractFileoutLikeTask>>doRemoveOldContainersFor: "
-        #'stx:libscm/mercurial'    "HGError - referenced by SCMAbstractPackageRevision>>childNamed: "
-        #'stx:libtool'    "Tools::ChangeSetDiffTool - referenced by SCMCommonSourceCodeManagerUtilities>>compareProject:withRepositoryVersionFrom: "
-        #'stx:libview'    "Color - referenced by SCMAbstractCommitDialog>>browseWorkingCopyLabel "
-        #'stx:libwidg'    "Button - referenced by SCMAbstractCommitDialog>>doRunSanityChecks "
-        #'stx:libwidg2'    "ProgressNotification - referenced by SCMAbstractFileoutLikeTask>>doCompileCopyrightMethodsFor: "
+        #'stx:libjava'    "JavaVM - referenced by SCMAbstractFileoutLikeTask>>doRemoveOldContainersFor:"
+        #'stx:libscm/mercurial'    "HGError - referenced by SCMAbstractPackageRevision>>childNamed:"
+        #'stx:libtool'    "Tools::ChangeSetDiffTool - referenced by SCMCommonSourceCodeManagerUtilities>>compareProject:withRepositoryVersionFrom:extensionsOnly:"
+        #'stx:libview'    "Color - referenced by SCMAbstractCommitDialog>>browseWorkingCopyLabel"
+        #'stx:libwidg'    "Button - referenced by SCMAbstractCommitDialog>>doRunSanityChecks"
+        #'stx:libwidg2'    "ProgressNotification - referenced by SCMAbstractFileoutLikeTask>>doCompileCopyrightMethodsFor:"
     )
 !
 
@@ -155,6 +164,8 @@
         SCMCommonPackageModelGroup
         SCMCommonSourceCodeManagerUtilities
         SCMCompatModeQuery
+        SCMCopyrightLine
+        SCMCopyrightUpdater
         SCMError
         SCMWarning
         #'stx_libscm_common'
@@ -169,11 +180,16 @@
 !
 
 extensionMethodNames
-    "list class/selector pairs of extensions.
-     A correponding method with real names must be present in my concrete subclasses"
+    "lists the extension methods which are to be included in the project.
+     Entries are 2-element array literals, consisting of class-name and selector.
+     A correponding method with real names must be present in my concrete subclasses
+     if it has extensions."
 
     ^ #(
         ChangeSet condenseChangesForPackageAfterCommit:
+        Class copyrightMethodSource
+        UserPreferences historyManagerCopyrightHolder
+        UserPreferences historyManagerCopyrightHolder:
     )
 ! !
 
@@ -269,7 +285,7 @@
 !
 
 version_SVN
-    ^ '§Id::                                                                                                                        §'
+    ^ '§Id::                                                                                                                        §'
 ! !