From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail
From: Federico Tedin <federicotedin@gmail.com>
Newsgroups: gmane.emacs.devel
Subject: Writing ChangeLog-style commit messages with Magit
Date: Sun, 16 Feb 2020 19:19:31 +0100
Message-ID: <87lfp28kek.fsf@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202";
	logging-data="92012"; mail-complaints-to="usenet@ciao.gmane.io"
To: emacs-devel@gnu.org
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Feb 16 19:20:07 2020
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane-mx.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1j3OWU-000Npy-N9
	for ged-emacs-devel@m.gmane-mx.org; Sun, 16 Feb 2020 19:20:06 +0100
Original-Received: from localhost ([::1]:34952 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1j3OWT-00054D-PB
	for ged-emacs-devel@m.gmane-mx.org; Sun, 16 Feb 2020 13:20:05 -0500
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54239)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <federicotedin@gmail.com>) id 1j3OW0-0004ek-IE
 for emacs-devel@gnu.org; Sun, 16 Feb 2020 13:19:37 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <federicotedin@gmail.com>) id 1j3OVz-0002tE-CX
 for emacs-devel@gnu.org; Sun, 16 Feb 2020 13:19:36 -0500
Original-Received: from mail-wm1-x335.google.com ([2a00:1450:4864:20::335]:53343)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <federicotedin@gmail.com>)
 id 1j3OVz-0002rL-4O
 for emacs-devel@gnu.org; Sun, 16 Feb 2020 13:19:35 -0500
Original-Received: by mail-wm1-x335.google.com with SMTP id s10so14957338wmh.3
 for <emacs-devel@gnu.org>; Sun, 16 Feb 2020 10:19:35 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=from:to:subject:date:message-id:mime-version;
 bh=FOyQHN6KzJnTh8jBc0PsCLGzVCN7xNd54BgEkMT2NNs=;
 b=ifrHUpfxRMODk+ut77YCMkLNqxlt61IsEb2d9vOfjFHCRc2wsT2oXhvhvVsltHtHho
 dsyeM8w7S5uEY24lb0j5xKAHw9vRbqVd9ZwmN1qa4EyEK6ev5I9T+J4OK3maMTDgVszH
 CUBNDgpOyYN8O4m3MIOS0CqS0bxUvrjl8MGkhWdydgSqIamMPuve1tC+f40ELMBBjQ0M
 vX6ci4w7p2jn3kCzBVelow1X/xyKdTlhDQlM8eidWoi+uSmkfTOaum7bm6BwkozzMZHn
 DEX+OrK83tegQI3EgOm9fBIO0WbDMgzOB3SnnKo6vv9pfUisqdde+qUOSGWpOmELpsYw
 UBSg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:from:to:subject:date:message-id:mime-version;
 bh=FOyQHN6KzJnTh8jBc0PsCLGzVCN7xNd54BgEkMT2NNs=;
 b=ZEDAjGqYVftc19mIIBoDxto75hfDGHgncBmd7DAq/G1mb/opuajDYxLcudL5jimKwW
 cM5mUk/So37QTwTu96CRRiceM7IYFUVOoNGE1TW1Xuz5hV+qDhfZ/fLfVpZFEFmZ23NX
 RxbLgDEcH+lleFZhGsA79YjsjP2BUFc9G2cfi+OGUmqK1hYLIdsM5Mf2SP21eRpPa4os
 VFUT+COv5jY3X9m1Wg+MFga32zUur2k6LdoTaDnmDTJHGkqnl3Okw9K8UJP1MMRmOTYc
 eQIUhQKnCzpKOl/qlxLhIOqVQ3XvUk3lIVledxozi2vIkEjJ+3/FFwYqcCURtjJR+cUT
 93Qg==
X-Gm-Message-State: APjAAAXMenheME88e/3jGLeR3VVlUNYZw1O6KNbKlT3vznSi1xUIwGbe
 t9GDDWz6zKzEwITqD51B+NURcXip
X-Google-Smtp-Source: APXvYqw+G/+0F7miXAq7u2h0+YgXrVGatwhbg69meuiHLetyf2YgJiVzrXy8YjqnjZS6APu5fMUo8Q==
X-Received: by 2002:a1c:cc06:: with SMTP id h6mr17786441wmb.118.1581877173114; 
 Sun, 16 Feb 2020 10:19:33 -0800 (PST)
Original-Received: from lead ([2a02:8109:8ac0:2ff0:6c4d:15d5:57aa:7f1d])
 by smtp.gmail.com with ESMTPSA id z4sm17042706wrt.47.2020.02.16.10.19.32
 for <emacs-devel@gnu.org>
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Sun, 16 Feb 2020 10:19:32 -0800 (PST)
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
 recognized.
X-Received-From: 2a00:1450:4864:20::335
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org
Original-Sender: "Emacs-devel"
 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.devel:244973
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/244973>

Hi all,

I was wondering what's the best way of writing ChangeLog-style commit
messages with Magit. Currently, I'm aware of these options:

- Use "C-x 4 a" to add entries into the ChangeLog file, and then copy
  those over to the commit message buffer when I'm about to create a
  commit.

- Use "C" while on the diff buffer like described here by Jonas:
  https://emacs.stackexchange.com/questions/13753/insert-changelog-entries-in-commit-message
  That post is from 2015 though (and according to him "it's not very
  good"), so maybe it's outdated.

- Write and structure the commit message manually (adding change
  descriptions per file/symbol)

So far I've been writing the commit messages manually (just found out
about "C-x 4 a"), so I wanted to know if anyone has a workflow similar
to the first one in the list, or maybe something more automated.

Thanks.

- Fede