>
> However, the syntax diagrams for default values are still incorrect in
> rexxref5.pdf; they should appear on a branch Above the main line, not on
> the main line itself:
>
When David changed from the ASCII to the SVG diagrams, he chose
bottlecaps.de/rr. This raiload generator doesn't support all of the
features the ASCII diagrams were using.You may want to test bottlecaps.de/rr
with the stream BIF
<http://bottlecaps.de/rr/ui?text=stream%20::=%20%27STREAM%28%27%20name%20%28%20%27,%27%20%28%20%27State%27%20|%27Command%27%20%27,%27%20stream_command%20|%27Description%27%20%29%20%29?%20%27%29%27stream_command%20::=%20%28%20%28%20%27Open%27%20%28%20%27BOth%27%20write_options%20|%20%27REAd%27%20|%20%27Write%27%20write_options%20%29?%20options%20%29%20|%28%20%27Close%27%20%29%20|%28%20%27Flush%27%20%29%20|%28%20%28%20%27Seek%27%20|%20%27Position%27%20%29%20%28%20%27=%27%20|%20%27%3C%27%20|%20%27+%27%20|%20%27;%27%20|%20%28%29%20%29%20offset%20%28%20%27Read%27%20|%20%27Write%27%20|%20%29%20%28%20%27Char%27%20|%20%27Line%27%29%20%29%20|%28%20%27Query%27%20%28%20%27Datetime%27%20|%27Exists%27%20|%27Handle%27%20|%28%20%27Seek%27%20|%20%27Position%27%20%29%20%28%20%28%27Read%27%20|%20%27Write%27%20%29%20%28%20%27Char%27%20|%27Line%27%29?%20|%27Sys%27%20%29%20|%28%20%27SIze%27%20%29%20|%28%20%27STreamtype%27%20%29%20|%28%20%27Timestamp%27%20%29%20%29%20%29%29%20%27%29%27stream_write_options%20::=%20%28%20%28%29%20|%20%27APpend%27%20|%20%27REPlace%27%20%29stream_options%20::=%20%28%20%27SHARED%27%20|%20%27SHARERead%27%20|%20%27SHAREWrite%27%20%29?%28%20%27NOBuffer%27%20|%20%27BInary%27%20%28%20%27REClength%27%20length%20%29?%20%29*>
.
stream ::= 'STREAM(' name ( ',' ( 'State' |
'Command' ',' stream_command |
'Description' ) )? ')'
stream_command ::= ( ( 'Open' ( 'BOth' write_options | 'REAd' | 'Write'
write_options )? options ) |
( 'Close' ) |
( 'Flush' ) |
( ( 'Seek' | 'Position' ) ( '=' | '<' | '+' | ';' | ()
) offset ( 'Read' | 'Write' | ) ( 'Char' | 'Line') ) |
( 'Query' ( 'Datetime' |
'Exists' |
'Handle' |
( 'Seek' | 'Position' ) ( ('Read' |
'Write' ) ( 'Char' |
'Line')? |
'Sys' ) |
( 'SIze' ) |
( 'STreamtype' ) |
( 'Timestamp' ) ) )
) ')'
stream_write_options ::= ( () | 'APpend' | 'REPlace' )
stream_options ::= ( 'SHARED' | 'SHARERead' | 'SHAREWrite' )?
( 'NOBuffer' | 'BInary' ( 'REClength' length )? )*
Only a small fraction of diagrams use the default-above-main path
convention, many default values easily cannot be described in that way.
bottlecaps.de/rr doesn't support the default-above-line convention, so you
would need to find another tool to generate the SVG's or convince the
bottlecaps.de/rr owner to implement it. I've already talked to him about
a) displaying the main path *above *any optional items (bottlecaps.de/rr
currently generates the main path *below *optional items), b) I mentioned
the default-above-line convention, and c) asked about italic font for
non-terminal items (which we "use" as variables). He says, he has done
some tests regarding a) but he hasn't published that yet. He isn't
convinced about b) or c).
I would be glad to work on the syntax diagrams, if someone would be kind
> enough to explain the tools involved (SVG, DocBook, ...?).
I'll gladly share everything I know about that. When just working on the
diagrams you will not need any knowledge of DocBook or Publican. You'll
just need to generate SVG's from the EBNF files in SVN.
Note that there are currently 1000+ SVG's in the SVN.
I have worked on (checked & corrected) some of the SVG's. You can
recognized the ones I went through - those already use italic font for
variables (I'm adding italic font in a special SVG post-processing step).
Erich
On Mon, Jun 15, 2015 at 3:06 AM, J. Leslie Turriff <[email protected]>
wrote:
> However, the syntax diagrams for default values are still incorrect in
> rexxref5.pdf; they should appear on a branch Above the main line, not on
> the main line itself:
>
> ►►─command┬default┬──────────►◄
>
> ├option1┤
>
> ├option2┤
>
> └option3┘
>
> should look like this:
>
> ┌default┐
>
> ►►─command┼───────┼──────────►◄
>
> ├option1┤
>
> ├option2┤
>
> └option3┘
>
> I would be glad to work on the syntax diagrams, if someone would be kind
> enough to explain the tools involved (SVG, DocBook, ...?).
>
> Leslie
>
> On Sunday 14 June 2015 10:56:55 Rony G. Flatscher wrote:
>
> > Hi there,
>
> >
>
> > just saw that Erich committed an actual set of the PDF documentation at
>
> > <https://sourceforge.net/projects/oorexx/files/oorexx-docs/5.0.0alpha/>
> a
>
> > few moments ago where you can get <rexxref5.pdf> from!
>
> >
>
> > ---rony
>
> --
>
> It’s good to be open-minded, but not so open-minded that your brain falls
> out.
>
>
> ------------------------------------------------------------------------------
>
> _______________________________________________
> Oorexx-devel mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/oorexx-devel
>
>
------------------------------------------------------------------------------
_______________________________________________
Oorexx-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
