OK, I'm going to show my ignorance here but it seems someone should at least explore replacing the unsupported/broken publican with pandoc.?? I've done some cursory searching and reading about pandoc and it seems to be a "good" tool; i.e. it has many conversion options and seems to have a reasonably sized base of users.?? So it looks like it can take an input file in DocBook format - that is what we are using , right? - and produce both HTML and PDF output formats.?? But it looks like the PDF option needs another tool, e.g.LaTex.?? Is that what we use or is FOP or something else our PDF-maker??? As I said, I'm really ignorant here but I'm willing to slog through it if I can get some guidance. What should be the first step?

Gil B.

On 10/30/2019 12:34 PM, Erich Steinb??ck wrote:

    I'm not really that comfortable with relying on an old version of
    tools that don't really have any support any more

The issue has become even more serious since switching over to Windows 10.
All ooRexx docs still build (with slightly less appealing fonts) except for rexxref. Tested on two Win 10 machines, any rexxref build fails with a c0000005 exception about 99% of the time, but eventually successfully builds in 1 out of a 100 tries.?? A real pain.

Although publican is an exe we still might be able to figure out where the crash occurs (and maybe fix it), because publican.exe really is a PAR-packed ZIP file of (Strawberry) Perl scripts and native libraries.?? The scripts can be extracted with a simple unzip and it might be possible to run them in Perl debug mode, figure out where it breaks and replace the culprit with a newer version (or bring all stuff to the latest Perl version).

I tried a bunch of things but with no success yet.

On Wed, Oct 30, 2019 at 1:56 PM Rick McGuire <object.r...@gmail.com <mailto:object.r...@gmail.com>> wrote:

    There was a long discussion on how to get this set up that took
    place on this list back in January of this year. The net of this
    discussion was that while it was possible to build the docs on
    linux, the results were not as good as the version built on
    Windows. Getting a working setup on Windows required a good bit of
    manual tweaking and installing very specific versions of publican.
    I believe Erich made a snapshot of his build tools available for
    download on Sourceforge.

    I don't know if anybody has every tried pandoc. I would be nice if
    it did work, since I'm not really that comfortable with relying on
    an old version of tools that don't really have any support any more.

    Rick

    On Wed, Oct 30, 2019 at 8:22 AM Rony G. Flatscher
    <rony.flatsc...@wu.ac.at <mailto:rony.flatsc...@wu.ac.at>> wrote:

        Following the communication in the past it seems that
        currently a special publican setup on Windows
        is necessary. Is there any "cheat-sheet"/"todo-list"
        documentation available on the Internet (did
        not find anything on the ooRexx wiki
        <https://sourceforge.net/p/oorexx/wiki/Home/>)?

        Would publican (https://pkgs.org/download/publican) for Linux
        be able to process the ooRexx
        documentation? If not, would anyone know of the reason(s)?

        ---

        Has anyone ever tried to process the ooRexx documentation with
        "pandoc" (https://pandoc.org/), which
        would be available for all major platforms for free?

        ---rony




        _______________________________________________
        Oorexx-devel mailing list
        Oorexx-devel@lists.sourceforge.net
        <mailto:Oorexx-devel@lists.sourceforge.net>
        https://lists.sourceforge.net/lists/listinfo/oorexx-devel

    _______________________________________________
    Oorexx-devel mailing list
    Oorexx-devel@lists.sourceforge.net
    <mailto:Oorexx-devel@lists.sourceforge.net>
    https://lists.sourceforge.net/lists/listinfo/oorexx-devel



_______________________________________________
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

Reply via email to