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
from https://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 on http://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[email protected]https://lists.sourceforge.net/lists/listinfo/oorexx-devel