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 ADcnM15Xo2IxBwAAbAwnHQ (envelope-from ) for ; Fri, 10 Jun 2022 16:38:22 +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 aDgdM15Xo2JMvgAAauVa8A (envelope-from ) for ; Fri, 10 Jun 2022 16:38:22 +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 95BFE3B8BB for ; Fri, 10 Jun 2022 16:38:22 +0200 (CEST) Received: from localhost ([::1]:37888 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nzfmG-0001AL-67 for larch@yhetil.org; Fri, 10 Jun 2022 10:38:20 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:47570) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nzflC-0000bg-3s for emacs-orgmode@gnu.org; Fri, 10 Jun 2022 10:37:15 -0400 Received: from mail-wr1-x429.google.com ([2a00:1450:4864:20::429]:41761) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nzflA-00023o-Iw for emacs-orgmode@gnu.org; Fri, 10 Jun 2022 10:37:13 -0400 Received: by mail-wr1-x429.google.com with SMTP id k19so36790646wrd.8 for ; Fri, 10 Jun 2022 07:37:11 -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=nomCNIDELZ+BDZVMaMN8+fsWdOEoHOWS9WDNjO7C8XU=; b=Qk0RQomrx5NJ0d7n3VsfUCUzbby42kbsBh4zXTbZnhdAUsqt87Lgu1y5HFV/J776aL sQhyNeu2ue2yxGRPGuGNrvYtWKsgSbNarzSl+Tp1VH+eCLcGiYk62YJZcjLLsmNfMtP2 WX6kD6DJk6D/hX6zE95U6HcOLlVyTkwt5hXtcmH2Mm93oryOcIkKNWflOoF5IgiQcjgO YdoxRs/bLn4IxITdPFE/LJTRF56kiSrdUnw6oPnWX+sdjc6zekZ6r46QZs3Hhj0wMvx5 D4etaVU63V9QQU0XK2jhWSj5w1G8VV7KtSKBxZMH025yEYQRmNWHs6heIEBvAiHFmyBl dTRA== 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=nomCNIDELZ+BDZVMaMN8+fsWdOEoHOWS9WDNjO7C8XU=; b=5XhYh4pkrcwulVZosQysklB6QWtZMKPNF6Wi/1PPrtWc7+C6Hjm0AugbMZyM2Of0S6 0Bp2gXNcoCNsqiVeO39BQJYWTE617tAsrZTAvuyDRkTPP1KDfFPgbkl5ZDcFd/CAetlK EssDTKhUdIvFpJILHGBrYkcGJebGRiehdeQXinrdcelOhqhe8wtiXw2exHQRYM0IO+T7 iynd2onEj9l5tNkncfxhdPssLgeXJ8n42KkBv3a46q9HIkw8xzoS7dV3t7MuaONz2d9C 5SFpY5/eY4ziZDAzUNvtcquye+owj95eaL19+xaxRbS9Z8aMf5oiubmJwhlCmZ0KlABB j8IQ== X-Gm-Message-State: AOAM530cEyoj6E9O6HpKl5J2SRR5R0gR6kSjV6GiAKd4DLdUdJq1NnJu oxoTf5MMywCGErUKcDCGO+6+18/POcc= X-Google-Smtp-Source: ABdhPJw9ap8j+DSeJ0T2PttUyfyxTjIDOZKv6s0ykvt1OIq2K2/AnMK9a7E0LjErlx34+3ImkwYiaA== X-Received: by 2002:adf:f582:0:b0:213:44ea:832e with SMTP id f2-20020adff582000000b0021344ea832emr43988717wro.59.1654871830124; Fri, 10 Jun 2022 07:37:10 -0700 (PDT) Received: from rltb ([2a01:e0a:3f3:fb50:d322:20a3:e287:911e]) by smtp.gmail.com with ESMTPSA id q3-20020a7bce83000000b003976fbfbf00sm3097676wmj.30.2022.06.10.07.37.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 10 Jun 2022 07:37:09 -0700 (PDT) From: Robert Pluim To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: 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> Gmane-Reply-To-List: yes Date: Fri, 10 Jun 2022 16:37:08 +0200 In-Reply-To: <87r13wr7x1.fsf@localhost> (Ihor Radchenko's message of "Fri, 10 Jun 2022 20:59:22 +0800") Message-ID: <87mtek1t63.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::429; envelope-from=rpluim@gmail.com; helo=mail-wr1-x429.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=1654871902; 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=nomCNIDELZ+BDZVMaMN8+fsWdOEoHOWS9WDNjO7C8XU=; b=EmEdO1G7wPdwxbh+ufis2mtgJ2Lb7V/3B5Id0gyl/l54PQaU/aYVXa1ZaEo323FRdh1Heh mvwmeHeL33co+jBmiR0OByTKJGkrNLMd8SrmXSFsgq14FFucSiGYziFikoiYzTXaxqsuDP Ff7iUddffKwVALJIYRuNyfdrGnFqehV2hyd7ycMO3H29+AuncyU6FVpLmTta//wOvkpheX +vfyYrjCl3mKLdN8SBk3853Fg90FbbAzqM/8VJvRRpJsaXLwxrA9QNu0kmFJWM0MGTy4it a4JJBTqxEioBf0A9IwqoRGLLvJHYonyOxjiJDnX6Sloi8EyMy9amTIG42hF2rw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1654871902; a=rsa-sha256; cv=none; b=kLwqjxJvqQpbuw15KZSFGNea+Zy0NrXyYyO2fx58LwnB/MPJOvyxlp0M0I+tnez9BcEXcT V9tC9pZl/55RbBzl/wPbmvvq0IMX9+NT+dHRKqU3arQkP0+2t6F0FJ7vFZyWKrakp0a5Cm psylRsTvg4XxGCvgnfTwJxoDRp4F5zYfoF716Gedxupyr9PXk2RPB6e3OdkjiWOiUYkV58 qcVW12XxdJQ85QtxBBMEOdSXK+cV0yz1RwAcZVJ4r41Dd9SlLqBk2NaafNZ3oVkRYjFjSa zBKjNtr/Ut8b5jD4KgnkbAuaDLKOfirvlB8YUZtZUpuZW/W6bJNHOvGpnSA5vQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Qk0RQomr; 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: -3.98 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Qk0RQomr; 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: 95BFE3B8BB X-Spam-Score: -3.98 X-Migadu-Scanner: scn0.migadu.com X-TUID: X56q3WlxbBj0 >>>>> On Fri, 10 Jun 2022 20:59:22 +0800, Ihor Radchenko said: Ihor> Just submit a patch here. Against the Org mode repository. Ihor> Org mode development happens in Org mode repository and in this m= ailing Ihor> list, not in Emacs repo. Ihor> See https://orgmode.org/worg/org-contribute.html Those conventions are slightly different than Emacs', with one point of ambiguity. They say * Line 1 of the commit message should always be a short description of the overall change. Line 1 does not get a dot at the end and does not start with a star. Generally, it starts with the filename that has been changed, followed by a colon, like this:=20 lisp/ol-man.el: Restore file * Line 2 is an empty line. * Line 3 starts the ChangeLog entry. It looks like this:=20 * org-timer.el (org-timer-cancel-timer, org-timer-stop): Enhance message. 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 around: Here is an example for such a message:=20 org-capture.el: Fix the case of using a template file * lisp/org-capture.el (org-capture-set-plist): Make sure txt is a string before calling `string-match'. (org-capture-templates): Fix customization type. * doc/org.texi (Capture): Document using a file for a template. Thanks Robert --=20