From 3e1ceb50e9c0889fe347ef6f921e9224a2f5e405 Mon Sep 17 00:00:00 2001
From: AJ Rossini <blindglobe@gmail.com>
Date: Wed, 12 Dec 2007 08:35:53 +0100
Subject: [PATCH] Updated documentation and "expected results" within the
 demonstration.

---
 README       | 31 +++++++++++++++++++++++++++----
 ls-demo.lisp |  4 ++--
 2 files changed, 29 insertions(+), 6 deletions(-)

diff --git a/README b/README
index e0d73ea..b3f4067 100644
--- a/README
+++ b/README
@@ -1,5 +1,11 @@
 -*- mode: text -*-
 
+===========
+
+See Doc/README* for history and design considerations
+See Doc/INSTALL for getting this to work and run
+
+===========
 
 For a fast start: 
 
@@ -12,12 +18,29 @@ Step through ls-demo.lisp for a range of examples that will become
 part of the test suite.
 
 
+So basically ..   
 
+1. change directory into the CommonLispStat working directory.
+2. start your lisp
+3. follow the commands in the ls-demo.lisp file, i.e.
 
-===========
+   a. (load "init.lisp")
+   b. (in-package :ls-user)
+   c. (normal-rand 20)
+   d. (setf mytest (normal-rand 20))
 
-See Doc/README* for history and design considerations
-See Doc/INSTALL for getting this to work and run
+   and see if they work (basic CFFI functionality for external C
+   library, LIFT package for unit-testing framework to ensure run time
+   stability).
 
-===========
+4. Tell me ( <blindglobe@gmail.com> ) if there is any thing wrong (or
+   if anything happens to work.
+
+
+What to expect:
+
+CMUCL and SBCL work justfine at this stage.
 
+CLISP is finicky regarding the problems that we have with CFFI
+conversation.  In particular that we can not really do typing that we
+need to take care of.  
diff --git a/ls-demo.lisp b/ls-demo.lisp
index fba6605..46bd46e 100644
--- a/ls-demo.lisp
+++ b/ls-demo.lisp
@@ -22,8 +22,7 @@
 (in-package :cl-user)
 (lisp-stat:binomial-quant 0.95 3 0.4) ;;; 3
 (lisp-stat:binomial-quant 0 3 0.4) ;;; 0
-(lisp-stat:normal-rand 20) ;;; DOESN'T RETURN
-
+(lisp-stat:normal-rand 20) ;;; 20 numbers :-)
 
 ;;;; THIS is how I expect it to be used, either with work in ls-user,
 ;;;; or a cloned package similar to ls-user.
@@ -77,6 +76,7 @@ my-chol-decomp-test
 
 (rcondest #2A((2 3 4) (1 2 4) (2 4 5)))
 ;; 6.8157451e7
+;;; CURRENTLY FAILS!!
 
 (eigen #2A((2 3 4) (1 2 4) (2 4 5)))
 ;; (#(10.656854249492381 -0.6568542494923802 -0.9999999999999996)
-- 
2.11.4.GIT