From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jorge 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, 2 Oct 2016 16:40:16 -0300 Message-ID: References: <87intexx22.fsf@nicolasgoaziou.fr> <87bmz3wvbi.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:58035) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bqmcX-0005nG-AY for emacs-orgmode@gnu.org; Sun, 02 Oct 2016 15:40:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bqmcV-000345-0Z for emacs-orgmode@gnu.org; Sun, 02 Oct 2016 15:40:20 -0400 Received: from mail-qt0-x230.google.com ([2607:f8b0:400d:c0d::230]:36113) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bqmcU-00033t-S7 for emacs-orgmode@gnu.org; Sun, 02 Oct 2016 15:40:18 -0400 Received: by mail-qt0-x230.google.com with SMTP id m5so16037323qtb.3 for ; Sun, 02 Oct 2016 12:40:18 -0700 (PDT) In-Reply-To: <87bmz3wvbi.fsf@nicolasgoaziou.fr> 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: org mode On 1 October 2016 at 19:36, Nicolas Goaziou wrote: > 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. It is good now, but I still have some questions and observations: First, there is some undocumented behavior if M-RET is called in the headli= ne after column 0 but before the headline text (e.g. if point is on the priori= ty cookie). It then splits the heading just before the PROPERTIES drawer. Bu= t I don=E2=80=99t know if this is worthy of documentation. Now something which I do consider worthy of description: This forces the insertion of a heading after the current subtree, independently on the location of point. At least in Org version 8.3.6 (8.3.6-4-g4835be-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20160926/), the new subtree is positioned /before/ the current one if M-RET (even C-u M-RET) is invoked at column 0 in the headline. You could change the text to This forces the insertion of a heading after the current subtree, for any position of point except at column 0 in the headline. Or you could change the code to remove this non-uniform behavior at column = 0 of the headline. Now a very small detail: With double \\[universal-argument] \\[universal-argument] prefix A =E2=80=9Cdouble \\[universal-argument] \\[universal-argument]=E2=80=9D co= uld be interpreted as C-u C-u C-u C-u. I think it would be better to say just With a \\[universal-argument] \\[universal-argument] prefix --=20 =E2=80=A2 I am Brazilian. I hope my English is correct and I welcome corre= ctions. =E2=80=A2 Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM a= nd 7z. =E2=80=A2 Free (as in free speech) software for Android: https://f-droid.or= g/