Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 16 Feb 2015 11:11:35 -0500
From:      John Baldwin <jhb@freebsd.org>
To:        Garrett Cooper <ngie@freebsd.org>
Cc:        svn-src-stable@freebsd.org, svn-src-all@freebsd.org, src-committers@freebsd.org, svn-src-stable-9@freebsd.org
Subject:   Re: svn commit: r278718 - in stable/9: etc/rc.d sbin share/man/man4 share/mk sys/modules/geom tools/build/mk tools/build/options
Message-ID:  <5328252.MWfFGgsrnY@ralph.baldwin.cx>
In-Reply-To: <201502132136.t1DLaHLi008470@svn.freebsd.org>
References:  <201502132136.t1DLaHLi008470@svn.freebsd.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Friday, February 13, 2015 09:36:17 PM Garrett Cooper wrote:
> Author: ngie
> Date: Fri Feb 13 21:36:16 2015
> New Revision: 278718
> URL: https://svnweb.freebsd.org/changeset/base/278718
> 
> Log:
>   MFC r278717:
> 
>   r278717:
> 
>     MFC r277678:
> 
>     r277678:
> 
>       Add MK_CCD knob for building and installing ccd(4), ccdconfig, etc
> 
>       Sponsored by: EMC / Isilon Storage Division

I believe you are supposed to merge from HEAD to 9, not from 10 to 9.  But 
also, I find these log messages quite noisy.  I much prefer just:

MFC <head rev>:
<original log message>

Where the <original log message> is not extra-indented but is formatted 
similar to a normal commit.

On a more general note, if I'm merging a change with several followup fixes, I 
1) always merge the entire batch of changes so as not to leave stable/ in a 
broken state (most folks also do this), and 2) I don't cut and paste all N 
logs verbatim.  This tends to be very hard to read.  Instead, I do 'MFC <list 
of head revs>' and then use a brief summary of the change being merged.  Often 
this means using the log message of the first change (which introduces the new 
feature and explains it) but omitting short descriptions of specific bugs 
fixed (which aren't very useful to someone reading the stable log message as 
the commit in question is introducing the needed feature in its fixed state.)

This does require a bit more effort editorial wise, but I think it results in 
commit logs for stable that are more readable.

-- 
John Baldwin



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?5328252.MWfFGgsrnY>