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: Thu, 29 Sep 2016 22:36:53 +0200 Message-ID: <87intexx22.fsf@nicolasgoaziou.fr> References: 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]:34025) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bpi4e-0005Fb-Sj for emacs-orgmode@gnu.org; Thu, 29 Sep 2016 16:36:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bpi4c-0000s1-UV for emacs-orgmode@gnu.org; Thu, 29 Sep 2016 16:36:55 -0400 Received: from relay3-d.mail.gandi.net ([2001:4b98:c:538::195]:39693) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bpi4c-0000rb-Og for emacs-orgmode@gnu.org; Thu, 29 Sep 2016 16:36:54 -0400 In-Reply-To: (Jorge's message of "Thu, 29 Sep 2016 15:36:27 -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: > This is the first batch of documentation problems. I will report the rest > later, because preparing this first batch already took several hours. Those are fixed, except the points below. > =E2=80=A2 When describing the behavior with C-u C-u, it wrongly substit= utes > "grandparent" for "parent". 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. > =E2=80=A2 [info:org#Structure editing] > I looked at the code, and C- (org-insert-heading-respect-content) = just > calls (org-insert-heading '(4) invisible-ok), so it has the same effect= as > C-u M-. The manual could mention that C- has the same effect= as > C-u M-, to aid the user's learning process, as she would just need= to > memorize this quick fact, instead of understanding both behaviors and > deducing they're equal). Also the manual doesn't adequately explain the > effect of C-u M-. And the description of C- is actually wron= g: > Just like `M-', except when adding a new heading below the > current heading, the new heading is placed after the body instead > of before it. This command works from anywhere in the entry. > /After the body/? Doesn't it mean /after the entry/? Besides, there a= re > additional differences: that M- may create a new plain list item, = while > C- always creates a new heading, and that C- never splits the > heading. Please rewrite the whole description. You are right, M-RET and C-RET are confusing, and making C-u M-RET a duplicate of C-RET is wasting some important keybinding. This was discussed on this ML already (with Rasmus) but led nowhere so far. In any case, it is more future-proof to not insist on the fact that C-RET is C-u M-RET. Thank you for this tedious, yet very important work. Regards, --=20 Nicolas Goaziou