Re: ChangeLogging commits to CVS

Keith Whitwell <keith-CdwZJljFklH+2FeEXyspIVaTQe2KTcn/@public.gmane.org>
Newsgroups gmane.comp.freedesktop.release-wranglers,gmane.comp.freedesktop.xorg
Message-ID <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.