Alan W. Irwin wrote: > 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.
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. /usr/bin/db2x_xsltproc uses the <title> to set the node name and file name by default. You can override the file name (at least with 0.87) with the texinfo-file entry. I have not yet found a way to override the title yet. I've posted a message to the docbook2X mail list, but that doesn't look like a promising place. I've tried reading the xsl stuff, but it's mostly gobbledy gook to me. -- 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
