[armedbear-cvs] r13815 - trunk/abcl/doc/manual

[rschlatte at common-lisp.net]

Author: rschlatte
Date: Fri Jan 27 06:53:23 2012
New Revision: 13815

Log:
Minor manual prettification.

Modified:
   trunk/abcl/doc/manual/abcl.sty
   trunk/abcl/doc/manual/abcl.tex

Modified: trunk/abcl/doc/manual/abcl.sty
==============================================================================
--- trunk/abcl/doc/manual/abcl.sty	Fri Jan 27 05:06:03 2012	(r13814)
+++ trunk/abcl/doc/manual/abcl.sty	Fri Jan 27 06:53:23 2012	(r13815)
@@ -20,16 +20,16 @@
 
 
 \lstnewenvironment{listing-java}
- {\lstset{language=Java}}
+ {\lstset{basicstyle=\ttfamily,language=Java}}
  {}
 
 
 \lstnewenvironment{listing-lisp}
- {\lstset{language=Lisp}}
+ {\lstset{basicstyle=\ttfamily,language=Lisp}}
  {}
 
 \lstnewenvironment{listing-shell}
- {\lstset{language=sh}}
+ {\lstset{basicstyle=\ttfamily,language=sh}}
  {}
 
 \usepackage{verbatim}

Modified: trunk/abcl/doc/manual/abcl.tex
==============================================================================
--- trunk/abcl/doc/manual/abcl.tex	Fri Jan 27 05:06:03 2012	(r13814)
+++ trunk/abcl/doc/manual/abcl.tex	Fri Jan 27 06:53:23 2012	(r13815)
@@ -218,7 +218,7 @@
 We define a higher level Java API in the topic:Higher level Java JSS
 package developed by Alan Ruttenberg which is available in the
 \code{contrib/} directory, see the  . This package is
-described later in this document, see \ref{section:jss} on page
+described later in this document, see Section~\ref{section:jss} on page
 \pageref{section:jss}.  This section covers the lower level API
 directly available after evaluating \code{(require 'JAVA)}.
 
@@ -1004,12 +1004,11 @@
 abstraction for handling logging systems:
 
 \begin{listing-lisp}
-    ;;;; -*- Mode: LISP -*-
-    (in-package :asdf)
+;;;; -*- Mode: LISP -*-
+(in-package :asdf)
 
-    (defsystem :log4j
-      :components ((:mvn "log4j/log4j" 
-                    :version "1.4.9")))
+(defsystem :log4j
+  :components ((:mvn "log4j/log4j" :version "1.4.9")))
 \end{listing-lisp}
 
 \subsection{API}
@@ -1036,16 +1035,23 @@
 artifacts to be downloaded
 
 \begin{listing-lisp}
-CL-USER> (abcl-asdf:resolve-dependencies "com.google.gwt" "gwt-user")
+CL-USER> (abcl-asdf:resolve-dependencies "com.google.gwt"
+                                         "gwt-user")
 WARNING: Using LATEST for unspecified version.
-"/Users/evenson/.m2/repository/com/google/gwt/gwt-user/2.4.0-rc1/gwt-user-2.4.0-rc1.jar:/Users/evenson/.m2/repository/javax/validation/validation-api/1.0.0.GA/validation-api-1.0.0.GA.jar:/Users/evenson/.m2/repository/javax/validation/validation-api/1.0.0.GA/validation-api-1.0.0.GA-sources.jar"
+"/Users/evenson/.m2/repository/com/google/gwt/gwt-user/2.4.0-rc1
+/gwt-user-2.4.0-rc1.jar:/Users/evenson/.m2/repository/javax/vali
+dation/validation-api/1.0.0.GA/validation-api-1.0.0.GA.jar:/User
+s/evenson/.m2/repository/javax/validation/validation-api/1.0.0.G
+A/validation-api-1.0.0.GA-sources.jar"
 \end{listing-lisp}
 
 To actually load the dependency, use the \code{JAVA:ADD-TO-CLASSPATH} generic
 function:
 
 \begin{listing-lisp}
-CL-USER> (java:add-to-classpath (abcl-asdf:resolve-dependencies "com.google.gwt" "gwt-user"))
+CL-USER> (java:add-to-classpath
+          (abcl-asdf:resolve-dependencies "com.google.gwt"
+                                          "gwt-user"))
 \end{listing-lisp}
 
 Notice that all recursive dependencies have been located and installed
@@ -1058,7 +1064,8 @@
 systems the code in this package will recursively package all the
 required source and fasls in a jar archive.
 
-See \url{http://svn.common-lisp.net/armedbear/trunk/abcl/contrib/asdf-jar/README.markdown}.
+The documentation for this contrib can be found at
+\url{http://svn.common-lisp.net/armedbear/trunk/abcl/contrib/asdf-jar/README.markdown}.
 
 
 \section{jss}
@@ -1076,15 +1083,17 @@
 Example:
 
 \begin{listing-lisp}
-
+CL-USER> (require 'abcl-contrib)
+==> ("ABCL-CONTRIB")
 CL-USER> (require 'jss)
-
+==> ("JSS")
 CL-USER) (#"getProperties" 'java.lang.System)
-
+==> #<java.util.Properties {java.runtime.name=Java.... {2FA21ACF}>
 CL-USER) (#"propertyNames" (#"getProperties" 'java.lang.System))
+==> #<java.util.Hashtable$Enumerator java.util.Has.... {36B4361A}>
+\end{listing-lisp} %$ <-- un-confuse Emacs font-lock
 
-\end{listing-lisp}
-
+Some more information on jss can be found in its documentation at
 \url{http://svn.common-lisp.net/armedbear/trunk/abcl/contrib/jss/README.markdown}
 
 \section{asdf-install}