This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Thoughts on doxygen for internal documentation

Am Fre, 2003-01-17 um 10.10 schrieb Daniel Berlin:

> Not necessarily.
> There are some pretty long macro names in gcc.

[ long explanation omitted ]

Your example is absolutely reasonable and I totally agree that
it's not wise to bend over and invent whatever obfuscated programming
has to offer just to keep it below 80 characters.

Though at the same time

> if (rtx_equal_p (NOTE_VAR_LOCATION_LOC (var1), NOTE_VAR_LOCATION_LOC (var2))

is a perfect example for code which is IMHO easy to misread because from
glancing over it one might miss what exactly happens to be the
condition. If in doubt I'd rather write your example as:

if (rtx_equal_p (NOTE_VAR_LOCATION_LOC (var1),
                 NOTE_VAR_LOCATION_LOC (var2))

-- 
Servus,
       Daniel

Attachment: signature.asc
Description: Dies ist ein digital signierter Nachrichtenteil

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]