From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Bug: Several small documentation problems [8.3.6 (8.3.6-4-g4835be-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20160926/)] Date: Sun, 02 Oct 2016 00:36:33 +0200 Message-ID: <87bmz3wvbi.fsf@nicolasgoaziou.fr> References: <87intexx22.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:49571) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bqStd-0001RN-0u for emacs-orgmode@gnu.org; Sat, 01 Oct 2016 18:36:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bqStY-00086q-Rt for emacs-orgmode@gnu.org; Sat, 01 Oct 2016 18:36:39 -0400 Received: from relay4-d.mail.gandi.net ([217.70.183.196]:36391) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bqStY-00086F-Lc for emacs-orgmode@gnu.org; Sat, 01 Oct 2016 18:36:36 -0400 In-Reply-To: (Jorge's message of "Fri, 30 Sep 2016 10:36:37 -0300") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Jorge Cc: org mode Hello, Jorge writes: > On 29 September 2016 at 17:36, Nicolas Goaziou wrote: >> I think "grandparent" is correct. In the following document >> >> * H1 >> ** H2 >> Text<--point >> >> "H2" is the parent headline of "Text" and as a consequence, "H1" is its >> grandparent. > What if point is in the headline, which is often the case? Besides the > docstring is inconsistent: > With two universal prefix arguments, insert the heading at the end > of the grandparent subtree. For example, if point is within a > 2nd-level heading, then it will insert a 2nd-level heading at the > end of the 1st-level parent heading. > > In the first sentence it says "grandparent subtree", whereas in the second > sentence it says "parent heading". And the manual says "parent": > Calling this command with `C-u C-u' will unconditionally respect > the headline's content and create a new item at the end of the > parent subtree. In this case, both "parent" and "grandparent" are confusing terms. I made a change to M-RET docstring, hopefully eschewing the confusion. Please let me know if there is still something wrong there. > But I still ask you to look at the other points I made about that manual > section: that it doesn't adequately explain the effect of C-u M-RET, and that > the description of C-RET is actually wrong. I overlooked that part. Fixed. Thank you. Regards, -- Nicolas Goaziou