Re: Bug: Several small documentation problems [8.3.6 (8.3.6-4-g4835be-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20160926/)]

[Nicolas Goaziou <mail@nicolasgoaziou.fr>]

Hello,

Jorge <jorge13515@gmail.com> writes:

> On 29 September 2016 at 17:36, Nicolas Goaziou <mail@nicolasgoaziou.fr> 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