README - datagen (Data Generator) Version 1.7.0
Copyright (C) 1999-2010   dondalah721@yahoo.com (Dondalah)

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to:

	Free Software Foundation, Inc.
	59 Temple Place - Suite 330
	Boston, MA  02111-1307, USA.
-------------------------------------------------------------------

In this release of datagen, the compile produces
shift/reduce and reduce/reduce error messages.  However,
the test files compare to the previous release.  Therefore,
if you have incorrect results with your testing, please
notify me as soon as possible.

To install datagen,
	extract all the files from datagen-1.7.0.tar.gz.
	change directory to datagen-1.7.0
	run instpc
	change directory to datagen-1.7.0/lib
	run instdg
	change directory to datagen-1.7.0/rantest
	run insttest

The makefile for compiling datagen is called "Makefile".
"make" will compile all the modules belonging to datagen.
Move the datagen executable to your bin directory.
Test the compiled program with the following test files:
	tst/dgtst1.dg
	tst/dgtst2.dg
	tst/dgtst3.dg
	tst/dgtst4.dg
	tst/dgtst5.dg

You may test datagen with the shell scripts:
	runtst.sh
	runtst2.sh

Examine the message listings to be sure that the result
of each compile = 0.  The last few lines in the
message file indicate where the compiler finds an error.
The last "good" instruction appears near the end
of the listing.  To obtain more diagnostic information
from datagen, use the -v or -V option.

Examine the data files to make sure that they produce
coherent data, when the compiler completes.  Compare
the 3 source files with the output from the test.

If you encounter problems, please send me:

	the test input file
	the error file
	the output data file (if any)

Practice, practice, practice with your own source files.
The fastest way to learn the syntax is to copy examples
from the test files:
	tst/dgtst1.dg - full syntax
	tst/dgtst2.dg - full syntax
	tst/dgtst3.dg - full syntax
	tst/dgtst4.dg - shorter syntax
	tst/dgtst5.dg - shorter syntax

Examples from the documentation are in the tst
subdirectory.  They're called eg???.dg.

Browse datagen.html with your favorite browser to obtain
information about the syntax of the input language.
datagen.html contains a table of contents for the
documentation.

To test the subroutine library, change directory
to datagen-1.7.0/lib.  Run tst.sh.

Follow the documentation for testing the support
routines.  Random number generator statistical
tests are in a subdirectory called rantest.
Run rantest/test.sh to see working examples of
the test programs.

------------------------------------------------------
Non-Intel platforms:

Use source file rnd2.c     instead of rnd.s
Use source file rndpwr2.c  instead of rndpwr.s
Use source file rndnum2.c  instead of rndnum.s
Use source file rndfrac2.c instead of rndfrac.s
Compile datagen with the makefile nonintel.mak.
Then run rantest/insttest.

	make -f nonintel.mak
	rantest/insttest

The non-Intel randomizing routines have only been
tested on an Intel Linux platform.  They run about
20 times slower than the corresponding assembler
subroutines.

------------------------------------------------------
To de-install datagen, run:
	deinst
	lib/deinst
	rantest/deinst
