From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp11.migadu.com ([2001:41d0:8:6d80::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms5.migadu.com with LMTPS
	id CGcXBg1fo2JYSAEAbAwnHQ
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Fri, 10 Jun 2022 17:11:09 +0200
Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp11.migadu.com with LMTPS
	id 2CU4Bg1fo2LJ5AAA9RJhRA
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Fri, 10 Jun 2022 17:11:09 +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 B17101CF40
	for <larch@yhetil.org>; Fri, 10 Jun 2022 17:11:08 +0200 (CEST)
Received: from localhost ([::1]:41132 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	id 1nzgHy-0000lF-W2
	for larch@yhetil.org; Fri, 10 Jun 2022 11:11:07 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:54246)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <yantar92@gmail.com>)
 id 1nzgHR-0000gw-Uj
 for emacs-orgmode@gnu.org; Fri, 10 Jun 2022 11:10:33 -0400
Received: from mail-pj1-x1030.google.com ([2607:f8b0:4864:20::1030]:46714)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <yantar92@gmail.com>)
 id 1nzgHQ-00073i-7C
 for emacs-orgmode@gnu.org; Fri, 10 Jun 2022 11:10:33 -0400
Received: by mail-pj1-x1030.google.com with SMTP id
 k5-20020a17090a404500b001e8875e6242so2316116pjg.5
 for <emacs-orgmode@gnu.org>; Fri, 10 Jun 2022 08:10:31 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
 h=from:to:cc:subject:in-reply-to:references:date:message-id
 :mime-version:content-transfer-encoding;
 bh=b/hQzx7mvIF5Ryef+jO20HE/EMRrwS1xU8vjTLBXHlE=;
 b=Yogn20qgHL/NjTeot9oVJVqs/T4r4N5U0Cw5o3cNs3vH7N5l11pEOMO2UuSf4x7S2v
 fSopWPQoQNC9UasATJye/uZLZ4TuAR8klVmHV4suy6cTjqp90PDUc3blFnLg8oliAX0N
 o0ZxOhlTaYL1Ni2crdrjyoOTzl9Eoms9aKZ/6Vfj8pmompt4TSDrgTuzIyLQtSETJlaY
 akYW68HS/2cCzBkUFpkmD7GEO89fnwY65rQEkGFhlNkeoeGjuUFZzA6ItLkfq2/jLhCp
 K5qQX6WEGUOgn6OhRJu8ACp+0nMYy5Yi35+pi8+VzWeY2eQHAL+3ghM8kzpDlnY+9cak
 Ka5w==
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:in-reply-to:references:date
 :message-id:mime-version:content-transfer-encoding;
 bh=b/hQzx7mvIF5Ryef+jO20HE/EMRrwS1xU8vjTLBXHlE=;
 b=f0tBljEHZXkY2SiG060yHrBeceTyRkReq/3C1iAwbW6YsNHantJW7ZzM2y5xsa8WPl
 R2rcjKFcyxJ774rMkl7fYMTMbSigfpjsXpCpeCXCbuz4fArSYZO8JHrLau+1B/hasL03
 8p9w4YGqbLzrH5zU8doeZk7ZZgO+gcHccJtWuRjzi5AsJj9om8TCFt0/y928muytCPL/
 LkhuKvMT3MVEJJZW6faAco7F7pcYsWP/IBLrsMNcLUNXOctZgTYAPsG0tNwR2Eg43k8g
 5XPPkCSJnmv1iuX4I1+kr/NRL/vc01Me6XwCv2ri5X9xEdRc2rXjds2X8KLkuQ516Rfs
 EHPg==
X-Gm-Message-State: AOAM533MyMkAdx7gSFCV3nRXJC7kNg1EjtWhOAaz+uQZoS0NTOwNGtXM
 Z2kMdasOKURXtUun0U5fEeUQ11c9kqWazUGL
X-Google-Smtp-Source: ABdhPJz4oUMb1C0P51YydcrccsZ5h75RO2YKuHqx05HfTewy23vZpo8qxPumTAQJYXNa9V+xHklTQg==
X-Received: by 2002:a17:90b:1d04:b0:1e8:64e2:38c6 with SMTP id
 on4-20020a17090b1d0400b001e864e238c6mr219151pjb.238.1654873830797; 
 Fri, 10 Jun 2022 08:10:30 -0700 (PDT)
Received: from localhost ([64.32.23.62]) by smtp.gmail.com with ESMTPSA id
 m10-20020a1709026bca00b0015e8d4eb2c0sm18754143plt.266.2022.06.10.08.10.29
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Fri, 10 Jun 2022 08:10:30 -0700 (PDT)
From: Ihor Radchenko <yantar92@gmail.com>
To: Robert Pluim <rpluim@gmail.com>
Cc: emacs-orgmode@gnu.org
Subject: Re: Ambiguity in commit message conventions for org
In-Reply-To: <87mtek1t63.fsf_-_@gmail.com>
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>
Date: Fri, 10 Jun 2022 23:11:09 +0800
Message-ID: <87a6akr1te.fsf@localhost>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Received-SPF: pass client-ip=2607:f8b0:4864:20::1030;
 envelope-from=yantar92@gmail.com; helo=mail-pj1-x1030.google.com
X-Spam_score_int: -18
X-Spam_score: -1.9
X-Spam_bar: -
X-Spam_report: (-1.9 / 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_ENVFROM_END_DIGIT=0.25, 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." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
Sender: "Emacs-orgmode" <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
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=1654873868;
	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=b/hQzx7mvIF5Ryef+jO20HE/EMRrwS1xU8vjTLBXHlE=;
	b=R6O3fC3nqb0FtfxT9qWr7R6dyjrb48Vz1NnnRHi5VM6KpY8RRRNa8QSH80EvXqadoCKZAb
	X/Tk2Odlhm07HTHIN2Y8Twdvkyu20Ys7jVlEZ4dgwKgohRCV3GFlY647gATl/RKdive7Ul
	3qgfrLwJQt27CN3HF7vY8dTX90CPoHSqqp8dl2kIwEjt01KafKaC5+hRAvqheOczOI297r
	TdJ0wefEp/q3BkWa78dEc0Nyrhtkeyb5grVA/+bULWM67OBUUpLeA9i7rkz+8Z6h8O+MlL
	3NwLMmAxgkNSirN4VLeL9hWDfqxWsUWm9Ig5MoqwlAtPZz5iKkAIqujFVYmNAw==
ARC-Seal: i=1; s=key1; d=yhetil.org; t=1654873868; a=rsa-sha256; cv=none;
	b=M09Rizjy8sq8S0NInuJosY8uZUKEqIxngBxyxdWlyAKol8UgQHog+7JZYw+VTG6x0vQR8H
	UXBcqp0LVTioYGVWxW0WjbereqOeJbiz+6Gf8TsHw5ZuaSJ7pN9UbytYu7hQqy9ga3b3PN
	iAbwdBWZjbPmb2pgmTMBY5fDPATEvRLSYmz9n0bvfcBgqqCbOYZxa9IsDuqIKl2EVuI4mN
	7eZPdzg85NQrxi0/FNjVbeFPuNwvq74841sTdntFGS0MfGycJbj17OpD0cT7b7spdaQ5Jg
	Wg0QKSmfIJeR7gK5FYC1ZvdnHsDH+J2MtLZfyy/PzP++xP2qJ7CLTX3zWyuHAA==
ARC-Authentication-Results: i=1;
	aspmx1.migadu.com;
	dkim=pass header.d=gmail.com header.s=20210112 header.b=Yogn20qg;
	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: -1.98
Authentication-Results: aspmx1.migadu.com;
	dkim=pass header.d=gmail.com header.s=20210112 header.b=Yogn20qg;
	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: B17101CF40
X-Spam-Score: -1.98
X-Migadu-Scanner: scn0.migadu.com
X-TUID: zq8XX3PU289n

Robert Pluim <rpluim@gmail.com> writes:

>     Ihor> See https://orgmode.org/worg/org-contribute.html
>
> Those conventions are slightly different than Emacs', with one point
> of ambiguity. They say
> ...
>
> The summary line contains the 'lisp' directory, but the ChangeLog entry
> doesn=CA=BCt, and in the example just after it=CA=BCs the other way aroun=
d:

You are right. The example is indeed a bit confusing. The main
difference between Emacs' and Org's converntions is in summary line. We
are less formal about and prefer shorter summaries. You can drop the
directory or even file name if it saves space and does not create
amiguity.

The most common types for summary lines are:
org-library.el: Changed this
library-name: Changed that
function-name: Fixed
variable-name: ...

Examples:

org-lint: Fix invocation with C-u prefix argument
org-cycle-hide-block-startup: Fix docstring
manual: Fix function name and key index reference

You can also refer to
https://git.savannah.gnu.org/cgit/emacs/org-mode.git/log/

Best,
Ihor