Re: Word completion in text modes

[Eli Zaretskii]

> From: Eshel Yaron <me@eshelyaron.com>
> Cc: emacs-devel@gnu.org
> Date: Sat, 25 Nov 2023 13:11:27 +0100
> 
> >> diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
> >> index 8670807cbdf..ffd7ad7f51d 100644
> >> --- a/doc/lispref/modes.texi
> >> +++ b/doc/lispref/modes.texi
> >> @@ -981,9 +981,7 @@ Basic Major Modes
> >>  @deffn Command text-mode
> >>  Text mode is a major mode for editing human languages.  It defines the
> >>  @samp{"} and @samp{\} characters as having punctuation syntax
> >> -(@pxref{Syntax Class Table}), and binds @kbd{M-@key{TAB}} to
> >> -@code{ispell-complete-word} (@pxref{Spelling,,, emacs, The GNU Emacs
> >> -Manual}).
> >> +(@pxref{Syntax Class Table}).
> >
> > Why remove the reference to the command binding here?
> 
> Text mode no longer binds `C-M-i` to anything, relying on the global
> binding instead.  So there doesn't seem to be any reason to mention this
> binding here anymore, just like it's not mentioned in the description of
> `prog-mode` that follows this paragraph.  Does that make sense?

But the global bin ding has a text-mode-special effect in Text mode,
does it not?  Then we should change the text to mention that special
effect, instead of removing it completely.  That's assuming the
completion feature is still important enough to mention it in the
manual.

> > Did you check what happens when Flyspell mode is turned on in a buffer
> > under Text mode or one of its descendants?
> 
> Yes.  Unless one sets `flyspell-use-meta-tab` to nil, Flyspell mode binds
> `C-M-i` to a completely different command, `flyspell-auto-correct-word`.

And if flyspell-use-meta-tab is nil, what happens then under Flyspell
mode?