home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / demos / commerci / origins.lzh / ReadMe_Demo < prev    next >
Encoding:
Text File  |  1992-09-30  |  10.1 KB  |  238 lines
  1. File: ReadMe_Demo - Origins Demo documentation         Last Update: 29 Sep 1992
  2.  
  3.  
  4.                       *******************************
  5.                       *     Origins_Demo V1.01      *
  6.                       * ⌐1992 by The Puzzle Factory *
  7.                       *     All Rights Reserved     *
  8.                       *******************************
  9.  
  10.  
  11. Legal Stuff
  12. ===========
  13. This program is NOT Shareware or Public Domain.
  14. It is Copyright ⌐1992 by The Puzzle Factory, Inc.
  15. This version of Origins is freely redistributable provided the following
  16. rules are followed:
  17.  
  18.     1. Only reasonable media costs may be charged.
  19.  
  20.     2. The program and documentation may not be modified in any way.
  21.  
  22.     3. The entire archive, as described below, must be distributed in
  23.        its original, unaltered form.
  24.  
  25. The Puzzle Factory, Inc. will be in no way liable for damages, incidental, or
  26. consequential, arising from the use or misuse of the Origins Demo or for any
  27. other claim by any other party.  Use this program at your own risk.
  28.  
  29. Origins is a trademark of The Puzzle Factory, Inc.
  30. Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  31.  
  32.  
  33. Archive Contents
  34. ================
  35. The distribution of files for the Origins Demo is listed below:
  36.  
  37.   Origins_Demo                 The main executable
  38.   Origins_Demo.info            Icon for Origins
  39.   ReadMe_Demo                  This file
  40.   ReadMe_Demo.info             Icon for this file
  41.   Tutorial.doc                 An entry level tutorial
  42.   libs (dir)
  43.        arp.library             Required library
  44.   Data (dir)
  45.        genfile                 The empty data bases
  46.        persfile
  47.        ordfile
  48.        marrfile
  49.   Stuff (dir)
  50.        Origins_Demo.doc        On-line help file for Origins
  51.        Banner.ilbm             Initial screen with cute generic people
  52.        TafelHeader.txt         Header file for Tiny-Tafel generator
  53.   ARexx (dir)
  54.        ARexxFuncs.txt          What ARexx functions are available
  55.        ATest.rexx              A sample of the Origins ARexx functions
  56.        EditGen.rexx            Edit SOURCE and NOTE files from within Origins
  57.  
  58.  
  59. What is Origins?
  60. ================
  61. Origins is a dedicated data base manipulation program for keeping track of
  62. genealogical information.  The number of records is limited in practice only
  63. by available memory and storage.  You may track attributes of people, such as
  64. where and when they were born, died and were buried, marriages, and parent/
  65. child relationships.  Extra details, such as baptism, confirmation, and
  66. immigration dates, occupation, etc., for all of the persons are also allowed
  67. for.  Origins is capable of maintaining files on approximately 2000 persons
  68. and 500 marriages on a single floppy data disk.  Larger data bases can be
  69. constructed on a hard-disk based system.
  70.  
  71. Origins will run on any Amiga with a minimum of 1 MB of ram, under V1.3 or
  72. V2.0 of the OS.  A printer is really necessary too, as you will undoubtedly
  73. want listings.  If printing Pedigree Charts is desired, the printer must also
  74. support condensed (136 column) printing.  Origins requires Arp library, V1.3
  75. or later.
  76.  
  77. Origins is not intended to be used for religious purposes, and does not
  78. conform to standards for LDS submissions.  The Ordinance file does not
  79. provide for christenings, sealings, priesthood status, or other required
  80. information.  Please do not use Origins for this purpose.
  81.  
  82.  
  83. How do I install Origins?
  84. =========================
  85. 1. Unpack the archive "Origins.lha"
  86.  
  87. 2. Copy the executables somewhere in your path:
  88.  
  89.     copy Origins               SYS:Tools/    ;or C:
  90.     copy Origins.info          SYS:Tools/
  91.  
  92. 3. If you have ARexx on your system, copy the rexx scripts:
  93.  
  94.     copy ARexx/ATest.rexx      SYS:rexxc/    ;or REXX:
  95.     copy ARexx/EditGen.rexx    SYS:rexxc/
  96.  
  97. In order for Origins to have the flexibility to be used on a wide variety of
  98. hardware, from systems with floppy drives and limited memory, to systems with
  99. multiple hard drives and megabytes of ram, it relies on the use of logical
  100. assignments for its working directories.  Origins looks for various files in
  101. certain logical directories:
  102.  
  103.       GenData:   persfile, ordfile, marrfile,
  104.                  pcindex, mindex, genfile
  105.       GenIff:    Person, Ordinance, Marriage, and Family Group pictures
  106.       GenNotes:  Person, Ordinance, Marriage, and Family Group notes
  107.                  Person , Ordinance and Marriage source files
  108.       GenStuff:  Origins.doc, Banner.ilbm, TafelHeader.txt
  109.  
  110. 4. In order that Origins may operate properly, you must add the following
  111.    lines to your startup-sequence (or enter them before running Origins):
  112.  
  113.       Assign GenData:  <PathName1>
  114.       Assign GenIff:   <PathName2>
  115.       Assign GenNotes: <PathName3>
  116.       Assign GenStuff: <PathName4>
  117.  
  118.    where PathNameN is the name of the directory where you want Origins to
  119.    keep its files.  If you are not familiar with this, here is an example to
  120.    help get you started:
  121.  
  122.       Assign GenData:  DH0:MyFamily
  123.       Assign GenIff:   DH2:MyFamily/Pictures
  124.       Assign GenNotes: DH1:MyFamily/Notes
  125.       Assign GenStuff: DH0:MyFamily/Files
  126.  
  127.    I find this arrangement helpful:
  128.  
  129.       Assign GenData:  Work:Gen/Data
  130.       Assign GenIff:   Work:Gen/Iff
  131.       Assign GenNotes: Work:Gen/Notes
  132.       Assign GenStuff: Work:Gen/Stuff
  133.  
  134.    As you can see, the names of the assignments don't have to match the
  135.    logical names.  They also don't have to be on the same volume or disk.  If
  136.    you have floppy drives only, you can do the following:
  137.  
  138.       Assign GenData:  DataDisk:
  139.       Assign GenIff:   PictureDisk:
  140.       Assign GenNotes: NoteDisk:
  141.       Assign GenStuff: DataDisk:
  142.  
  143.    where the above names are three separate physical floppy disks.  This will
  144.    help you by leaving room for data on the GenData: disk, and not filling it
  145.    up with pictures or notes.
  146.  
  147. 5. After creating the logical assignments, you MUST:
  148.  
  149.       copy Stuff/Origins.doc     GenStuff:     ;The hypertext documentation
  150.       copy Stuff/TafelHeader.txt GenStuff:     ;Header file for Tiny-Tafels
  151.       copy Stuff/Banner.ilbm     GenStuff:     ;Initial picture w/cute people
  152.  
  153.       copy Data/genfile          GenData:      ;The empty data bases
  154.       copy Data/persfile         GenData:
  155.       copy Data/ordfile          GenData:
  156.       copy Data/marrfile         GenData:
  157.  
  158. These are the files required to use all the features of Origins.  There are
  159. other files in the archive that you may want to copy.
  160.  
  161. 6. In the ARexx directory is a file named "EditGen.rexx".  This script allows
  162.    Origins to automatically call your editor when you want to edit source
  163.    documentation and note files.  The "PROJECT/Edit Source Files/:"  and
  164.    "PROJECT/Edit Note Files/:" provide these functions.
  165.  
  166.    Your system must be running ARexx to use these functions.  Also, the ARexx
  167.    macro must match the configuration of your editor to use these functions
  168.    successfully.  If they don't match, load "EditGen.rexx" into your editor,
  169.    and follow the instructions you will find in that file.
  170.  
  171. When you select the "Create Parent/Child Index" and "Create Marriages Index",
  172. Origins will create pcindex and mindex in the GenData: directory.
  173.  
  174. Origins is now installed, and ready to work for you.  Please see the file
  175. "Tutorial.doc" to learn how to put Origins to work for you.
  176.  
  177.  
  178. Differences between the Commercial and the Demo Versions
  179. ========================================================
  180. This is the DEMO version of Origins.  Some functions are either disabled or
  181. missing from this version of the program.  This list points out the major
  182. differences between the commercial and the demo versions:
  183.  
  184.  1. In the commercial version, the number of records are basically limited
  185.     only by available storage.  In the demo version, the user is limited to
  186.     100 person records, 100 ordinance records, and 50 marriage records.
  187.  2. In the commercial version, if the Banner.ilbm is missing, we just don't
  188.     show the banner.  In the demo version, we complain and exit.
  189.  3. In the commercial version, if genfile, persfile, ordfile, or marrfile is
  190.     missing, they are created.  In the demo version, we complain and exit.
  191.  4. In the demo version, the About requester is shown as you enter the
  192.     program.  In the commercial version, it is shown only if requested.
  193.  5. In the commercial version, the user can increase the size of the
  194.     persfile, ordfile, and marrfile.  In the demo version, when calling these
  195.     functions, a requester stating that these functions do not exist is
  196.     displayed instead.
  197.  6. In the commercial version, if the data bases are full, the user may be
  198.     automatically asked if they would like to increase the size of the data
  199.     bases.  Because the AutoSiz flag in User Preferences is disabled in the
  200.     demo, the user will just be informed that the data bases are full.
  201.  8. In the demo version, the ARexx function, GENAPPENDRECORDS(), has the
  202.     active code removed, and, if no other errors, always returns that it
  203.     added zero records.
  204.  9. In the demo version, the File and Printer gadgets are disabled for the
  205.     entire List Menu except for "List Person's Records".
  206.  
  207. Additionally, several utilities are provided with Origins, and are not
  208. included in the demo version.  Two of these deal with GEDCOM files.  ToGED
  209. is used for creating GEDCOM files from a data base, and FromGED is used for
  210. reading GEDCOM files and creating a data base.
  211.  
  212. GEDCOM stands for GEnealogical Data COMmunication, and was developed by the
  213. Family History Department of the Church of Jesus Christ of Latter-day Saints.
  214. GEDCOM is a standardized method of representing genealogical data, designed
  215. to allow transfer of information between diverse computer systems.  Without
  216. it, a person might be forced to re-enter a large data base by hand merely to
  217. move their family tree from one genealogy program to another.
  218.  
  219. Together, ToGED and FromGED allow you to import and export genealogical data
  220. to and from Origins.  If you have a need for GEDCOM in your genealogical
  221. work, please contact The Puzzle Factory (listed below) for the commercial
  222. version of Origins.
  223.  
  224.  
  225. How do I order the Commercial Version?
  226. ======================================
  227. If you find this program useful, contact:
  228.  
  229.   The Puzzle Factory
  230.   P.O. Box 986
  231.   Veneta, OR 97487
  232.   800:828-9952
  233.   503:935-3709
  234.  
  235. or call your dealer to purchase the commercial version of Origins.
  236.  
  237. =eof=
  238.