Re: Bug: Small documentation errors [9.3.6 (9.3.6-29-g6a3dff-elpaplus @ /home/jorge/.emacs.d/elpa/27.0/develop/org-plus-contrib-20200406/)]

[Jorge P. de Morais Neto <jorge+list@disroot.org>]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: 0001-doc-org-manual.org-Tracking-TODO-state-changes-move-.patch --]
[-- Type: text/x-diff, Size: 1524 bytes --]

From 474192b67077b3a7bfaa8e9ff152b1a9ac7524f3 Mon Sep 17 00:00:00 2001
From: "Jorge P. de Morais Neto" <jorge+git@disroot.org>
Date: Wed, 11 Aug 2021 17:13:06 -0300
Subject: [PATCH] * doc/org-manual.org (Tracking TODO state changes): move
 sentence

The sentence was misplaced, interrupting the train of thought.  I also
did not understand the need for disabling paragraph indentation, so I
removed the directive.
---
 doc/org-manual.org | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 977ef80b9..d34d33561 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -4205,10 +4205,6 @@ example, with the setting
       '((sequence "TODO(t)" "WAIT(w@/!)" "|" "DONE(d!)" "CANCELED(c@)")))
 #+end_src
 
-#+texinfo: @noindent
-To record a timestamp without a note for TODO keywords configured with
-=@=, just type {{{kbd(C-c C-c)}}} to enter a blank note when prompted.
-
 #+vindex: org-log-done
 You not only define global TODO keywords and fast access keys, but
 also request that a time is recorded when the entry is set to =DONE=,
@@ -4228,6 +4224,9 @@ to a buffer:
 
 : #+TODO: TODO(t) WAIT(w@/!) | DONE(d!) CANCELED(c@)
 
+To record a timestamp without a note for TODO keywords configured with
+=@=, just type {{{kbd(C-c C-c)}}} to enter a blank note when prompted.
+
 #+cindex: @samp{LOGGING}, property
 In order to define logging settings that are local to a subtree or
 a single item, define a =LOGGING= property in this entry.  Any
-- 
2.32.0


[-- Attachment #2: Type: text/plain, Size: 1360 bytes --]

Hi.  I continue below:

Em [2020-04-12 dom 10:45:44-0300], Jorge P. de Morais Neto escreveu:

> ** [info:org#Tracking TODO state changes]
>
> The following sentence is misplaced, interrupting the previous train of
> thought:
>
>     To record a timestamp without a note for TODO keywords configured
>     with `@', just type `C-c C-c' to enter a blank note when prompted.

I prepared the patch above to improve the organization of the respective
manual section.

> ** [[info:org#Drawers]]
>
> I don't understand the sentence
>
>        Completion over drawer keywords is also possible using ‘M-<TAB>’
>
> Could give me a simple example of drawer keyword completion?

Sorry for insisting, but can someone give me an example of what the
manual means by "Completion over drawer keywords"?

And in this kind of situation, did I do well by attaching the patch to a
normal reply in the thread, or should I have started a new thread with
an appropriate subject line?  If so, then please give me details so I do
it correctly next time.

Regards

-- 
- Disinformation flourishes because many people care about injustice
  but very few check the facts.  Ask me about <https://stallmansupport.org>
- I am Brazilian.  I hope my English is correct and I welcome feedback.
- https://www.defectivebydesign.org
- https://www.gnu.org