From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: MINI-PATCH: add how to turn auto-completion in test buffers off Date: Thu, 04 Apr 2024 21:48:15 +0300 Message-ID: <86y19t55hs.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25855"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Pedro Andres Aranda Gutierrez Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Apr 04 20:49:04 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1rsS92-0006Sl-1V for ged-emacs-devel@m.gmane-mx.org; Thu, 04 Apr 2024 20:49:04 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rsS8O-0000RS-6y; Thu, 04 Apr 2024 14:48:24 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rsS8N-0000RJ-5g for emacs-devel@gnu.org; Thu, 04 Apr 2024 14:48:23 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rsS8M-0000mi-Th; Thu, 04 Apr 2024 14:48:22 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=BkizyWdzhjDrN6vnI0ZwtJnKp91d7x0pj+ddDSEkDC4=; b=ouQmxtvJc8Tu iK+XDxnIAZ2bN1URQ26bKTmKyaURck9W7K9WvI2UK2zPnihqECeeMIFlb/f+KigDaJg29yDosvOjx 6wHwfCzu2kdrudwpumfRnCHiPa1OqXczH25G13PaMveHvz3TKbj6m9NJeD6yRdV1ydfUCNuA0J8Fk CG72mUSoMa9FhQYCn3AB6a8yjyS7m7CTOBA++TpLp3GirpSNjUyG0GEw3/bfpb7X+0poA09yl626I qu5WbCPtmvrYhzNFhCCi3xms7V/3bwldvVsO/DOJTvToIbKgMgx5rHvPMAp9ODTHE33pRlK250Nqk avqcEiMnA2uQNFblM1bFpg==; In-Reply-To: (message from Pedro Andres Aranda Gutierrez on Thu, 4 Apr 2024 19:29:30 +0200) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:317527 Archived-At: > From: Pedro Andres Aranda Gutierrez > 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.