Maybe you can generate png files from ebnf files and include then in the docbook (one file per diagram) http://en.wikipedia.org/wiki/Syntax_diagram gave me some links to explore :
Assuming you want a diagram for the DO instruction
=====
Instruction = DO [LABEL name] [repetitor] [conditional] ";"
[{instruction}] END [name].
repetitor = (control1 "=" expri [TO exprt] [BY exprb] [FOR exprf])
| (control2 OVER collection)
| (FOREVER)
| expr.
conditional = (WHILE exprw) | (UNTIL expru)
=====
I tested this declaration (copy-paste) in
http://www-cgi.uni-regensburg.de/~brf09510/syntax.html
The result is not exactly what we see in the pdf (the optional elements
are not under the main line), but it's a start.
The width of the image can be specified and the application automatically
adjusts the diagram.
I had a look at http://dotnet.jku.at/applications/Visualizer/
The look is similar but with less arrow (looks better to me). There is no
witdh adjustment, but it's possible to insert linebreaks in the ebnf using
\n
The application runs only under Windows, so not candidate.
If we find a diagram generator which runs under the build machine and if
we create one file per diagram, then a makefile could generate all the
diagrams.
Then we could reference the diagrams from the docbook files.
Jean Louis
David Ashley <[EMAIL PROTECTED]>
Sent by: [EMAIL PROTECTED]
24/08/2008 18:03
Please respond to
Open Object Rexx Developer Mailing List
<[email protected]>
To
Open Object Rexx Developer Mailing List
<[email protected]>
cc
Subject
Re: [Oorexx-devel] Railroad tracks in docs
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" ---08/24/2008 10:30:07 AM---I've never been a big fan of
railroad track diagrams for syntax
"Rick McGuire" <[EMAIL PROTECTED]>
Sent by: [EMAIL PROTECTED]
08/24/2008 10:29 AM
Please respond to
Open Object Rexx Developer Mailing List
<[email protected]>
To
"Open Object Rexx Developer Mailing List"
<[email protected]>
cc
Subject
[Oorexx-devel] Railroad tracks in docs
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
-------------------------------------------------------------------------
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
<<image/gif>>
<<image/gif>>
<<image/gif>>
<<image/gif>>
<<image/gif>>
<<image/gif>>
<<image/gif>>
<<image/gif>>
<<image/gif>>
<<image/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
