Hi P.O.,
On 06.02.2023 22:56, ooRexx wrote:
I failed to notice that the machine used for building the documentation was offline for some time.
I have reconnected it and it will start to rebuild any changed documentation within an hour or so.
This line seems to take ages to get past, seems to be a huge file. What is it?
A oorexxdocSVN/tools/RailRoadDiagrams/rr-1.67-java8.zip
It is the stand-alone RailroadDiagram Generator from the Welcome tab of
<https://www.bottlecaps.de/rr/ui>, where you have a Download link at the bottom. Thought this to be
very handy to have in the tools subdirectory as it makes us independent of that web site (which
might go away one day who knows): it allows for generating the reaildiagrams via the command line
and also getting a stand-alone GUI (it is a web application that can start on your local machine and
to which you can connect from a local browser with <http://localhost:8080> by default).
The zip file is not needed as the RailroadDiagram folder contains the unzipped version of it (I
understand a version 2.0 is in the works). Here the files with their sizes (altogether 20 MB):
18.01.2023 13:59 <DIR> LICENSE
18.01.2023 13:59 1 465 README.txt
04.02.2023 18:07 10 283 724 rr-1.67-java8.zip
18.01.2023 13:59 10 273 733 rr.war
If you run it with "java -jar rr.war" you will get the options:
F:\work\svn\oorexx\docs\trunk\tools\RailRoadDiagrams>java -jar rr.war
RR - Railroad Diagram Generator
version 1.67
released Jan 18, 2023
fromhttps://bottlecaps.de/rr
Usage: java -jar rr.war
{-suppressebnf|-keeprecursion|-nofactoring|-noinline|-noepsilon|-color:COLOR|-offset:OFFSET|-png|-md|-out:FILE|width:PIXELS}...
GRAMMAR
or java -jar rr.war -gui [-port:PORT]
-suppressebnf do not show EBNF next to generated diagrams
-keeprecursion no direct recursion elimination
-nofactoring no left or right factoring
-noinline do not inline nonterminals that derive to single literals
-noepsilon remove nonterminal references that derive to epsilon only
-color:COLOR use COLOR as base color, pattern: #[0-9a-fA-F]{6}
-offset:OFFSET hue offset to secondary color in degrees
-png create HTML+PNG in a ZIP file, rather than XHTML+SVG
output
-out:FILE create FILE, rather than writing result to standard
output
-width:PIXELS try to break graphics into multiple lines, when width
exceeds PIXELS (default 992)
-enc:ENCODING set grammar input encoding (default: autodetect UTF8/16
or use system encoding)
GRAMMAR path of grammar, in W3C style EBNF (use '-' for stdin)
-gui run GUI onhttp://localhost:8080/
-port:PORT use PORT rather than 8080
rr.war is an executable war file. It can be run with "java -jar" as shown
above, but it can also be deployed in servlet containers like Tomcat or
Jetty.
Not having realized that this might incur problems because of the sizes I will remove the directory
altogether but leave the companion script "docs/trunk/tools/extract_svg_from_rr_xhtml.rex" which
extracts the svg definitions from the generated xhtml files thereby switching the styling
information to the styles the ooRexx project currently uses in its documentation (greyscale, no
colors).
In addition I will add a RailRoadDiagram-readme.txt file to "docs/trunk/tools" where a brief
information is given about creating the syntax diagrams with this tool, where to get it, such that
everyone who wishes can autonomeously find, download and use that utility.
HTH
---rony
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
