On Sat, Feb 16, 2013 at 11:57 AM, Staffan Tylen <staffan.ty...@gmail.com>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.
>>
>>
> Nice idea, could probably be automated to a large extent. Thinking about
> it, any of the two could PROBABLY be more or less automated because the
> diagrams follow a definite pattern.
>
It probably could be automated if some one took enough time to do. I don't
think it could be *easily* automated. Well maybe by someone more skilled
than I am. ;-)
> In what format is the source to the documentation stored?
>
In DocBook
> SVN controlled?
>
Yes definitely. This is URL to the root of the docs, you need to convert
the URL to anonymous access:
svn+ssh://miesf...@svn.code.sf.net/p/oorexx/code-0/docs/trunk
This is the URL to the root of the ooDialog doc, same caveat about
converting the URL:
svn+ssh://miesf...@svn.code.sf.net/p/oorexx/code-0/docs/trunk/oodialog
> One file per chapter, section, page,...?
>
Generally in one file per related content, mostly one file per chapter, but
not always.
> I believe I saw something recently about it being changed from one mark-up
> language to another?
>
It has always been DocBook since the ooRexx project started. Some years
ago, David changed the file extension from .sgml to .xml. The more recent
change was in the tools used to compile the books. We switched from an
Open Jade tool chain to the Publican tool chain.
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.
--
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
Oorexx-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-users
