The Trunk: ST80-eem.225.mcz

Eliot Miranda uploaded a new version of ST80 to project The Trunk:
http://source.squeak.org/trunk/ST80-eem.225.mcz

==================== Summary ====================

Name: ST80-eem.225
Author: eem
Time: 30 March 2017, 5:17:50.795656 pm
UUID: 4d0e7040-3099-47d8-b1d7-af4a54e67e80
Ancestors: ST80-ul.224

Replace mention of BlockContext with BlockClosure in the non-Morphic explainer code.

=============== Diff against ST80-ul.224 ===============

Item was changed:
  ----- Method: ParagraphEditor>>explainChar: (in category 'explain') -----
  explainChar: string
  "Does string start with a special character?"
 
  | char |
  char := string at: 1.
  char = $. ifTrue: [^'"Period marks the end of a Smalltalk statement.  A period in the middle of a number means a decimal point.  (The number is an instance of class Float)."'].
  char = $' ifTrue: [^'"The characters between two single quotes are made into an instance of class String"'].
  char = $" ifTrue: [^'"Double quotes enclose a comment.  Smalltalk ignores everything between double quotes."'].
  char = $# ifTrue: [^'"The characters following a hash mark are made into an instance of class Symbol.  If parenthesis follow a hash mark, an instance of class Array is made.  It contains literal constants."'].
  (char = $( or: [char = $)]) ifTrue: [^'"Expressions enclosed in parenthesis are evaluated first"'].
+ (char = $[ or: [char = $]]) ifTrue: [^'"The code inside square brackets is an unevaluated block of code.  It becomes an instance of BlockClosure and is usually passed as an argument."'].
- (char = $[ or: [char = $]]) ifTrue: [^'"The code inside square brackets is an unevaluated block of code.  It becomes an instance of BlockContext and is usually passed as an argument."'].
  (char = ${ or: [char = $}]) ifTrue: [^ '"A sequence of expressions separated by periods, when enclosed in curly braces, are evaluated to yield the elements of a new Array"'].
  (char = $< or: [char = $>]) ifTrue: [^'"<primitive: xx> means that this method is usually preformed directly by the virtual machine.  If this method is primitive, its Smalltalk code is executed only when the primitive fails."'].
  char = $^ ifTrue: [^'"Uparrow means return from this method.  The value returned is the expression following the ^"'].
  char = $| ifTrue: [^'"Vertical bars enclose the names of the temporary variables used in this method.  In a block, the vertical bar separates the argument names from the rest of the code."'].
  char = $_ ifTrue: [^'"Left arrow means assignment.  The value of the expression after the left arrow is stored into the variable before it."'].
  char = $; ifTrue: [^'"Semicolon means cascading.  The message after the semicolon is sent to the same object which received the message before the semicolon."'].
  char = $: ifTrue: [^'"A colon at the end of a keyword means that an argument is expected to follow.  Methods which take more than one argument have selectors with more than one keyword.  (One keyword, ending with a colon, appears before each argument).', '\\' withCRs, 'A colon before a variable name just inside a block means that the block takes an agrument.  (When the block is evaluated, the argument will be assigned to the variable whose name appears after the colon)."'].
  char = $$ ifTrue: [^'"The single character following a dollar sign is made into an instance of class Character"'].
  char = $- ifTrue: [^'"A minus sign in front of a number means a negative number."'].
  char = $e ifTrue: [^'"An e in the middle of a number means that the exponent follows."'].
  char = $r ifTrue: [^'"An r in the middle of a bunch of digits is an instance of Integer expressed in a certain radix.  The digits before the r denote the base and the digits after it express a number in that base."'].
  char = Character space ifTrue: [^'"the space Character"'].
  char = Character tab ifTrue: [^'"the tab Character"'].
  char = Character cr ifTrue: [^'"the carriage return Character"'].
  char = Character lf ifTrue: [^'"the line feed Character"'].
  ^nil!

Item was changed:
  ----- Method: ParagraphEditor>>explainCtxt: (in category 'explain') -----
  explainCtxt: symbol
  "Is symbol a context variable?"
 
  | reply classes text cls |
  symbol = #nil ifTrue: [reply := '"is a constant.  It is the only instance of class UndefinedObject.  nil is the initial value of all variables."'].
  symbol = #true ifTrue: [reply := '"is a constant.  It is the only instance of class True and is the receiver of many control messages."'].
  symbol = #false ifTrue: [reply := '"is a constant.  It is the only instance of class False and is the receiver of many control messages."'].
+ symbol = #thisContext ifTrue: [reply := '"is a context variable.  Its value is always the Context which is executing this method."'].
- symbol = #thisContext ifTrue: [reply := '"is a context variable.  Its value is always the MethodContext which is executing this method."'].
  (model respondsTo: #selectedClassOrMetaClass) ifTrue: [
  cls := model selectedClassOrMetaClass].
  cls ifNil: [^ reply].  "no class known"
  symbol = #self ifTrue:
  [classes := cls withAllSubclasses.
  classes size > 12
  ifTrue: [text := cls printString , ' or a subclass']
  ifFalse:
  [classes := classes printString.
  text := 'one of these classes' , (classes copyFrom: 4 to: classes size)].
  reply := '"is the receiver of this message; an instance of ' , text , '"'].
  symbol = #super ifTrue: [reply := '"is just like self.  Messages to super are looked up in the superclass (' , cls superclass printString , ')"'].
  ^reply!