README - datagen Version 1.7.0 - Data generator library
Copyright (C) 2004-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.

-------------------------------------------------------------------

This is the directory for the datagen subroutine library.
There is also a DOS version of this datagen library, called
datagen-1.7.0.dos.zip.  The library subroutines in this
directory were first written and tested under DOS.

The test programs, tst.c, tst2.c, and sample.c contain
examples of how the subroutines are called.  The parameters
for each subroutine call are contained in the dgfmt structure.
The test programs show you how to set up those parameters for
each data type and its corresponding subroutine.

Real time features are not included in the datagen library.
If you want to generate data in real time, then modify your
generator program to include wait states in between data
generation calls.

The editing in the subroutine library has been
de-emphasized in favor of faster execution.  Make
sure that you emulate the sample calls in tst.c to
assure the accuracy of your output.

To install the datagen library,
	Extract all the files from datagen-1.7.0.tar.gz.
	Change directory to datagen-1.7.0/lib.
	Run instdg to compile the library.
        Run tst.sh to test the library.

To de-install the datagen library, run "deinst" in the
lib directory.

The test programs for this library are:

tst.c - contains call examples for all data types.

tst2.c - contains call examples with wait states.

sample.c - contains a minimal data generator.  You
           may modify this file for your own generator,
           emulating sample calls in tst.c.

g2jd.c - date conversion to aid in setting up the dgdtrng()
         call.  This program converts from the Gregorian
         date format to julian day.

jd2g.c - date conversion to aid in setting up the dgdtrng()
         call.  This program converts from julian day to
         the Gregorian date format.

The algorithms in the DOS version have been adapted to
a 16 bit, real mode, environment.  The output from the
same calls in Linux do not match DOS.  Only the output
from rnd() matches in both DOS and Linux.  This holds
true, if you compile with "instdg".  If you compile with
"make -f nonintel.mak", the DOS and Linux output matches
except for the different dates/times and ticks.

In tst.c and tst2.c, you will see a section of code that
overrides the seed.  This is just before the main loop.
If you want to generate random data, bypass this code.
If you want to run parallel tests, activate the code.
You can change the value of the seed in the strncpy call
to any 16 byte string that you want.  Make sure the first
byte has an odd ASCII value.

If you need to compile the datagen library on a
non-Intel platform, run make -f nonintel.mak.

If you encounter problems, please send me:

	A detailed description of your compile steps.
	A detailed description of the problem.
