[Gimp-docs] documentation of the clipping options: no answer

[Ulf-D. Ehlert]

julien (Dienstag, 5. Februar 2008, 06:40):
> There still remain some features, especially new functions, that I
> can't explain.
> I can't read C code.

If you could, you would find out (that's my experience) that the code is 
not documented. Typically no comments about the underlying algorithm, 
no headers explaining what which functions is doing, no word about the 
function parameters, etc. etc. [1]

For the developer everything is clear when he is coding (so he could 
easily describe what happens within his code), but there's no chance 
for a documenter unless he wants to spend many hours with the source 
code (since, of course, the functions called by the relevant function 
and the functions using this relevant function are also not 
documented...).

Ulf


[1] See e.g. "gimp_transform_resize_crop()"
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : /lists/gimp-docs/attachments/20080205/4680b1fb/attachment.bin