[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [O] Bug: Several small documentation problems [8.3.6 (8.3.6-4-g4835b
Re: [O] Bug: Several small documentation problems [8.3.6 (8.3.6-4-g4835be-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20160926/)]
Sun, 02 Oct 2016 00:36:33 +0200
Jorge <address@hidden> writes:
> On 29 September 2016 at 17:36, Nicolas Goaziou <address@hidden> wrote:
>> I think "grandparent" is correct. In the following document
>> * H1
>> ** H2
>> "H2" is the parent headline of "Text" and as a consequence, "H1" is its
> 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.
- Re: [O] 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 <=