[Plplot-devel] New documentation at our SF website

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

Joao, please have a look at
http://plplot.sourceforge.net/resources/docbook-manual/plplot-html-5.2.0/
to see the results of your api.xml changes (as
corrected by Rafael and me, and just built and www-installed by me).  The
corrections I applied concerned adding the new plenv0 entity to
plplotdoc.xml.in, fully defining plenv0 (including a full description of the
arguments), using the correct <sect1> attributes for plotsh3d, and correcting
badly nested tags.  Actually these fixes are no problem at all, and I want
to encourage you to continue documenting this way.

Rafael, there is still one openjade error left when you build the
documentation;

openjade  -d plplotdoc-print.dsl -t tex \
  -o plplot-5.2.0.jadetex /usr/lib/sgml/declaration/xml.dcl plplotdoc.xml

openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/print/dbttlpg.dsl:2635
:6:E: flow object not accepted by port; only display flow objects accepted
jadetex plplot-5.2.0.jadetex

I don't know how to fix this one, but I also don't think it has anything to
do with the recent api.xml changes.

I am also having some other www-install troubles for non-html results
which I am investigating further.

All these issues have occurred for the Debian build of the documentation.
Sorting out the rest of the problems (other than the above openjade error)
may take the rest of the day so it is unlikely I will be able to address
RedHat documentation build problems today.

Alan

__________________________
Alan W. Irwin
email: ir...@be...
phone: 250-727-2902

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

Programming affiliations with the Canadian Centre for Climate Modelling and
Analysis (www.cccma.bc.ec.gc.ca) and the PLplot scientific plotting software
package (plplot.org).

__________________________

Linux-powered Science
__________________________