Re: MINI-PATCH: add how to turn auto-completion in test buffers off

[Eli Zaretskii]

> From: Pedro Andres Aranda Gutierrez <paaguti@gmail.com>
> Date: Thu, 4 Apr 2024 19:29:30 +0200
> 
> I find auto-completion suggestions when writing text quite intrusive and 
> distracting. It has taken me some
> Emacs Lisp reading to find out how to turn it off. Attached is a micro-patch 
> to add a small hint to turn it off. A
> reminder: there are people who need to be not disturbed with external stimuli 
> when working (for example
> attention deficits, etc.)
> 
> Thx, /PA
> 
> ---cut here---
> diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
> index b034fecd77b..8a61117142d 100644
> --- a/doc/lispref/modes.texi
> +++ b/doc/lispref/modes.texi
> @@ -1056,7 +1056,8 @@ Basic Major Modes
>  @samp{"} and @samp{\} characters as having punctuation syntax
>  (@pxref{Syntax Class Table}), and arranges for
>  @code{completion-at-point} to complete words based on the spelling
> -dictionary (@pxref{Completion in Buffers}).
> +dictionary (@pxref{Completion in Buffers}), unless variable
> +@code{text-mode-ispell-word-completion} is set to @code{nil}.

Thanks, but this is not the right place for documenting the option if
we want to make it more discoverable.  User options are supposed to be
documented in the Emacs user manual, not in the Lisp Reference manual,
and users are unlikely to look in the latter when they look for
user-level information.

So I think this should be added to the node "Text Mode" of the user
manual instead.  Bonus points for mentioning this feature in the doc
string of text-mode as well.