ChangeLogging commits to CVS
Keith Whitwell
keith at tungstengraphics.com
Tue Dec 14 02:56:13 PST 2004
Egbert Eich wrote:
> More or less by accident I came across commits to the X.Org
> tree that have not been properly ChangeLogged.
>
> When we created this repository we made a - yet unwritten - rule
> that every commit (maybe with the exception of simple typo fixes)
> need to be ChangeLogged properly in the topmost ChangeLog file.
>
> This is to ensure we can easily track changes to the tree back to
> when they took place and who made them. CVS itself is file oriented
> so it is difficult to track which changes went into the tree as
> a whole.
>
> Furthermore the text added to ChangeLog file should also go into
> the log of the commit itself.
>
> To simplify the generation of the ChangeLog entry we use a perl
> script which I will append to this message.
> It can be run in the topmost (xc/) directory and will create a
> properly formatted entry. The only thing that remains to do is
> to add a brief description about the nature and the purpose of
> the change.
> The verbosity of this description is pretty much up to everyones
> personal taste, please take the descriptions of other commits
> as a general guideline.
>
> So far we have not added any check script that enforces this rule
> but we may have to do this in the future.
>
> It would be best if all changes that have been applied without
> proplery ChangeLogging would get reverted (again without modifying
> the ChangeLog) and reapplied this time with a poper entry to the
> file.
>
> [A description of the commit procedures should go into the X.Org
> wiki and I will add this once the machine is not as slow as it
> is right now.]
>
Is there a reason why the ChangeLog entry can't be generated automatically
from the CVS commit messages? Am I missing something here?
Keith
More information about the release-wranglers
mailing list