I'm a little iffy on moving the set operation section to before the classes (and the methods they use) are documented.  I'd be more comfortable leaving that after.  There's also a section on sorting that I gave to David that really should be at the end, so it will have company.

Rick

On 7/25/07, Rony G. Flatscher <Rony.Flatscher@wu-wien.ac.at> wrote:
Hi David,

To clarify what I am proposing I created a version of the docs that has my proposed organization.

http://build.oorexx.org/builds/docs/626/rexxreff-proposed.pdf

The only difference is in the organizations of the collection classes section.

Please let me know what you think.


How about:

5.3. The Collection Classes
5.3.1 General Concepts of Collection Classes
5.3.1.1 Classifying Collections
5.3.1.2 Setlike Operations on Collections
5.3.1.3 Hierarchical Overview of the Collection Classes
5.3.2 Collection Classes Ordered by Name
5.3.2.1 The Array Class
5.3.2.1.1 Inherited Methods
5.3.2.1.2 Defined Methods
5.3.2.1.2.1 new (Class Method)
5.3.2.1.2.2 of (Class Method)
5.3.2.1.2.3 []
...
5.3.2.1.3 Sorting Arrays
5.3.2.1.4 Examples

5.3.2.2 The Bag Class
...
5.3.2.16 The Table Class
Remarks:
  • Created a new heading at the "Inherited Methods" level, entitled "Defined Methods"; all locally defined methods are then listed a level deeper
    • for the Array class moved "5.3.17. Sorting Arrays" to "5.3.2.1.3 Sorting Arrays", aligned at the same hierarchy level as "5.3.2.1.1 Inherited Methods", "5.3.2.1.2 Defined Methods" and finally moved "5.3.2.34. Examples" to "5.3.2.1.4 Examples" (aligned with "Inherited Methods" etc.)
    • would suggest introducing "5.3.2.x.2 Defined Methods" in all classes, examples should be moved to level "5.3.2.x.4 Examples"
  • moved "5.3.18. The Concept of Set Operations" to "5.3.1.2 Setlike Operations on Collections"
HTH,

---rony


-------------------------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc.
Still grepping through log files to find problems?  Stop.
Now Search log events and configuration files using AJAX and a browser.
Download your FREE copy of Splunk now >>  http://get.splunk.com/
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel