Re: [Oorexx-devel] Building the docs

2018-12-29 Thread P.O. Jonsson
This is just for info; there has been a lot of water under the bridges since this mail but I just wanted to let you know that there exists a Publican installation (ver 3.2.1) for Docker. I could install it in virtually no-time and have it up&running on my Macbook. I tried the test examples from

Re: [Oorexx-devel] Building the docs

2018-12-27 Thread Rick McGuire
Yes, will do. Rick On Thu, Dec 27, 2018 at 4:09 AM Erich Steinböck wrote: > Just uploaded the wkhtmltopdf versions. At first glance, they look quite a >> bit better. >> > Much better, yes. > Still a few points, you'd need to get used to, like the underlined links > or the one-column index. Twe

Re: [Oorexx-devel] Building the docs

2018-12-27 Thread Erich Steinböck
> > Just uploaded the wkhtmltopdf versions. At first glance, they look quite a > bit better. > Much better, yes. Still a few points, you'd need to get used to, like the underlined links or the one-column index. Tweaking the xsl could be an option. The SVG scaling issue looks bad. As long as they

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Rick McGuire
Just uploaded the wkhtmltopdf versions. At first glance, they look quite a bit better. Rick On Wed, Dec 26, 2018 at 12:29 PM Erich Steinböck wrote: > fop-docs.zip >> > Ok .. I guess I remember this: dull fonts and no images, although it's > fop-based and you'd expect this to be as similar as po

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread René Jansen
well, that explains a number of things. Indeed it builds on your machine now; rather quickly compared to the much slower docker build on my machine. Also, I took the zip from my local machine so it really is no miracle that it ran on the same image on which it was built on. I switched to ubuntu

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread René Jansen
well, that certainly is amazing! I am going to see what happened here. Just before I stopped this activity last week I made a zip from the last build that it did, and that ran perfect on Arch Linux - but I see that might have been a ubuntu build. I checked this with a local jenkins and that went

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Erich Steinböck
> > The label ‘ubuntu16’ tells it to build on the master machine because I > know that to have a docker system running > Well, ubuntu16 is my Ubuntu VM, and I'm pretty sure it has no docker running It's seems a bit amazing that the pipeline doesn't notice that. _

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread René Jansen
Hi Erich, it uses the pipeline process on Jenkins, which is relatively new, and meant to do docker builds. It assumes a running docker system on the host, which P.O. provided. Then it executes the following build pipeline script: pipeline { agent { docker { image 'rvjansen/arch-devel' } lab

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Erich Steinböck
> > fop-docs.zip > Ok .. I guess I remember this: dull fonts and no images, although it's fop-based and you'd expect this to be as similar as possible to what we have with our ancient Publican+fop on Windows installation. On Wed, Dec 26, 2018 at 6:08 PM Rick McGuire wrote: > I just uploaded a fo

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Rick McGuire
I just uploaded a fop-docs.zip to the docs folder on Sourceforge. I still need to modify the BookInfos to add dummy abstracts before I can build the wkhtmltopdf versions. I've got to run out for a few hours, I'll get to that later. Rick On Wed, Dec 26, 2018 at 10:36 AM Erich Steinböck wrote: >

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Rick McGuire
I'm sort of in a mixed state right now. I just made a clone of my VM. I'm going to set one up for FOP and the other for wkhtmltopdf and generate a full set both ways. Rick On Wed, Dec 26, 2018 at 10:36 AM Erich Steinböck wrote: > Amazing! > How does the generated PDF look like? Images, font, ta

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Erich Steinböck
> > the one that builds ooRexx for Arch Linux now > René, can you explain the docker scenario in the Jenkins build machine? It runs on an Ubuntu slave and creates a build for Arch Linux? How does it do that? A cross-compile? Where to do the generated binaries go? What about running the regression

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Erich Steinböck
Amazing! How does the generated PDF look like? Images, font, tables, index etc. Can you upload (or else make available) the Ubuntu-built fop and wkhtmltopdf versions of any doc you have done? ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.ne

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Rick McGuire
And now I've had success building the rxmath docs with wkhtmltopdf. Adding a minimal abstract to the BuildInfo..html got past the abstract tag error, but then I hit the issue of running with the unpatched wkhtmltopdf. I found an article here showing a shell script for installing the patched version

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Rick McGuire
I found the secret sauce to get the rexxref pdf to build using FOP. Before running the make, issue export JAVA_TOOL_OPTIONS="-Xms1g -Xmx2g" This allows the pdf build to run to completion and the build runs significantly faster. I still want to see if I get get things to build with wkhtmltopdf. R

Re: [Oorexx-devel] Building the docs

2018-12-26 Thread Erich Steinböck
> > Rats, the installer gives an error trying to download components. You > might have the only working installer for this! > We really should try to keep alive our ability to build docs on Windows I've uploaded three ZIPs to https://sourceforge.net/projects/oorexx/files/windows-build-tools These

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
Rats, the installer gives an error trying to download components. You might have the only working installer for this! I'm still stuck on trying to get this to build on ubunto. If I use Fop, I get a java out of heap exception that I've not had any success at eliminating. If I install wkhtmltopdf, I

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
I found this FAQ about how to increase the FOP heap size: https://jfearn.fedorapeople.org/en-US/Publican/4.0/html/Users_Guide/chap-Publican-Users_Guide-Frequently_Asked_Questions.html#idp21915680 But it didn't seem to work. I tried going as high as 2g on the max, and it died at the same place. I'

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread René Jansen
Linux - I am planning a docker image for the build machine, like the one that builds ooRexx for Arch Linux now. René. On 25 Dec 2018, at 14:07, Erich Steinböck wrote: >> I’d like to build the docs on the build server also > Hi René, on which platform should that be: Windows or Linux? > >> Do

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rony G Flatscher
Use java -X for all switches —-rony Rony G. Flatscher (mobil/e) > Am 25.12.2018 um 22:40 schrieb Rony G Flatscher : > > Use -Xmx fir nax hesp size -Xms initial Java heap size > > —-rony > > Rony G. Flatscher (mobil/e) > >> Am 25.12.2018 um 22:35 schrieb Rick McGuire : >> >> I went back

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rony G Flatscher
Use -Xmx fir nax hesp size -Xms initial Java heap size —-rony Rony G. Flatscher (mobil/e) > Am 25.12.2018 um 22:35 schrieb Rick McGuire : > > I went back and tried rebuilding just the rexxref, and it looks like this is > a heap space problem with java. I don't know if there is a way to increas

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
I went back and tried rebuilding just the rexxref, and it looks like this is a heap space problem with java. I don't know if there is a way to increase this. Rick On Tue, Dec 25, 2018 at 3:36 PM Rick McGuire wrote: > I fired up a build on unbuntu before I left to walk my dog. It looks like > ev

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
I fired up a build on unbuntu before I left to walk my dog. It looks like everything but the rexxref built cleanly, and I think the failure there was related to the ulimit problem. When I try to issue the ulimit command you show, I get the following error: bash: ulimit: open files: cannot modify l

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Erich Steinböck
> > That could mean, Publican is dead > According to https://www.redhat.com/archives/publican-list/2017-January/msg1.html the Publican git was moved to https://sourceware.org/gerrit/#/admin/projects/publican But for me, this new site is currently unavailable. On Tue, Dec 25, 2018 at 6:51 PM E

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Erich Steinböck
> > I’d like to build the docs on the build server also > Hi René, on which platform should that be: Windows or Linux? Do you still have that email somewhere in which you explained to me what > you did? > Are you maybe referring to this thread? https://sourceforge.net/p/oorexx/mailman/message/3525

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Erich Steinböck
> > it might be better to delete wkhtmltopdf and allow it to use FOP instead > I can't remember whether I managed to get publican+fop to work on Ubuntu, but I think the idea was to create a "supported" publican environment (Jeff said, publican+fop was deprecated and wouldn't support it) which would

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread René Jansen
Hi Erich, I’d like to build the docs on the build server also. Do you still have that email somewhere in which you explained to me what you did? René. On 25 Dec 2018, at 13:51, Erich Steinböck wrote: >> OK, snag #1) fedorahosted.org has gone away > Well, as far as I understand this is where t

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Erich Steinböck
> > OK, snag #1) fedorahosted.org has gone away > Well, as far as I understand this is where the Publican git was hosted. That could mean, Publican is dead. Do you still have the installer file? Perhaps we should add that to the > buildutils directory on sourceforge. Yes, I still have it. I've pa

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
I thought I'd give the ubuntu build a try. I was able to build and install the brand successfully. Attempting to build the docs got the the phase "Starting pdf" and it has been sitting there for a long time. I don't know it it is hung, or just taking a really long time. This is using the latest pub

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
OK, snag #1) fedorahosted.org has gone away and I haven't been able to find another source for publican 3.0. Do you still have the installer file? Perhaps we should add that to the buildutils directory on sourceforge. Rick On Tue, Dec 25, 2018 at 10:18 AM Erich Steinböck wrote: > I'm building o

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Gil Barmwater
I, too, was under the impression that the docs were built on *ix, not Windows!  Once we have a tested "recipe" for doing it, I'll attempt to get it working on my system as well.  That way, when I find typos, etc., I can edit/build and supply a "tested" patch that a committer can confidently app

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
I didn't realize you were doing this on Windows...I'd actually prefer that. Years ago David stated Windows would not be possible, so I didn't realize that had changed. I'll give that a shot. I ran into an immediate road block with your ubuntu instructions. The patched version doesn't appear availa

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Erich Steinböck
I'm building on Windows only, using an ancient, unsupported version of publican plus fop for Windows I changed some settings, like single-page formatting and added a crude manual cleaning-step which removes a lot of annoying whitespace around examples. Windows was (and still seems) the only way to

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Rick McGuire
I'll give it a go...how are you building the docs now if not this way? Rick On Tue, Dec 25, 2018 at 9:30 AM Erich Steinböck wrote: > I tried this some two or three years ago, and it was a miserable > experience. > I've attached below my notes from back then. > > If you want to give it a try, pl

Re: [Oorexx-devel] Building the docs

2018-12-25 Thread Erich Steinböck
I tried this some two or three years ago, and it was a miserable experience. I've attached below my notes from back then. If you want to give it a try, please note down each step as accurately as possible. If we get somewhere, I'll add the steps required to our Wiki. I tried getting help for a f