This is the mail archive of the
mailing list for the Cygwin project.
Re: [setup] Makefile.am patches
- From: Achim Gratz <Stromeko at nexgo dot de>
- To: cygwin-apps at cygwin dot com
- Date: Mon, 16 Feb 2015 23:10:47 +0100
- Subject: Re: [setup] Makefile.am patches
- Authentication-results: sourceware.org; auth=none
- References: <87k2zkcnxv dot fsf at Rainer dot invalid> <20150215104056 dot GO7225 at calimero dot vinschen dot de> <87a90fxqhn dot fsf at Rainer dot invalid> <20150215143557 dot GU7225 at calimero dot vinschen dot de> <871tlrxhc2 dot fsf at Rainer dot invalid> <20150216091237 dot GV7225 at calimero dot vinschen dot de> <54E23548 dot 8040802 at redhat dot com> <20150216191129 dot GJ8493 at calimero dot vinschen dot de> <87y4nxy7k8 dot fsf at Rainer dot invalid> <20150216205236 dot GL8493 at calimero dot vinschen dot de>
Corinna Vinschen writes:
>> Uh, what? You need to keep a blank line between the (brief) commit
>> message and any ChangeLog lines,
> That's a rule? In theory the subject line is totally useless for a
> ChangeLog entry, but if that's required, ok, fine.
Not so much a rule, but rather a consequence of the possible interaction
of patches sent via email. The subject line might have been folded if
it gets too long, so the first paragraph becomes the first line of the
commit message. The formatting of the rest of the message (after the
first blank line) is kept and becomes the actual commit description.
>> the first line and any following
>> (wrapped) lines will be the single-line commit message.
> Yuck! Who had the terrible idea to fold all commit lines into a single
> line? Why bother to write detailed log message at all if it gets this
> messy and unreadable?
Just leave a blank line after the first. The first line is the subject
of the commit, if you will. It gets shown for "git log --oneline" and
other such things, so it's good to keep it short.
> The question is, can this be automated so that a commit automatically
> adds the entry to the ChangeLog file and commit the ChangeLog file at
> the same time? Or is there some problem with that approach?
That way lies madness, but you could do this in a pre-commit-hook on the
server. If you want to keep a ChangeLog file, I'd rather just edit this
file (C-x 4 a in Emacs) and then copy the text into the commit message.
The other option is to generate the ChangeLog only when a release is
made and then tag that commit, typically via some special target for
+<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+
Waldorf MIDI Implementation & additional documentation: