On 2009-09-02 00:08-0700 Jerry wrote:

> x19c.c uses 70 as the last argument in plenv, axis, but the
> documentation does not mention such a value. This was detected by the
> Ada compiler at compile time. I have made the Ada code accept
> arguments up to 70 by creating a constant called Undocumented_Feature
> but I don't know if 70 is high enough or what is the meaning of
> arguments above 63. I suppose it is in the C code somewhere but I much
> prefer writing to the documentation rather than reading C which I seem
> genetically unable to do well. Genetics notwithstanding, the docs
> should probably be updated.

Done, revision 10364.

In response to your genetics comment (which I assume was it least partially
tongue in cheek although I also have my troubles with C sometimes), have a
look at src/plvpor.c where the meanings of the last argument to (c_)plenv
(including the 70-73 values) are clearly documented.  That's the source I
used for the above revision to doc/docbook/src/api.xml. Our website
documentation will be built from api.xml (and other files in that directory)
as part of the release process.  Until then, you will have to rely on
api.xml or plvpor.c for documentation of plenv.

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
__________________________

------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day 
trial. Simplify your report design, integration and deployment - and focus on 
what you do best, core application coding. Discover what's new with 
Crystal Reports now.  http://p.sf.net/sfu/bobj-july
_______________________________________________
Plplot-devel mailing list
Plplot-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/plplot-devel

Reply via email to