From f5d11dffca744c1b8d02138eaf92094708f8ea73 Mon Sep 17 00:00:00 2001 From: hilaire Date: Mon, 12 Aug 2024 23:17:05 +0200 Subject: [PATCH] Clarification on cascade and serie of messages --- docs/Indexes.html | 1 + docs/Summary-of-Syntax.html | 13 ++++++++----- en/syntaxSummary.texinfo | 12 +++++++----- 3 files changed, 16 insertions(+), 10 deletions(-) diff --git a/docs/Indexes.html b/docs/Indexes.html index 3ab3f3f5..ff65989e 100644 --- a/docs/Indexes.html +++ b/docs/Indexes.html @@ -180,6 +180,7 @@

Appendix H Conceptual indexCaesar cipherFun with collections cascade of messagesMessage send definitions cascade of messagesSummary of Syntax +chain of messagesSummary of Syntax change logThe Change Log change setThe Change Set characterKernel-Text diff --git a/docs/Summary-of-Syntax.html b/docs/Summary-of-Syntax.html index c06f0603..c537d4d5 100644 --- a/docs/Summary-of-Syntax.html +++ b/docs/Summary-of-Syntax.html @@ -118,7 +118,7 @@

Appendix B Summary of Syntax ↑ true, ^ truereturn the value true Transcript show: 'hello'. Transcript crexpression separator (.) Transcript show: 'hello'; crmessage cascade (;) -BoxedMorph new :: color: Color blue; openInWorldmessage cascade (::) +BoxedMorph new :: color: Color blue; openInWorldmessage chain (::) `{ 3@4 . 56 . 'click me'}`the compound literal #(3@4 56 'click me') @@ -311,21 +311,24 @@

Appendix B Summary of Syntax
Cascades.
+
+
+
Chains.
-

There are two kinds of message cascades. +

There are two kinds of message compositions, cascade and chain.

-

Semicolons can be used to send a cascade of messages to the original +

Semicolons can be used to send a series of messages to the original receiver. In Transcript show: 'hello'; cr we first send the keyword message #show: 'hello' to the receiver Transcript, and then we send the unary message #cr to the same receiver.

-

It is sometimes useful to send messages to the result of a message send. +

It is sometimes useful to send a series of messages to the result of a message send. In BoxedMorph new :: color: Color blue; openInWorld. we send suceeding messages to the new BoxedMorph instance, not the BoxedMorph class.

-

To better understand the differences between these message cascades, +

To better understand the differences between message cascade and chain, observe the result of the three statements below:

diff --git a/en/syntaxSummary.texinfo b/en/syntaxSummary.texinfo index 9ba8ac47..7cd8defe 100644 --- a/en/syntaxSummary.texinfo +++ b/en/syntaxSummary.texinfo @@ -33,7 +33,7 @@ @item @smalltalk{@U{2191} true}, @smalltalk{^ true} @tab @tab return the value true @item @smalltalk{Transcript show: 'hello'. Transcript cr} @tab @tab expression separator (.) @item @smalltalk{Transcript show: 'hello'; cr} @tab @tab message cascade (;) - @item @smalltalk{BoxedMorph new :: color: Color blue; openInWorld} @tab @tab message cascade (::) + @item @smalltalk{BoxedMorph new :: color: Color blue; openInWorld} @tab @tab message chain (::) @item @smalltalk{`@{ 3@@4 . 56 . 'click me'@}`} @tab @tab the compound literal @smalltalk{#(3@@4 56 'click me')} @end multitable @end float @@ -205,21 +205,23 @@ @cindex cascade of messages @item Cascades. + @cindex chain of messages + @item Chains. - There are two kinds of message cascades. + There are two kinds of message compositions, cascade and chain. - Semicolons can be used to send a cascade of messages to the original + Semicolons can be used to send a series of messages to the original receiver. In @smalltalk{Transcript show: 'hello'; cr} we first send the keyword message @msg{show: 'hello'} to the receiver @class{Transcript}, and then we send the unary message @msg{cr} to the same receiver. - It is sometimes useful to send messages to the @emph{result} of a message send. + It is sometimes useful to send a series of messages to the @emph{result} of a message send. In @smalltalk{ BoxedMorph new :: color: Color blue; openInWorld. } we send suceeding messages to the new BoxedMorph instance, not the BoxedMorph class. -To better understand the differences between these message cascades, +To better understand the differences between message cascade and chain, observe the result of the three statements below: @smallexample