bug-standards
[Top][All Lists]
Advanced

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

ChangeLogs and generated files


From: Joseph S. Myers
Subject: ChangeLogs and generated files
Date: Tue, 31 Jan 2012 16:27:23 +0000 (UTC)

When should a ChangeLog entry mention the regeneration of a generated 
file, in the form "* configure: Regenerate."?  My inclination is that:

* if the generated file is checked in, it *should* be mentioned in the 
ChangeLog; it's part of the change being committed and in practice I find 
in GCC that the presence in the ChangeLog entry is a useful indicator when 
reviewing a patch of whether the submitter has actually regenerated the 
file as part of testing, and a useful reminder on commit that the file 
needs regenerating;

* if the generated file is not checked in, it probably should not be 
mentioned in the ChangeLog (although I don't have much experience myself 
working with projects not checking in these files).

-- 
Joseph S. Myers
address@hidden



reply via email to

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