On 2008-05-20 18:03-0700 Jerry wrote: > Example x23c.c calls two procedures, plgfci and plgfont, which do not > appear in the Programmer's Reference Manual, http:// > plplot.sourceforge.net/docbook-manual/plplot-html-5.9.0/. However > they appear in plplot.h (with the prefix c_). Some of the language > examples such as C++ and Fortran 95, upon superficial examination, > appear to not implement this part of the C example. > > Are plgfci and plgfont part of the public API?
Yes. So are plsfci and plsfont (see plplot.h). > Should I write Ada > interfaces to them [...]? Yes, please, for all four functions. Note, plgfci and plsfci have been part of our public API (as defined by plplot.h) for quite some time, but they were rather obscure until Andrew and I started discussing them on list in March. (Look for the subject "plgfci / plsfci"). The upshot was we decided to retain both plgfci and plsfci in the public API, but Andrew also wrote a user-friendly versions of each of them called plgfont and plsfont which are now also in the public API. Also, I extended examples/c/x23c.c to illustrate all our modern font-setting techniques (which is why both plgfci and plgfont now appear in that example). Those extra pages for example 23 should be propagated to all language examples (including Ada). Finally, note that plgfci/plsfci/plgfont/plsfont are all officially documented in doc/docbook/src/api.xml so that documentation should appear automatically on our website as a result of some of the scripts that Hazen runs during the course of the next 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); 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 __________________________ ------------------------------------------------------------------------- This SF.net email is sponsored by: Microsoft Defy all challenges. Microsoft(R) Visual Studio 2008. http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/ _______________________________________________ Plplot-devel mailing list Plplot-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/plplot-devel
