[GRASS-dev] G__ in public API

[Glynn Clements]

Martin Landa wrote:

> many of modules are using G__ functions which should be dedicated for
> internal use only (in libs level). Those which are used by modules I
> would suggest to rename to G_ (before GRASS 7 release).  Any
> objections, comments?

It's probably an exaggeration to say that G__ functions are "internal
use only". It's closer to "this is (probably) not the function you
should be using". Typically, it indicates a lower-level function which
is "primarily" for internal use.

There does seem to be some excessive use of G__ names (e.g. 
lib/gis/env.c). But I wouldn't go so far as to say that G__ names
should *never* be used for functions which are used externaly,
particularly if such use is limited to a few specialised modules.

-- 
Glynn Clements <glynn at gclements.plus.com>