From: ams@gnu.org (Alfred M. Szmidt)
To: Glenn Morris <rgm@gnu.org>
Cc: 12946@debbugs.gnu.org
Subject: bug#12946: 23.2; log-edit-insert-changelog not inserting a description line from ChangeLog file
Date: Tue, 20 Nov 2012 13:53:37 -0500 [thread overview]
Message-ID: <E1Taswz-0005YY-Gc@fencepost.gnu.org> (raw)
In-Reply-To: <biehjocejp.fsf@fencepost.gnu.org> (message from Glenn Morris on Tue, 20 Nov 2012 13:30:50 -0500)
Alfred M. Szmidt wrote:
> 2012-11-16 Alfred M. Szmidt <ams@gnu.org>
>
> This is a deccription line.
>
> * random-file: New file.
If you don't use a blank line between the two, you get
This is a description line.
* random-file: New file.
in the log buffer, which seems fine to me. You can easily kill all
but the first line if you don't want it.
http://www.gnu.org/prep/standards/html_node/Style-of-Change-Logs.html#Style-of-Change-Logs
says not to put blank lines between related entries (essentially,
IMO). (Maybe it should be updated for the practise of adding a
leading summary.)
Interesting; this might make me change how I do things. I've always
done one ChangeLog entry per related entry. Though, I think it would
be useful if there was some variable at least, that would only put in
the description line.
> * random-file: New file.
>
> What would be useful is that you got the description line
> inserted instead, with nothing following it. This is common
> practise when working with various distributed version control
> systems where the commit entry only contains a brief description
> of the change, and the ChangeLog contains the detailed
> information.
Really? I got the impression the trend was to generate ChangeLogs
from commit logs.
Well, there are two camps, those who keep ChangeLog entries in commit
message, and those who don't. Those who don't put a short summary in
the commit message. At least from my limited observations. E.g. in
Emacs it tends to be short summaries in the commit message.
next prev parent reply other threads:[~2012-11-20 18:53 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2012-11-20 18:06 bug#12946: 23.2; log-edit-insert-changelog not inserting a description line from ChangeLog file Alfred M. Szmidt
2012-11-20 18:30 ` Glenn Morris
2012-11-20 18:53 ` Alfred M. Szmidt [this message]
2012-11-20 18:58 ` Glenn Morris
2012-11-20 20:27 ` Alfred M. Szmidt
2012-11-20 20:19 ` Stefan Monnier
2012-11-20 20:29 ` Alfred M. Szmidt
2012-11-20 20:46 ` Glenn Morris
2012-11-21 13:48 ` Stefan Monnier
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=E1Taswz-0005YY-Gc@fencepost.gnu.org \
--to=ams@gnu.org \
--cc=12946@debbugs.gnu.org \
--cc=rgm@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.