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 ms0.migadu.com with LMTPS id QkpDGdB4QmGsOwAAgWs5BA (envelope-from ) for ; Thu, 16 Sep 2021 00:50:56 +0200 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 2N1sFNB4QmHgJQAA1q6Kng (envelope-from ) for ; Wed, 15 Sep 2021 22:50:56 +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 5B411187F0 for ; Thu, 16 Sep 2021 00:50:55 +0200 (CEST) Received: from localhost ([::1]:40156 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mQdjy-00054L-9n for larch@yhetil.org; Wed, 15 Sep 2021 18:50:54 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54350) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQdis-00052E-OY for emacs-orgmode@gnu.org; Wed, 15 Sep 2021 18:49:47 -0400 Received: from walmailout06.yourhostingaccount.com ([65.254.253.54]:52803) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mQdir-0005XD-5l for emacs-orgmode@gnu.org; Wed, 15 Sep 2021 18:49:46 -0400 Received: from mailscan01.yourhostingaccount.com ([10.1.15.1] helo=walmailscan01.yourhostingaccount.com) by walmailout06.yourhostingaccount.com with esmtp (Exim) id 1mQdio-0004Q6-Nr for emacs-orgmode@gnu.org; Wed, 15 Sep 2021 18:49:42 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=tomdavey.com; s=dkim; h=Sender:Content-Transfer-Encoding:Content-Type: MIME-Version:Message-ID:Date:Subject:In-Reply-To:References:Cc:To:From: Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender :Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=8VZsoSvpQCZxxTbRtk32PSKj9f8jAGBK2Cu5Gczp61Y=; b=U0DpC27bD+cFMZwK2VtlisunBC KovjsJzqYxwnK1sdX8SyeqT32eAOgooE6i2xg8Mm9hhbg5/E5p6MkVXMatCKpkwQlAY6T9KcxXnTT c/JR/EIv2VwaVC423f5TXvqDKARF/z/SjEIT755idqLs3aA4LTYI7FSi5G/df7CAChS9i1kGvv+5h Dpfw7xG7M9qasrHGFn2kYdEOkEsjjQJNC5sclZOqXrr2QtEv+TWuSnMpgvJnZZfJ/mu08gw7VJKIO iSA4wlIZ9XM8+ro3HX4qybmFDKfprq3rNmQDaMWpL2Hihodjr9UmMIWnJDxAlPX+aDGJ1kHFHXBoF tWeNwQBw==; Received: from [10.114.3.22] (helo=walimpout02) by walmailscan01.yourhostingaccount.com with esmtp (Exim) id 1mQdio-0001ZP-Fs for emacs-orgmode@gnu.org; Wed, 15 Sep 2021 18:49:42 -0400 Received: from walauthsmtp56.yourhostingaccount.com ([10.1.18.56]) by walimpout02 with id uNpf250011Cb6gA01Npi3r; Wed, 15 Sep 2021 18:49:42 -0400 X-Authority-Analysis: v=2.3 cv=BvkGPbf5 c=1 sm=1 tr=0 a=1U9kRYeRNkEmUUoD+e2nCw==:117 a=zuBDUjl1ZKkaZ1e1JP5yeA==:17 a=kj9zAlcOel0A:10 a=7QKq2e-ADPsA:10 a=BJfXAp5dUnUA:10 a=6JfXMdr6AAAA:8 a=pGLkceISAAAA:8 a=mDV3o1hIAAAA:8 a=kSrFO0vRnCnS4dxUU38A:9 a=CjuIK1q_8ugA:10 a=TsfbUbXGka_IpY0nsRw-:22 a=_FVE-zBwftR9WsbkzFJk:22 Received: from cpe-74-73-105-65.nyc.res.rr.com ([74.73.105.65]:53995 helo=Penny) by walauthsmtp56.yourhostingaccount.com with esmtpa (Exim) id 1mQdil-0004yR-1f; Wed, 15 Sep 2021 18:49:39 -0400 From: "Tom Davey" To: "'Marco Wahl'" References: <014801d7aa5c$c9057450$5b105cf0$@tomdavey.com> <87ilz1360m.fsf@gmail.com> In-Reply-To: <87ilz1360m.fsf@gmail.com> Subject: RE: Bug: doc string for "org-end-of-meta-data" Date: Wed, 15 Sep 2021 18:49:36 -0400 Message-ID: <015b01d7aa83$f6ee0270$e4ca0750$@tomdavey.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Outlook 16.0 Thread-Index: AQIfmn6oaD9nktpLwQFm0FXTZWwDIwE184i3qwwgGpA= Content-Language: en-us X-EN-UserInfo: 52ba5adf417010193fa3ef08325f2c21:931c98230c6409dcc37fa7e93b490c27 X-EN-AuthUser: tom@tomdavey.com X-EN-OrigIP: 74.73.105.65 X-EN-OrigHost: cpe-74-73-105-65.nyc.res.rr.com Received-SPF: pass client-ip=65.254.253.54; envelope-from=SRS0=3MTXpa=OF=tomdavey.com=tom@yourhostingaccount.com; helo=walmailout06.yourhostingaccount.com X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.25, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no 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: , Reply-To: tom@tomdavey.com Cc: 'emacs-org list' Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1631746256; h=from:from:sender:sender:reply-to: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=8VZsoSvpQCZxxTbRtk32PSKj9f8jAGBK2Cu5Gczp61Y=; b=aBM1+KksMgwgbBhYf2WFi/eC5Av1CzjPdanQgofV/aBQTNeR9dTn0Asi2iNPkV/bBBOQhS IlCn6rxuXeKR/UiehrPh8zF/siRUAVtCuTCQP2UKJdDFgNGg1rAuWfapFJjUZ6E1PM6CNP D/negq5DUldKFTzQDABhIXf+yEgJGo/xEcghiw60oqVw7/pw9GIEqWgeAPPviaYhZeJR1o MogEfGz64QLyJGQvWwVPkNYzUd9BtB1mJz8WyDsNftTqtz/9g8TxlmJVwV1/RYVHq4K9Yf YNJa6asINFVLjmD/krMPh5LUUgAQIO4koKd9rfO8jcf0wPe2IiugkGBLJKTxxg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1631746256; a=rsa-sha256; cv=none; b=nmsYYIAj3gy/d2sLRfCWJI2s+7SNacXXvRW6S9wIA6vO1arYH7xCv5ufZCVnLcMMfLi4YD RhILB5kWOlAStn0Ce5YQFjK2QN2OTOGfphbCGYMnaujgMt2Xu+InIFUShHRfQUCf2LGi6p iELyufHr/Jp+fAYr7GxB1XjPjx6pL/K+qyDvDi6ju1cR9yMB2BjAwJclYlmBgp8LZP97vH FH6jkUcmapcz5s4K/qleMIDs9zEissWD6M+tWlNfxpo967ae38ocn3N/p46qKv3tkHjWwF 9HtGRjPx+LfhITmIQUrhwFA2/wipvf6CRSIyfAjipKe3UnHUmxVCbQic4MDsHg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tomdavey.com header.s=dkim header.b=U0DpC27b; 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-Migadu-Spam-Score: -1.40 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tomdavey.com header.s=dkim header.b=U0DpC27b; 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-Migadu-Queue-Id: 5B411187F0 X-Spam-Score: -1.40 X-Migadu-Scanner: scn0.migadu.com X-TUID: qhswOFXG02be Hi Marco, You make sense. What you propose to substitute is easier to understand and concise: When FULL is non-nil but not t, skip planning information, properties, clocking lines and logbook drawers. Thank you! -- Tom Davey tom@tomdavey.com New York NY USA -----Original Message----- From: Marco Wahl Sent: Wednesday, September 15, 2021 5:04 PM To: Tom Davey Cc: 'emacs-org list' Subject: Re: Bug: doc string for "org-end-of-meta-data" Hello Tom, > I believe the last paragraph of the doc string for the function > "org-end-of-meta-data" contains an error. That one-sentence paragraph > currently reads: > > When FULL is non-nil but not t, skip planning information, > clocking lines and only non-regular drawers, i.e. properties > and logbook drawers. > > I believe that should be "regular drawers," not "non-regular drawers." > IMO, the last paragraph could be clearer were it rewritten as follows: > > When FULL is non-nil but not t, skip only planning information, > clocking lines and regular drawers, i.e. properties and logbook > drawers. If any non-regular drawers exist and do not follow the > two regular drawers, stop at the first non-regular drawer instead. > > I believe that this expansion of the paragraph corrects the error and > adds coverage of a rare case. I think the use of the word "regular" is not a good idea in their documentation of org-end-of-meta-data. I could not find any occurance of the term "regular drawer" in the org-info manual. There is a section where the property drawer is called "special". In conclusion I'd say that the logic of the recent documentation is okay with "regular" meaning "non-special". Finally I propose to remove completely the categorisation due to "regular" from the documentation. Which reads: When FULL is non-nil but not t, skip planning information, properties, clocking lines and logbook drawers. WDYT?