From 144a2bdc7096bbcd2e8fde29df8119c1d6d847ef Mon Sep 17 00:00:00 2001 From: may Date: Sat, 20 Jan 2024 13:44:37 -0600 Subject: [PATCH 1/4] Improve Emacs instructions, point users to an emacs quickstart. I've used emacs for more than a decade, but I found this quickstart to be the best I've seen in a long time and it worked flawlessly for me. --- editor-support.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/editor-support.md b/editor-support.md index 6e90421..1f23f6d 100644 --- a/editor-support.md +++ b/editor-support.md @@ -29,6 +29,7 @@ Since SLIME is heavily modular and the defaults only do the bare minimum (not even the SLIME REPL), you might want to enable more features with ~~~lisp +(require 'slime) (slime-setup '(slime-fancy slime-quicklisp slime-asdf)) ~~~ @@ -41,6 +42,7 @@ Now you can run SLIME with `M-x slime` and/or `M-x slime-connect`. See also: * [https://wikemacs.org/wiki/SLIME](https://wikemacs.org/wiki/SLIME) - configuration examples and extensions. +* [https://github.com/susam/emacs4cl](https://github.com/susam/emacs4cl) - a minimal Emacs configuration to get new users up and running quickly, *with* a tutorial. ### Using Emacs as an IDE From c0cd4f64b00674fa4139e39f9eccd82d726ae343 Mon Sep 17 00:00:00 2001 From: may Date: Sun, 21 Jan 2024 22:17:26 -0600 Subject: [PATCH 2/4] Useful tip to set environmental variables cross-implementation. --- os.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/os.md b/os.md index 2945d72..e6f813f 100644 --- a/os.md +++ b/os.md @@ -51,6 +51,8 @@ NIL You should also note that some of these implementations also provide the ability to _set_ these variables. These include ECL (`si:setenv`) and AllegroCL, LispWorks, and CLISP where you can use the functions from above together with [`setf`](http://www.lispworks.com/documentation/HyperSpec/Body/m_setf_.htm). This feature might be important if you want to start subprocesses from your Lisp environment. +To set an envionmental variable, you can `setf` with `(uiop:getenv "lisp")` in a implementation-independent way. + Also note that the [Osicat](https://www.common-lisp.net/project/osicat/manual/osicat.html#Environment) library has the method `(environment-variable "name")`, on POSIX-like From b13e58f69b1b057b3d45569534cb59b1af6e0e83 Mon Sep 17 00:00:00 2001 From: may Date: Mon, 22 Jan 2024 21:38:55 -0600 Subject: [PATCH 3/4] Ensure basic Emacs+SLIME install instructions work for newbies. --- editor-support.md | 24 ++++++++++++++++++++---- 1 file changed, 20 insertions(+), 4 deletions(-) diff --git a/editor-support.md b/editor-support.md index 1f23f6d..a9eee75 100644 --- a/editor-support.md +++ b/editor-support.md @@ -20,10 +20,22 @@ Quicklisp, SLIME and Git. ### Installing SLIME -SLIME is in the official GNU ELPA repository of Emacs Lisp packages -(in Emacs24 and forward). Install with: +On Ubuntu, SLIME is easily installed alongside Emacs and SBCL: - M-x package-install RET slime RET + sudo apt install emacs slime sbcl + +Otherwise, install SLIME by adding this code to your `~/.emacs` file: + +~~~lisp +(require 'package) +(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t) +(dolist (package '(slime)) + (unless (package-installed-p package) + (package-install package))) +(require 'slime) +~~~ + +assuming you've also instealled Emacs and SBCL. Since SLIME is heavily modular and the defaults only do the bare minimum (not even the SLIME REPL), you might want to enable more features with @@ -33,11 +45,15 @@ even the SLIME REPL), you might want to enable more features with (slime-setup '(slime-fancy slime-quicklisp slime-asdf)) ~~~ +After this you can press Alt-X on your keyboard and type `slime` and try Common Lisp! + +(Alt-X is often written `M-x` in Emacs-world.) + For more details, consult the [documentation](https://common-lisp.net/project/slime/doc/html/) (also available as an Info page). -Now you can run SLIME with `M-x slime` and/or `M-x slime-connect`. +Now you can run SLIME with, as mentioned, `M-x slime` and/or `M-x slime-connect`. See also: From 0d06a649b837aa20d600e1197ac7eeed96623c77 Mon Sep 17 00:00:00 2001 From: may Date: Tue, 23 Jan 2024 22:19:41 -0600 Subject: [PATCH 4/4] Ensure Emacs + SLIME works easily for thoes new to emacs. --- editor-support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/editor-support.md b/editor-support.md index a9eee75..272ddfc 100644 --- a/editor-support.md +++ b/editor-support.md @@ -24,7 +24,7 @@ On Ubuntu, SLIME is easily installed alongside Emacs and SBCL: sudo apt install emacs slime sbcl -Otherwise, install SLIME by adding this code to your `~/.emacs` file: +Otherwise, install SLIME by adding this code to your `~/.emacs.d/init.el` file: ~~~lisp (require 'package)