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).