On 2010-06-05 23:57-0700 Alan W. Irwin wrote: > Hi Leo: > > I think this is a good idea. I am pretty sure the > relevant section of our DocBook source code is > > <abstract role="texinfo-node"> > <para>The PLplot Plotting Library</para> > </abstract> > > in doc/docbook/src/plplotdoc.xml.in. Anyhow, I have just made a commit > that drops the "The" there, and I am now regenerating our documentation > to see whether this change will implement what you want without screwing > up anything else.
Hi Leo: I am moving this discussion to plplot-devel for obvious reasons. You should subscribe to that list if you want to take part in the discussions. Sorry, that implementation idea did not pan out (see the commit message for revision 11064 [which reverted the change] for the details). Also, I completely forgot this question has been asked before by Orion Poplawski, but google reminded me of that. We use docbook2X to generate our info pages from DocBook source. The last release of docbook2X is version 0.8.8 done on 2007-03-03 (which is the version I have installed on my computer). After a google search I found http://permalink.gmane.org/gmane.text.docbook.docbook2x.general/264 where Orion Poplawski pursued your question with the docbook2X developer four months after the last release of docbook2X. There was a statement of intent from the docbook2X developer to deal with the issue, but since no further releases have been made, if he did do the work, it has not been released. The message also included an intriguing snippet about how to fix the problem <quote> [...]it requires a little stylesheet customization. You can add this small template: <xsl:template match="book" mode="for-menu-title"> <xsl:text>PLplot</xsl:text> </xsl:template> </quote> Orion's request for clarification of that snippet was never answered. However, from the docbook2X documentation it appears that you can generate info files with a specific docbook2X stylesheet as follows: xsltproc /usr/share/docbook2X/xslt/backend/db2x_texixml.xsl mydoc.txml and if you look in that stylesheet there are xsl:template tags of various kinds. So I believe the thing to do is copy that stylesheet (which has a MIT license) to the PLplot source tree and customize it for our own needs by adding the above snippet. I have played a bit with xsltproc and stylesheets before, and I always have trouble with it but eventually I get it to do what I want. So I am not exactly looking forward to this, but getting the correct menu entry for PLplot in the info files it is a long-standing issue that would be nice to get fixed so I will give this idea a try tomorrow unless someone else with more xslt experience than me wants to give it a go. 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 __________________________ ------------------------------------------------------------------------------ ThinkGeek and WIRED's GeekDad team up for the Ultimate GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the lucky parental unit. See the prize list and enter to win: http://p.sf.net/sfu/thinkgeek-promo _______________________________________________ Plplot-devel mailing list Plplot-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/plplot-devel
