[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.
s/could/should.
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.