0.8.11.4:

[sbcl.git] / doc / sbcl.1

diff --git a/doc/sbcl.1 b/doc/sbcl.1
index 216fd64..29b5559 100644 (file)
--- a/doc/sbcl.1
+++ b/doc/sbcl.1
@@ -58,13 +58,12 @@ give you another prompt, and wait for your next input. E.g.
   *
 
 Many people like to run SBCL, like other Lisp systems, as a subprocess
-under Emacs. The Emacs "ilisp" mode provides many convenient features,
-like command line editing, tab completion, and various kinds of
-coupling between Common Lisp source files and the interactive SBCL
-subprocess, but can be somewhat fragile because it tries to be so
-clever and intimate in its interactions with the Lisp subprocess. In
-case of ilisp problems, running SBCL in the Emacs "shell" mode can a
-useful substitute.
+under Emacs. The Emacs "Slime" and "ilisp" modes provide many
+convenient features, like command line editing, tab completion, and
+various kinds of coupling between Common Lisp source files and the
+interactive SBCL subprocess, but they can be somewhat fragile wrt.
+packages and readtables, in which case SBCL in the Emacs "shell" mode
+can a useful substitute.
 
 .SH OVERVIEW
 
@@ -194,11 +193,6 @@ better job on them.)
 
 .SH THE COMPILER
 
-SBCL is essentially a compiler-only implementation of Common Lisp. All
-nontrivial Lisp code is compiled to native machine code before being
-executed, even when the Lisp code is typed interactively at the
-"interpreter" prompt.
-
 SBCL inherits from CMU CL the "Python" native code compiler. (Though
 we often avoid that name in order to avoid confusion with the
 scripting language also called Python.) This compiler is very clever
@@ -228,20 +222,6 @@ are used.
 
 For more information about the compiler, see the user manual.
 
-.SH DOCUMENTATION
-
-Currently, the documentation for the system is
-.TP 3
-\--
-this man page
-.TP 3
-\--
-the user manual
-.TP 3
-\--
-doc strings and online help built into the SBCL executable
-.PP
-
 .SH COMMAND LINE SYNTAX
 
 Command line syntax can be considered an advanced topic; for ordinary
@@ -373,7 +353,7 @@ chance to see it.
 
 .SH SYSTEM REQUIREMENTS
 
-SBCL currently runs on X86 (Linux, FreeBSD, and OpenBSD), Alpha
+SBCL currently runs on X86 (Linux, FreeBSD, OpenBSD, and NetBSD), Alpha
 (Linux, Tru64), PPC (Linux, Darwin/MacOS X), SPARC (Linux and Solaris
 2.x), and MIPS (Linux).  For information on other ongoing and possible
 ports, see the sbcl-devel mailing list, and/or the web site.
@@ -482,8 +462,8 @@ Linux 4.5 X86 box, I get an UNBOUND-VARIABLE error."
 .SH SUPPORT
 
 Various information about SBCL is available at
-<http://sbcl.sourceforge.net/>. The mailing lists there are the
-recommended place to look for support.
+<http://ww.sbcl.org/>. The mailing lists there are the recommended
+place to look for support.
 
 .SH ENVIRONMENT
 
@@ -521,3 +501,22 @@ directory, or as specified by  --userinit)
 Dozens of people have made substantial contributions to SBCL and its
 subsystems, and to the CMU CL system on which it was based, over the
 years. See the CREDITS file in the distribution for more information.
+
+.SH SEE ALSO
+
+Full SBCL documentation is maintained as a Texinfo manual. If is has
+been installed, the command
+.IP
+.B info sbcl
+.PP
+should give you access to the complete manual. Depending on your
+installation it may also be available in HTML and PDF formats in eg.
+.IP
+.B /usr/local/share/doc/sbcl/
+.PP
+See the SBCL homepage 
+.IP
+.B http://www.sbcl.org/
+.PP
+for more information, including directions on how to subscribe to the
+sbcl-devel and sbcl-help mailing-lists.