On 2014-03-26 22:53-0000 Andrew Ross wrote:

> That [deploying our own patched version of __makeinfo__.m] sounds like it 
> might be a wise option, though we should check that any such
> file works with at least octave 3.6 and 3.8.

Hi Andrew:

I am putting this thread back on the list for obvious reasons.

@others: To review the issue, the documentation strings that are
propagated from api.xml to bindings/swig-support/swig_documentation.i
contain utf8 symbols (i.e., look at the documentation of plplot3dcl in
that file which contains the utf8 "greater than or equal symbol",
≥).  But the corresponding octave on-line help for plplot3dcl was
truncated just before the utf8 character because of an Octave bug. 
The octave mailing lists could not be reached by either Andrew or me
until yesterday when those lists were migrated over to a much better
version of mailman.  That change allowed me to finally make contact
with the octave developers, and it turns out (see
<http://savannah.gnu.org/bugs/index.php?41965>) the solution is a
simple patch to the Octave system version of __makeinfo__.m.

Following Andrew's advice above I have now tentatively committed that
modified version of that Octave system file to our source tree. That
gives good test results for our documentation strings for octave
3.6.2.  (For details of the test see the revision 13086 commit
message.)

@Andrew: please make the same test for octave-3.8.x to verify there
are no obvious problems with this fix for Octave 3.6 and 3.8.

Of course, this modified Octave system file should be removed from our
source tree once Octave makes an official fix for the problem, and that
fix propagates to most Octave installations.

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
__________________________

------------------------------------------------------------------------------
_______________________________________________
Plplot-devel mailing list
Plplot-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/plplot-devel

Reply via email to