[Top][All Lists]
[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