#TUNING by stefan
class: UnixOperatingSystem class
changed:
#fork
#getProcessId
cache my own pid
"
COPYRIGHT (c) 2009 by Jan Vrany
COPYRIGHT (c) 2009 by eXept Software AG
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 }"
ProgrammingLanguage subclass:#SmalltalkLanguage
instanceVariableNames:''
classVariableNames:''
poolDictionaries:''
category:'Kernel-Languages'
!
!SmalltalkLanguage class methodsFor:'documentation'!
copyright
"
COPYRIGHT (c) 2009 by Jan Vrany
COPYRIGHT (c) 2009 by eXept Software AG
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
"
provide info about which tools are to be used for smalltalk code
"
! !
!SmalltalkLanguage methodsFor:'accessing'!
id
"Return a unique integer id of this language.
For languages built into the VM, it must be < 32.
This id is used as index to various structures used by runtime
(bytecode set ?).
cg: this ought to be better documented - I have no idea, where it is used"
^ 1
"Created: / 12-04-2018 / 09:16:27 / stefan"
!
name
"Answers a human-readable name of myself:
'Smalltalk' for SmalltalkLanguage,
'Ruby' for RubyLanguage
..."
^ 'Smalltalk'
"Modified: / 16-08-2009 / 10:53:35 / Jan Vrany <vranyj1@fel.cvut.cz>"
!
sourceFileSuffix
"Answers a default suffix for source files, i.e.
'st' for Smalltalk, 'js' for JavaScript or 'rb' for Ruby', etc."
^'st'
"Modified: / 16-08-2009 / 10:53:52 / Jan Vrany <vranyj1@fel.cvut.cz>"
"Modified (comment): / 27-06-2019 / 12:33:29 / Claus Gittinger"
! !
!SmalltalkLanguage methodsFor:'accessing-classes'!
codeGeneratorClass
"Answers a class that can generate code"
^ SmalltalkCodeGeneratorTool
"Created: / 30-01-2011 / 15:19:52 / cg"
!
compilerClass
"Answer a class suitable for compiling a source code in 'my' language"
^ Smalltalk at:#Compiler
"Modified: / 21-08-2009 / 13:02:27 / Jan Vrany <vranyj1@fel.cvut.cz>"
!
compilerWithBreakpointSupportClass
"Answer a class suitable for compiling a source code with breakpoints
in 'my' language"
^ ByteCodeCompilerWithBreakpointSupport
"Created: / 22-07-2013 / 15:46:12 / cg"
!
explainerClass
"Answers a class used by browser and debugger to
show some hints about the code. It is OK to return
nil, which means that there is no explainer for given language."
"return nil by default"
^ Explainer
"Created: / 21-08-2009 / 08:49:29 / Jan Vrany <vranyj1@fel.cvut.cz>"
!
formatterClass
"Answer a class suitable for prettyPrinting (indenting) code in 'my' language.
It is ok to return nil, which means that the browser will not be able to prettyprint."
^ Parser
!
parserClass
"Answer a class suitable for parsing a source code in 'my' language"
^ Parser
"Modified: / 21-08-2009 / 13:02:21 / Jan Vrany <vranyj1@fel.cvut.cz>"
!
sourceFileReaderClass
"Answers a class that can be used for reading & compiling source files"
^SmalltalkChunkFileSourceReader
"Modified: / 16-08-2009 / 12:29:39 / Jan Vrany <vranyj1@fel.cvut.cz>"
!
sourceFileWriterClass
"Answers a class is used for source file writing (i.e. file-out)"
^ SmalltalkChunkFileSourceWriter
"Modified: / 16-08-2009 / 09:51:41 / Jan Vrany <vranyj1@fel.cvut.cz>"
!
syntaxHighlighterClass
"return the class to use for syntaxHighlighting (prettyPrinting) this class -
this can be redefined in special classes, to highlight classes with
Lisp, Prolog, ASN1, Basic :-) or whatever syntax."
^ SyntaxHighlighter
! !
!SmalltalkLanguage methodsFor:'mimicry'!
, anObject
"Emulates symbol behavior. This is sometimes required
as 'Smalltalk language' is used by legacy code to access
the current language setting.
Future versions should contain class Locale.
cg: this is crab, who needs this?
"
<resource: #obsolete>
self obsoleteMethodWarning.
^ Smalltalk language , anObject
"Created: / 22-08-2009 / 09:33:44 / Jan Vrany <vranyj1@fel.cvut.cz>"
"Modified (comment): / 01-04-2012 / 13:19:28 / cg"
!
asSymbol
"Returns a language symbol. This is sometimes required
as Smalltalk language is used by legacy code to access
current language. Future versions should contain class
Locale.
cg: this is crab, who needs this?
"
<resource: #obsolete>
self obsoleteMethodWarning.
^ Smalltalk language
"Created: / 22-08-2009 / 09:33:16 / Jan Vrany <vranyj1@fel.cvut.cz>"
! !
!SmalltalkLanguage methodsFor:'queries'!
canBeCompiled
"true if compilable in the browser"
^ true
! !
!SmalltalkLanguage methodsFor:'source queries'!
bracketStrings
"used for autoindent"
^ #(
('[' ']') "/ blocks
)
"Created: / 26-06-2019 / 22:03:42 / Claus Gittinger"
!
commentStrings
^ #(
'"/' "/ EOL comment
('"' '"') "/ normal comment
)
!
methodDefinitionTemplateForSelector:aSelector andArgumentNames:argNames
"given a selector, return a prototype definition string"
|numArgs|
numArgs := aSelector argumentCount.
(numArgs ~~ 0 and:[numArgs == argNames size]) ifTrue:[
aSelector isKeywordSelector ifTrue:[
^ Text streamContents:[:stream |
aSelector keywords with:argNames do:[:eachKeyword :eachArgName|
stream bold; nextPutAll:eachKeyword; normal; nextPutAll:eachArgName; space.
].
stream backStep. "remove the last space"
].
].
^ aSelector allBold , ' ' , (argNames at:1)
].
^ aSelector allBold
"
SmalltalkLanguage instance
methodDefinitionTemplateForSelector:#foo andArgumentNames:#()
SmalltalkLanguage instance
methodDefinitionTemplateForSelector:#+ andArgumentNames:#('aNumber')
SmalltalkLanguage instance
methodDefinitionTemplateForSelector:#foo:bar:baz: andArgumentNames:#('fooArg' 'barArg' 'bazArg')
"
"Modified: / 12-04-2018 / 08:39:15 / stefan"
"Modified: / 24-10-2019 / 10:53:15 / Stefan Vogel"
! !
!SmalltalkLanguage methodsFor:'testing'!
isSmalltalk
"true iff I represent the smalltalk language"
^ true
"Created: / 16-08-2009 / 09:01:38 / Jan Vrany <vranyj1@fel.cvut.cz>"
! !
!SmalltalkLanguage class methodsFor:'documentation'!
version
^ '$Header$'
!
version_CVS
^ '$Header$'
!
version_SVN
^'$Id$'
! !