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]

Re: Useless ChangeLog entries


    Generally, the technical bits about why something changed belong as
    comments in the code.

I concur.

And I also note that those comments should be "time-independent" and
say why things are the way they are and not, in general, a history of
all the code that was ever at that location.  The latter type of comments
take a lot of time to read and usually confuse more than clarify.

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