[doc changes
tom@zwizwa.be**20080718141023] hunk ./doc/scrbl/Makefile 17
+RSYNC = rsync --archive --update --delete --numeric-ids --verbose --one-file-system --progress --rsh=ssh
+
hunk ./doc/scrbl/Makefile 21
-	rsync.backup scribble.css scribble-common.js staapl.html giebrok:darcs/staapl/www/-/
+	$(RSYNC) scribble.css scribble-common.js staapl.html giebrok:darcs/staapl/www/-/
hunk ./doc/scrbl/staapl.scrbl 48
-comprising the purely functional concatentative (compositional) Scat
+comprising the purely functional concatenative (compositional) Scat
hunk ./doc/scrbl/staapl.scrbl 131
-Identifiers occuring in a @scheme[scat:] form are always referenced
+Identifiers occurring in a @scheme[scat:] form are always referenced
hunk ./doc/scrbl/staapl.scrbl 239
-function following the invokation, @scheme[exit] to abort the
+function following the invocation, @scheme[exit] to abort the
hunk ./doc/scrbl/staapl.scrbl 316
-targets. In classic Forth, this functionality is implememented as
+targets. In classic Forth, this functionality is implemented as
hunk ./doc/scrbl/staapl.scrbl 363
-defintion, changing the the meaning of the following source text word
+definition, changing the the meaning of the following source text word
hunk ./doc/scrbl/staapl.scrbl 376
-essential non-reducable components (primitives + composition) of Coma,
+essential non-reducible components (primitives + composition) of Coma,
hunk ./doc/scrbl/staapl.scrbl 380
-extra complexitity in 1 (or 2) preprocessing steps necessary to
+extra complexity in 1 (or 2) preprocessing steps necessary to
hunk ./doc/scrbl/staapl.scrbl 450
-What is special about this form of two-stage progamming is that it
+What is special about this form of two-stage programming is that it
hunk ./doc/scrbl/staapl.scrbl 475
-non-staged semantics is clear, staging annotiations can be studied to
+non-staged semantics is clear, staging annotations can be studied to
hunk ./doc/scrbl/staapl.scrbl 487
-Forth (2002), Mole (2004), Badnop(2004) and Brood/Staapl(2006). Staapl
+Forth (2002), Mole (2004), Badnop(2005) and Brood/Staapl(2006). Staapl
hunk ./doc/scrbl/staapl.scrbl 491
-is a Lisp/Forth hibrid that explores multimethods and linear memory
+is a Lisp/Forth hybrid that explores multimethods and linear memory
hunk ./doc/scrbl/staapl.scrbl 499
-Diggins' efforts. Cat is a typed Joy with a preprocessing term rewrite
-system. Cat has fueled my interest in type systems and statically
-typed functional languages, which eventually lead to the discovery of
-MetaOcaml and Walid Taha's efforts in the RAP domain.  I want to
-acknowledge Slava Pestov for being a source of ideas by being verbal
-about Factor and his opinions on language design and
+Diggins' efforts. Cat is a typed Joy with a preprocessing
+term rewrite system. Cat has fueled my interest in type systems and
+statically typed functional languages, which eventually lead to the
+discovery of MetaOcaml and Walid Taha's efforts in the RAP domain.  I
+want to acknowledge Slava Pestov for being a source of ideas by being
+verbal about Factor and his opinions on language design and
hunk ./www/index.html 20
-  Forth</a>.  Staapl is an attempt to create a programmable interactive
-  compiler for networked deeply embedded applications.
+  Forth</a>.  Staapl is an attempt to create a programmable
+  interactive compiler for networked deeply embedded applications. For
+  a more elaborate introduction
+  see <a href="http://zwizwa.be/darcs/staapl/www/-/staapl.html">here</a>.
hunk ./www/index.html 63
-    <li>[SCAT] A functional concatenative language loosely modeled
+    <li>[Scat] A functional concatenative language loosely modeled
hunk ./www/index.html 67
-    <li>[MACRO] A functional concatenative meta-language written as an
-    extension of SCAT, which serves as the basis for representing a
+    <li>[Coma] A functional concatenative macro language written as an
+    extension of Scat, which serves as the basis for representing a
hunk ./www/index.html 72
-    <li>[FORTH] A set of syntax extensions that add Forth syntax to a
-    SCAT based language.
-    <li>[ASM] Integrated generic assembler which interfaces with the
-    partial evaluator in MACRO, and a bit pattern matching assembler
+    <li>[Forth] A set of syntax extensions that add Forth syntax and
+    semantics to a Scat or Coma based language.
+    <li>[Asm+Comp] Integrated compiler with simple control flow
+    analysis and a generic assembler which interfaces with the partial
+    evaluator in Coma. This includes a bit pattern matching assembler
hunk ./www/index.html 78
-    <li>[PURRR18] The combination of MACRO, FORTH and ASM with
-    primitives for
-    the <a href="http://www.microchip.com">Microchip</a> PIC18 8-bit
-    microcontroller architecture.
-    <li>[BADNOP] A command console for target system interaction and
+    <li>[Purrr18] The combination of Coma and Forth with primitives
+    for the <a href="http://www.microchip.com">Microchip</a> PIC18
+    8-bit microcontroller architecture.
+    <li>[Live] A command console for target system interaction and
hunk ./www/index.html 83
-    <li>[POKE] A C code generator and virtual machine for 32-bit
-    architectures.
hunk ./www/index.html 90
-    <li> The <a href="http://zwizwa.be/sheep">Sheep</a> sound
-         synthesizer software which has been the main test suite for
-         the Purrr18 Forth language since the start of the project
-         (april 2005). Originally written for the PIC12F625, it now
-         runs on the PIC18 architecture (PIC18F1220).
+    <li> The Sheep sound synthesizer software which has been the main
+         test suite for the Purrr18 Forth language since the start of
+         the project (april 2005). Originally written for the
+         PIC12F625, it now runs on the PIC18 architecture
+         (PIC18F1220).
hunk ./www/index.html 103
-      developped in collaboration
-      with <a href="http://catkit.goto10.org">GOTO10</a>.
+      developed for projects in collaboration
+      with <a href="http://goto10.org">GOTO10</a>.
hunk ./www/index.html 111
-  <a href="mailto:tom@zwizwa.be">contact me</a> and temporarily fork
-  the code as a shield from current core changes, as I'm not maintaing
-  a stable/devel dual branch repository yet. This will probably remain
-  the best approach for a while, until the project gains a critical
-  mass.
+  <a href="mailto:tom@zwizwa.be">contact me</a> so I can give some
+  assistance, growing the documentation according to specific needs.
hunk ./www/index.html 116
-  clients.
+  clients and projects that apply Staapl to practical problems.
hunk ./www/index.html 121
-<p>The documentation is mostly the source, but there are some ad-hoc
-  text files in the <a href="../doc">doc</a> folder. Some preliminary
-  papers are available for <a href="../tex/brood.pdf">Staapl</a>,
-  <a href="../tex/purrr.pdf">Purrr18</a> and
-  the <a href="../tex/synth.pdf">Sheep</a> sound synthesizer. I'm
-  working on some scribble docs for the Staapl core.
+<p>The documentation is mostly the source, but there's a
+  small <a href="http://zwizwa.be/darcs/staapl/www/-/staapl.html">
+  introduction</a>
+  and <a href="http://zwizwa.be/ramblings/staapl-blog">blog</a>.