I have now added a warning message to the doc2fo.cmd script that running
it may take several minutes. I experimented with the --timing switch but
most of the time is spent in one spot so it still appears to be "hung"
there so I didn't put it in. I have added the ability, however, to
provide additional parameters to the xsltproc program so that the user
could specify that they wanted to use that flag (or others) without
having to modify doc2fo.cmd.
I also found the parameter that controls the TOC depth! I have set it to
3 to match our historical document appearance but, by using the same
mechanism mentioned above, a user could change it to 4 if they prefer
that look. I need to document how to use this option (as well as a
corresponding one for FOP which would allow one to change the JAVA heap
space) and build a new package. I will wait a day, however, in case
there is additional feedback that I can incorporate.
Gil
On 2/25/2020 9:57 AM, Rony G. Flatscher wrote:
Dear Gil,
On 25.02.2020 15:31, Gil Barmwater wrote:
Thanks so much for the feedback! I was unaware of the "timing " switch so will
consider adding
that to my package in order to give the user some indication that things are
still running. On my
laptop the transform step also takes >5 minutes when building the rexxref so
some visual feedback
would be helpful.
Yes, or simple warning that some books may take ten minutes or more (if they
get built faster and
faster over time, no one would complain ;) ), then the user's expectation are
"managed" to take time
and patience to wait...
Ad the TOC: the build of ooRexx 5.0.0 that I have installed is at 11978 which
includes a rexxref
at 11974. That version only has three levels of entries compared to what my
package produces which
has four. I have not checked any other more recent versions of the rexxref so
I'm not sure when
the fourth level was introduced. As I mentioned to P.O., the extra level seems
to me a bit
distracting but I am happy to leave it in if that is the general consensus of
the development
team. It should also be noted that even if there are only three levels in the TOC, the
"bookmarks"
displayed by Acrobat Reader on the left of the document do contain all four
levels making
navigation to a specific section simple.
Oh, o.k. I see now.
Personally, I actually like it as one can get an even better overview of the
structure and the
concepts that get documented there.
---rony
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
--
Gil Barmwater
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
