freetype-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: latest formatting updates


From: David Turner
Subject: Re: latest formatting updates
Date: Mon, 06 Nov 2000 19:38:26 +0100

Hi Werner,

> Related to this, I again ask to remove the double comments of exported
> functions.  For example, if I update the comment for, say,
> FT_Init_FreeType() in freetype.h, I have to repeat that in ftinit.c --
> I really prefer just one comment (in the header file), replacing the
> comment in the source file with
> 
>   /* this function is documented in freetype.h */
> 
> Avoiding redundancy increases the quality of documentation enormously,
> even if it may be a bit inconvenient to check two files...
> 
> Addionally, the library becomes smaller by 50kByte or so.
> 

All right, let's all begin to remove the comments when editing source
code.

Thanks,

- David



reply via email to

[Prev in Thread] Current Thread [Next in Thread]