From e1220db84b5b00c83bc71bd2c6c13b31bd52891f Mon Sep 17 00:00:00 2001 From: vindarel Date: Mon, 2 Jan 2017 15:44:08 +0100 Subject: [PATCH 01/26] (minor) emacs-setup fill paragraphs --- ides/emacs-setup.html | 55 +++++++++++++++++++++++++++++++++++-------- 1 file changed, 45 insertions(+), 10 deletions(-) diff --git a/ides/emacs-setup.html b/ides/emacs-setup.html index 38aef3e..d856e83 100644 --- a/ides/emacs-setup.html +++ b/ides/emacs-setup.html @@ -5,15 +5,37 @@

Emacs

-

Emacs is the modern open source Lisp IDE. Its history and quirks extend back to the Lisp machines and early editors such as TECO.

-

It is considered difficult to initially learn, and often disparaged due to the antiquated interface, but is generally thought the best open source free IDE for Common Lisp.

-

In order to use emacs, there are two variants; XEmacs and GNU Emacs. I usually use GNU emacs, so I’ll talk about it here.

-

In order to get it, you can obtain it from the GNU. Windows, Linux, and OSX versions are available. It’s also available via most Linux distributions package repositories. The most recent version is 24; 23 is also recent and works well with the Superior Lisp Interaction Mode for Emacs, a.k.a SLIME.

-

New users can find many resources online for Emacs, including a well-written help system! An emacs tutorial can be found here, and the GNU FAQ is also available

+

Emacs is the modern open source Lisp IDE. Its history and +quirks extend back to the Lisp machines and early editors such as +TECO.

+ +

It is considered difficult to initially learn, and often disparaged +due to the antiquated interface, but is generally thought the best +open source free IDE for Common Lisp.

+ +

In order to use emacs, there are two variants; XEmacs and GNU +Emacs. I usually use GNU emacs, so I’ll talk about it here.

+ +

In order to get it, you can obtain it from +the GNU. Windows, +Linux, and OSX versions are available. It’s also available via +most Linux distributions package repositories. The most recent version +is 24; 23 is also recent and works well with the Superior Lisp +Interaction Mode for Emacs, a.k.a SLIME.

+ +

New users can find many resources online for Emacs, including a +well-written help system! An emacs tutorial can be +found here, +and the GNU FAQ is +also available

+

Usually you want to get SLIME installed for your development.

+

If you’re using emacs23, SLIME can be found here.

Emacs24 has it in its package manager (M-x package-list-packages).

+

I like to use the following elisp to configure SLIME:

+ 
(require 'cl)
 (setq inferior-lisp-program  "/usr/local/bin/sbcl") ;modify to taste
 (require 'slime)
@@ -29,9 +51,22 @@ 
Emacs

 (require 'paren)
 (show-paren-mode t)
+

Once you are set up…

-

When you load a Lisp file and want to engage SLIME, M-x slime will do the trick.

-

Paredit is a popular Lisp editing mode that the engaged student will hear about. The author recommends getting comfortable with emacs and SLIME before using Paredit, it provides several automatic s-expression editing features that surprised him on first use.

-

When you have configured your SLIME in a fancy fashion, you will find a SLIME REPL (Read Evaluate Print Loop) buffer created in your Emacs window.

-

This provides an interactive view into Common Lisp. You can evaluate functions you are writing in the source file and immediately use them in the REPL. This provides a very fast “code and test” facility.

-
+ +

When you load a Lisp file and want to engage SLIME, M-x + slime will do the trick.

+ +

Paredit is a popular Lisp editing mode that the engaged student +will hear about. The author recommends getting comfortable with emacs +and SLIME before using Paredit, it provides several automatic + s-expression editing features that surprised him on first use.

+ +

When you have configured your SLIME in a fancy +fashion, you will find a SLIME REPL (Read Evaluate Print Loop) buffer + created in your Emacs window.

+ +

This provides an interactive view into Common Lisp. You can +evaluate functions you are writing in the source file and immediately +use them in the REPL. This provides a very fast “code and +test” facility.

From 722e74a9f917cf589dadb88437d18c3c0e99f40f Mon Sep 17 00:00:00 2001 From: vindarel Date: Mon, 2 Jan 2017 15:44:41 +0100 Subject: [PATCH 02/26] summary: about Portacle --- ides/summary.html | 1 + 1 file changed, 1 insertion(+) diff --git a/ides/summary.html b/ides/summary.html index 0aee9ff..785f130 100644 --- a/ides/summary.html +++ b/ides/summary.html @@ -8,6 +8,7 @@

IDE Selection

The canonical free IDE is undoubtably emacs, but it is difficult for newbies. The author has had good experience with messing around on LispWorks.

Open Source