On 2014-01-23 13:02+0800 Hailiang Wang wrote:
> Yes, you're right. Here is the complete result:
>
> c_plbtime is not documented.
> c_plconfigtime is not documented.
> c_plctime is not documented.
[....]
Hi Hǎiliàng:
Thanks very much for that complete report from the current form of your checker.
I have now (revision 12956) written long-overdue documentation in
api.xml for the above three fundamental time transformation functions.
Writing such documentation is time-consuming so although I didn't
remove many items from your long list of api.xml issues, I still feel
I made substantial progress on that list today. I hope to finish off
documenting the remaining 6 functions and correcting the argument
number and name inconsistencies your api.xml checker found in the next
couple of days. However, I
hope you would also be willing to add a further consistency check for
the types of the arguments to that checker code. For example, I am
sure there are a lot of const type inconsistencies at the moment
between plplot.h and api.xml, and it would be good to get those
inconsistencies all cleaned up.
You commented before that parsing the argument types from api.xml was
difficult, but the api.xml schema is not that complex. For example,
the relevant type information is tagged up as in this example:
<variablelist>
<varlistentry>
<term>
<parameter>year</parameter>
(<literal>PLINT *</literal>, output)
</term>
[...]
</varlistentry>
[...]
</variablelist>
I really hope parsing the type ("PLINT *") in this case from a literal
tag inside a term tag inside a varlistentry tag for the list of
arguments inside a variablelist tag turns out to be not that difficult
in Go.
Note, the 5.10.0 release is scheduled soon (9 days from now) so it's
an important goal to get plplot.h/api.xml inconsistencies cleaned up
as much as possible for that release. However, I hope to finish the
task in just the next several days because I won't be able to work on
that task much nearer the release date because of my release manager
responsibilities for that release. But if you have your own time
constraints that do not allow you to implement parsing the argument
type information from api.xml in the next several days, then I hope
you would still be willing to implement that important api.xml checker
feature after the 5.10.0 release.
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
Plplot-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/plplot-devel
