On Wed, Sep 17, 2008 at 1:37 PM, David Ashley <[EMAIL PROTECTED]> wrote:

> I have begun experimenting with new styles for the ooRexx syntax diagrams.
> My first stab at this is located at
>
> http://build.oorexx.org/builds/release_candidates/rxftp.pdf
>
> This style has some drawbacks, especially in the area of multiple choices
> for a single method/function argument. See the FtpSetMode method for an
> example of this problem. This method argument has only two possibilities but
> we have other examples where we have as many as seven possibilities. This
> might become onerous.

I think that looks good David.

For arguments that have one of several distinct possibilities, I was
visualizing something like this:

mode
   Sets the mode for file transfers. Only the first letter of the argument
   is significant and it is not case-sensitive.  The value for mode must
   be exactly one of the following:

      PASSIVE  The transfer is done using yada yada yada

      ACTIVE  The transfer is done ....

Return Values:

Sort of like this from the ooDialog reference

options
    This argument determines the behavior
    and style of the dialog item and can be
    one or more of the following, separated
    by blanks:

      ATROOT
           The tree view has lines linking child
           items to the root of the hierarchy.

      BUTTONS
          The tree view adds a button to the
          left of each parent item.

      LINES
          The tree view has lines linking
          child items to their corresponding
          parent items.

And so on.

--
Mark Miesfeld

-------------------------------------------------------------------------
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

Reply via email to