package local nicknames
[sbcl.git] / doc / manual / intro.texinfo
index 60b76a5..a9f2eb1 100644 (file)
@@ -24,16 +24,8 @@ Lisp.
 @section ANSI Conformance
 
 Essentially every type of non-conformance is considered a bug. (The
-exceptions involve internal inconsistencies in the standard.) In SBCL
-the master record of known bugs is in the @file{BUGS} file in the
-distribution.
-
-The recommended way to report bugs is through the @cite{sbcl-help} or
-@cite{sbcl-devel} mailing lists. For mailing list addresses,
-see @ref{SBCL Homepage}; note that as a spam-reduction measure you
-must subscribe before you can post.
-
-
+exceptions involve internal inconsistencies in the standard.)
+@xref{Reporting Bugs}.
 
 @node Extensions
 @comment  node-name,  next,  previous,  up
@@ -116,7 +108,7 @@ Hooks for Users}.
 @code{sb-aclrepl} provides an Allegro CL -style toplevel for SBCL,
 as an alternative to the classic CMUCL-style one. @xref{sb-aclrepl}.
 
-@item CLTL2 Compatility Layer
+@item CLTL2 Compatibility Layer
 @code{sb-cltl2} module provides @code{compiler-let} and environment
 access functionality described in @cite{Common Lisp The Language, 2nd
 Edition} which were removed from the language during the ANSI
@@ -130,7 +122,7 @@ runtime.
 
 @item Bitwise Rotation
 @code{sb-rotate-byte} provides an efficient primitive for bitwise
-rotation of integers, an operation required by eg. numerous
+rotation of integers, an operation required by e.g. numerous
 cryptographic algorithms, but not available as a primitive in ANSI
 Common Lisp. @xref{sb-rotate-byte}.
 
@@ -217,7 +209,7 @@ leads to some oddities, e.g. collapsing @code{functionp} and
 @node Defining Constants
 @comment  node-name,  next,  previous,  up
 @subsection Defining Constants
-@findex defconstant
+@findex @cl{defconstant}
 
 SBCL is quite strict about ANSI's definition of @code{defconstant}.
 ANSI says that doing @code{defconstant} of the same symbol more than
@@ -242,7 +234,7 @@ code can be rewritten in portable ANSI Common Lisp which has the
 desired behavior. E.g., the code above can be given an exactly defined
 meaning by replacing @code{defconstant} either with
 @code{defparameter} or with a customized macro which does the right
-thing, eg.
+thing, e.g.
 @lisp
 (defmacro define-constant (name value &optional doc)
   `(defconstant ,name (if (boundp ',name) (symbol-value ',name) ,value)
@@ -348,8 +340,8 @@ sb-ext:save-lisp-and-die}.
 
 @menu
 * SBCL Homepage::               
-* Additional Distributed Documentation::  
 * Online Documentation::        
+* Additional Documentation Files::  
 * Internals Documentation::     
 @end menu
 
@@ -361,22 +353,33 @@ The SBCL website at @uref{http://www.sbcl.org/} has some general
 information, plus links to mailing lists devoted to SBCL, and to
 archives of these mailing lists. Subscribing to the mailing lists
 @cite{sbcl-help} and @cite{sbcl-announce} is recommended: both are
-fairly low-volume, and help you keep abrest with SBCL development.
+fairly low-volume, and help you keep abreast with SBCL development.
+
+@node Online Documentation
+@comment  node-name,  next,  previous,  up
+@subsection Online Documentation
+
+Documentation for non-ANSI extensions for various commands is
+available online from the SBCL executable itself. The extensions
+for functions which have their own command prompts (e.g. the debugger,
+and @code{inspect}) are documented in text available by typing
+@command{help} at their command prompts. The extensions for functions
+which don't have their own command prompt (such as @code{trace}) are
+described in their documentation strings, unless your SBCL was
+compiled with an option not to include documentation strings, in which
+case the documentation strings are only readable in the source code.
 
-@node Additional Distributed Documentation
+@node Additional Documentation Files
 @comment  node-name,  next,  previous,  up
-@subsection Additional Distributed Documentation
+@subsection Additional Documentation Files
 
 Besides this user manual both SBCL source and binary distributions
 include some other SBCL-specific documentation files, which should be
-installed along with this manual in on your system, eg. in
+installed along with this manual on your system, e.g. in
 @file{/usr/local/share/doc/sbcl/}.
 
 @table @file
 
-@item BUGS
-Lists known bugs in the distribution.
-
 @item COPYING
 Licence and copyright summary.
 
@@ -391,25 +394,8 @@ information.
 @item NEWS
 Summarizes changes between various SBCL versions.
 
-@item SUPPORT
-Lists SBCL developers available for-pay development of SBCL.
-
 @end table
 
-@node Online Documentation
-@comment  node-name,  next,  previous,  up
-@subsection Online Documentation
-
-Documentation for non-ANSI extensions for various commands is
-available online from the SBCL executable itself. The extensions
-for functions which have their own command prompts (e.g. the debugger,
-and @code{inspect}) are documented in text available by typing
-@command{help} at their command prompts. The extensions for functions
-which don't have their own command prompt (such as @code{trace}) are
-described in their documentation strings, unless your SBCL was
-compiled with an option not to include documentation strings, in which
-case the documentation strings are only readable in the source code.
-
 @node Internals Documentation
 @comment  node-name,  next,  previous,  up
 @subsection Internals Documentation
@@ -501,8 +487,8 @@ lesser differences as well. This book tends to help with the culture
 shock.
 
 @item Art Of Metaobject Programming, by Gregor Kiczales et al.
-Currently to prime source of information on the Common Lisp Metaobject
-Protocol, which is supported by SBCL. Section 2 (Chapers 5 and 6) are
+Currently the prime source of information on the Common Lisp Metaobject
+Protocol, which is supported by SBCL. Section 2 (Chapters 5 and 6) are
 freely available at @uref{http://www.lisp.org/mop/}.
 
 @end table
@@ -612,7 +598,7 @@ Other major changes since the fork from CMUCL include
 SBCL has removed many CMUCL extensions, (e.g. IP networking,
 remote procedure call, Unix system interface, and X11 interface) from
 the core system. Most of these are available as contributed modules
-(distributed with sbcl) or third-party modules instead.
+(distributed with SBCL) or third-party modules instead.
 
 @item
 SBCL has deleted or deprecated some nonstandard features and code