cvs commit: ports UPDATING

[Alexey Dokuchaev]

On Tue, Aug 11, 2009 at 10:28:07AM -0700, Doug Barton wrote:
> Alexey Dokuchaev wrote:
> > Well, it's really hard to add anything here.  :-)  
> 
> "Update line breaks, punctuation, and white space on the recent KDE4
> and libtool entries to improve readability."
> 
> I'm picking on a trivial case here, so sorry Alexey, but from what I
> can see the trend is getting worse, not better.
> 
> There are 3 main rules for log entries:
> 1. Keep in mind that people will be reading this years from now when
> you are long gone.
> 2. A brief summary of WHAT was done makes browsing the logs and
> finding specific entries easier. However if necessary that can always
> be discovered with diff, so
> 3. Always err on the side of including more information about WHY a
> change was made.

Fair enough.  Thanks for being pedantic, I like it.  :-)

./danfe