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>
> -    <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.

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

<title>The PLplot Plotting Library</title>

as is but make the rest of your changes? I assume

<titleabbrev role="texinfo-file">plplotdoc</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

Reply via email to