README for string modules
-- dnw 15-Feb-2012

This distribution is a modularization of dnw's ANS Forth
compatible parsing and measured strings libraries, which uses
the module system developed by Krishna Myneni and David N.
Williams.

The distribution is intended to be self-contained, with all
files necessary to run and test the modules.  To run the tests,
simply load parsing-test.fs or mstrings-test.fs, in the
directory into which stringmodules.fs is decompressed.  For
example:

  unzip stringmodules.zip
  cd stringmodules
  gforth parsing-test.fs

The tests work with gforth, iForth, and pfe.  The two test files
provide examples of loading, in their load script sections.  In
particular, they ensure that REQUIRE and REQUIRED are defined.

All files are either in the public domain or licensed under the
GNU Lesser General Public License (LGPL).

FILES

stringmodules.zip		the distribution

modules.fs			module glossary
modular-forth.lyx		module documentation
required.fs			Forth 200x reference implementation
				  of REQUIRED for systems which don't
				  have it, as an anonymous module

fstrings.fs			ANS Forth string parsing
parse-area.fs			parsing the parse area
linstream.fs			parsing the input stream
				  across lines or blocks
parsing.html			documentation and tests for
parsing-test.fs		 	  the above three modules

mstrings-srep.fs		memory representation
mstrings-cat.fs			concatenation
mstrings-store.fs		safe storage into predefined buffers
mstrings-comma.fs		storage into data space
mstrings-linput.fs		multiline input
mstrings-0end.fs		null termination
mstrings.html			mstrings documentation and tests
mstrings-test.fs		

ttester-xf.fs			ttester-based tester for the data
tester-display.fs		  and floating-point stacks, with
xtester-errors.fs		  display and error reporting
ftester-errors.fs		  support