[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#20328: outdated CONTRIBUTE info re ChangeLogs

From: Dmitry Gutov
Subject: bug#20328: outdated CONTRIBUTE info re ChangeLogs
Date: Thu, 16 Apr 2015 17:54:21 +0300
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Thunderbird/36.0

On 04/15/2015 07:52 PM, Glenn Morris wrote:

IMO the file should be rewritten to explain that commit logs are to be
written in the style of ChangeLogs.

Updated, please take a look.

This still applies. Even though it could say "in commit messages",
this also emphasized the fact that the same non-sandardized references
will appear in the ChangeLog file.


I'd prefer not to touch this part until the following is resolved.

I guess we are supposed to use those silly "action stamps", but
understandably no-one does. I'm sure people are going to keep using
hashes in commit logs, which will be meaningless in the generated C'log.

Agreed: it's a nuisance. And since it relatively trivial to convert commit hashes to the action stamps or whatever when generating ChangeLogs, it makes sense to use hashes in the commit messages. Maybe prefixed with "git:", if someone is worried about ambiguity.

If they are in a commit all of their own, you can use the "; " prefix to
omit that entire commit log entry from the generated C'log.

I think it's also improved now.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]