From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 ) for ; 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 ) for ; 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 ; 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 ) 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 ) 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 ) 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 ; 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 To: Robert Pluim 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." 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=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 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