home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 4 / CDPD_IV.bin / utilities / misc / scion / arexx / readme < prev    next >
Encoding:
Text File  |  1994-06-28  |  6.3 KB  |  133 lines
  1. The ARexx scripts included with this distribution of Scion are the work of
  2. Scion users. If you wish to discuss these scripts or make suggestions, please
  3. contact the authors directly.
  4.  
  5. Please note that ALL scripts are supplied AS IS, and no guarantees are made.
  6. Note also that some of the scripts that involve a graphical user-interface
  7. may require the use of additional libraries (not supplied) and may be designed
  8. for PAL video screens only.
  9.  
  10. I had hoped to include more scripts, but unfortunately the disk got too full!
  11.  
  12. The following scripts are included:
  13.  
  14. -----------------------------------------------------------------------------
  15. FixLastNames.rexx
  16.    This script should FIND and REPLACE a given LAST name in the SCION
  17.    database.
  18.  
  19.    Author: Peter Billing, RMB 1240, Yinnar 3869, Australia
  20. -----------------------------------------------------------------------------
  21. FixPlaceNames.rexx
  22.    This script should FIND and REPLACE a given PLACE name in the SCION
  23.    database. It will check Birth, Death, Burial and Marriage place names.
  24.  
  25.    Author: Peter Billing, RMB 1240, Yinnar 3869, Australia
  26. -----------------------------------------------------------------------------
  27. PrintDescendant.rexx
  28.  Version 1.12 (1 Mar 1994)
  29.  
  30.    Output options:
  31.     1. Descendant Chart - all descendants [Dutch: parenteel]
  32.     2. Descendant Chart - male descendants (mention daughters, no children)
  33.        [Dutch: genealogie - nageslacht van zonen, maar vermelding dochters]
  34.     3. Descendant Chart - male descendants (leave out daughters)
  35.        [Dutch: stamboom - nageslacht van zonen, geen vermelding dochters]
  36.  
  37.    This version uses (by default) the rexxreqtools.library (which requires
  38.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  39.    If you do not have any of these, you need to supply the NOREQ argument,
  40.    except when you supply the QUIET argument.
  41.  
  42.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  43. -----------------------------------------------------------------------------
  44. PrintPedigree.rexx
  45.  Version 1.10 (1 Mar 1994)
  46.  
  47.    Output options:
  48.     1. Pedigree Chart - male ancestor line only [Dutch: stamreeks]
  49.     2. Pedigree Chart - all ancestors, no siblings [Dutch: kwartierstaat]
  50.     3. Pedigree Chart - all ancestors, only siblings of last generation
  51.     4. Pedigree Chart - all ancestors, all siblings
  52.  
  53.    This version uses (by default) the rexxreqtools.library (which requires
  54.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  55.    If you do not have any of these, you need to supply the NOREQ argument,
  56.    except when you supply the QUIET argument.
  57.  
  58.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  59. -----------------------------------------------------------------------------
  60. GEDCOM2Scion.rexx
  61.  Version 1.08 (1 Mar 1994)
  62.  
  63.    This program was created to import GEDCOM data into the Scion database.
  64.    It is still very basic and not user-friendly at all.
  65.    I assume it will only be able to parse the most basic GEDCOM files, and
  66.    I can't even guarantee that it will handle these correctly...
  67.  
  68.    Even though this script does no parsing of dates, it's safer if they are
  69.    in the exact format "DD MMM YYYY".
  70.    All unrecognized fields or fields that Scion doesn't use, are skipped.
  71.    The database must be running for this AREXX script to work.
  72.    NOTE: The program generates a file DATABASE.err (where DATABASE is the
  73.      name of the current Scion database), containing parsing info about
  74.      which lines were skipped and which non-fatal errors were encountered.
  75.      It may be a good idea to read this file!
  76.  
  77.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  78. -----------------------------------------------------------------------------
  79. Scion2GEDCOM.rexx
  80.  Version 1.11 (1 Mar 1994)
  81.  
  82.    This program was created to export the Scion data into the GEDCOM file
  83.    format. It is still very basic and not user-friendly at all.
  84.  
  85.    This version uses (by default) the rexxreqtools.library (which requires
  86.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  87.    If you do not have any of these, you need to supply the NOREQ argument,
  88.    except when you supply the QUIET argument.
  89.  
  90.    Sexes and dates should be in the English format.
  91.    Dates should be in the format "DD MMM YYYY", "DD-MMM-YYYY" or
  92.    "DD.MMM.YYYY", if you don't want any problems with programs importing
  93.    the GEDCOM data.
  94.    The database must be running for this AREXX script to work.
  95.  
  96.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  97. -----------------------------------------------------------------------------
  98.  
  99. The following note is from the author Freddy Ariës:
  100.  
  101. The new versions are now able to use the ReqTools.library, and default
  102. to that, if you have rexxreqtools.library (No, these libraries are not
  103. included here, because it would make the package too large, but they are
  104. freely distributable and should be easy to obtain).
  105. If you don't want the scripts to use requesters, you can (apart from editing
  106. them and making them default to no requesters) pass the command line option
  107. 'NOREQ', in which case normal text output to the Shell shall be used. Note
  108. that the previous option 'NOMSG' has been renamed to 'QUIET' (matching
  109. Commodore's own commands). It still does the same - output no messages at all,
  110. neither by shell nor by requesters. So using 'QUIET' *and* 'NOREQ' is useless,
  111. and even impossible; if you pass both options to the program, only the first
  112. option passed will be used. The second option will simply be ignored.
  113.  
  114. Please don't use these scripts as examples of good programming in ARexx!
  115. They were all just quick hacks for myself, never really meant for public
  116. distribution. Apart from bad programming, they may also be full of bugs.
  117. These scripts are released to the Public Domain and are entirely without
  118. guarantees, so you can do with them whatever you want - at your own
  119. responsibility.
  120.  
  121. DISTRIBUTION
  122.  
  123. As I said, these scripts are Public Domain. That means that you can do with
  124. them whatever you want. All I ask of you is to name me as the original author.
  125.  
  126. NO WARRANTIES! I do not take the responsibility for ANYTHING, including,
  127. but not limited to, the loss of data caused by any of these scripts.
  128. Everything you do with the scripts is your own responsibility, and at your
  129. own risk.
  130.  
  131. Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  132. 2 Mar 1994
  133.