From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id GEIoKLdto2KRSgEAbAwnHQ (envelope-from ) for ; Fri, 10 Jun 2022 18:13:43 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id WEDvJ7dto2KZdAEAauVa8A (envelope-from ) for ; Fri, 10 Jun 2022 18:13:43 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 56D033E71A for ; Fri, 10 Jun 2022 18:13:42 +0200 (CEST) Received: from localhost ([::1]:36476 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nzhGW-0007iP-ES for larch@yhetil.org; Fri, 10 Jun 2022 12:13:40 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:36122) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nzh5T-0002bY-Ob for emacs-orgmode@gnu.org; Fri, 10 Jun 2022 12:02:15 -0400 Received: from mail-wr1-x430.google.com ([2a00:1450:4864:20::430]:35426) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nzh5Q-0006PG-Ue for emacs-orgmode@gnu.org; Fri, 10 Jun 2022 12:02:15 -0400 Received: by mail-wr1-x430.google.com with SMTP id a15so28598123wrh.2 for ; Fri, 10 Jun 2022 09:02:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:references:gmane-reply-to-list:date:in-reply-to :message-id:mime-version:content-transfer-encoding; bh=R9HpS9olL/bMMLwotIAS5G9e+HELaY8T8pu4bBdBVW0=; b=o4XKQArs8hMHdX1FrUoFB5gVxFe1E+8cL7eLBH2COPmpDNUwIr8L7Z2UJO4zildEP3 jAXB3XoZlAaFHYLfth0w8Rd5nzsVMRcA/5nt0gGcW+ZQtxpzVdQCRTIbSw3NlJx6XgPc J3QSqdUVQdFGDnRHSnYGPjxIFaQG/0tiPNqAfLL5YN9wG8k1EO/zQPo9fKElQonMOKiG i+bOewfzLKz6L+pxCuKAQwtx/uThpKen4DXmrY6QsxoowHpiqFbKp/SocShQarvg9loW SC2Bi7gAyw/taY6w7Kwz7Rrvc8pwJxgDVwub4IgRDOfLcB4C+KZI4u55sGbh7eFe49Cz makg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:references :gmane-reply-to-list:date:in-reply-to:message-id:mime-version :content-transfer-encoding; bh=R9HpS9olL/bMMLwotIAS5G9e+HELaY8T8pu4bBdBVW0=; b=mPEvmd/ssV2ckCiuYlN/wq1ijZZKnVIC1mj8gUb9t92ISflX2vmRzggXezMu1r3i88 M62GQjmyyy4UOabOMipSj4IUgX+PZZO1pByup5ZfAOuqPiU3mmamYD4oLQmNxECL5zfe Mro7OepLvTAJoigyzEIexykfayxQa8CQ3N/i2macQvE0ksb7wwlWu2kRV6vLTElBFae1 FksMBNrYVexGF4lCjXkiRKlGoYh18J7lJ//w0mOf7Y9drmeXXXdxrHJ/WV8eK/PlG55A j/AmWy6kPmjm8vfRsexlaKSZc7ZnCaZmopo4sfk1KngwOXdhWLO0fzHxpP35SxahjiDC /mSA== X-Gm-Message-State: AOAM532aZEVRB6goaMF9p3OFwgAcvlrb+mMhJmo3iSpIgHC1jxdmsPvQ 4pis56vMwp68o3IKsz2gkvYHLabexeU= X-Google-Smtp-Source: ABdhPJz7nKFaoJy5E3UpBZ4UNhZ+QgrQVZiGcKTmRv1RSCkdQOX3Q9X8hMI9E0Ma/tx9XZF7pBbyUg== X-Received: by 2002:a5d:59ae:0:b0:217:2519:8a0f with SMTP id p14-20020a5d59ae000000b0021725198a0fmr31878767wrr.383.1654876930607; Fri, 10 Jun 2022 09:02:10 -0700 (PDT) Received: from rltb ([2a01:e0a:3f3:fb50:d322:20a3:e287:911e]) by smtp.gmail.com with ESMTPSA id m3-20020a7bcf23000000b0039c7dbafa7asm2671174wmg.19.2022.06.10.09.02.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 10 Jun 2022 09:02:09 -0700 (PDT) From: Robert Pluim To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: Ambiguity in commit message conventions for org References: <87fskpg6hq.fsf@gmail.com> <87czfter3k.fsf@ucl.ac.uk> <87bkvdg46m.fsf@gmail.com> <87zgik29hf.fsf@gmail.com> <87wndoahd0.fsf@gmail.com> <87v8t81yc2.fsf@gmail.com> <87r13wr7x1.fsf@localhost> <87mtek1t63.fsf_-_@gmail.com> <87a6akr1te.fsf@localhost> Gmane-Reply-To-List: yes Date: Fri, 10 Jun 2022 18:02:09 +0200 In-Reply-To: <87a6akr1te.fsf@localhost> (Ihor Radchenko's message of "Fri, 10 Jun 2022 23:11:09 +0800") Message-ID: <87edzw1p8e.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a00:1450:4864:20::430; envelope-from=rpluim@gmail.com; helo=mail-wr1-x430.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1654877622; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=R9HpS9olL/bMMLwotIAS5G9e+HELaY8T8pu4bBdBVW0=; b=CS8UzE3GwAALUGyDfCauxXnGFOEfHp4/omnt3MlWI5a/I6YJk4Wml2VJHic2HRko5gqHZZ 2emdnJrFcDLs/YlrhprerX0Xr2Gpg+U0nmQT00X29LyqJcoakvUpLwntfvAfxUyjsPoEMr PlOpKpDp2Zza3jOAmA2eKipIJ2c4OIx7Op1Pl6YwzX3Kg8zJB5ngEue+JLp+olGnisQoV+ fIbf85rC7rLPMR/vxyWRDvvh67eDF7XPJTPw8EFhmO6iY8YJkmAqmYhVthM6pWnCjqITjZ jMZni6FbeJvQWVIj1eYkw0apdy240cMH1F5eVYWsAsrQFrsIkoS4ekEBJDWhaA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1654877622; a=rsa-sha256; cv=none; b=PwKVd8jnhyET1BI7yo6eqJzSf9Cko9gRv+k4zL9+vuCTNofODlXJSMTylLGiUe1o6ESiUb gVjsOgE71Z6Bd4MJO8PvS7HZr0zXLaDZO2uEw7G0zCGkTZKz3dPKdQxlCk6/gaW3tHeaeh wAYanzztS4yL4YNVnMYgKjpcvMhUAamqixvkKCc2F5deRBhhkBvq8BXGWcLn/ao4VTXMj0 NTddiTrHs0hcQAyX8Cp3hvYAG1LLbdbhGsHwglXe+HHqkJ2+h2DQtZFpgWGvu8XBWoHGFJ by5lS8DfwQMOBQbepQg5vl2RKVGwrdfHk89SYzzPIM5J2Ko/kJKeKJxX4Uwvig== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=o4XKQArs; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -5.48 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=o4XKQArs; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 56D033E71A X-Spam-Score: -5.48 X-Migadu-Scanner: scn0.migadu.com X-TUID: 8X5q/OdA3eTd >>>>> On Fri, 10 Jun 2022 23:11:09 +0800, Ihor Radchenko said: Ihor> Robert Pluim writes: Ihor> See https://orgmode.org/worg/org-contribute.html >>=20 >> Those conventions are slightly different than Emacs', with one point >> of ambiguity. They say >> ... >>=20 >> The summary line contains the 'lisp' directory, but the ChangeLog en= try >> doesn=CA=BCt, and in the example just after it=CA=BCs the other way = around: Ihor> You are right. The example is indeed a bit confusing. The main Ihor> difference between Emacs' and Org's converntions is in summary li= ne. We Ihor> are less formal about and prefer shorter summaries. You can drop = the Ihor> directory or even file name if it saves space and does not create Ihor> amiguity. Emacs convention is to not mention the file name in the summary, unless it=CA=BCs a one-file change, in which case you put the filename with '* ' prepended (although some contributors prefer not to do that). I went for 'dir/filename' in the summary, since I=CA=BCm lazy and can copy that from the ChangeLog commit message :-) Robert --=20