all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#49278: 28.0.50; Lisp Mode is for Common Lisp
@ 2021-06-29 18:06 João Távora
  2021-06-29 18:16 ` Eli Zaretskii
                   ` (2 more replies)
  0 siblings, 3 replies; 52+ messages in thread
From: João Távora @ 2021-06-29 18:06 UTC (permalink / raw)
  To: 49278; +Cc: monnier

Hi,

It's been the status quo for a long time now that Lisp Mode is the Emacs
major mode for editing Common Lisp programs.  The SLIME and SLY packages
are popular amongst CL programmers and have relied on this fact for many
years (SLIME in I think has been the tool of choice for Emacs+CL for
more than 15 years).

In addition, there are many references to "Common Lisp" in lisp-mode.el.

In addition, non-CL-lisps have also historically used their own major
modes derived from prog-mode.  Examples are Emacs lisp mode, Scheme mode
and Clojure mode.

In addition, there is in Emacs 27.1 a new lisp-data-mode.  That is
useful for defining using define-derived-mode to make Lisp-like major
modes derived from commonly found Lisp-style functionality such as
parenthesis-matching syntax tables and such.

However, the docstring of lisp-mode, the function, still states that it
is used for "Lisps other than GNU Emacs Lisp".  Likely this docstring
was written when Common Lisp was still young and intended to group its
closely-related Lisp brethren (MacLisp, Franz Lisp, etc) in mind.

Those variants are now gone, we should update lisp-mode.el's docstring
to reflect the state of things, since a fraction of people seem to be
misusing lisp-mode to derive new major modes for new niche Lisps, where
they should be using lisp-data-mode (perhaps they are not aware of it).

See also:

  https://gitlab.com/technomancy/fennel-mode/-/issues/11
  https://github.com/joaotavora/sly/issues/339
  https://emacs.stackexchange.com/questions/18646/why-isnt-emacs-lisp-mode-derived-from-lisp-mode/18652#18652

João


To fix this, I suggest this documentation patch.


diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 8de93867ba..7d655449c5 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -1764,10 +1764,10 @@ External Lisp
 @cindex mode, Lisp
 @cindex Common Lisp
 
-  Lisp mode is the major mode for editing programs written in
-general-purpose Lisp dialects, such as Common Lisp.  Its mode command
-is @kbd{M-x lisp-mode}.  Emacs uses Lisp mode automatically for files
-whose names end in @file{.l}, @file{.lsp}, or @file{.lisp}.
+  Lisp mode is the major mode for editing programs written in Common
+Lisp or its ancestor dialects.  Its mode command is @kbd{M-x
+lisp-mode}.  Emacs uses Lisp mode automatically for files whose names
+end in @file{.l}, @file{.lsp}, or @file{.lisp}.
 
 @findex run-lisp
 @vindex inferior-lisp-program
diff --git a/lisp/emacs-lisp/lisp-mode.el b/lisp/emacs-lisp/lisp-mode.el
index 59325d647d..99bf1a98c2 100644
--- a/lisp/emacs-lisp/lisp-mode.el
+++ b/lisp/emacs-lisp/lisp-mode.el
@@ -765,7 +765,7 @@ lisp-mode-menu
      :help "Run an inferior Lisp process, input and output via buffer `*inferior-lisp*'"]))
 
 (define-derived-mode lisp-mode lisp-data-mode "Lisp"
-  "Major mode for editing Lisp code for Lisps other than GNU Emacs Lisp.
+  "Major mode for editing Common Lisp code.
 Commands:
 Delete converts tabs to spaces as it moves back.
 Blank lines separate paragraphs.  Semicolons start comments.






^ permalink raw reply related	[flat|nested] 52+ messages in thread

end of thread, other threads:[~2021-09-28  2:52 UTC | newest]

Thread overview: 52+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2021-06-29 18:06 bug#49278: 28.0.50; Lisp Mode is for Common Lisp João Távora
2021-06-29 18:16 ` Eli Zaretskii
2021-06-29 18:25   ` João Távora
2021-06-30 12:35     ` Eli Zaretskii
2021-06-30 12:45       ` João Távora
2021-06-29 20:46   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-06-29 20:55     ` João Távora
2021-06-29 22:59       ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-06-30 12:47         ` Eli Zaretskii
2021-06-30 12:37     ` Eli Zaretskii
2021-06-30 13:03       ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-06-30 13:21         ` João Távora
2021-06-30 13:29         ` Eli Zaretskii
2021-06-30 13:32           ` João Távora
2021-06-30 13:51             ` Eli Zaretskii
2021-06-30 14:32               ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-06-30 14:50                 ` João Távora
2021-06-30 15:54                   ` Eli Zaretskii
2021-06-30 16:02                     ` João Távora
2021-06-30 15:52                 ` Eli Zaretskii
2021-06-30 16:37                   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-06-30 16:47                     ` Eli Zaretskii
2021-06-30 16:50                       ` João Távora
2021-06-30 16:55                         ` Eli Zaretskii
2021-06-30 16:58                           ` João Távora
2021-06-30 14:54               ` João Távora
2021-06-30 15:55                 ` Eli Zaretskii
2021-06-30 15:58                   ` João Távora
2021-06-30 16:49                     ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-06-30  3:50 ` Phil Hagelberg
2021-06-30  9:44   ` João Távora
2021-09-24 23:01 ` Stefan Kangas
2021-09-24 23:23   ` João Távora
2021-09-25  0:22     ` Stefan Kangas
2021-09-25  1:26       ` bug#49278: [External] : " Drew Adams
2021-09-25  1:35       ` Lars Ingebrigtsen
2021-09-25  6:42       ` Eli Zaretskii
2021-09-25  1:13     ` bug#49278: [External] : " Drew Adams
2021-09-25  9:02       ` João Távora
2021-09-25 16:03         ` Drew Adams
2021-09-25 16:43           ` Stefan Kangas
2021-09-25 17:24             ` Drew Adams
2021-09-27 20:10           ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-27 22:05             ` Drew Adams
2021-09-27 22:25               ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-27 23:24                 ` Drew Adams
2021-09-27 23:36                   ` João Távora
2021-09-28  2:17                     ` Drew Adams
2021-09-28  2:06                   ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-28  2:31                     ` Drew Adams
2021-09-28  2:52                       ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-27 14:48         ` Jean Louis

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.