[Gdal-dev] Documenting the Swig bindings

[Ari Jolma]

Frank Warmerdam kirjoitti:
> Ari Jolma wrote:
>> What do you think, would it be a good idea to document the bindings 
>> directly in code? Are the different language versions similar enough 
>> that it would make sense to write documentation into the interface 
>> files,
>
> I'm at best lukewarm on this idea.  The generated bindings are still
> in terms of the C++ types ("char **options" for instance) so I don't 
> think
> the users are getting that much support in their own language. And it 
> still
> seems to leave us needing to duplicate the meaningful portion of the docs
> unless I'm misunderstanding the intent.

ok, I'll try to work out a scheme for writing the documentation for the 
Perl bindings more close to the actual code

Ari

-- 
Prof. Ari Jolma
Geoinformaatio- ja paikannustekniikka
Geoinformation and positioning technology
Teknillinen Korkeakoulu / Helsinki University of Technology
POBox 1200, 02015 TKK, Finland
Email: ari.jolma at tkk.fi URL: http://www.tkk.fi/~jolma