The problem with the MFC syntax is that he used a character for options (the square brackets) that were not a part of classic Rexx. With ooRexx I think it would be confusing since square brackets are a part of the character set.
But I am open to other ideas and alternatives. I am not much of a fan of
the railroad diagrams either.
Thanks,
W. David Ashley
IBM Systems and Technology Group Lab Services
Open Object Rexx Team
Mobile Phone: 512-289-7506
"Rick McGuire"
<[EMAIL PROTECTED]
l.com> To
Sent by: "Open Object Rexx Developer Mailing
oorexx-devel-boun List"
[EMAIL PROTECTED] <[email protected]
orge.net >
cc
08/24/2008 10:29 Subject
AM [Oorexx-devel] Railroad tracks in
docs
Please respond to
Open Object Rexx
Developer Mailing
List
<[EMAIL PROTECTED]
ts.sourceforge.ne
t>
I've never been a big fan of railroad track diagrams for syntax
diagrams, but they were an IBM standard so they sort of got imposed on
the Object Rexx docs. Now that I've had to update a few of these, I'm
even less of a fan of these. I find them hard to read, hard to
update, and easy to get wrong. I much prefer the simpler syntax that
MFC used in TRL. For example, here's the railroad track diagram for
OVERLAY()
>>-OVERLAY(new,target------------------------------------------->
>--+---------------------------------------+--)----------------><
+-,--+---+--+-------------------------+-+
+-n-+ +-,--+--------+--+------+-+
+-length-+ +-,pad-+
vs. Mike's syntax in TRL:
OVERLAY(new,target[,[n][,[length][,pad]]])
This is much easier to scan from left-to-right to see what arguments
are optional, and is also easier to update to add additional
arguments. Anybody else in favor of changing this?
Rick
-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's
challenge
Build the coolest Linux based applications with Moblin SDK & win great
prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Oorexx-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
<<inline: graycol.gif>>
<<inline: pic28771.gif>>
<<inline: ecblank.gif>>
------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________ Oorexx-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/oorexx-devel
