On Saturday 27 December 2008, Tamas TEVESZ wrote:
> On Sat, 27 Dec 2008, Dan Pascu wrote:
> > I disagree with such a change. It is hardly a fix to be less
> > explicit with the function declarations.
>
> oh well, matter of preference, i guess. whatever.
This is not about taste. C is painful enough to work with, to avoid making
it more difficult than necessary.
The purpose of the header files is to give a crude API documentation, so
one can figure out what the library offers and what input the functions
require without having to look into a fully fledged documentation or the
source code.
A prototype like this:
void RCopyArea(RImage*, RImage*, int, int, unsigned, unsigned, int, int);
tells me nothing, while one like this:
void RCopyArea(RImage *image, RImage *src, int sx, int sy,
unsigned width, unsigned height, int dx, int dy);
is clear enough to put me on the right track and suggest what those ints
are about.
--
Dan
--
To unsubscribe, send mail to [email protected].
