File: ReadMe_Demo - Origins Demo documentation         Last Update: 6 Apr 1993


                      *******************************
                      *     Origins_Demo V1.06      *
                      * 1993 by The Puzzle Factory *
                      *     All Rights Reserved     *
                      *******************************


Legal Stuff
===========
This program is NOT Shareware or Public Domain.
It is Copyright 1992 by The Puzzle Factory, Inc.
This version of Origins is freely redistributable provided the following
rules are followed:

    1. Only reasonable media costs may be charged.

    2. The program and documentation may not be modified in any way.

    3. The entire distribution, as described below, must be distributed
       in its original, unaltered form.

The Puzzle Factory, Inc. will be in no way liable for damages, incidental, or
consequential, arising from the use or misuse of the Origins Demo or for any
other claim by any other party.  Use this program at your own risk.

Origins is a trademark of The Puzzle Factory, Inc.
Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.


Archive Contents
================
The distribution of files for the Origins Demo is listed below:

  Origins_Demo                 The main executable
  Origins_Demo.info            Icon for Origins
  Install_Origins              Script for quick temporary installation
  Install_Origins.info         Icon to execute script
  ReadMe_Demo                  This file
  ReadMe_Demo.info             Icon to view this file
  Tutorial.doc                 An entry level tutorial
  libs (dir)
       arp.library             Required library
  Data (dir)
       genfile                 The empty data bases
       persfile
       ordfile
       marrfile
  Stuff (dir)
       Origins_Demo.doc        On-line help file for Origins
       Banner.ilbm             Initial screen with cute generic people
       TafelHeader.txt         Header file for Tiny-Tafel generator
  Iff (dir)
       IFF.txt                 Placeholder in empty directory
  Notes (dir)
       Notes.txt               Placeholder in empty directory
  ARexx (dir)
       ARexxFuncs.txt          What ARexx functions are available
       ATest.rexx              A sample of the Origins ARexx functions
       EditGen.rexx            Edit SOURCE and NOTE files from within Origins
       Ed_Gen.rexx             Same as above, using Ed
       No_Rexx.rexx            Same as above, for editors without ARexx port


What is Origins?
================
Origins is a dedicated data base manipulation program for keeping track of
genealogical information.  The number of records is limited in practice only
by available memory and storage.  You may track attributes of people, such as
where and when they were born, died and were buried, marriages, and parent/
child relationships.  Extra details, such as baptism, confirmation, and
immigration dates, occupation, etc., for all of the persons are also allowed
for.  Origins is capable of maintaining files on approximately 2000 persons
and 500 marriages on a single floppy data disk.  Larger data bases can be
constructed on a hard-disk based system.

Origins will run on any Amiga with a minimum of 1 MB of ram, under V1.3 or
V2.0 of the OS.  A printer is really necessary too, as you will undoubtedly
want listings.  If printing Pedigree Charts is desired, the printer must also
support condensed (136 column) printing.  Origins requires Arp library, V1.3
or later.

Origins is not intended to be used for religious purposes, and does not
conform to standards for LDS submissions.  The Ordinance file does not
provide for christenings, sealings, priesthood status, or other required
information.  Please do not use Origins for this purpose.


How do I install Origins?
=========================
For a quick trial installation before you move any files around, double-click
on the "Install_Origins" icon.  For a more permanent and flexible
installation, do the following:

1. Copy the executables somewhere in your path:

    copy Origins               SYS:Tools/    ;or C:
    copy Origins.info          SYS:Tools/

2. If you have ARexx on your system, copy the rexx scripts:

    copy ARexx/ATest.rexx      REXX:
    copy ARexx/EditGen.rexx    REXX:

In order for Origins to have the flexibility to be used on a wide variety of
hardware, from systems with floppy drives and limited memory, to systems with
multiple hard drives and megabytes of ram, it relies on the use of logical
assignments for its working directories.  Origins looks for various files in
certain logical directories:

      GenData:   persfile, ordfile, marrfile,
                 pcindex, mindex, genfile
      GenIff:    Person, Ordinance, Marriage, and Family Group pictures
      GenNotes:  Person, Ordinance, Marriage, and Family Group notes
                 Person , Ordinance and Marriage source files
      GenStuff:  Origins.doc, Banner.ilbm, TafelHeader.txt

3. In order that Origins may operate properly, you must add the following
   lines to your startup-sequence (or enter them before running Origins):

      Assign GenData:  <PathName1>
      Assign GenIff:   <PathName2>
      Assign GenNotes: <PathName3>
      Assign GenStuff: <PathName4>

   where PathNameN is the name of the directory where you want Origins to
   keep its files.  If you are not familiar with this, here is an example to
   help get you started:

      Assign GenData:  DH0:MyFamily
      Assign GenIff:   DH2:MyFamily/Pictures
      Assign GenNotes: DH1:MyFamily/Notes
      Assign GenStuff: DH0:MyFamily/Files

   I find this arrangement helpful:

      Assign GenData:  Work:Gen/Data
      Assign GenIff:   Work:Gen/Iff
      Assign GenNotes: Work:Gen/Notes
      Assign GenStuff: Work:Gen/Stuff

   As you can see, the names of the assignments don't have to match the
   logical names.  They also don't have to be on the same volume or disk.  If
   you have floppy drives only, you can do the following:

      Assign GenData:  DataDisk:
      Assign GenIff:   PictureDisk:
      Assign GenNotes: NoteDisk:
      Assign GenStuff: DataDisk:

   where the above names are three separate physical floppy disks.  This will
   help you by leaving room for data on the GenData: disk, and not filling it
   up with pictures or notes.

4. After creating the logical assignments, you MUST:

      copy Stuff/Origins.doc     GenStuff:     ;The hypertext documentation
      copy Stuff/TafelHeader.txt GenStuff:     ;Header file for Tiny-Tafels
      copy Stuff/Banner.ilbm     GenStuff:     ;Initial picture w/cute people

      copy Data/genfile          GenData:      ;The empty data bases
      copy Data/persfile         GenData:
      copy Data/ordfile          GenData:
      copy Data/marrfile         GenData:

These are the files required to use all the features of Origins.  There are
other files in the archive that you may want to copy.

5. In the ARexx directory is a file named "EditGen.rexx".  This script allows
   Origins to automatically call your editor when you want to edit source
   documentation and note files.  The "PROJECT/Edit Source Files/:"  and
   "PROJECT/Edit Note Files/:" provide these functions.

   Your system must be running ARexx to use these functions.  Also, the ARexx
   macro must match the configuration of your editor to use these functions
   successfully.  If they don't match, load "EditGen.rexx" into your editor,
   and follow the instructions you will find in that file.

When you select the "Create Parent/Child Index" and "Create Marriages Index",
Origins will create pcindex and mindex in the GenData: directory.

Origins is now installed, and ready to work for you.  Please see the file
"Tutorial.doc" to learn how to put Origins to work.


Differences between the Commercial and the Demo Versions
========================================================
This is the DEMO version of Origins.  Some functions are either disabled or
missing from this version of the program.  This list points out the major
differences between the commercial and the demo versions:

 1. In the commercial version, the number of records are basically limited
    only by available storage.  In the demo version, the user is limited to
    100 person records, 100 ordinance records, and 50 marriage records.
 2. In the commercial version, if the Banner.ilbm is missing, we just don't
    show the banner.  In the demo version, we complain and exit.
 3. In the commercial version, if genfile, persfile, ordfile, or marrfile is
    missing, they are created.  In the demo version, we complain and exit.
 4. In the demo version, the About requester is shown as you enter the
    program.  In the commercial version, it is shown only if requested.
 5. In the commercial version, the user can increase the size of the
    persfile, ordfile, and marrfile.  In the demo version, when calling these
    functions, a requester stating that these functions do not exist is
    displayed instead.
 6. In the commercial version, if the data bases are full, the user may be
    automatically asked if they would like to increase the size of the data
    bases.  Because the AutoSiz flag in User Preferences is disabled in the
    demo, the user will just be informed that the data bases are full.
 8. In the demo version, the ARexx function, GENAPPENDRECORDS(), has the
    active code removed, and, if no other errors, always returns that it
    added zero records.
 9. In the demo version, the File and Printer gadgets are disabled for the
    entire List Menu except for "List Person's Records".

Additionally, several utilities are provided with Origins, and are not
included in the demo version.  Two of these deal with GEDCOM files.  ToGED
is used for creating GEDCOM files from a data base, and FromGED is used for
reading GEDCOM files and creating a data base.

GEDCOM stands for GEnealogical Data COMmunication, and was developed by the
Family History Department of the Church of Jesus Christ of Latter-day Saints.
GEDCOM is a standardized method of representing genealogical data, designed
to allow transfer of information between diverse computer systems.  Without
it, a person might be forced to re-enter a large data base by hand merely to
move their family tree from one genealogy program to another.

Together, ToGED and FromGED allow you to import and export genealogical data
to and from Origins.  If you have a need for GEDCOM in your genealogical
work, please contact The Puzzle Factory (listed below) for the commercial
version of Origins.


How do I order the Commercial Version?
======================================
If you find this program useful, contact:

  The Puzzle Factory
  P.O. Box 986
  Veneta, OR 97487
  USA
  800:828-9952
  503:935-3709

or in Europe contact:

  Helios Software
  163 Huthwait Road
  Sutton-in-Ashfield
  Notts.  NG17 2HB
  U.K.
  (0623) 554828

or call your dealer to purchase the commercial version of Origins.

=eof=
