[39023] trunk/base

Anders F Björklund afb at macports.org
Wed Aug 6 01:48:39 PDT 2008


Ryan Schmidt wrote:

>> Hmm, I thought ChangeLog was in chronological order (which you  
>> just broke) ?
>
> Since the ChangeLog is something the casual user might be expected  
> to read, it should be concise and organized.
>
> The Subversion log is in chronological order. The ChangeLog should  
> not merely duplicate the Subversion log. Rather, it should have one  
> entry per logical change.
>
> I would also say that the most important changes should be first in  
> the ChangeLog, so that a user who begins to read it but gives up  
> before reaching the end learns the most important things anyway.
>
> Such rearrangement and consolidation of the ChangeLog is probably  
> something the release manager should do right before a release. I'm  
> just trying to get a head start.

A matter of conventions, I suppose. I normally have "NEWS" as the  
user-readable, and ChangeLog for development.

The version control log is more like "end of day commit, fix typo,  
oops move that function, missed a file" etc.

--anders



More information about the macports-dev mailing list