Hi Jean Louis
On Sat, Feb 16, 2013 at 11:31 AM, Jean-Louis Faucher
<[email protected]>wrote:
> Other possibility : keep the syntax diagram as-is, and add a comma on the
> main line, above each optional argument (except the first one, which is a
> special case here, and the last one).
> This is not yet the right description, because commas are declared
> mandatory, but the syntax is correct, and the update is more easy.
>
Actually, I don't think the update is easier. It is the time to go
through every single syntax diagram and see if it needs to be changed, and
change it, that is the hard part. My experience with working on the doc so
far, tells me that it would be very time consuming.
>
>
>
> >>--createStaticText(-+------+--x-,--y-+-,----+-+-,----+-+-,--------+-+--------+-)-><
> +-id-,-+ +-,-cx-+ +-,-cy-+ +-,-style--+
> +-,-text-+
>
>
> A more accurate description would be similar to that :
>
> >>-TIME(--+-----------------------------------+--)-------------><
> +-option--+-----------------------+-+
> +-,string--+----------+-+
> +-,option2-+
>
>
That representation is exactly what I wanted to eliminate. In ooDialog
with so many methods with optional parameters, you end of with many, many
of the syntax diagrams on two pages. Having the syntax diagram broken up
on two pages is worse than having no syntax at all in my opinion.
I'm not saying that what I'm currently doing is technically accurate. It
is easy to point out that it isn't technically accurate.
What I'm saying is, I think it is easily understandable. And, I'm saying
that the amount of time to change all the syntax diagrams to Staffan's
proposal is not time I'm willing to spend.
--
Mark Miesfeld
------------------------------------------------------------------------------
The Go Parallel Website, sponsored by Intel - in partnership with Geeknet,
is your hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials, tech docs,
whitepapers, evaluation guides, and opinion stories. Check out the most
recent posts - join the conversation now. http://goparallel.sourceforge.net/
_______________________________________________
Oorexx-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/oorexx-users
