From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id gJeyDTYh2F44EQAA0tVLHw (envelope-from ) for ; Wed, 03 Jun 2020 22:16:22 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id kciVCTYh2F61HQAA1q6Kng (envelope-from ) for ; Wed, 03 Jun 2020 22:16:22 +0000 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 892329404CF for ; Wed, 3 Jun 2020 22:16:21 +0000 (UTC) Received: from localhost ([::1]:44906 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jgbgI-0006L2-Ph for larch@yhetil.org; Wed, 03 Jun 2020 18:16:18 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:52178) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jgbfk-0006J4-4a for emacs-orgmode@gnu.org; Wed, 03 Jun 2020 18:15:44 -0400 Received: from devianza.investici.org ([198.167.222.108]:51461) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jgbfi-0004h1-Hm; Wed, 03 Jun 2020 18:15:43 -0400 Received: from mx2.investici.org (unknown [127.0.0.1]) by devianza.investici.org (Postfix) with ESMTP id 9EB05E05FE; Wed, 3 Jun 2020 22:15:37 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=anche.no; s=stigmate; t=1591222537; bh=h3z/oirpzU+jXh5zbyICgQ/yiVsEM3CGaqDRa72rXKc=; h=Subject:To:Cc:References:From:Date:In-Reply-To:From; b=MJ3EACRp2FiP6ajSymz7hzUNNFjogx9PSynFZrBQkZnoEIdrwhdrpuFsR5LI3BW9x sQNx5fgofzXmMXRBJGKCynXYnODYzgkkI9VdTFe/AVKJMlbpUEzLUooXhCINN3B+eI IHnZ+z7Eedn5ZHvZPXid+PFofEBIXbX0KoeKQ9N8= Received: from [198.167.222.108] (mx2.investici.org [198.167.222.108]) (Authenticated sender: mariotomo@inventati.org) by localhost (Postfix) with ESMTPSA id 45993E05F6; Wed, 3 Jun 2020 22:15:35 +0000 (UTC) Subject: Re: `with` as a list. To: Bastien References: <87h7vxuq8i.fsf@kyleam.com> <1a448b21-cdf9-467d-e707-471bb8c01781@anche.no> <874krvvdr3.fsf@kyleam.com> <87sgfftt30.fsf@kyleam.com> <87zh9kxjw5.fsf@bzg.fr> <15c8b193-6bf5-5248-c557-d28c0c25f123@anche.no> <87o8q0rwus.fsf@gnu.org> From: Mario Frasca Message-ID: Date: Wed, 3 Jun 2020 17:15:23 -0500 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.8.1 MIME-Version: 1.0 In-Reply-To: <87o8q0rwus.fsf@gnu.org> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Content-Language: en-US Received-SPF: pass client-ip=198.167.222.108; envelope-from=mario@anche.no; helo=devianza.investici.org X-detected-operating-system: by eggs.gnu.org: First seen = 2020/06/03 17:07:06 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] 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, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: emacs-orgmode@gnu.org Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=anche.no header.s=stigmate header.b=MJ3EACRp; dmarc=none; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Spam-Score: -1.21 X-TUID: Fo0L2a/3O/7e On 03/06/2020 10:29, Bastien wrote: > The few lines above is what we called the "changelog". It should be > the first part of the commit message -- after which you can add more > free-form context and explanations, if needed. this "Changelog", and I'm sure I am the stiffy one, isn't clear from the description.  browsing through the other contributions, I recognize this structure: the "Changelog" is the second block, (preferably) without any empty lines.  the next empty line will end the "Changelog" and start the less formal comments. (unsure about this). changes are grouped by file, each changed file is introduced by a line starting with an asterisk '*', and the complete path of the file.  then follows the function affected, in single parentheses, a colon ':', and the description of the change.  if the change is relative to documentation, the parentheses include title of the affected paragraph.  finally the description, formatted as per your html page. if the next change is in the same file, you skip the leading '*' and file name and the line should start with the parenthesized affected object. ---------------------------- for example (two files, two different changes --- code and doc): * lisp/org.el (org-read-date-analyze): Add support for HHhMM time input, in similar way as for am/pm times. * doc/org-manual.org (The date/time prompt): Add example to illustrate the feature. ---------------------------- other example (two affected files, single description --- code): * testing/lisp/test-ob-tangle.el (ob-tangle/jump-to-org): * testing/lisp/test-org-attach.el (test-org-attach/dir): Rig org-file-apps so that temporary files are visited inside Emacs. ---------------------------- (one file, two different changes --- doc): * doc/org-manual.org (Capturing column view): Replace stale binding with mention of org-dynamic-block-insert-dblock, and refer to org-columns-insert-dblock rather than its obsolete variant. (The clock table): Prune references to stale binding, rewrite org-dynamic-block-insert-dblock key sequence in a clearer manner, and add a dedicated entry for org-clock-report. ---------------------------- slightly sloppy example (two files, single description, not clear what's affected): * lisp/org-clock.el: * lisp/org-colview.el: Autoload call to org-dynamic-block-define. ---------------------------- etc/ORG-NEWS is an exception, and should be mentioned as first. are empty lines acceptable?  or will your parser fail to understand? * etc/ORG-NEWS: Announce the change. * lisp/org-keys.el (org-mode-map): Rebind C-j to a command emulating `electric-newline-and-maybe-indent'. * lisp/org.el (org-cdlatex-environment-indent): Stop using the now obsolete function. (org--newline): New helper function. (org-return): Use it to transparently handle `electric-indent-mode'. (org-return-and-maybe-indent): New command to emulate `electric-newline-and-maybe-indent' while taking care of Org special cases (tables, links, timestamps). ----------------------------