>
> 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">
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)
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.
I'll take a look again on monday.
--
Orion Poplawski
Technical Manager 303-415-9701 x222
NWRA/CoRA Division FAX: 303-415-9702
3380 Mitchell Lane [EMAIL PROTECTED]
Boulder, CO 80301 http://www.cora.nwra.com
-------------------------------------------------------------------------
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
