Re: [Plplot-devel] TeXinfo patch
On 2007-07-03 14:14-0600 Orion Poplawski wrote: Alan W. Irwin wrote: [...] I am inclined to go with your changes except keeping the overall title as is. Here's what I'm trying to produce, an info entry that looks like: * PLplot: (plplotdoc). The PLplot Plotting Library. rather than the current: * The PLplot Plotting Library: . ??? For comparison, most info entries look like: * URL: (url). URL loading package. The first item is the node name, the second is the filename, the third is the description. Without changing the title, I get: * The PLplot Plotting Library: (plplotdoc). The PLplot Plotting Library The problem with that is that info plplot won't bring you to the plplot page. I have committed the following change: Index: plplotdoc.xml.in === --- plplotdoc.xml.in(revision 7740) +++ plplotdoc.xml.in(working copy) @@ -238,6 +238,13 @@ book id=plplot-docbook bookinfo titleThe PLplot Plotting Library/title +titleabbrev role=texinfo-fileplplotdoc/titleabbrev +abstract role=texinfo-node + paraThe PLplot Plotting Library/para +/abstract +subjectset scheme=texinfo-directory + subjectsubjecttermScientific Visualization/subjectterm/subject +/subjectset abbrevDocBook/abbrev subtitleProgrammer's Reference Manual/subtitle releaseinfoVersion 5.0/releaseinfo i.e., your patch with the overall title left as is. But I am not getting the menu entry * The PLplot Plotting Library: (plplotdoc). The PLplot Plotting Library that is expected from your above notes. Instead, when I execute info plplotdoc.info the detailed node listing under Introduction is as follows: * The PLplot Plotting Library:: * Getting a Copy of the PLplot Package:: ... Am I looking in the wrong place in the menu or is this the right place, but my old software is producing a simplified menu result? Please check this commit (and the prior one) to make sure at least the filename aspect of it finally works for you. 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
Re: [Plplot-devel] TeXinfo patch
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 -titleThe PLplot Plotting Library/title +titlePLplot/title +titleabbrev role=texinfo-fileplplotdoc/titleabbrev +abstract role=texinfo-node + paraThe PLplot Plotting Library/para +/abstract +subjectset scheme=texinfo-directory + subjectsubjecttermScientific Visualization/subjectterm/subject +/subjectset abbrevDocBook/abbrev subtitleProgrammer's Reference Manual/subtitle releaseinfoVersion 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 DivisionFAX: 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
Re: [Plplot-devel] TeXinfo patch
On 2007-07-02 16:47-0600 Orion Poplawski wrote: 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 -titleThe PLplot Plotting Library/title +titlePLplot/title +titleabbrev role=texinfo-fileplplotdoc/titleabbrev +abstract role=texinfo-node + paraThe PLplot Plotting Library/para +/abstract +subjectset scheme=texinfo-directory + subjectsubjecttermScientific Visualization/subjectterm/subject +/subjectset abbrevDocBook/abbrev subtitleProgrammer's Reference Manual/subtitle releaseinfoVersion 5.0/releaseinfo These could go anywhere in the bookinfo section. Watch the line wrap above. I too am concerned with the title change. That apparently applies to the whole documentation (see first line of http://plplot.sourceforge.net/docbook-manual/plplot-html-5.7.3/) so I don't think that overall title change is acceptable. What happens if you leave titleThe PLplot Plotting Library/title as is but make the rest of your changes? I assume titleabbrev role=texinfo-fileplplotdoc/titleabbrev completely determines the output file name. Thus, what issue is solved by changing the overall title at this point? If it is not a showstopper issue for you (like the filename issue is), then I am inclined to go with your changes except keeping the overall title as is. 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
