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.bugs Subject: bug#62677: 30.0.50; Need to find a better name for flyspell-prog-mode Date: Thu, 06 Apr 2023 09:24:46 +0300 Message-ID: <83y1n5r0i9.fsf@gnu.org> References: <87mt3mv5e9.fsf@web.de> <076460cb-f203-de49-c949-bdc213fd1965@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20310"; mail-complaints-to="usenet@ciao.gmane.io" Cc: michael_heerdegen@web.de, 62677@debbugs.gnu.org To: Jim Porter Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Apr 06 08:25:40 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1pkJ3z-00058D-Ke for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 06 Apr 2023 08:25:39 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pkJ3d-0003JR-G2; Thu, 06 Apr 2023 02:25:17 -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 1pkJ3T-0003Ha-9E for bug-gnu-emacs@gnu.org; Thu, 06 Apr 2023 02:25:07 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pkJ3O-00043I-Mj for bug-gnu-emacs@gnu.org; Thu, 06 Apr 2023 02:25:06 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pkJ3N-00016w-WE for bug-gnu-emacs@gnu.org; Thu, 06 Apr 2023 02:25:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 06 Apr 2023 06:25:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 62677 X-GNU-PR-Package: emacs Original-Received: via spool by 62677-submit@debbugs.gnu.org id=B62677.16807622664209 (code B ref 62677); Thu, 06 Apr 2023 06:25:01 +0000 Original-Received: (at 62677) by debbugs.gnu.org; 6 Apr 2023 06:24:26 +0000 Original-Received: from localhost ([127.0.0.1]:53235 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pkJ2o-00015p-7K for submit@debbugs.gnu.org; Thu, 06 Apr 2023 02:24:26 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:33602) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pkJ2m-00015c-Qf for 62677@debbugs.gnu.org; Thu, 06 Apr 2023 02:24:25 -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 1pkJ2h-0003ya-9W; Thu, 06 Apr 2023 02:24:19 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=ty0/AXX5C3+3Mlpl+JfqH28Rgwuqsl09REOFKK2ZEvc=; b=DuMxQPBm55cs62A+MNZH OdClxs0zgClZhuf+ZitaKb6PKJdrNxCzn3U9z/WnXn4f0Hg6fDaE7YdtElOBja186uSDQx2p/KblU Ffb6vFex1FGQRA/qEjZxsbV0sfp3UuTf2A7+epwOmGXOieKGVTfLClnwzfq+6RXOKVZqio25TjqLh 4+RF/youoMzVlT9TEIz4PQz7NW7dqob6wAzK3ZVdoKcpuY2bkPQZsoWE5TyqsRGhVzONBpKFfiD4q rCanVCSHWKk5ymfcv6hW0p2R4sNYzaQdBaFU6mkeSc8hMLDis9LOvPEKq+DUixIP160dreuNwE6ef UODv9wOvBhLupA==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pkJ2g-0001o1-Ph; Thu, 06 Apr 2023 02:24:19 -0400 In-Reply-To: <076460cb-f203-de49-c949-bdc213fd1965@gmail.com> (message from Jim Porter on Wed, 5 Apr 2023 13:29:59 -0700) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:259298 Archived-At: > Date: Wed, 5 Apr 2023 13:29:59 -0700 > From: Jim Porter > > On 4/5/2023 6:13 AM, Michael Heerdegen wrote: > > `flyspell-prog-mode' is a variant of `flyspell-mode' for editing > > programs: it limits spell checking to areas of text fontified with > > certain faces (`flyspell-prog-text-faces', normally strings and > > comments). The intention is obviously to skip keywords and tags that > > are used by the programming language itself. > > For what it's worth, when I started using flyspell-mode last year and > subsequently discovered flyspell-prog-mode, I immediately understood > what its intent was from the name. So from my perspective, it's actually > a very good name. That depends on what you understood ;-) It could be that you understood it immediately, but incorrectly or inaccurately. > > This mode is geared toward text modes. In buffers that contain > > code, ‘flyspell-prog-mode’ is usually a better choice. The above is inaccurate as well: text-derived modes for markup text can also benefit. Basically, anything where you have keywords that are not necessarily words in a human language. > If there are still discoverability issues, then I think we should try to > provide appropriate keywords in manuals, etc so that it's easier to find > this. IMO, we should start with what the manual says: Flyspell Prog mode works just like ordinary Flyspell mode, except that it only checks words in comments and string constants. This feature is useful for editing programs. Which might try to explain the name, but in doing so, it misses the opportunity to let the readers discover what that mode truly is and what it can do.