Alan W. Irwin wrote: >There are a large variety of hand-crafted files in our source tree which >specify the public API for some component of PLplot, and it is very easy for >these files to get out of synch. Therefore, I have just committed a script >called scripts/check_api_completeness.sh that checks whether at least the >list of names of PLplot functions is identical between the various API >definition files for docbook, swig, octave, f77, and f95, and our >fundamental definition of our public API in include/plplot.h. > >I have made no attempt to make this script cross-platform so it is likely >only to work on Linux. However, it is extremely useful there. > > Indeed, this is useful!
> > >** f77 (and f95) >scripts/check_api_completeness.sh f77 \ >|grep '[+-]' |grep -v '@@' |grep -v '\-\-\-' |grep -v '+++' > >yields the following results: > >-plarrows >-plenv0 >-plgcolbga >-plgfci >-plimage >-plmap >-plmeridians >+plmapc >+plmeridiansc >-plot3dcl >+plsetmapformc >-plsfci >-plsurf3dl > >and similarly for f95. The reason why plmap is missing and plmapc is found >even though not present in plplot.h and similarly for plmeridians and >plmeridiansc is a "c" suffix was used for these functions rather than the >more usual "7". > >Arjen, is there any reason for that "c" suffix on plmap and plmeridians or >may I change it to "7" (or f77) to be consistent with every other fortran >function defined by our api? > >Arjen, I don't know what to make of +plsetmapformc. Could you comment? > >The remaining "-" results are because quite a few functions are missing from >our f77 and f95 API's. > > plsetmapformc registers the Fortran routine to be used for the transformations in plmap(c) - see the static (hence invisible from the outside) function plmapf2c(). The reason for its existence is that under Windows at least the calling convention in Fortran is different from that in C - the notorious __stdcall keyword. I do not mind a "7" instead of a "C" - it simply seemed a good idea at the time, as they figure in the FORTRAN 77 and the Fortran 95 bindings and work around a calling convention difference with C. Come to think of it, the intermediate function plsetmapform is superfluous - it can be put in plmap and plmeridians ... Regards, Arjen ------------------------------------------------------------------------- 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
