Alan W. Irwin wrote:
> On 2007-06-29 17:04-0600 Orion Poplawski wrote:
>>
>> Second is something I think I reported before, which is that nothing
>> in plplot calls perl's XML::SAX::Expat parser:
>
> 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.
>
The point is that the nothing in plplot *itself* requires
XML::SAX::Expat, not that XML::SAX::Expat is needed at all. You just
need the db2x_* utilities. Whatever packages provides those need to be
concerned about XML::SAX::Expat, not plplot.
>>
>> 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.
>
>
> 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.
Argh, looks like there is a bug in docbook2X 0.8.7 that causes
--to-stdout to be ignored, so that doesn't work. Looks like this has
been around for a while so make sure you aren't ending up with an empty
plplotdoc.texi in addition to the_plplot_plotting_library.texi.
But, I think I've figured out how to fix this in the xml source. What I
don't like it that it changes the <title> but I haven't found a way
around this yet. Not sure what else it affects. In any case, this
generates a proper .info file now.
--- plplotdoc.xml.in (revision 7739)
+++ plplotdoc.xml.in (working copy)
@@ -237,7 +237,14 @@
<book id="plplot-docbook">
<bookinfo>
- <title>The PLplot Plotting Library</title>
+ <title>PLplot</title>
+ <titleabbrev role="texinfo-file">plplotdoc</titleabbrev>
+ <abstract role="texinfo-node">
+ <para>The PLplot Plotting Library</para>
+ </abstract>
+ <subjectset scheme="texinfo-directory">
+ <subject><subjectterm>Scientific
Visualization</subjectterm></subject>
+ </subjectset>
<abbrev>DocBook</abbrev>
<subtitle>Programmer's Reference Manual</subtitle>
<releaseinfo>Version 5.0</releaseinfo>
These could go anywhere in the "bookinfo" section. Watch the line wrap
above.
--
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
