On Aug 6, 2008, at 03:04, Anders F Björklund wrote:

>> Revision: 39023
>>           http://trac.macosforge.org/projects/macports/changeset/ 
>> 39023
>> Author:   [EMAIL PROTECTED]
>> Date:     2008-08-06 01:00:26 -0700 (Wed, 06 Aug 2008)
>> Log Message:
>> -----------
>> ChangeLog: consolidate entries for Leopard environment variable issue
>>
>> Modified Paths:
>> --------------
>>     trunk/base/ChangeLog
>>     trunk/base/src/port1.0/portlint.tcl
>>     trunk/base/src/port1.0/portutil.tcl
>
> 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.


> I assume those other two files were just innocent bystanders or  
> something :-)

Oh crap. Undone in r39025. Thanks for catching that.

_______________________________________________
macports-dev mailing list
[email protected]
http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev

Reply via email to