Hi Sven,

On Mar 8, 2018, at 9:55 AM, Sven Van Caekenberghe <sven@stfx.eu> wrote:



On 8 Mar 2018, at 17:58, Eliot Miranda <eliot.miranda@gmail.com> wrote:

Hi Stef,

following on from Sean, (+1000 for using ordinary quotes)

���string��� collection of characters => ���string��� sequence of characters
$a, Character space Two ways to create characters => $a, Character space two ways to denote characters (or two ways to write characters; all other explanations in this list are not capitalized; this shouldn't be either)
exp1. exp2 expression separator => expr1. expr2 statement separator
; message cascade => expr doThis ; doThat   semicolon - message cascade (c.f. exp1. exp2 expression separator)
^ expr caret - returns a result from a method => ^ expr caret - return a result from a method (or, ParcPlace preference, answer a result from a method, since we're sending messages here)

...
A unary message is one with no arguments. => A unary message has no arguments. (c.f. A binary message takes only one argument ...)
...
Set new add: 4; add: 4 ; yourself ~> aSet => Set new add: 4; add: 4 ; yourself ~> aSet(4)
Dictionary new at: #a put: 'Alpha' ; yourself a Dictionary => Dictionary new at: #a put: 'Alpha' ; yourself a Dictionary(#a->'Alpha' )

and then in the Files and Stream section I would give two more examples of exactly the same sequence that use the convenience APIs.  This is the existing text:

   work := FileSystem disk workingDirectory.
   stream := (work / ���foo.txt���) writeStream.
   stream nextPutAll: ���Hello World���.
   stream close.
   stream := (work / ���foo.txt���) readStream.
   stream contents.                                     ~> 'Hello World'
   stream close.

I would make it read

   work := FileSystem disk workingDirectory.
   stream := (work / ���foo.txt���) writeStream.
   stream nextPutAll: ���Hello World���.
   stream close.
   stream := (work / ���foo.txt���) readStream.
   stream contents.                                     ~> 'Hello World'
   stream close.

   or, more simply

   work := FileSystem disk workingDirectory.
   (work / ���foo.txt���) writeStreamDo: [ :fileStream | fileStream nextPutAll: ���Hello World��� ].
   (work / ���foo.txt���) readStreamDo: [ :fileStream | fileStream contents]                            ~> 'Hello World'

   or, more simply still

   work := FileSystem disk workingDirectory.
   (work / ���foo.txt���) writeStreamDo: [ :fileStream | fileStream nextPutAll: ���Hello World��� ].
   (work / ���foo.txt���) contents                                                                                             ~> 'Hello World'

file := FileSystem disk workingDirectory / 'foo' , 'txt'.
file ensureDelete.
file writeStreamDo: [ :fileStream | fileStream nextPutAll: 'Hello World' ].
file contents.
file delete.

(to make it re-entrant and a bit more concise)

that suggests 

file := FileSystem disk workingDirectory / 'foo' , 'txt'.
file newWriteStreamDo: [ :fileStream | fileStream nextPutAll: 'Hello World' ].
file contents.
file delete.

where newWriteStreamDo: includes the file ensureDelete, or better still a truncation, which saves the effort of deletion but (I *think*) has the same effect.


+1e10 for plain single quotes, VERY important.

or if you can't make it fit, just give the last version

Finally, this seems to have fallen off the end:
A simple, uniform and powerful model
Pharo has a simple dynamically-typed object model:

Perhaps shrink the picture of the browser.  You can save three lines by writing
   OrderedCollection new
       add: 1;
       add: 2;
       add: 3.

as OrderedCollection new add: 1; add: 2; add: 3.
And another by writing 2=2 ifTrue: [ Error signal: ���Help��� ]. on one line.

HTH

On Fri, Apr 8, 2016 at 12:56 PM, stepharo <stepharo@free.fr> wrote:
new cheatsheet for Pharo syntax.
Any feedback is welcome

Stef



--
_,,,^..^,,,_
best, Eliot