update README for swank-media information

[swankr.git] / README

diff --git a/README b/README
index e7ebd91da8bd48fdd8e2e46ad59026c9b15d19c1..c86edfbc28c662eee3d20670ea1f90c2c269ccb1 100644 (file)
--- a/README
+++ b/README
@@ -14,13 +14,16 @@
    swankr is in the level of integration of various facilities with
    emacs: ESS uses the browser() debugger, whereas swankr provides its
    own debugger, sldb; swankr provides a custom REPL with hooks for
-   common commands; and so on.  For Lisp programmers, perhaps the most
-   useful analogy is to say that swankr is to ESS what SLIME is to
-   ILISP.  At present, however, ESS mode remains active in R source
+   common commands; and so on.  On the other hand, ESS is mature,
+   feature-rich software, while swankr is only a little more advanced
+   than a proof-of-concept.  For Lisp programmers, perhaps the most
+   useful analogy is to say that swankr intends to be to ESS what
+   SLIME is to ILISP.  At present, ESS mode remains active in R source
    buffers, providing font-locking functionality among other things.
 * Installation
 ** Running
    To begin using swankr:
+
    1. start R;
    2. load the swank.R file:
 #+BEGIN_SRC R
@@ -31,16 +34,24 @@
       swank();
 #+END_SRC
    4. within emacs, load and initialize slime;
-   5. run slime-connect, accepting the default host and port, and
-      acknowledging the protocol version mismatch.
-   At this point, a R REPL should appear.
+#+BEGIN_SRC emacs-lisp
+      (require 'slime)
+      (slime-setup '(slime-repl))
+#+END_SRC
+   5. run =M-x slime-connect=, accepting the default host and port,
+      and acknowledging the protocol version mismatch.
+
+   At this point, an R REPL should appear.
 ** Emacs customization
    At a minimum, slime needs to be set up to function.  I've
    used the following forms in my =~/.emacs=
 #+BEGIN_SRC emacs-lisp
    (require 'slime)
-   (slime-setup '(slime-repl slime-scratch))
-#+END_SRCA
+   (slime-setup '(slime-repl slime-scratch slime-media))
+#+END_SRC
+   The =slime-media= contrib is new and (at present) R-specific,
+   allowing for image results to be embedded in the REPL.
+
    In addition, for keybindings like =C-c C-c= to work properly, emacs
    needs to be told how to guess where a function definition begins.
    This can be achieved with /e.g./