Update of /cvsroot/sbcl/sbcl/doc
In directory sc8-pr-cvs8.sourceforge.net:/tmp/cvs-serv28609/doc
Modified Files:
README sbcl.1
Log Message:
1.0.13.22: text tweaks
* logged a bug
* searched for sbcl-devel references and added notes about
the need to subscribe (since the mailman bounce message is
particularly unhelpful, and I periodically get mail from
frustrated would-be posters)
* fixed a few typoes
* revised a few passages, and completely gave up on trying to
summarize SBCL performance in a paragraph in the man page
Index: README
===================================================================
RCS file: /cvsroot/sbcl/sbcl/doc/README,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- README 19 Sep 2004 19:38:56 -0000 1.4
+++ README 10 Jan 2008 15:54:04 -0000 1.5
@@ -1,5 +1,5 @@
-SBCL is -- ahem! -- not completely documented at this point. What can
-I say? Help with documentation might not be refused.:-)
+SBCL is -- ahem! -- imperfectly documented. What can we say? Help with
+documentation might not be refused.:-)
There is a Unix man page, sbcl.1.
Index: sbcl.1
===================================================================
RCS file: /cvsroot/sbcl/sbcl/doc/sbcl.1,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- sbcl.1 22 Feb 2007 20:14:14 -0000 1.42
+++ sbcl.1 10 Jan 2008 15:54:04 -0000 1.43
@@ -62,9 +62,9 @@
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.
+interactive SBCL subprocess, but they can be somewhat fragile with
+respect to packages and readtables, in which case SBCL in the Emacs
+"shell" mode can be a useful substitute.
.SH OVERVIEW
@@ -79,7 +79,7 @@
SBCL also includes various non-ANSI extensions, described more fully
in the User Manual. Some of these are in the base system and others
are "contrib" modules loaded on request using \f(CRREQUIRE\fR. For
-example, to load the \f(CRSB\-BSD\-SOCKETS\fR module that providces
+example, to load the \f(CRSB\-BSD\-SOCKETS\fR module that provides
TCP/IP connectivity,
\f(CR
* (require \(aqasdf)
@@ -145,8 +145,9 @@
\f(CRREQUIRED\-ARGUMENT\fR), and many others.
SBCL inplements multithreading, but in a completely different fashion
-from CMU CL: see the User Manual for details. As of 0.8.5 this is
-considered beta-quality and must be explicitly enabled at build time.
+from CMU CL: see the User Manual for details. As of 1.0.13 this is
+still considered beta-quality and must be explicitly enabled at build
+time.
SBCL has retained some extensions from its parent CMU CL. Many of the
retained extensions are in these categories:
@@ -208,15 +209,6 @@
type declarations should be checked at runtime unless the user
explicitly tells the system that speed is more important than safety.
-The compiler reportedly produces pretty good code for modern CPU
-architectures which have lots of registers, but its code for the X86
-is marred by many extra loads and stores to stack-based temporary
-variables. Because of this, and because of the extra levels of
-indirection in Common Lisp relative to C, the performance of SBCL
-isn't going to impress people who are impressed by small constant
-factors. However, even on the X86 it tends to be faster than byte
-interpreted languages (and can be a lot faster).
-
The compiled code uses garbage collection to automatically
manage memory. The garbage collector implementation varies considerably
from CPU to CPU. In particular, on some CPUs the GC is nearly exact,
@@ -431,11 +423,12 @@
To report a bug, please send mail to the mailing lists sbcl-help or
sbcl-devel. You can find the complete mailing list addresses on the
-web pages at <\f(CRhttp://sbcl.sourceforge.net/\fR&gt;. (You may also
-find fancy SourceForge bug-tracking machinery there, but don't be
-fooled. As of 2002-07-25 anyway, we don't actively monitor that
-machinery, and it exists only because we haven't been able to figure
-out how to turn it off.)
+web pages at <\f(CRhttp://sbcl.sourceforge.net/\fR&gt;; note that as a
+spam reduction measure you must subscribe to the lists before you can
+post. (You may also find fancy SourceForge bug-tracking machinery
+there, but don't be fooled. As of 2002-07-25 anyway, we don't actively
+monitor that machinery, and it exists only because we haven't been
+able to figure out how to turn it off.)
As with any software bug report, it's most helpful if you can provide
enough information to reproduce the symptoms reliably, and if you say