home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / gene / soundr20.zip / SOUNDER.NFO < prev    next >
Text File  |  1993-08-25  |  21KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.     August, 1993
  7.  
  8.  
  9.  
  10.                  --------------------------------------
  11.                            SOUNDER Bug Found
  12.                  --------------------------------------
  13.  
  14.  
  15.     Sounder Versions 1.0 and 1.1 may not properly calculate the
  16.     Soundex code when a surname contains repeating letter values.
  17.     (Clipper programmers beware - the SOUNDEX() function of the
  18.     Summer '87 product may not return a value consistent with
  19.     genealogical needs.)
  20.  
  21.       ------------------------------------------------------------
  22.  
  23.               Sounder Version 2.0 has been released and
  24.           utilizes a custom routine to correct the problem.
  25.  
  26.       ------------------------------------------------------------
  27.  
  28.     The program has been uploaded to Ancestry TBBS (813-382-9061) as
  29.     SOUNDR20.zip and is available thru GSDS.
  30.  
  31.     Version 2.0 does include a couple of new features including the
  32.     ability to maintain & print search log worksheets, print a
  33.     variety of blank forms, and view selected files on-screen.  If a
  34.     SOUNDER database was created using an earlier version, it will
  35.     automatically be checked so that the codes are correct.  If you
  36.     discover any discrepancies, naturally I would appreciate a note.
  37.  
  38.     Those of you who requested and received an earlier version
  39.     through the mail can expect to receive an update within the
  40.     coming days.  If you are inadvertently overlooked, please let me
  41.     know.  Pending mail requests are also being processed.
  42.  
  43.     Special thanks to Thomas F. Rahrig (Cumberland, MD) & James E.
  44.     Stout (Raymore, MO) for notifying me of the problem and to George
  45.     Pardue (Soundex 8.02) and Chris Long (Family Scrap Book) for
  46.     their consultations on the new routine.
  47.  
  48.     My sincere apologies to anyone who spent research time in vain
  49.     due to a bad code.  Over 600 random names were checked for
  50.     accuracy in the initial version but...  If you want to give me a
  51.     thorough blasting, drop a line or call...
  52.  
  53.  
  54.     Patrick C. Deatherage
  55.     P.O. Box 202
  56.     League City, TX  77574-0202
  57.     (713:332-3268)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.     December, 1992
  73.  
  74.  
  75.     Sounder is not designed to be a do-everything-for-everyone
  76.     utility and I hope it fills a gap in your research needs.
  77.     Questions, complaints, comments (good, bad and in-different) and
  78.     suggestions are welcomed.  Please make a note of the comments on
  79.     the opening screen and then, enjoy.
  80.  
  81.  
  82.     Patrick C. Deatherage
  83.     P. O. Box 202
  84.     League City, TX  77574-0202
  85.     (713) 332:3268
  86.  
  87.  
  88.     ps: Press F10 while viewing the opening screen and the program
  89.         will be patched to ignore it on start-up.
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.     ═════════════════════════════════════════════════════════════════
  135.                      Sounder - Freeware Version 2.0
  136.                              August 1993
  137.     ═════════════════════════════════════════════════════════════════
  138.  
  139.  
  140.     Sounder is a simple DOS based program that will calculate a
  141.     Soundex code for one or more surnames and place the information
  142.     in a database.  This information can then be viewed on-screen or
  143.     printed in a two or three-column alphabetized list to be used as
  144.     a handy reference during research.
  145.  
  146.     Blank work sheet forms can be printed directly from the program
  147.     and an electronic log can be maintained.
  148.  
  149.     Written in Clipper (Summer '87), Sounder creates a "standard"
  150.     .DBF which can be read by most database programs.
  151.  
  152.     Sounder Version 2.0 utilizes a custom function to calculate the
  153.     Soundex code.  Please report any discrepancies.
  154.  
  155.  
  156.                            Installing Sounder
  157.  
  158.     Sounder Version 2.0 was released as SOUNDR20.ZIP to the Ancestry
  159.     TBBS (813-382-9061) and is available to Sysops thru GSDS - and
  160.     should contain the following files:
  161.  
  162.               Sounder.exe - the program
  163.               Sounder.nfo - this text file
  164.               Soundr1.ged - a sample .GED file, LDS format
  165.               Soundr2.ged - a sample .GED file, Roots III format
  166.               Prswap.com  - forces printer into non-graphic format
  167.  
  168.     Create a directory on your hard disk by the name of SOUNDER,
  169.     switch to that directory and unzip SOUNDR20 to that directory.
  170.     Type SOUNDER to begin.  In DOS lingo,
  171.  
  172.               C: <whichever drive you wish to use>
  173.               MD \SOUNDER
  174.               CD \SOUNDER
  175.               PKUNZIP A:SOUNDER <B: if applicable>
  176.               SOUNDER
  177.  
  178.     If you received Sounder already "unzipped", that is, the files
  179.     listed above on disk, at the DOS prompt type:
  180.  
  181.               C:              <whichever drive you wish to use>
  182.               MD \SOUNDER
  183.               CD \SOUNDER
  184.               COPY A:*.*      <B: if applicable>
  185.               SOUNDER
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.     ═════════════════════════════════════════════════════════════════
  195.  
  196.  
  197.  
  198.  
  199.  
  200.     Sounder - Freeware Version 2.0                             Page 2
  201.     ═════════════════════════════════════════════════════════════════
  202.  
  203.  
  204.                         Main Menu/Scroll Screen
  205.  
  206.     Sounder utilizes a combined Main Menu and "Scroll Screen"
  207.     routine.  Entries in the database are shown on the screen and can
  208.     be navigated by using the UP & DOWN arrow, PAGE DOWN, PAGE UP,
  209.     HOME, and END keys.  The menu options are selected by using the
  210.     LEFT and RIGHT arrow keys and pressing ENTER will activate the
  211.     hilited choice.  ESC will terminate the program and return
  212.     control to the DOS prompt.
  213.  
  214.          Add    - add Surnames/Codes to the database
  215.  
  216.          Edit   - modify the hilighted Surname/Code
  217.  
  218.          Delete - remove selected entries from the database
  219.  
  220.          Import - scan GED, Tafel, Nameview/Namedrop files
  221.  
  222.          Print  - send selected entries of the database to
  223.                   the printer or a text file
  224.  
  225.          Logs   - create, print & maintain individual log
  226.                   search sheets
  227.  
  228.          View   - View on-screen selected text files
  229.  
  230.          Quit   - quit the program and return control to DOS
  231.  
  232.  
  233.     Key Control:
  234.  
  235.         PageUp, PageDown, Up, Down, Home, End - navigate entries in
  236.         the data base shown on the scroll screen
  237.  
  238.         Left & Right Arrow Keys - hilite menu option
  239.  
  240.         Enter - activate menu option
  241.  
  242.         Space Bar - tag or untag the hilited entry
  243.         INS - activate ADD option
  244.         DEL - activate DELete option
  245.  
  246.         ^S  - switch sort between surname and soundex code
  247.         ^T  - tag ALL entries
  248.         ^U  - untag ALL entries
  249.  
  250.  
  251.         F3  - activate print menu
  252.         F10 - quick quit to DOS from any menu
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.     ═════════════════════════════════════════════════════════════════
  261.  
  262.  
  263.  
  264.  
  265.  
  266.     Sounder - Freeware Version 2.0                             Page 3
  267.     ═════════════════════════════════════════════════════════════════
  268.  
  269.  
  270.                      Adding Entries to the Database
  271.  
  272.     An entry is added to the database by using the RIGHT ARROW key to
  273.     hilight the ADD option on the main menu and then pressing
  274.     ENTER - or by pressing the INS key.  A box will appear.  Type in
  275.     the desired surname and press ENTER.  Sounder will calculate the
  276.     soundex code and verify that the name does not already exist in
  277.     the database.
  278.  
  279.     If the soundex code can not be calculated, a message box will
  280.     appear.  If the surname is already in the database, a message box
  281.     will appear.  A Yes/No prompt will appear before a new entry is
  282.     added.  Use the Up and Down arrow keys to hilite the desired
  283.     answer and press the RIGHT ARROW key or ENTER to active the
  284.     choice.  Pressing ESC or the LEFT arrow key will tell Sounder not
  285.     to add the entry.  As new entries are added, the last 9 will
  286.     appear below the entry box.  If the ADD box was reached in error,
  287.     or there are no additional names to include, leave the box blank
  288.     and press ENTER.  The ESC key will also cancel the add routine.
  289.  
  290.  
  291.                     Editing Entries in the Database
  292.  
  293.     Individual entries may be modified if necessary.  Hilite the name
  294.     to be modified.  Hilite the EDIT option on the main menu and
  295.     press ENTER.
  296.  
  297.     The cursor will be at the soundex code field.  Type in the new
  298.     information and press ENTER.  The cursor will advance to the name
  299.     field.  Type in the new information and press ENTER.
  300.  
  301.     The Up and Down arrow keys will also move the cursor between the
  302.     two fields.  The PageDown key or ^W will also save the entry as
  303.     it is written.  The ESC key will negate any changes and cancel
  304.     the Edit routine.  The soundex code field may be left blank but
  305.     the program will not allow the name field to be empty.
  306.  
  307.     NOTE:  the edit routine does not contain any error checking which
  308.            allows free-form use for other needs.
  309.  
  310.  
  311.                     Deleting Entries in the Database
  312.  
  313.     Entries may be deleted from the database.  Hilite DEL at the main
  314.     menu and press ENTER - or press the DEL key.  The Delete Menu
  315.     will appear.  The hilited entry, all the tagged entries or ALL of
  316.     the entries may be deleted.  Use the Up and Down arrow keys to
  317.     hilite the desired action and press either the RIGHT ARROW key or
  318.     the ENTER key.
  319.  
  320.     Once entries are deleted, they are permanently removed from the
  321.     database.  If an entry was accidently deleted it must be re-added
  322.     through the ADD or IMPORT routines.  The delete option may be
  323.     cancelled by pressing the LEFT ARROW key or the ESC key.
  324.  
  325.  
  326.     ═════════════════════════════════════════════════════════════════
  327.  
  328.  
  329.  
  330.  
  331.  
  332.     Sounder - Freeware Version 2.0                             Page 4
  333.     ═════════════════════════════════════════════════════════════════
  334.  
  335.  
  336.                             Importing Files
  337.  
  338.     Sounder can scan Gedcom and Nameview .DAT files for surnames and
  339.     will automatically place them in the database.  Tafel files are
  340.     not handled at this time.  Sounder will not allow duplicate
  341.     entries, so a file can be processed more than once without fear.
  342.  
  343.     A gedcom file from the LDS Family Search Program is handled
  344.     differently than a .GED produced by other genealogy packages.
  345.     Sounder will attempt to determine the FSP type of file by reading
  346.     the first "1 SOUR" (source) line.  If "IGI" or "SSDI" is
  347.     designated, the program will assume the gedcom is from the Family
  348.     Search Program.  Any other type of source information is found, a
  349.     "Non-FSP" gedcom will be assumed.
  350.  
  351.     The import routine is a two step process.  Sounder will
  352.     automatically find both GED and Nameview/Namedrop DAT files but
  353.     must be told which drive to search.  Which file to process must
  354.     also be selected.
  355.  
  356.  
  357.     Selecting a File Type
  358.     ─────────────────────
  359.     Select the desired type and press either the RIGHT ARROW key or
  360.     ENTER.  The LEFT ARROW key will return the program to the main
  361.     menu and scroll screen.
  362.  
  363.     Choose "ALL" and all GED and Nameview/Namedrop DAT files will be
  364.     listed for the drive selected.  If only GED files are desired,
  365.     select either GED option.  If only DAT files are desired, select
  366.     the DAT option.  The TT option is de-activated at this time.
  367.  
  368.  
  369.     Selecting a Drive
  370.     ─────────────────
  371.     Hilite the desired drive and press either the RIGHT ARROW key or
  372.     ENTER.  The LEFT ARROW key will return the program to the File
  373.     Type Selection box.  All directories of the drive selected will
  374.     be searched for the chosen file type.  The "ALL" drives option is
  375.     not active at this time.
  376.  
  377.  
  378.     Selecting a File to Process
  379.     ───────────────────────────
  380.     Use the Up, Down, PageUp, PageDown, Home, and End keys to
  381.     navigate the list of files.  Use either the RIGHT ARROW key or
  382.     ENTER to begin processing the hilited file.  The LEFT ARROW key
  383.     will return the program to the File Type box.
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.     ═════════════════════════════════════════════════════════════════
  393.  
  394.  
  395.  
  396.  
  397.  
  398.     Sounder - Freeware Version 2.0                             Page 5
  399.     ═════════════════════════════════════════════════════════════════
  400.  
  401.  
  402.     Processing Files
  403.     ────────────────
  404.     The ESC key may be pressed during processing to cancel the
  405.     routine.  If Sounder can not determine a soundex code for a name,
  406.     it will be ADDED to the text file BADSNDX.TXT - and at the end of
  407.     the import routine, a Yes/No box will allow for the option of
  408.     viewing and/or deleting this file.  NOTE:  each time a file is
  409.     processed, the "unknown" entries will be ADDED to this file so
  410.     therefore if it is not occasionally deleted, it will continue to
  411.     grow in size and take up unnecessary disk space.
  412.  
  413.  
  414.     LDS Gedcom
  415.     ──────────
  416.     The following is an example of a line from gedcom produced by the
  417.     Family Search Program's IGI routine:
  418.  
  419.               1 NAME Sheila Mae/ILDERTON/
  420.  
  421.     Sounder will only find the words between the slashes.
  422.     Occasionally a name will be listed like:
  423.  
  424.               1 NAME Sheila Mae/ILDERTON or ELDERTON/
  425.  
  426.     This version of Sounder assumes only what is between the slashes.
  427.     Therefore, "ILDERTON or ELDERTON" will be listed in the database.
  428.     Use the EDIT routine or DELete the offending entry at the main
  429.     menu and ADD the correction.
  430.  
  431.  
  432.     Gedcom - Other
  433.     ──────────────
  434.     The following is an example of a line from gedcom produced by
  435.     Roots III:
  436.  
  437.         1 NAME Sheila Mae/Ilderton/Deatherage
  438.  
  439.     Sounder will concentrate solely on the "1 NAME" lines.  The
  440.     program will assume that the word between the two slashes is a
  441.     surname.  Any word(s) found following the 2nd slash will also be
  442.     considered as a surname.  Both will be included in the database.
  443.     Roots III allows multiple names.  Consider the following:
  444.  
  445.         1 NAME Sheila Mae/Ilderton/Greene Halterman Deatherage
  446.  
  447.     Sounder will attempt to separate up to the first 5 words after
  448.     the surname between the slashes.  Depending on how the entries
  449.     are recorded in the genealogy package, it is possible that titles
  450.     such as Jr, Sr, Dr, and DDS will be considered a surname and
  451.     included in the database.  the offending entry must be manually
  452.     removed using the delete option at the main menu.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.     ═════════════════════════════════════════════════════════════════
  459.  
  460.  
  461.  
  462.  
  463.  
  464.     Sounder - Freeware Version 2.0                             Page 6
  465.     ═════════════════════════════════════════════════════════════════
  466.  
  467.  
  468.     Tafel (.TT)
  469.     ───────────
  470.     Until additional research can be done on the formal format of
  471.     Tafel files, this feature is disabled even though the .TT files
  472.     will be shown.
  473.  
  474.  
  475.     Namedrop.dat/Nameview.dat
  476.     ─────────────────────────
  477.     Since Nameview and Namedrop allow key words for any purpose as
  478.     well as surnames in the .DAT file, a YES/NO prompt will request
  479.     verification before adding a name to the database.
  480.     Nameview/Namedrop users are aware that the key word  list begins
  481.     following the "~~" line in the .DAT file.  Sounder begins it's
  482.     name processing following the double tilde.
  483.  
  484.     Nameview and Namedrop are excellent message search and retrieval
  485.     utilities that can be found on most genealogy related-bulletin
  486.     boards.  Contact
  487.  
  488.             Ray Cox
  489.             17410 Huntersglen
  490.             Humble, TX  77396-1622
  491.  
  492.     for additional information on or ordering Nameview and Namedrop.
  493.  
  494.  
  495.                          Printing the Database
  496.  
  497.  
  498.     Select PRT at the main menu or press the F3 key.  The Print Menu
  499.     will appear.  Use the UP and DOWN ARROW keys to select one of the
  500.     options and press ENTER or the RIGHT ARROW key.  The LEFT ARROW
  501.     key will cancel the print routine and return the program to the
  502.     main menu.
  503.  
  504.     The print output is "hard-wired" to utilized a two-column, 55-
  505.     line result - and is sorted by the current active sort.  Press
  506.     the ESC key during printing to cancel the routine.
  507.  
  508.  
  509.                   Sorting the Entries in the Database
  510.  
  511.  
  512.     There are two sorts available.  By Surname or Soundex code.
  513.     At the main menu, press ^S (the CTRL key and the S key
  514.     simultaneously) to switch between the two.  The printed output,
  515.     whether to the printer or SOUNDER.TXT, will be in the currently
  516.     selected sort.
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.     ═════════════════════════════════════════════════════════════════
  525.  
  526.  
  527.  
  528.  
  529.  
  530.     Sounder - Freeware Version 2.0                             Page 7
  531.     ═════════════════════════════════════════════════════════════════
  532.  
  533.  
  534.                                File Options
  535.  
  536.  
  537.     The database created by Sounder is named SOUNDER.DBF and this
  538.     version does not allow for additional .DBF's to be maintained.
  539.     SOUNDER.DBF is a "standard" database file which can be read by
  540.     any of the database systems such as DBASE III+, FoxPro etc.
  541.  
  542.  
  543.  
  544.                                    Logs
  545.  
  546.  
  547.     An electronic search log sheet can be created for a surname.
  548.     Each sheet contains the surname, year, soundex code and a
  549.     checklist of each of the 50 states.  Use the UP and DOWN arrow
  550.     keys at the main menu to hilight the surname to use.  Then use
  551.     the LEFT or RIGHT arrow keys to hilight the LOGS option and press
  552.     enter.  A box asking for the beginning year and number of sheets
  553.     to create will appear.
  554.  
  555.     If a log sheet already exists for a surname, a dot will appear
  556.     next to the name on the scroll screen.  When the LOGS option is
  557.     selected, the main screen of the logs will automatically be shown
  558.     with the first sheet of the surname shown.
  559.  
  560.     For example, to create sheets for 1880 through 1920 but omitting
  561. 1890,  use 1880 as the start year and 4 as the number of sheets to
  562. create.  When the program asks to use 1890, select NO.
  563.  
  564.     The main screen of the logs will show the appropriate key
  565.     control, the current log sheet, and the names & years of the 5
  566.     sheets before and after the current sheet (if any).
  567.  
  568.     Use the UP, DOWN, RIGHT and LEFT arrow keys to navigate the
  569.     states of the current sheet.  Press the SPACE BAR to mark or
  570.     unmark the hilighted state.
  571.  
  572.     Use the PAGE UP and PAGE DOWN keys to navigate through the
  573.     existing sheets one at a time.  The HOME key will display the
  574.     first sheet, the END key will display the last sheet.
  575.  
  576.     An additional sheet for the surname of the current sheet can be
  577.     added by pressing the INS key.  Sounder will ask for the
  578.     beginning year and number of sheets to create.  If a sheet for
  579.     that name and year already exists, a duplicate will not be made.
  580.  
  581.     Sheets may be deleted (removed permanently).  Press the DEL key
  582.     and the Delete Menu will appear.  Hilight either of the options
  583.     and press ENTER.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.     ═════════════════════════════════════════════════════════════════
  591.  
  592.  
  593.  
  594.  
  595.  
  596.     Sounder - Freeware Version 2.0                             Page 8
  597.     ═════════════════════════════════════════════════════════════════
  598.  
  599.  
  600.  
  601.     Sheets may be printed.  Press the ENTER key and the Print Menu
  602.     will appear.  Hilight either of the options and press ENTER.  The
  603.     print routine is "hard-wired" for an Epson graphic printer @ 12
  604.     CPI and a 10 space margin.  Use the control panel of your printer
  605.     to "force" other modes if desired.
  606.  
  607.     If a non-graphic mode is required, try running the program PRSWAP
  608.     prior to running Sounder.
  609.  
  610.  
  611.  
  612.     PRSWAP.COM
  613.     ----------
  614.  
  615.     A small file by the name of PRSWAP.COM is included.  It is
  616.     designed to allow a non-graphic printer use non-graphic
  617.     characters in lieu of graphic output.
  618.  
  619.     This program has been in the BBS domain since 1985 and has a (c)
  620.     notation by Dickenson & Associates - if anyone has knowledge of a
  621.     "doc" file for the program or information on where to contact
  622.     this company please advise.  PRSWAP has been successfully used
  623.     with an Okidata 92, Panasonic 1123 and Panasonic 1124 - NOTE:
  624.     there are no warranties of any kind, implied or expressed - use
  625.     PRSWAP.COM at your own risk.  At the dos prompt type PRSWAP to
  626.     load it.  The computer must be re-booted to unload it.  Turning
  627.     the printer off has no effect.
  628.  
  629.     Cancel the Log routine and return to the main menu by pressing
  630.     the ESC key.
  631.  
  632.  
  633.  
  634.                           Quitting the Program
  635.  
  636.  
  637.     Quit the program by selecting QUIT at the main menu and pressing
  638.     ENTER.  Pressing the F10 key while at any of the menus will also
  639.     immediately end the program and return control to the DOS prompt.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.     ═════════════════════════════════════════════════════════════════
  657.  
  658.  
  659.  
  660.  
  661.