Re: changelog format

[Stefano Lattarini]

On 04/28/2012 02:15 PM, Thien-Thi Nguyen wrote:
> Oops, forgot the patch.  Here it is:
> 
I really like your patch, it's a definte improvement over the
previous situation.  I strongly disagree on one point though:

  +A reference to another change should be expressed as a date
  +and optionally a title if the date is insufficient to uniquely
  +identify the reference.
  +We recommend this over using a VCS commit identifier primarily
  +to keep the change log self-contained, and secondarily to avoid
  +lossage should the project switch to another VCS in the future.

Here, we should advise to use the date and (optionally) the summary
of the referenced change *in addition* to its commit ID (or a
proper "abridged" versions thereof, e.g., in git, the output of
"git describe").  Otherwise, one loses the possibility of following
cross-references between commits with a single click of mouse when
browsing the VCS history through tools like 'gitk' (and the
equivalent ones for other VCS).

Thanks,
  Stefano