[Oorexx-bugs] [ oorexx-Documentation-1818323 ] typos in Rev 985 of RexxRef

[SourceForge.net <no...@so...>]

Documentation item #1818323, was opened at 2007-10-23 01:56
Message generated for change (Settings changed) made by bigrixx
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=1001880&aid=1818323&group_id=119701

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
>Category: Reference
>Group: 4.0.0
>Status: Pending
>Resolution: Fixed
Priority: 5
Private: No
Submitted By: Jon Wolfers (sahananda)
Assigned to: Rick McGuire (bigrixx)
Summary: typos in Rev 985 of RexxRef

Initial Comment:
Hi,

I submitted these wrongly (went to sourceforge Documentation tab & selected Submit) so I don't know whether you've seen them or not.  In case they have disappeared into the ether, I resubmit them here.
Changes are enclosed in <>


4.2 (The ooRexx Forums) 
anyone my contribute to or monitor.  Should read anyone m<a>y contribute to or monitor.

1.4. How Objects Interact
The "message send" symbol, ~, which is called the twiddle
Is prefixed by an extraneous tab

1.10.3.6. Operator Characters
Note: The Rexx interpreter uses ASCII character 124 in the concatenation operator and as the
logical OR operator. Depending on the code page or keyboard for your particular country, ASCII 124
can be shown as a solid vertical bar (|) or a split vertical bar ()
should read
Note: The Rexx interpreter uses ASCII character 124 in the concatenation operator and as the
logical OR operator. Depending on the code page or keyboard for your particular country, ASCII 124
can be shown as a solid vertical bar (|) or a split vertical bar (<¦>)

1.10.3.8. Example
This example is composed of six tokens--a literal string ("REPEAT"), a blank operator, a symbol (A, which
can have an assigned value), an operator (+), a second symbol (3, which is a number and a symbol), and
the clause delimiter (;). The blanks between the A and the + and between the + and the 3 are removed.
Should read and be formatted
This example is composed of six tokens:
·	a literal string ("REPEAT")
·	a blank operator
·	a symbol (A, which can have an assigned value)
·	an operator (+)
·	a second symbol (3, which is a number and a symbol)
·	the clause delimiter (;) 
The blanks between the A and the + and between the + and the 3 are removed.

1.10.4. Implied Semicolons
• The last token was the continuation character (a comma) and
should read
• The last token was the continuation character (a comma< or a minus sign>) and

3.1 ::Atribute
Unless I’ve misunderstood what is being got at here, in the example for ::attribute size get
if datatype(size, "Whole") = .false | size < 0 then
should read:
if datatype(<value>, "Whole") = .false | <value> < 0 then

also this note doesn’t make sense to me:
Note: It is an error to specify ::ATTRIBUTE more than once within the same class and to define the
name set or get method.

4.1.4 Metaclasses
Examples Version 1 & Version 2
Although it is not dealing precisely with the material at hand, I think people may copy & adapt these examples so it is worthwhile including an unInit class for completeness:
::method uninit class
expose instanceCount /* finished with an instance */
instanceCount = instanceCount - 1 /* Decrease the count */
forward class (super) /* Forward UnInit to superclass */

4.2.6 Unknown Method
The following sentence makes no sense to me (I think it needs some context):

If you define an UNKNOWN method, you can use the following syntax:
>>-UNKNOWN(messagename,messageargs)----------------------------><

4.3.1 The class heirachy
figure 4-2 is omitted

5.1.3.6 Concatenation Methods
The examples are for arithmetic methods not concatenation methods

5.1.3.20 CaselessEquals
The text is for the wrong method (equals – not CaselessEquals)


I'll continue to read through & submit as I find stuff.

Jon

----------------------------------------------------------------------

Comment By: Rick McGuire (bigrixx)
Date: 2007-10-24 04:52

Message:
Logged In: YES 
user_id=1125291
Originator: NO

I don't think this should be done as a last second change.  Changes to
this example would need to be played with a bit.  

----------------------------------------------------------------------

Comment By: David Ashley (wdashley)
Date: 2007-10-23 20:28

Message:
Logged In: YES 
user_id=931756
Originator: NO

I fixed most of this in SVN rev 1071.

Rick - I nned you to look at the 4.1.4 item and see if this makes sense.

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=1001880&aid=1818323&group_id=119701