On 2013-10-05 16:55-0700 Alan W. Irwin wrote: > As of revision 12582, I have implemented this change [to pure UTF-8 approach] which I hope is > the last fundamental change in how we generate our documentation for > years to come. I have also substantially updated > doc/docbook/README.developers[...] > > The summary is the results for UTF-8 documentation are much improved > compared to previously, and we are probably doing the best that is > possible. Nevertheless, there are still some limitations due to > system and tool issues. See the updated doc/docbook/README.developers > for discussion of those UTF-8 details[....]
To resurrect this 3-month-old thread, today for the first time I introduced UTF-8 symbols into api.xml. As expected from previous tests which included an extensive UTF-8 table in advanced.xml, those results rendered properly for the html, pdf, and info backends for our DocBook documentation. However, this was the first opportunity I had to test what happens with UTF-8 symbols with the man backend since that backend ignores all our DocBook files except for api.xml. I horsed around with nroff -man options, but could never get a good rendering of those symbols so I was a bit discouraged by that initial result, but finally I tried the actual man viewer and not "nroff -man" (by copying the relevant man pages to a temporary directory man/man3 and using "man -M./man <command name>"), and that method of testing our man pages rendered the UTF-8 symbols without issues. So I am happy with our generated man pages which include UTF-8 symbols, and (as of revision 12959) I have updated doc/docbook/README.developers accordingly. 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); the Time Ephemerides project (timeephem.sf.net); PLplot scientific plotting software package (plplot.sf.net); 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 __________________________ ------------------------------------------------------------------------------ CenturyLink Cloud: The Leader in Enterprise Cloud Services. Learn Why More Businesses Are Choosing CenturyLink Cloud For Critical Workloads, Development Environments & Everything In Between. Get a Quote or Start a Free Trial Today. http://pubads.g.doubleclick.net/gampad/clk?id=119420431&iu=/4140/ostg.clktrk _______________________________________________ Plplot-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/plplot-devel
