"{ Encoding: utf8 }"

"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libbasic' }"

"{ NameSpace: Smalltalk }"

Behavior subclass:#ClassDescription

	instanceVariableNames:'instvars'

	classVariableNames:'CatchClassRedefinitions CatchMethodRedefinitions

		ChangeDefaultApplicationNotificationSignal ChangeFileAccessLock

		ClassCategoryQuerySignal

		ClassConventionViolationConfirmationQuerySignal

		CreateNameSpaceQuerySignal DefaultApplicationQuerySignal

		FileOutErrorSignal FileOutNameSpaceQuerySignal

		ForceNoNameSpaceQuerySignal LockChangesFile MethodHistory

		MethodHistorySize NameSpaceQuerySignal PackageQuerySignal

		TryLocalSourceFirst UpdateChangeFileQuerySignal

		UpdateChangeListQuerySignal UpdateHistoryLineQuerySignal

		UpdatingChanges UsedNameSpaceQuerySignal'

	poolDictionaries:''

	category:'Kernel-Classes'

!

Notification subclass:#PackageRedefinition

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:ClassDescription

!

ClassDescription::PackageRedefinition subclass:#MethodRedefinitionNotification

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:ClassDescription

!

ClassDescription::PackageRedefinition subclass:#ClassRedefinitionNotification

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:ClassDescription

!

!ClassDescription class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    ClassDescription conceptually adds some descriptive information to the basic

    Behavior class. It is an abstract class used as a common superclass

    for Metaclass and Class.

    Subclasses must define the #name, #category and #comment methods.

    [Instance variables:]

	instvars        <String>        the names of the instance variables

			| <Collection of words>

    [Class variables:]

	UpdatingChanges <Boolean>       true if the changes-file shall be updated

					(except during startup and when filing in, this flag

					 is usually true)

					Please do no longer use this - see the two queries

					below.

	UpdateChangeFileQuerySignal     used as an upQuery from the change management.

					Whenever a changeRecord is to be written,

					this signal is raised and a handler (if present)

					is supposed to return true or false.

					If unhandled, the value of the global

					UpdatingChanges is returned for backward

					compatibility (which means that the old

					mechanism is used if no query-handler

					is present).

	UpdateChangeListQuerySignal     used as an upQuery from the change management.

					Whenever a change is to be added to the changeSet,

					this signal is raised and a handler (if present)

					is supposed to return true or false.

					If unhandled, the value of the global

					UpdatingChanges is returned for backward

					compatibility (which means that the old

					mechanism is used if no query-handler

					is present).

	LockChangesFile <Boolean>       if true, the change file is locked for updates.

					Required when multiple users operate on a common

					change file.

					This is an experimental new feature, being evaluated.

	FileOutErrorSignal              raised when an error occurs during fileOut

	CatchMethodRedefinitions        if true, classes protect themself

	MethodRedefinitionSignal        (by raising MethodRedefinitionSignal)

					from redefining any existing methods,

					which are defined in another package.

					(i.e. a signal will be raised, if you

					 fileIn something which redefines an

					 existing method and the packages do not

					 match).

					The default is (currently) true.

	TryLocalSourceFirst             If true, local source files are tried

					first BEFORE the sourceCodeManager is

					consulted. If false, the sourceCodeManager

					is asked first.

					Should be turned on, if you run an image from

					local sources which have not yet been checked in.

	NameSpaceQuerySignal            used as an upQuery to ask for a namespace into

					which new classes are to be installed.

	PackageQuerySignal              used as an upQuery to ask for a packageSymbol with

					which new classes/methods are to be marked.

	CreateNameSpaceQuerySignal      used as an upQuery to ask if unknown namespaces

					should be silently created (without asking the user)

	MethodHistory                   if nonNil, this must be an OrderedCollection,

					which is filled with method->previousversionMethod

					associations. Can be used for undo-last-method-change

					The number of remembered methods is controlled via the

					UserPreferences.

					Notice: this may fillup your memory over time,

					the preferences are set too high.

	MethodHistorySize               the size of the methodHistory

					(nil: unlimited)

    [author:]

	Claus Gittinger

    [see also:]

	Behavior Class Metaclass

"

! !

!ClassDescription class methodsFor:'initialization'!

initialize

    "the classvariable 'UpdatingChanges' controls if changes are put

     into the changes-file; normally this variable is set to true, but

     (for example) during fileIn or when changes are applied, it is set to false

     to avoid putting too much junk into the changes-file."

    UpdatingChanges := true.

    LockChangesFile := false.

    CatchMethodRedefinitions := CatchClassRedefinitions := true.

    TryLocalSourceFirst := false.

    FileOutErrorSignal isNil ifTrue:[

        FileOutErrorSignal := Error newSignalMayProceed:true.

        FileOutErrorSignal nameClass:self message:#fileOutErrorSignal.

        FileOutErrorSignal notifierString:'error during fileOut'.

"/        MethodRedefinitionSignal := QuerySignal new.

"/        MethodRedefinitionSignal nameClass:self message:#methodRedefinitionSignal.

"/        MethodRedefinitionSignal notifierString:'attempt to redefine method from different package'.

"/        MethodRedefinitionSignal defaultAnswer:#keep.

"/        ClassRedefinitionSignal := QuerySignal new.

"/        ClassRedefinitionSignal nameClass:self message:#classRedefinitionSignal.

"/        ClassRedefinitionSignal notifierString:'attempt to redefine class from different package'.

"/        ClassRedefinitionSignal defaultAnswer:#keep.

        UpdateHistoryLineQuerySignal := QuerySignal new.

        UpdateHistoryLineQuerySignal nameClass:self message:#updateHistoryLineQuerySignal.

        UpdateHistoryLineQuerySignal notifierString:'asking if history line update in method is wanted'.

        UpdateHistoryLineQuerySignal handlerBlock:[:ex | ex proceedWith:false].

        UpdateChangeFileQuerySignal := QuerySignal new.

        UpdateChangeFileQuerySignal nameClass:self message:#updateChangeFileQuerySignal.

        UpdateChangeFileQuerySignal notifierString:'asking if changeFile update is wanted'.

        UpdateChangeFileQuerySignal handlerBlock:[:ex | ex proceedWith:UpdatingChanges].

        UpdateChangeListQuerySignal := QuerySignal new.

        UpdateChangeListQuerySignal nameClass:self message:#updateChangeListQuerySignal.

        UpdateChangeListQuerySignal notifierString:'asking if changeList update is wanted'.

        UpdateChangeListQuerySignal handlerBlock:[:ex | ex proceedWith:UpdatingChanges].

        NameSpaceQuerySignal isNil ifTrue:[

            "This could be used BEFORE initialize has been invoked - that's why we initialize

             the class var there."

            NameSpaceQuerySignal := self nameSpaceQuerySignal

        ].

        UsedNameSpaceQuerySignal isNil ifTrue:[

            "This could be used BEFORE initialize has been invoked - that's why we initialize

             the class var there."

            UsedNameSpaceQuerySignal := self usedNameSpaceQuerySignal.

        ].

        CreateNameSpaceQuerySignal := QuerySignal new.

        CreateNameSpaceQuerySignal nameClass:self message:#createNameSpaceQuerySignal.

        CreateNameSpaceQuerySignal notifierString:'asking for nameSpace creation'.

        CreateNameSpaceQuerySignal defaultAnswer:false.

        ClassConventionViolationConfirmationQuerySignal := QuerySignal new.

        ClassConventionViolationConfirmationQuerySignal nameClass:self message:#classConventionViolationConfirmationQuerySignal.

        ClassConventionViolationConfirmationQuerySignal notifierString:'asking for class convention'.

        PackageQuerySignal := QuerySignal new.

        PackageQuerySignal nameClass:self message:#packageQuerySignal.

        PackageQuerySignal notifierString:'asking for package'.

        PackageQuerySignal handlerBlock:[:ex | ex proceedWith:(Project isNil

                                                                    ifTrue:[

                                                                        nil

                                                                    ] ifFalse:[

                                                                        Project currentPackageName

                                                                    ])].

        ClassCategoryQuerySignal := QuerySignal new.

        ClassCategoryQuerySignal nameClass:self message:#classCategoryQuerySignal.

        ClassCategoryQuerySignal notifierString:'asking for category'.

        ClassCategoryQuerySignal handlerBlock:[:ex | ex proceedWith:'* as yet unspecified *'].

        FileOutNameSpaceQuerySignal := QuerySignal new.

        FileOutNameSpaceQuerySignal defaultAnswer:false.

        ForceNoNameSpaceQuerySignal := QuerySignal new.

        ForceNoNameSpaceQuerySignal defaultAnswer:false.

        ChangeFileAccessLock := RecursionLock new.

        ChangeFileAccessLock name:'ChangeFileAccessLock'.

    ].

    DefaultApplicationQuerySignal isNil ifTrue:[

        DefaultApplicationQuerySignal := QuerySignal new defaultAnswer:nil.

        DefaultApplicationQuerySignal nameClass:self message:#defaultApplicationQuerySignal.

        DefaultApplicationQuerySignal notifierString:'query for default application'.

        ChangeDefaultApplicationNotificationSignal := QuerySignal new defaultAnswer:nil.

        ChangeDefaultApplicationNotificationSignal nameClass:self message:#changeDefaultApplicationNotificationSignal.

        ChangeDefaultApplicationNotificationSignal notifierString:'change default application'.

    ].

    "

     ClassDescription initialize

    "

    "Created: / 02-04-1997 / 17:27:40 / stefan"

    "Modified: / 17-03-1999 / 16:52:41 / stefan"

    "Modified: / 17-08-2006 / 14:04:17 / cg"

    "Modified (format): / 12-06-2017 / 20:58:10 / cg"

! !

!ClassDescription class methodsFor:'Signal constants'!

changeDefaultApplicationNotificationSignal

    "return the signal used as an up-Info to change the current application to which

     new classes/methods will be added.

     Will is only used when filing in V'Age code"

    ^ ChangeDefaultApplicationNotificationSignal

    "

     Transcript showCR:Class changeDefaultApplicationNotificationSignal raise

    "

    "Modified: / 5.11.1996 / 20:08:38 / cg"

    "Created: / 15.6.1998 / 18:29:57 / cg"

!

classCategoryQuerySignal

    "return the signal used as an upQuery for the current class category name.

     Will be used when defining a class without a proper classCategory information

     (JS or Ruby classes). The browser will answer with the currently selected category then."

    ^ ClassCategoryQuerySignal

    "

     Transcript showCR:Class classCategoryQuerySignal raise

    "

!

classConventionViolationConfirmationQuerySignal

    "return the query signal raised when a class is about to be installed

     (or changed) which violates conventions (such as upper case instVars).

     This is raised in subclass creation and can be handled to suppress

     dialog boxes popping up during fileIn"

    ^ ClassConventionViolationConfirmationQuerySignal

    "Created: / 3.2.1999 / 11:22:07 / cg"

!

classRedefinitionNotification

    "return the signal raised when a class is about to be redefined

     differently from an existing class and the packages are not

     equal. This helps when filing in alien code, to prevent existing

     classes from being redefined by incompatible classes

     (classVars, classInstVars or inheritance)."

    ^ ClassDescription::ClassRedefinitionNotification

    "Created: / 17.6.1998 / 10:13:44 / cg"

!

classRedefinitionSignal

    "use #classRedefinitionNotification"

    <resource: #obsolete>

    ^ ClassDescription::ClassRedefinitionNotification

    "Created: / 17.6.1998 / 10:13:44 / cg"

!

createNameSpaceQuerySignal

    "return the signal used as an upQuery if a new nameSpace should be

     silently created without user confirmation.

     Only used when installing autoloaded classes"

    ^ CreateNameSpaceQuerySignal

    "Created: 2.4.1997 / 17:27:54 / stefan"

!

defaultApplicationQuerySignal

    "return the signal used as an upQuery for the current application to which

     new classes/methods are to be added.

     Will is only used when filing in V'Age code"

    ^ DefaultApplicationQuerySignal

    "

     Transcript showCR:Class defaultApplicationQuerySignal raise

    "

    "Modified: / 5.11.1996 / 20:08:38 / cg"

    "Created: / 15.6.1998 / 18:28:54 / cg"

!

fileOutErrorSignal

    "return the signal raised when an error occurs while fileing out.

     This is signalled to allow browsers some user feed back in case

     a fileout fails (for example due to disk-full errors)"

    ^ FileOutErrorSignal

    "Created: 2.4.1997 / 17:28:03 / stefan"

!

fileOutNameSpaceQuerySignal

    "return the signal used as an upQuery whether the current

     namespace should be prepended on fileOut."

    ^ FileOutNameSpaceQuerySignal

    "

     Transcript showCR:Class fileOutNameSpaceQuerySignal raise

    "

    "Modified: / 05-11-1996 / 20:08:38 / cg"

    "Created: / 02-04-1997 / 17:28:41 / stefan"

    "Modified (comment): / 27-07-2013 / 15:35:32 / cg"

!

forceNoNameSpaceQuerySignal

    ^ ForceNoNameSpaceQuerySignal

!

methodRedefinitionNotification

    "return the signal raised when a method is about to be installed

     which redefines an existing method and the method's packages are not

     equal. This helps when filing in alien code, to prevent existing

     methods to be overwritten or redefined by incompatible methods"

    ^ ClassDescription::MethodRedefinitionNotification

    "Modified (comment): / 21-11-2017 / 12:59:38 / cg"

!

methodRedefinitionSignal

    "use #methodRedefinitionNotification"

    <resource: #obsolete>

    ^ ClassDescription::MethodRedefinitionNotification

!

nameSpaceQuerySignal

    "return the signal used as an upQuery for the current nameSpace.

     Will be used when filing in code.

     This could be used BEFORE initialize has been invoked - that's why we do not

     simply return the class var here."

    NameSpaceQuerySignal isNil ifTrue:[

        NameSpaceQuerySignal := QuerySignal new.

        NameSpaceQuerySignal nameClass:self message:#nameSpaceQuerySignal.

        NameSpaceQuerySignal notifierString:'asking for nameSpace'.

        NameSpaceQuerySignal handlerBlock:[:ex | ex proceedWith:Project defaultNameSpace].

    ].

    ^ NameSpaceQuerySignal

    "

     Transcript showCR:Class nameSpaceQuerySignal raise

    "

    "Modified: / 17-08-2006 / 14:03:39 / cg"

!

packageQuerySignal

    "return the signal used as an upQuery for the current packages name.

     Will be used when filing in code"

    PackageQuerySignal isNil ifTrue:[ ClassDescription initialize ].

    ^ PackageQuerySignal

    "

     Transcript showCR:Class packageQuerySignal raise

    "

    "Created: 5.11.1996 / 20:07:22 / cg"

    "Modified: 5.11.1996 / 20:08:35 / cg"

!

packageRedefinitionNotification

    "return the signal raised when a class or method is about to be installed

     which redefines an existing method and the method's packages are not

     equal. This helps when filing in alien code, to prevent existing

     methods to be overwritten or redefined by incompatible methods"

    ^ ClassDescription::PackageRedefinition

    "Modified (comment): / 21-11-2017 / 12:59:42 / cg"

!

updateChangeFileQuerySignal

    "return the signal used as an upQuery if the changeFile should be updated.

     If unhandled, the value of UpdatingChanges is returned by the signals

     static handler."

    ^ UpdateChangeFileQuerySignal

    "

     Transcript showCR:Class updateChangeFileQuerySignal raise

    "

    "Modified: 5.11.1996 / 20:08:44 / cg"

!

updateChangeListQuerySignal

    "return the signal used as an upQuery if the changeList should be updated.

     If unhandled, the value of UpdatingChanges is returned by the signals

     static handler."

    ^ UpdateChangeListQuerySignal

    "

     Transcript showCR:Class updateChangeListQuerySignal raise

    "

!

updateHistoryLineQuerySignal

    "return the signal used as an upQuery if the historyline of a method should be updated.

     If unhandled, the history managers setting is returned by the signals

     static handler."

    ^ UpdateHistoryLineQuerySignal

    "

     Class updateHistoryLineQuerySignal raise

    "

    "Created: / 05-07-2006 / 17:30:52 / cg"