X-Git-Url: http://git.tremily.us/?a=blobdiff_plain;f=README;h=46340b8a4f398245d0efb77e446816943a1485ca;hb=3d02d3a946bd43b0984c198e34504c96425ed43a;hp=32e9fb15d009f839e967f797b852c3f6fa832df0;hpb=748552de6b57f6cfbe2f3668993f58657e241a57;p=sawsim.git

diff --git a/README b/README
index 32e9fb1..46340b8 100644
--- a/README
+++ b/README
@@ -1,17 +1,42 @@
-Warning: also my noweb-training program.
- http://www.eecs.harvard.edu/~nr/noweb/
-(noweb, or the transitional nowebm, in Debian-based distributions)
+Compiling
+---------
 
+Sawsim is written in noweb_ (`noweb` in Debian-based distributions).
 Extract Makefile and compile with:
- $ notangle -Rmakefile sawsim.nw | sed 's/        /\t/' > Makefile
- $ make
-Run the unit tests with
- $ make check
-
-Depends on the GSL (GNU Scientific Library) development package.
- http://www.gnu.org/software/gsl/
- (libgsl0-dev in Debian-based distributions)
-
-The unit test programs check_* depend on the check package.
- http://check.sourceforge.net/
- (check in Debian-based distributions)
+
+  $ notangle -Rmakefile src/sawsim.nw | sed 's/        /\t/' > Makefile
+  $ make
+
+Run the unit tests with:
+
+  $ make check
+
+.. _noweb: http://www.eecs.harvard.edu/~nr/noweb/
+
+
+Dependencies
+------------
+
+Sawsim depends on the GSL_ (GNU Scientific Library) development
+package (`libgsl0-dev` in Debian-based distributions).
+
+The unit test programs `check_*` depend on the check_ package (`check`
+in Debian-based distributions).
+
+.. _GSL: http://www.gnu.org/software/gsl/
+.. _check: http://check.sourceforge.net/
+
+
+Python wrapper
+--------------
+
+The `sawsim` binary only runs a single pull, but you'll probably want
+to run many repetitions to generate enough data for significant
+statistical analysis.  To facilitate this, we provide the `pysawsim`
+module which provides a higher level interface to `sawsim`.
+
+
+License
+-------
+
+Saswim is released under the GNU GPLv3+.  See `COPYING` for details.