Smalltalk/X Webserver

Documentation of class 'ParserFlags':

Class: ParserFlags

Inheritance
Description
Class protocol
Instance protocol

Inheritance:

   Object
   |
   +--ParserFlags

Package:: stx:libcomp

Category:: System-Compiler

Version:: rev: 1.55 date: 2009/12/10 14:06:29; user: cg; file: ParserFlags.st directory: libcomp; module: stx stc-classLibrary: libcomp

Description:

compiler flags (used to be defined in Scanner and Parser) have been extracted for easier
individual-method customization (using ST as scripting).

howTo_fileInVSE:
    ParserFlags allowSTVExtensions:true.
    ParserFlags allowSTVPrimitives:true.
    ParserFlags allowSTXEOLComments:false.

Class protocol:

accessing-compilation control

allowExtensionsToPrivateClasses
allowExtensionsToPrivateClasses: aBoolean
allowPossibleSTCCompilationProblems
allowPossibleSTCCompilationProblems: aBoolean
arraysAreImmutable: return true if arrays are immutable literals
arraysAreImmutable: aBoolean: turn on/off immutable array literals - default is false for ST-80 compatibilty.
implicitSelfSends: return true if undefined variables with
lowercase first character are to be turned
into implicit self sends
implicitSelfSends: aBoolean: turn on/off implicit self sends
stringsAreImmutable: return true if strings are immutable literals
stringsAreImmutable: aBoolean: turn on/off immutable string literals - default is false for ST-80 compatibilty.

accessing-stc compilation control

ccCompilationOptions
ccCompilationOptions: aString
ccPath
ccPath: aSymbol
libPath
libPath: aString
linkArgs
linkArgs: aString
linkCommand
linkCommand: aString
linkSharedArgs
linkSharedArgs: aString
makeCommand
makeCommand: aString
searchedLibraries
searchedLibraries: aString
stcCompilation
stcCompilation: aSymbol
stcCompilationDefines
stcCompilationDefines: aString
stcCompilationIncludes
stcCompilationIncludes: aString
stcCompilationOptions
stcCompilationOptions: aString
stcKeepCIntermediate
stcKeepCIntermediate: something
stcKeepOIntermediate
stcKeepOIntermediate: something
stcKeepSTIntermediate
stcKeepSTIntermediate: something
stcModulePath
stcModulePath: something
stcPath
stcPath: aSymbol
useBorlandC: ^ true.
useGnuC
withSTCCompilation: howSymbol do: aBlock

accessing-syntax-control

allowArrayIndexSyntaxExtension: experimental
allowArrayIndexSyntaxExtension: aBoolean: experimental
allowDollarInIdentifier: return true, if $-characters are allowed in identifiers.
Notice, that dollars are NEVER allowed as the first character in an identifier.
allowDollarInIdentifier: aBoolean: this allows turning on/off $-characters in identifiers.
Notice, that dollars are NEVER allowed as the first character in an identifier.
If turned off (the default), dollars are not allowed in identifiers,
but instead are scanned as character-constant prefix.
If turned on, dollars are in identifiers are allowed, while extra
dollars are still scanned as constant character prefix.
If you have to fileIn old VW-Vsn2.x classes, turn this off
before filing them in; i.e.:
Compiler allowDollarInIdentifiers:false
allowDolphinExtensions: return true, if ##(..) computed literals are allowed
allowDolphinExtensions: aBoolean: this allows turning on/off support for computed arrays ##(..) as in dolphin.
If you want to fileIn Dolphin classes, enable this with:
Compiler allowDolphinComputedArrays:true
allowEmptyStatements: return true, if empty statements are allowed (two .'s in a row).
Notice, that stc cannot (yet) handle those.
allowEmptyStatements: aBoolean: turn on/off, if empty statements are allowed (two .'s in a row).
Notice, that stc cannot (yet) handle those.
allowExtendedBinarySelectors: experimental extended selectors extensions
allowExtendedBinarySelectors: aBoolean: experimental syntay extensions
allowExtendedSTXSyntax: experimental syntay extensions
allowExtendedSTXSyntax: aBoolean: experimental syntay extensions
allowFixedPointLiterals: return true, if nnnsn (FixedPoint) literals are allowed
allowFixedPointLiterals: aBoolean: enable/disable, if nnnsn (FixedPoint) literals are allowed
allowFunctionCallSyntaxForBlockEvaluation: experimental
allowFunctionCallSyntaxForBlockEvaluation: aBoolean: experimental
allowHashAsBinarySelector
allowHashAsBinarySelector: aBoolean
allowLiteralNameSpaceSymbols: return true, if literal nameSpace symbols are allowed (#foo::bar) are allowed
allowLiteralNameSpaceSymbols: aBoolean: controls, if literal nameSpace symbols are allowed (#foo::bar) are allowed
allowLocalVariableDeclarationWithInitializerExpression: experimental
allowLocalVariableDeclarationWithInitializerExpression: aBoolean: experimental
allowNationalCharactersInIdentifier: return true, if national characters (diaresis etc.) are allowed in identifiers
allowNationalCharactersInIdentifier: aBoolean: this allows turning on/off recognition of national characters (diaresis etc.) in identifiers.
Use this ONLY to file in some non-ANSI ST/V code
allowOldStyleAssignment: return true, if underscore-assignment (pre ST-80v4 syntax) are to be allowed
allowOldStyleAssignment: aBoolean: this allows turning on/off recognition of underscore-assignment (pre ST-80v4 syntax).
You must turn this off, if code with variables named '_' is to be filedIn
allowPeriodInSymbol: return true, if periods are allowed in a symbol literal #foo.bar.
Needed to parse some old ST80/Squeak code
allowPeriodInSymbol: aBoolean: control, if periods are allowed in a symbol literal #foo.bar.
Needed to parse some old ST80/Squeak code
allowQualifiedNames: return true, if #{..} qualified names are allowed
allowQualifiedNames: aBoolean: this allows turning on/off support for qualifiedNames #{ .., } as in vw3.
If you want to fileIn vw3 or later classes, enable this with:
Compiler allowQualifiedNames:true
Notice, that qualified names are not really supported semantically
(they are parsed, but treated like regular globals)
allowReservedWordsAsSelectors: return true, if self, super, thisContext, nil, true and false are to be allowed
as unary message selectors.
allowReservedWordsAsSelectors: aBoolean: enable/disable, if self, super, thisContext, nil, true and false are to be allowed
as unary message selectors.
allowSTVExtensions: return true, if support for ST/V syntax extensions is enabled.
allowSTVExtensions: aBoolean: this allows turning on/off support for ST/V extensions:
If you want to fileIn ST/V classes, enable this with:
Compiler allowSTVComputedArrays:true
allowSTVPrimitives: return true, if support for ST/V primitives is enabled.
allowSTVPrimitives: aBoolean: this allows turning on/off support for ST/V primitives
allowSTXEOLComments
allowSTXEOLComments: aBoolean
allowSqueakExtensions: return true, if support for squeak extensions
computed arrays { .., }
c/java style arguments in message sends rec foo(arg1, ... argN)
is enabled.
allowSqueakExtensions: aBoolean: this allows turning on/off support for squeak extensions:
computed arrays { .., }
c/java style arguments in message sends rec foo(arg1, ... argN)

If you want to fileIn Squeak classes, enable this with:
Compiler allowSqueakComputedArrays:true
allowSqueakPrimitives: return true, if support for squeak primitives is enabled.
allowSqueakPrimitives: aBoolean: this allows turning on/off support for squeak primitives
allowUnderscoreInIdentifier: return true, if underscores are allowed in identifiers
allowUnderscoreInIdentifier: aBoolean: this allows turning on/off underscores in identifiers.
If turned off (the default), underscores are not allowed in identifiers,
but instead scanned as assignment character (old ST/80 syntax).
If turned on, underscores are in identifiers are allowed, while extra
underscores are still scanned as assignment.
If you have to fileIn old VW-Vsn2.x classes,
turn them off with:
Compiler allowUnderscoreInIdentifiers:false
allowUnicodeCharacters
allowUnicodeCharacters: aBoolean
allowUnicodeStrings
allowUnicodeStrings: aBoolean
allowVisualAgeESSymbolLiterals: return true, if ##symbols are allowed (treated like symbols)
allowVisualAgeESSymbolLiterals: aBoolean: if on, visualAge's ##symbols are allowed (treated like symbols)
allowVisualAgePrimitives: return true, if support for V'Age primitives is enabled.
allowVisualAgePrimitives: aBoolean: this allows turning on/off support for V'Age primitives
allowVisualWorksMethodAnnotations: return true, if support for V'Works extended primitive syntax for method annotations.
allowVisualWorksMethodAnnotations: aBoolean: turn on/off support for V'Works extended primitive syntax for method annotations.

accessing-warning-control

warnAboutBadComments: controls generation of warning messages about empty comments
warnAboutBadComments: aBoolean: controls generation of warning messages about empty comments
warnAboutNonLowercaseLocalVariableNames: controls generation of warning messages about wrong variable names
warnAboutNonLowercaseLocalVariableNames: aBoolean: controls generation of warning messages about wrong variable names
warnAboutPeriodInSymbol
warnAboutPeriodInSymbol: aBoolean
warnAboutPossibleSTCCompilationProblems
warnAboutPossibleSTCCompilationProblems: aBoolean
warnAboutPossiblyUnimplementedSelectors
warnAboutPossiblyUnimplementedSelectors: aBoolean
warnAboutReferenceToPrivateClass: controls generation of warning messages when a private class is referenced
warnAboutReferenceToPrivateClass: aBoolean: controls generation of warning messages when a private class is referenced
warnAboutShortLocalVariableNames: controls generation of warning messages about short variable names
warnAboutShortLocalVariableNames: aBoolean: controls generation of warning messages about short variable names
warnAboutVariableNameConventions: controls generation of warning messages about wrong variable names
warnAboutVariableNameConventions: aBoolean: controls generation of warning messages about wrong variable names
warnAboutWrongVariableNames: controls generation of warning messages about wrong variable names
warnAboutWrongVariableNames: aBoolean: controls generation of warning messages about wrong variable names
warnCommonMistakes: return true, if common beginners mistakes are to be warned about
warnCommonMistakes: aBoolean: this allows turning on/off warnings about common beginners mistakes.
Those are not really errors in the strict sense, but often lead to
run time errors later.
Examples are: expr or:expr2, where expr2 is not a block.
If you get bored by those warnings, turn them off by adding
a line as:
ParserFlags warnCommonMistakes:false
in your 'private.rc' file
warnDollarInIdentifier: return true, if $-characters in identifiers are to be warned about
warnDollarInIdentifier: aBoolean: this allows turning on/off warnings about $-characters in identifiers.
You may find those warnings useful, to make certain that your code
is portable to other smalltalk versions, which do not allow this
(i.e. VW releases 2.x and maybe others).
Notice, that dollars are NEVER allowed as the first character in an identifier.
If you get bored by those warnings, turn them off by adding
a line as:
ParserFlags warnDollarInIdentifier:false
in your 'private.rc' file
warnHiddenVariables: controls generation of warning messages about hiding variables by locals
warnHiddenVariables: aBoolean: controls generation of warning messages about hiding variables by locals
warnInconsistentReturnValues: return true, if compiler should warn about inconsitent (boolean / non-boolean)
return values
warnInconsistentReturnValues: aBoolean: constrols if the compiler should warn about inconsitent (boolean / non-boolean)
return values
warnOldStyleAssignment: return true, if underscore-assignment (pre ST-80v4 syntax) are to be warned about
warnOldStyleAssignment: aBoolean: this allows turning on/off warnings about underscore-assignment (pre ST-80v4 syntax).
If you get bored by those warnings, turn them off by adding
a line as:
ParserFlags warnOldStyleAssignment:false
in your 'private.rc' file
warnPossibleIncompatibilities: return true, if possible incompatibilities (with other ST systems)
are to be warned about
warnPossibleIncompatibilities: aBoolean: this turns warnings about possible incompatibilities (with other ST systems)
on or off.
If you get bored by those warnings, turn them off by adding
a line as:
ParserFlags warnPossibleIncompatibilities:false
in your 'private.rc' file.
warnSTXSpecials: return true, if ST/X specials are to be warned about
warnSTXSpecials: aBoolean: this allows turning on/off warnings about stx specials.
If you get bored by those warnings, turn them off by adding
a line as:
ParserFlags warnSTXSpecials:false
in your 'private.rc' file
warnUnderscoreInIdentifier: return true, if underscores in identifiers are to be warned about
warnUnderscoreInIdentifier: aBoolean: this allows turning on/off warnings about underscores in identifiers.
You may find those warnings useful, to make certain that your code
is portable to other smalltalk versions, which do not allow this
(i.e. VW releases 2.x).
If you get bored by those warnings, turn them off by adding
a line as:
ParserFlags warnUnderscoreInIdentifier:false
in your 'private.rc' file
warnUnusedVars: controls generation of warning messages about unued method variables
warnUnusedVars: aBoolean: controls generation of warning messages about unued method variables
warnings: return true, if any warnings are to be shown
warnings: aBoolean: this allows turning on/off all warnings; the default is on.
You can turn off warnings in your 'private.rc' file with
ParserFlags warnings:false

class initialization

initialize

instance creation

new

Instance protocol:

accessing-compilation control

allowExtensionsToPrivateClasses
allowExtensionsToPrivateClasses: aBoolean
allowPossibleSTCCompilationProblems
allowPossibleSTCCompilationProblems: aBoolean
arraysAreImmutable
arraysAreImmutable: aBoolean
flattenVisualWorksNamespaces
stringsAreImmutable
stringsAreImmutable: aBoolean

accessing-stc compilation control

ccCompilationOptions
ccCompilationOptions: something
ccPath
ccPath: something
implicitSelfSends
implicitSelfSends: aBoolean
libPath
libPath: aString
linkArgs
linkArgs: aString
linkCommand
linkCommand: aString
linkSharedArgs
linkSharedArgs: aString
searchedLibraries
searchedLibraries: aString
stcCompilation
stcCompilation: something
stcCompilationDefines
stcCompilationDefines: something
stcCompilationIncludes
stcCompilationIncludes: something
stcCompilationOptions
stcCompilationOptions: something
stcKeepCIntermediate
stcKeepCIntermediate: something
stcKeepOIntermediate
stcKeepOIntermediate: something
stcKeepSTIntermediate
stcKeepSTIntermediate: something
stcModulePath
stcModulePath: something
stcPath
stcPath: something

accessing-syntax-control

allowArrayIndexSyntaxExtension
allowArrayIndexSyntaxExtension: aBoolean
allowCaretAsBinop
allowCaretAsBinop: aBoolean
allowCharacterEscapes
allowCharacterEscapes: aBoolean
allowDollarInIdentifier
allowDollarInIdentifier: aBoolean
allowDolphinExtensions
allowDolphinExtensions: aBoolean
allowDomainVariables
allowDomainVariables: aBoolean
allowEmptyStatements
allowEmptyStatements: aBoolean
allowExtendedBinarySelectors
allowExtendedBinarySelectors: aBoolean
allowExtendedSTXSyntax
allowExtendedSTXSyntax: something
allowFixedPointLiterals
allowFixedPointLiterals: something
allowFunctionCallSyntaxForBlockEvaluation
allowFunctionCallSyntaxForBlockEvaluation: aBoolean
allowHashAsBinarySelector
allowLazyValueExtension
allowLazyValueExtension: something
allowLiteralNameSpaceSymbols
allowLiteralNameSpaceSymbols: aBoolean
allowLocalVariableDeclarationWithInitializerExpression
allowLocalVariableDeclarationWithInitializerExpression: aBoolean
allowNationalCharactersInIdentifier
allowNationalCharactersInIdentifier: aBoolean
allowOldStyleAssignment
allowOldStyleAssignment: aBoolean
allowPeriodInSymbol
allowPeriodInSymbol: aBoolean
allowQualifiedNames
allowQualifiedNames: aBoolean
allowReservedWordsAsSelectors
allowReservedWordsAsSelectors: aBoolean
allowSTVExtensions: return true, if support for ST/V extensions is enabled.
allowSTVPrimitives: return true, if support for ST/V primitives is enabled.
allowSTXEOLComments
allowSTXEOLComments: aBoolean
allowSqueakExtensions: return true, if support for squeak extensions
computed arrays { .., }
c/java style arguments in message sends rec foo(arg1, ... argN)
is enabled.
allowSqueakExtensions: aBoolean: this allows turning on/off support for squeak extensions:
computed arrays { .., }
c/java style arguments in message sends rec foo(arg1, ... argN)
allowSqueakPrimitives: return true, if support for squeak primitives is enabled.
allowSqueakPrimitives: aBoolean: this allows turning on/off support for squeak primitives
allowStringEscapes
allowStringEscapes: aBoolean
allowUnderscoreInIdentifier
allowUnderscoreInIdentifier: aBoolean
allowUnicodeCharacters
allowUnicodeCharacters: aBoolean
allowUnicodeStrings
allowUnicodeStrings: aBoolean
allowVariableReferences
allowVariableReferences: aBoolean
allowVisualAgeESSymbolLiterals
allowVisualAgeESSymbolLiterals: aBoolean
allowVisualAgePrimitives: return true, if support for V'Age primitives is enabled.
allowVisualAgePrimitives: aBoolean: this allows turning on/off support for V'Age primitives
allowVisualWorksMethodAnnotations: return true, if support for V'Works extended primitive syntax for method annotations.
allowVisualWorksMethodAnnotations: aBoolean: turn on/off support for V'Works extended primitive syntax for method annotations.

accessing-warning-control

warnAboutBadComments
warnAboutBadComments: aBoolean
warnAboutNonLowercaseLocalVariableNames
warnAboutNonLowercaseLocalVariableNames: aBoolean
warnAboutPeriodInSymbol
warnAboutPeriodInSymbol: aBoolean
warnAboutPossibleSTCCompilationProblems
warnAboutPossibleSTCCompilationProblems: aBoolean
warnAboutPossiblyUnimplementedSelectors
warnAboutPossiblyUnimplementedSelectors: aBoolean
warnAboutReferenceToPrivateClass: controls generation of warning messages when a private class is referenced
warnAboutReferenceToPrivateClass: aBoolean: controls generation of warning messages when a private class is referenced
warnAboutShortLocalVariableNames
warnAboutShortLocalVariableNames: aBoolean
warnAboutVariableNameConventions
warnAboutVariableNameConventions: aBoolean
warnAboutWrongVariableNames
warnAboutWrongVariableNames: aBoolean
warnCommonMistakes
warnCommonMistakes: aBoolean
warnDollarInIdentifier
warnDollarInIdentifier: aBoolean
warnHiddenVariables
warnHiddenVariables: aBoolean
warnInconsistentReturnValues
warnInconsistentReturnValues: aBoolean
warnOldStyleAssignment
warnOldStyleAssignment: aBoolean
warnPossibleIncompatibilities: holds true, if possible incompatibilities (with other ST systems)
are to be warned about
warnPossibleIncompatibilities: aBoolean: holds true, if possible incompatibilities (with other ST systems)
are to be warned about
warnST80Directives
warnST80Directives: something
warnSTXHereExtensionUsed
warnSTXHereExtensionUsed: aBoolean
warnSTXNameSpaceUse
warnSTXNameSpaceUse: aBoolean
warnSTXSpecialComment
warnSTXSpecialComment: aBoolean
warnUndeclared
warnUndeclared: aBoolean
warnUnderscoreInIdentifier
warnUnderscoreInIdentifier: aBoolean
warnUnusedVars
warnUnusedVars: aBoolean
warnings
warnings: something

initialization

initialize

ST/X 6.1.1; WebServer 1.620 at exept:8081; Tue, 22 May 2012 21:35:23 GMT