On Sat, Feb 16, 2013 at 1:07 PM, Staffan Tylen <[email protected]>wrote:
>
> I would heartily encourage any one with the slightest leanings towards
>> working on the doc, especially the ooDialog doc to go for it. Patches are
>> always welcome. Contributing some patches will get you well on your way to
>> being nominated as a committer. As a committer you can take over the job
>> of documenting ooDialog and I will quickly give it up.
>>
>>
> That's what we are all afraid of :)
>
> I will have a look if we can get a quick solution to this, as long as we
> are in agreement that this is what we all want. Anyone against, please
> stand up!
>
I have no objection to using the syntax style you proposed. I will go so
far as to say your style is better and more correct than mine.
I don't think the style change Jean-Louis first proposed, adding a comma on
the main line, is less confusing than the current style and I would
probably object to making that change.
My goals are:
1.) Be able to have almost every syntax diagram fit on, at most, 2 lines.
There are a very few methods where that is not possible.
2.) Have all the syntax diagrams use the same style throughout the whole
book. There are still places where the IBM style has not been converted.
The only reason for that is time, converting the syntax is time consuming.
3.) Be able to keep incrementally updating the ooDialog doc.
So, I would object to anything that defeats those goals. Because of #3,
the change from the syntax diagrams I've already done to the new style,
needs to be done in a reasonably short period of time. Essentially in one
step, but over a couple of days, or a week at most, would not be
unreasonable.
--
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
