summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2020-09-05 16:40:58 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2020-09-05 16:40:58 +0200
commit4b2371631167e509668b6268334e324fdd2f0327 (patch)
tree514fb3557e1ee8d33d439d70f224dccf3b1b6096
parent3c69864a9c9ae45680660420b25807ab14255a11 (diff)
downloademacs-4b2371631167e509668b6268334e324fdd2f0327.tar.gz
Explain in the tab-always-indent doc how to make TAB insert a TAB
* lisp/indent.el (tab-always-indent): Mention how to make TAB insert a TAB character always (bug#37183).
-rw-r--r--lisp/indent.el11
1 files changed, 10 insertions, 1 deletions
diff --git a/lisp/indent.el b/lisp/indent.el
index 0a0dd99ce08..9f32cedfa4a 100644
--- a/lisp/indent.el
+++ b/lisp/indent.el
@@ -53,7 +53,16 @@ If `complete', TAB first tries to indent the current line, and if the line
was already indented, then try to complete the thing at point.
Some programming language modes have their own variable to control this,
-e.g., `c-tab-always-indent', and do not respect this variable."
+e.g., `c-tab-always-indent', and do not respect this variable.
+
+If you want the TAB key to always insert a literal TAB character,
+this can't be controlled by setting this variable. Instead you
+could say something like:
+
+\(setq overriding-terminal-local-map
+ (let ((map (make-sparse-keymap)))
+ (define-key map [?\t] 'self-insert-command)
+ map))"
:group 'indent
:type '(choice
(const :tag "Always indent" t)