On 2007-06-29 17:04-0600 Orion Poplawski wrote:
>
>>
>> Hmm. docbook2texi isn't mentioned in our documentation build. Looking
>> at the docbook2texi man page it is concerned with SGML. We use the XML
>> version of docbook instead.
>>
>> Looking at doc/docbook/src/CMakeLists.txt, the info files are created by a
>> series of custom commands involving the ${DB2X_XSLTPROC}, ${DB2X_TEXIXML},
>> and ${MAKEINFO} commands which correspond (from
>> cmake/modules/docbook.cmake)
>> to db2x_texixml, db2x_xsltproc, and makeinfo.
>>
>> I am unfamiliar with all these docbook-related commands (they were
>> originally Rafael's responsibility), but if you find some additional
>> options
>> to one of db2x_texixml, db2x_xsltproc, or makeinfo that will do what you
>> want, then it should be easy for you to change the CMakeLists.txt file to
>> add the required options to any of those commands, and I would be happy
>> to commit that CMakeLists.txt change.
>
> I'm running into a couple of problems building the documentation in Fedora
> Development (unsurprising I expect). The first is some xml issues, which the
> following fixes:
>
> Index: doc/docbook/src/api-fortran95.xml
> ===================================================================
> --- doc/docbook/src/api-fortran95.xml (revision 7726)
> +++ doc/docbook/src/api-fortran95.xml (working copy)
> @@ -243,6 +243,8 @@
> </para>
> </listitem>
> </varlistentry>
> + </variablelist>
> + </para>
> </sect1>
>
> <sect1 id="plshadefortran95" renderas="sect3">
>
Thanks! Just committed that change.
>
>
> Second is something I think I reported before, which is that nothing in
> plplot calls perl's XML::SAX::Expat parser:
>
> Index: cmake/modules/docbook.cmake
> ===================================================================
> --- cmake/modules/docbook.cmake (revision 7726)
> +++ cmake/modules/docbook.cmake (working copy)
> @@ -56,7 +56,6 @@
> # Check for required programs and perl libraries.
> if(BUILD_DOC)
> if(PERL_FOUND)
> - check_perl_modules(PERL_XML_SAX XML::SAX::Expat)
> check_perl_modules(PERL_XML_PARSER XML::Parser)
> check_perl_modules(PERL_XML_DOM XML::DOM)
> endif(PERL_FOUND)
> @@ -99,13 +98,13 @@
> set(BUILD_HTML ON)
> set(BUILD_PRINT ON)
>
> - if(NOT PERL_FOUND OR NOT PERL_XML_SAX OR NOT DB2X_TEXIXML OR NOT
> DB2X_XSLTPROC OR NOT MAKEINFO)
> + if(NOT PERL_FOUND OR NOT DB2X_TEXIXML OR NOT DB2X_XSLTPROC OR NOT
> MAKEINFO)
> set(BUILD_INFO OFF)
> message(STATUS
> "WARNING: Not building info documentation - "
> "required programs are missing"
> )
> - endif(NOT PERL_FOUND OR NOT PERL_XML_SAX OR NOT DB2X_TEXIXML OR NOT
> DB2X_XSLTPROC OR NOT MAKEINFO)
> + endif(NOT PERL_FOUND OR NOT DB2X_TEXIXML OR NOT DB2X_XSLTPROC OR NOT
> MAKEINFO)
>
> if(NOT PERL_FOUND OR NOT PERL_XML_PARSER OR NOT PERL_XML_DOM)
> set(BUILD_MAN OFF)
>
I did a check for SAX appearing anywhere in the source tree, and I agree
that XML::SAX::Expat appears at first glance not to be needed. However, it
could be a "hidden" dependency (something used internally in the docbook2x
system software) that Rafael was aware of. The reason why I am concerned
about this possibility is if I attempt to remove libxml-sax-expat-perl
(which contains XML::SAX::Expat) on Debian sarge, it also requires me to
remove docbook2x (which contains /usr/bin/db2x_xsltproc and
/usr/bin/db2x_texixml).
In sum, I cannot remove XML::SAX::Expat myself on Debian sarge to test the
possibility that it is really not needed. However, if it turns out it is
possible for you to completely build the documentation without
XML::SAX::Expat installed, I will drop the check.
>
> Next, which I haven't tackled yet and I'm leaving for the day:
>
> Generating plplotdoc.texi
> cd /builddir/build/BUILD/plplot-5.7.3/fedora/doc/docbook/src &&
> /usr/bin/db2x_texixml
> /builddir/build/BUILD/plplot-5.7.3/fedora/doc/docbook/src/plplotdoc.txml
>
> produces:
>
> ./doc/docbook/src/the_plplot_plotting_library.texi
>
> not doc/docbook/src/plplotdoc.texi like it used to.
This issue does not occur on my Debian sarge system:
[EMAIL PROTECTED]> ls doc/docbook/src/*.texi
doc/docbook/src/plplotdoc.texi
It appears from the doc/docbook/src/CMakeLists.txt file where the custom
command that defines /plplotdoc.texi is defined that the output file name
depends on some default output name supplied by db2x_texixml which probably
changed for your version of db2x_texixml. I ran db2x_texixml with the
--list-files option to show only one file is produced by that command.
That means we can use the --to-stdout option to specify the output file
name directly which is obviously better than relying on a default output
file name.
I have svn committed such a change. It works for me on Debian sarge, and
I believe it should work for you as well.
Let me know how it goes.
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); PLplot scientific plotting software
package (plplot.org); 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
__________________________
-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Plplot-devel mailing list
Plplot-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/plplot-devel
