Rony, I'd rather avoid introducing new terminology like "specializes", "constructor" or "destructor" - none of our ooRexx docs use it. When changing docs, I always try to keep the new wording similar to the current style and terminology.
Using hard-coded cross-book references like below doesn't seem to be a good idea (and rexxref really isn't called "Open Object Reference Documentation" either). Open Object Reference Documentation, section "4.2.11 Required String Values" I noticed instances where the SAY instruction is marked with <methodname> tags. On Thu, Apr 9, 2020 at 12:55 AM Rony G. Flatscher <rony.flatsc...@wu.ac.at> wrote: > At [1] you will find two versions of "rexxpg.pdf": > > - "rexxpg-before-changing-chapter-5.pdf" > - and the latest draft "rexxpg.pdf" > > There has been a *lot* of work in correcting, completing, updating, > enhancing this chapter which among other things contained outright wrong > information like: > > say myarray /* SAY sends STRING message to Myarray */ > Results: > an Array > Whenever a method > > The SAY instruction does *not* send the string message, rather the > required string mechanism gets triggered for such instructions or classic > Rexx built-in functions, the output has changed as Array's makestring > method employs its tostring method which turnes the array object to a > string where each stored item's string value is listed in its own line > (items are separated by CR-LF). > > There are many places where a reader, especially a newcomer cannot realize > what the term "variable" denotes in which context. Now that we have an > attribute directive I added in parentheses that term to make it a) clear > that an object/instance variable a.k.a. attribute is meant and b) that the > relationship to the attribute directive becomes clear. > > Many little things got tackled as well, like wrong examples or new > examples to demonstrate the environment object .syscargs, markup at wrong > places, ... > > As this was more than a day's work and I am not a native English speaker I > would really appreciate if some native speakers would proof-read that > chapter 5, A Closer Look at Objects. If something is unclear or the English > needs corrections or brush ups, please let me know. Chances are that you > learn something new as a price! ;-) > > ---rony > > [1] Temporary Dropbox link to the above books: < > https://www.dropbox.com/sh/gxvvgskb04gdsqf/AACRo_ZLeFOdoBXUHroPY_-Ca?dl=0> > > > _______________________________________________ > Oorexx-devel mailing list > Oorexx-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/oorexx-devel >
_______________________________________________ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
