From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jim Porter Newsgroups: gmane.emacs.bugs Subject: bug#62677: 30.0.50; Need to find a better name for flyspell-prog-mode Date: Wed, 5 Apr 2023 13:29:59 -0700 Message-ID: <076460cb-f203-de49-c949-bdc213fd1965@gmail.com> References: <87mt3mv5e9.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36989"; mail-complaints-to="usenet@ciao.gmane.io" To: Michael Heerdegen , 62677@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Apr 05 22:31:36 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 1pk9n6-0009RO-4e for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 05 Apr 2023 22:31:36 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pk9mi-0000pK-2Z; Wed, 05 Apr 2023 16:31:12 -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 1pk9mY-0000nJ-CZ for bug-gnu-emacs@gnu.org; Wed, 05 Apr 2023 16:31:02 -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 1pk9mX-00080P-RG for bug-gnu-emacs@gnu.org; Wed, 05 Apr 2023 16:31:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pk9mX-0008K6-N2 for bug-gnu-emacs@gnu.org; Wed, 05 Apr 2023 16:31:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Jim Porter Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 05 Apr 2023 20:31: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.168072663031948 (code B ref 62677); Wed, 05 Apr 2023 20:31:01 +0000 Original-Received: (at 62677) by debbugs.gnu.org; 5 Apr 2023 20:30:30 +0000 Original-Received: from localhost ([127.0.0.1]:52740 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pk9m1-0008JE-Up for submit@debbugs.gnu.org; Wed, 05 Apr 2023 16:30:30 -0400 Original-Received: from mail-pj1-f49.google.com ([209.85.216.49]:54877) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pk9lz-0008Iw-CG for 62677@debbugs.gnu.org; Wed, 05 Apr 2023 16:30:27 -0400 Original-Received: by mail-pj1-f49.google.com with SMTP id ml21so13250714pjb.4 for <62677@debbugs.gnu.org>; Wed, 05 Apr 2023 13:30:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; t=1680726621; x=1683318621; h=content-transfer-encoding:in-reply-to:from:references:to :content-language:subject:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=n2zkKj7YMe+IkF1EsFV7iqh9+z6PGBeKFDe9ahWJpHY=; b=HmoWJYa6vXu1/hrgHglXH79GHHSqsBtpK0w0v1xQuBQnzcW7XlWzKdKLiQGROtFdLr shVw7BdeXm4+Ku7OsfDeQ2wcZ3ywT0mQP5DD9+++nrXgLg/y72kY2gfqR+KSfEZ48J8D vTdPyBmETvcZqwlq+Qt6B/4/bwr9mF6aQcdY3w6YWCP03evCrWC5xjsBeFaZtuMKeM54 rkTgmNZu6vZLUjIDq11SiHvGTv+fC3DZcTAKmMKBfnG2UyqT2bxVGFKPx9VjevShFqlB ZXHY2JksdREO8MqG16KpCXues5VdfRwM5TkDsw7dUebh8do/cc+9vG0PDKiyEFcD5/iL 3Psw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; t=1680726621; x=1683318621; h=content-transfer-encoding:in-reply-to:from:references:to :content-language:subject:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=n2zkKj7YMe+IkF1EsFV7iqh9+z6PGBeKFDe9ahWJpHY=; b=YOP/3lyehUI8Xprd5YFA7AnuTx6rM+BMEqTcBL2crz6GPJlZWTfUdkmkQHJF8WUgNB yrtH2/YyPlYUaF1YcrDrwEKcKbJAVZZLHUme9nKbT+LDOH1gk8KPjkoVEmA3wVruRZS5 fhbwalUpY41laTmuBKL9kmkcFYUjNhcinD1K2bbqZsQvuiHFV9T+IKnk0+F+2Wzf6m/v 9UnTyCLT2nFWjmBWonR2OPyykZIRCVf3Of2RhQeZ3U3WmlrIqHh+JruEyvxL1HyrxlC3 6UoSOGzT3nI/IekJUHESyS3tlFD8/qq5uwB9s2v2UDbcHMhmnXu+yURRM5wsuPcLwfu4 gCpg== X-Gm-Message-State: AAQBX9eeKNRnmA7STU1s1CVIvhYeOodbeEsHbdDxZI1nNXnNlbjuf/V0 hljw9VKn7G8ooyWNhfNXtwQ= X-Google-Smtp-Source: AKy350YP9gXFuwJYokkyUbyJq4zDEKTbRgn/ogfODFgGfHbQLTx/vEwVus5JpN5RlAfERJpK3jbvrQ== X-Received: by 2002:a05:6a20:bb09:b0:d9:a792:8e3d with SMTP id fc9-20020a056a20bb0900b000d9a7928e3dmr525610pzb.30.1680726620754; Wed, 05 Apr 2023 13:30:20 -0700 (PDT) Original-Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com. [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id 9-20020aa79149000000b0062dd28aaca6sm11013320pfi.212.2023.04.05.13.30.20 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 05 Apr 2023 13:30:20 -0700 (PDT) Content-Language: en-US In-Reply-To: <87mt3mv5e9.fsf@web.de> 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:259288 Archived-At: 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. In particular, I never got the sense that it was a major mode or that it was *directly* tied to prog-mode; only that flyspell-prog-mode is most useful for programming-like modes (which are usually, but not always, derived from prog-mode). It's possible there's a better name, but is the name really the main problem for discoverability? As far as discoverability goes, I believe I found out about flyspell-prog-mode via flyspell-mode's docstring: > This mode is geared toward text modes. In buffers that contain > code, ‘flyspell-prog-mode’ is usually a better choice. 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. The problem of undiscoverable/misleading/opaque names in Emacs comes up fairly regularly (e.g. with Eglot), and while clear naming is helpful, I think it would be more helpful to make it easier for users to search for packages, modes, etc using whatever keywords make sense to them. Then discoverability is more about ensuring that we specify an appropriate set of keywords.