home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / genealog / namcln20.zip / NAMCLN20.TXT < prev    next >
Text File  |  1994-02-14  |  13KB  |  282 lines

  1.  
  2.  
  3.                             NAMECLEAN
  4.                     Version 2.0, 14 Feb 1994
  5.         Copyright (c) 1992, 1993, 1994 by Jack J. Chandler
  6.  
  7. This release of NAMECLEAN has some major modifications which alter
  8. the names in your NAME2.DAT file for entries into place fields
  9. two, three, and four of your INDIV2.DAt and MARR2.DAT files.
  10.  
  11. The modifications are intended to assist you in preparing or
  12. changing your place name entry formats to meet varying requirements
  13. of 1) Publication, and 2) Submission to SLC.  An attempt was made
  14. to retain the entry format of foreign locations while making the
  15. appropriate changes to all US locations.
  16.  
  17. Options are:
  18.   1> Adding the term 'Co.' to the county name in fields
  19.      at levels two or three. Replaces the term 'County'
  20.      with the term 'Co.'.
  21.  
  22.   2> Deleting the term 'Co.','Co','Co,' or the term 'County' from
  23.      the county name in fields at levels two or three.
  24.  
  25.   3> Replacing the full state name with the two letter postal
  26.      abbreviation as contained in the 'PAF Documentation
  27.      Guidelines' 1993 edition by the Silicon Valley PAF Users
  28.      Group in name field at levels three and four.
  29.  
  30.    4> Replacing the two letter postal with the full state name
  31.       in name fields at levels three or four.
  32.  
  33.    5> Install 'USA' in level four for all United States areas
  34.       that have a valid state name or two letter code in level
  35.       three.
  36.  
  37.    6> Remove 'USA' in level four for all United States areas
  38.       that have a valid state name or abbreviation in level
  39.       three.
  40.  
  41. At any one pass three operations may be performed.  One each
  42. for Counties, States, and USA.  Prior to selecting option 7>
  43. to proceed with the processing, any of the selections may be
  44. changed.  The '*' is placed to the left of the option that is
  45. currently selected.  If an option is marked with the '*' it may
  46. be de-selected by selecting that option again or by selecting
  47. an alternate option in the same category.
  48.  
  49. Under option 1> the term 'Co.' will _not_ be added if it already
  50. exists in the selected level.  If the addition of 'Co.' to the
  51. county name exceeds the 16 character limit of PAF for names then
  52. the county name is truncated to accommodate the addition of 'Co.'
  53. without exceeding 16 characters.  If a county name is truncated
  54. during the addition of the term 'Co.' and menu option 2> is later
  55. selected to remove the term 'Co.' the county name will remain
  56. truncated.  The original county name will not be restored.
  57.  
  58. Under option 1> the term 'Co.' will not be added if there is an
  59. entry in level four other than 'USA'.  If the Burial/Christening
  60. county is in level three, then for Burials/Christenings  the 'Co.'
  61. will be added only if there is a valid state name or two letter
  62. code in level 4.
  63.  
  64. Under option 2> the term 'Co.' or the term 'County' will _not_ be
  65. deleted if it is found in the first four characters of the name in
  66. the selected level.  This is to prevent removing 'Co.' from some
  67. entries from foreign places such as 'Co. Essex' or 'Co. York'.
  68. Under option 1> the term 'Co.' would _not_ be added to these entries.
  69.  
  70. County names cannot be modified in levels 1 or 4.  County names
  71. will not be modified if a valid state name or two letter code
  72. does not exist in the level immediately following the county
  73. name.
  74.  
  75. Under option 3> the full spelling of the state name will replace
  76. the existing two letter postal abbreviation entered for US States
  77. and Territories, and for Canadian Provinces as outlined in the
  78. above cited publication.  Several of these entries will exceed
  79. the 16 character limit of PAF for names and the existing names
  80. will be truncated to allow retain a trailing nul character in the
  81. 17th name position.
  82.  
  83. State names cannot be modified in levels 1 or 2.
  84.  
  85. Under all options the normal operation of NAMCLEAN in removing
  86. unused names is preserved.
  87.  
  88. It is most probable that under most options there will be an
  89. _increase_ shown in the size of the NAME2.DAT file.  Many of the
  90. names being changed under these options are used in other name/
  91. place fields and therefore the name being changed will _not_ be
  92. deleted but the new name added. If the original unused names
  93. exceed the names added, then there should be a decrease shown
  94. otherwise an increase will be shown.
  95.  
  96. To run NAMCLN20.EXE in its usually mode without changing either
  97. county or state entries, merely select item option 7> from the
  98. menu.  Option Q> will exit the program without running.
  99.  
  100. Proper operation of NAMCLN20.EXE for desired results depends upon
  101. the strict consistency of entering names in your Individual and
  102. Marriage records.  There must be consistency in levels/fields for
  103. names in each category.  The only deviation accommodated is for
  104. the entry of place names in the burial/christening fields.  Whereas
  105. the normal location for county names and state names are in levels
  106. 2 and 3 respectively, in the burial/christening fields they may be
  107. entered in levels 3 and 4 respectively.
  108.  
  109. If level 3 is used for counties in the burial/christening fields,
  110. then the state MUST be entered in level 4.  If there is no entry
  111. in level 4 to match a state name or postal code, then there will
  112. be no action on the request for 'Co.' add or delete in that burial/
  113. christening entry.
  114.  
  115. If level 2 is used for counties in the burial/christening fields,
  116. then the rules for level 4 entries for all other event place names
  117. will apply.
  118.  
  119. For all locations within the United States, level 4 must be empty
  120. or contain 'USA'.  Any other entry in level 4 except the state
  121. entry allowed for burial/christening fields will be interpreted
  122. as a Foreign location and the requested action for the 'Co.' entry
  123. or delete will not be taken.
  124.  
  125. Full state names and/or the state postal codes as listed in the
  126. SV-PAF-UG PAF Documentation Guidlines 1993 edition is used for
  127. all state comparisons and conversions.
  128.  
  129. No 'Co.' entries are made for the state of Alaska.  Alaska has
  130. 'Boroughs' instead of 'Counties'.
  131.  
  132. Louisiana has Parishes.  The term ' Par.' is inserted/deleted for
  133. Louisiana instead of ' Co.'.  If the terms ' Parish', ' PAR', or
  134. ' Par' is in the field it will be accepted as ' Par.' and deleted if
  135. menu option 2> is selected.  If one of those terms is in the field
  136. when menu option 1> is selected it will be corrected to 'Par.'.
  137.  
  138.  
  139. No 'Co.' entries are made for the Territories however all states
  140. and territories with the exception of 'Canal Zone' will have
  141. the 'USA' inserted in level 4 if requested.
  142.  
  143. If you have a database with mixed entry levels for your christening
  144. and burials, i.e., some with counties in level2 and some with
  145. level 3, some success can be had by running the program twice.
  146. First run with counties selected in level2.  Then run with the
  147. counties in level3.  There will be a problem only in those
  148. locations where there is a county name that is the same as
  149. a state name such as Utah, UT  or New York, NY  or Nevada, CA.
  150. This should leave a smaller number of errors that running with
  151. only a one level option.  Again, the program depends upon a
  152. consistent pattern of level selections for your place names.
  153.  
  154. NAMCLN20 has been tested and found to operate as designed on a
  155. database containing consistent field level selections for the
  156. counties and states as described in the PAF users manual.
  157.  
  158. NAMCLN20 incorporates all features of versions 1.2b including
  159. the correction of the format problem with the re-entry of case
  160. changed names into the NAME2.DAT file as discussed below.  If
  161. the NAME2.DAT file is increased in size, it will report ADDED
  162. names rather than negative DELETED names.
  163.  
  164. The inclusion of these additional options in NAMCLEAN has
  165. increased the size of the file considerably and has also
  166. increased the run time.  The time now required will be from
  167. the original time required by NAMCL12  if only item 7> is
  168. selected, or up to about 200 place names/minute if all three
  169. operation options are selected.
  170.  
  171. One current 'bug' or characteristic remaining in NAMCLN20 is
  172. the inconsistent failure to process approximately 1.3% of the
  173. state names when changing the full name to the two letter code
  174. with menu