Improve Makefile to make it more standard and so that

[pforth] / readme.txt

README for pForth - a Portable ANS-like Forth written in ANSI 'C'\r
\r
by Phil Burk\r
with Larry Polansky, David Rosenboom and Darren Gibbs.\r
Support for 64-bit cells by Aleksej Saushev.\r
\r
Last updated: May 20, 2010 V26\r
\r
Code for pForth is maintained on Google at:\r
   http://code.google.com/p/pforth/\r
   \r
Documentation for pForth at:\r
  http://www.softsynth.com/pforth/\r
\r
For technical support please use the pForth forum at:\r
  http://groups.google.com/group/pforthdev\r
  \r
The author is available for customization of pForth, porting to new\r
platforms, or developing pForth applications on a contractual basis.\r
If interested, contact Phil Burk at:\r
  http://www.softsynth.com/contacts.php\r
\r
-- LEGAL NOTICE -----------------------------------------\r
\r
The pForth software code is dedicated to the public domain,\r
and any third party may reproduce, distribute and modify\r
the pForth software code or any derivative works thereof\r
without any compensation or license.  The pForth software\r
code is provided on an "as is" basis without any warranty\r
of any kind, including, without limitation, the implied\r
warranties of merchantability and fitness for a particular\r
purpose and their equivalents under the laws of any jurisdiction.\r
\r
-- Contents of SDK --------------------------------------\r
\r
	build - tools for building pForth on various platforms\r
	build/win32/vs2005 - Visual Studio 2005 Project and Solution\r
	build/unix - Makefile for unix\r
	\r
	csrc - pForth kernel in ANSI 'C'\r
	csrc/pf_main.c - main() application for a standalone Forth\r
	csrc/stdio - I/O code using basic stdio for generic platforms\r
	csrc/posix - I/O code for Posix platform\r
	csrc/win32 - I/O code for basic WIN32 platform\r
	csrc/win32_console - I/O code for WIN32 console that supports command line history\r
	\r
	fth - Forth code\r
	fth/util - utility functions\r
\r
-- How to build pForth ------------------------------------\r
\r
See pForth reference manual at:\r
\r
  http://www.softsynth.com/pforth/pf_ref.htm\r
  \r
-- How to run pForth ------------------------------------\r
\r
Once you have compiled and built the dictionary, just enter:\r
     pforth\r
\r
To compile source code files use:    INCLUDE filename\r
\r
To create a custom dictionary enter in pForth:\r
	c" newfilename.dic" SAVE-FORTH\r
The name must end in ".dic".\r
\r
To run PForth with the new dictionary enter in the shell:\r
	pforth -dnewfilename.dic\r
\r
To run PForth and automatically include a forth file:\r
	pforth myprogram.fth\r
\r
-- How to Test PForth ------------------------------------\r
\r
You can test the Forth without loading a dictionary\r
which might be necessary if the dictionary can't be built.\r
\r
Enter:   pforth -i\r
In pForth, enter:    3 4 + .\r
In pForth, enter:    loadsys\r
In pForth, enter:    10  0  do i . loop\r
\r
PForth comes with a small test suite.  To test the Core words,\r
you can use the coretest developed by John Hayes.\r
\r
Enter:  pforth\r
Enter:  include tester.fth\r
Enter:  include coretest.fth\r
\r
To run the other tests, enter:\r
\r
	pforth t_corex.fth\r
	pforth t_strings.fth\r
	pforth t_locals.fth\r
	pforth t_alloc.fth\r
	\r
They will report the number of tests that pass or fail.\r