M-TAB in org manual

M-TAB in org manual

[Thomas Rikl]

[-- Attachment #1: Type: text/plain, Size: 575 bytes --]

Emacs  : GNU Emacs 25.1.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.22.7)
 of 2017-02-07
Package: Org mode version 9.0.5 (release_9.0.5-325-g28b847 @
/tom/github/org-mode/lisp/)

Hello Nicolas,

thanks for encouraging me to deliver a patch.
The patch (i think the first in my life delivered to public)
contains a superfluous comment line first inserted then removed
other parts come from fill-paragraph.

I tried also to unify the spelling of M-TAB somtimes M-<TAB>, or variants.

$ git format-patch -2 HEAD --stdout --minimal >M-TAB_patch

made the attached file.

Thanks.


[-- Attachment #2: M-TAB_patch --]
[-- Type: text/plain, Size: 4688 bytes --]

From 4824b482e2946eaca045d8adcd721a7fc2d8dd1d Mon Sep 17 00:00:00 2001
From: "Th. Rikl" <trikl@online.de>
Date: Tue, 28 Feb 2017 16:11:43 +0100
Subject: [PATCH 1/2] 2 hunks: M-<TAB> repl. by M-TAB, alternate key "ESC TAB"

---
 doc/org.texi | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/doc/org.texi b/doc/org.texi
index 6cb4243ac..83422c5ce 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -2133,7 +2133,7 @@ Re-align the table and don't move to another field.
 @orgcmd{C-c SPC,org-table-blank-field}
 Blank the field at point.
 @c
-@orgcmd{<TAB>,org-table-next-field}
+@orgcmd{TAB,org-table-next-field}
 Re-align the table, move to the next field.  Creates a new row if
 necessary.
 @c
@@ -10387,10 +10387,12 @@ In-buffer settings may appear anywhere in the file, either directly or
 indirectly through a file included using @samp{#+SETUPFILE: filename} syntax.
 Option keyword sets tailored to a particular back-end can be inserted from
 the export dispatcher (@pxref{The export dispatcher}) using the @code{Insert
-template} command by pressing @key{#}.  To insert keywords individually,
-a good way to make sure the keyword is correct is to type @code{#+} and then
-to use @kbd{M-<TAB>} for completion.
-
+template} command by pressing @key{#}.  To insert keywords individually, a
+good way to make sure the keyword is correct is to type @code{#+} and then to
+use @kbd{M-TAB} @footnote{Many desktops intercept @kbd{M-TAB} to switch
+windows. Use @kbd{C-M-i} or @kbd{@key{ESC} @key{TAB}} instead.} for
+completion.
+@c trikl m-tab spelling, footnote entferne kommentarzeile vor release
 The export keywords available for every back-end, and their equivalent global
 variables, include:
 
-- 
2.12.0


From 60256363d3d4df75491130a0366501d6f5049ad4 Mon Sep 17 00:00:00 2001
From: "Th. Rikl" <trikl@online.de>
Date: Tue, 28 Feb 2017 18:45:58 +0100
Subject: [PATCH 2/2] Intro of M-TAB footnotes and pxrefs first round completed

---
 doc/org.texi | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/doc/org.texi b/doc/org.texi
index 83422c5ce..673dc7ea6 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -1836,7 +1836,9 @@ You can interactively insert drawers at point by calling
 region, this command will put the region inside the drawer.  With a prefix
 argument, this command calls @code{org-insert-property-drawer} and add a
 property drawer right below the current headline.  Completion over drawer
-keywords is also possible using @key{M-TAB}.
+keywords is also possible using @kbd{M-@key{TAB}} @footnote{Many desktops
+intercept @kbd{M-@key{TAB}} to switch windows. Use @kbd{C-M-i} or @kbd{@key{ESC}
+@key{TAB}} instead for completion (@pxref{Completion}).}.
 
 Visibility cycling (@pxref{Visibility cycling}) on the headline will hide and
 show the entry, but keep the drawer collapsed to a single line.  In order to
@@ -3002,7 +3004,9 @@ a Lisp formula, format the formula according to Emacs Lisp rules.
 Another @key{TAB} collapses the formula back again.  In the open
 formula, @key{TAB} re-indents just like in Emacs Lisp mode.
 @orgcmd{M-@key{TAB},lisp-complete-symbol}
-Complete Lisp symbols, just like in Emacs Lisp mode.
+Complete Lisp symbols, just like in Emacs Lisp mode.@footnote{Many desktops
+intercept @kbd{M-@key{TAB}} to switch windows. Use @kbd{C-M-i} or
+@kbd{@key{ESC} @key{TAB}} instead for completion (@pxref{Completion}).}
 @kindex S-@key{up}
 @kindex S-@key{down}
 @kindex S-@key{left}
@@ -10389,10 +10393,10 @@ Option keyword sets tailored to a particular back-end can be inserted from
 the export dispatcher (@pxref{The export dispatcher}) using the @code{Insert
 template} command by pressing @key{#}.  To insert keywords individually, a
 good way to make sure the keyword is correct is to type @code{#+} and then to
-use @kbd{M-TAB} @footnote{Many desktops intercept @kbd{M-TAB} to switch
+use @kbd{M-@key{TAB}} @footnote{Many desktops intercept @kbd{M-TAB} to switch
 windows. Use @kbd{C-M-i} or @kbd{@key{ESC} @key{TAB}} instead.} for
 completion.
-@c trikl m-tab spelling, footnote entferne kommentarzeile vor release
+
 The export keywords available for every back-end, and their equivalent global
 variables, include:
 
@@ -16857,6 +16861,10 @@ and the keys, Org will offer different types of completions.  No minibuffer
 is involved.  Such mode-specific hot keys have become an integral part of
 Emacs and Org provides several shortcuts.
 
+If your desktop intercepts the combo @kbd{M-@key{TAB}} to switch
+windows. Use @kbd{C-M-i} or @kbd{@key{ESC} @key{TAB}} as an alternative or
+customize your environment.
+
 @table @kbd
 @kindex M-@key{TAB}
 @item M-@key{TAB}
-- 
2.12.0

Re: M-TAB in org manual

[Nicolas Goaziou]

Hello,

Thomas Rikl <trikl@online.de> writes:

> The patch (i think the first in my life delivered to public)
> contains a superfluous comment line first inserted then removed
> other parts come from fill-paragraph.
>
> I tried also to unify the spelling of M-TAB somtimes M-<TAB>, or variants.
>
> $ git format-patch -2 HEAD --stdout --minimal >M-TAB_patch
>
> made the attached file.

Applied. Thank you.

For the record, I added a commit message and put two spaces at the end
of sentences, as required by Texinfo.

I also added a kindex for C-M-i.

Regards,

-- 
Nicolas Goaziou