Re: [Plplot-devel] Project to replace DocBook backend SGML tools with XML tools

[Alan W. I. <ir...@be...>]

On 2013-08-24 16:50-0700 Alan W. Irwin wrote:

> On 2013-08-21 16:24-0700 Alan W. Irwin wrote:
>
>> In the next day or so I plan to play a bit more with dblatex to see if
>> I can generate dvi results with it, and I am also ready to deal with
>> any issues you find as well, but otherwise I believe I have completed
>> this project.
>
> Hi Andrew:
>
> It turned out the source of the dvi issue was a dblatex bug (see
> http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=720624 for a
> description of the problem and a patch to fix it).  Once I applied
> that patch, the dblatex command finally started working properly to
> generate dvi results both when dblatex was invoked directly
> or indirectly via "xmlto --with-dblatex".
>
> Please give the updated documentation build a spin following the
> (newly updated as of revision 12497) directions in
> doc/docbook/README.developers.  Also, please feel free to update that
> file if you feel more details about the packages required by xmlto are
> needed.
>
> Revision 12497 is the last commit I plan to do in the near term
> concerning the DocBook backend tools that we use unless you find some
> easily fixed issue in the documentation build.

Hi Andrew:

One additional piece of news for this thread is that Orion kindly ran
a number of tests, and as a result I made some additional fixups (as
of revision 12501) of the Docbook documentation build.  One of those
fixups was to empty DESTDIR before each call to xmlto.  That works
around a bug in xmlto or one of its dependencies (see
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=721366) for the case
when DESTDIR is set for the overall build.  As a result of these
fixups, I get good results for the documentation build and install
both with and without DESTDIR set for the overall build.  Furthermore,
Orion now reports complete success with a build and install (using
DESTDIR) of our DocBook documentation on Fedora.  (His test was
without dvi which will probably be removed, in any case, right after
the upcoming release when I hope to move to the pure UTF-8 approach I described
in a previous post in this thread.)

So I think I am done with refining the documentation build process for
this release cycle, but any additional testing by you of the new
documentation build on platforms accessible to you would be
appreciated so we don't get any last-minute documentation build
surprises just before the release.

My next step for this release cycle is to finish up the
pllegend/plcolorbar doxygen and DocBook documentation as discussed in
a different thread.

Alan
__________________________
Alan W. Irwin

Astronomical research affiliation with Department of Physics and Astronomy,
University of Victoria (astrowww.phys.uvic.ca).

Programming affiliations with the FreeEOS equation-of-state
implementation for stellar interiors (freeeos.sf.net); the Time
Ephemerides project (timeephem.sf.net); PLplot scientific plotting
software package (plplot.sf.net); the libLASi project
(unifont.org/lasi); the Loads of Linux Links project (loll.sf.net);
and the Linux Brochure Project (lbproject.sf.net).
__________________________

Linux-powered Science
__________________________