From d3c62edf7a713278432ebe1c72e4545b8a2b84e2 Mon Sep 17 00:00:00 2001
From: "Jorge P. de Morais Neto" <jorge+git@disroot.org>
Date: Wed, 11 Aug 2021 18:43:21 -0300
Subject: [PATCH] * doc/org-manual.org (Drawers): Clarify M-TAB

Provide example of completion over drawer keywords.  Also clarify the
footnote by qualifying "windows" as "graphical".
---
 doc/org-manual.org | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index d34d33561..467644453 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -1214,7 +1214,22 @@ Org mode uses this special drawer for storing properties (see
 [[*Properties and Columns]]).  You cannot use it for anything else.
 
 Completion over drawer keywords is also possible using
-{{{kbd(M-TAB)}}}[fn:16].
+{{{kbd(M-TAB)}}}[fn:16].  For example, if the buffer contains
+
+#+begin_example
+:foo:
+:end:
+
+:f★
+#+end_example
+
+#+texinfo: @noindent
+(where ★ indicates the location of point) then {{{kbd(M-TAB)}}} will
+complete the line as
+
+#+begin_example
+:foo:★
+#+end_example
 
 Visibility cycling (see [[*Visibility Cycling]]) on the headline hides and
 shows the entry, but keep the drawer collapsed to a single line.  In
@@ -21500,8 +21515,8 @@ variable ~org-M-RET-may-split-line~.
 
 [fn:15] See ~org-list-use-circular-motion~ for a cyclic behavior.
 
-[fn:16] Many desktops intercept {{{kbd(M-TAB)}}} to switch windows.
-Use {{{kbd(C-M-i)}}} or {{{kbd(ESC TAB)}}} instead.
+[fn:16] Many desktops intercept {{{kbd(M-TAB)}}} to switch graphical
+windows.  Use {{{kbd(C-M-i)}}} or {{{kbd(ESC TAB)}}} instead.
 
 [fn:17] To insert a vertical bar into a table field, use =\vert= or,
 inside a word =abc\vert{}def=.
-- 
2.32.0