home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / genealog / pafnmls2.zip / PAFNMLS.DOC < prev    next >
Text File  |  1994-01-01  |  8KB  |  146 lines
  1.              PAFNMLS - List PAF Name File Counts - Copyright 1993, 1994
  2.                            Version 2 - January 1, 1994
  3.                                 By Mike St. Clair
  4.  
  5.    PAFNMLS prints the names in a PAF name file (NAME2.DAT)  in  alphabetical
  6.    order,  with  counts  by  field type for the number of times that name is
  7.    used in the associated PAF data files (INDIV2.DAT and MARR2.DAT).
  8.  
  9.    PAFNMLS is Freeware. This  means you are not required to pay  any license
  10.    fee to make  legal use of it but the  author  retains  ownership  and the
  11.    copyright.   PAFNMLS can be  freely  distributed  as long as no charge is
  12.    required in excess of the cost of distribution.   This file (PAFNMLS.DOC)
  13.    must be included with any copy of the program.
  14.  
  15.    There is no warranty that PAFNMLS performs any useful function.   Still I
  16.    would be  delighted to  hear if you liked it or it has  been  useful,  to
  17.    accept reports of problems and to receive suggestions for possible future
  18.    enhancements.  The program was  created to help me understand my own name
  19.    file while I was writing a column for the NGS/CIG Digest.
  20.  
  21.    There are no required  parameters.  Either copy the program (PAFNMLS.EXE)
  22.    to the  directory  that contains your PAF data or to a directory which is
  23.    included in your DOS PATH.   Then change to the directory containing your
  24.    PAF data and type the command "PAFNMLS".  The  resulting report will then
  25.    print on your printer.  You should be aware that this report can be quite
  26.    lengthy since there is one line for every name in your PAF database. Each
  27.    line in the report includes the name,  followed by the number of times it
  28.    appears  in  each  of  ten categories of name fields as follows: Surname,
  29.    three levels of first/middle name,  title, four levels of place names and
  30.    temple names.  For brief help type PAFNMLS /H or PAFNMLS /?.
  31.  
  32.    Optionally,  you  may include parameters on the command to point to a set
  33.    of PAF data files and to limit which names are to be printed based on the
  34.    number  of  times  they are used.  To point to a specific set of PAF data
  35.    files, rather than look in the current directory(the default), simply add
  36.    the directory name to the command line.  You  must specify the disk drive
  37.    as part of the path name.  For example,  if  your data is on your C drive
  38.    in the directory PAFDATA, the command you enter would be:
  39.  
  40.       PAFNMLS C:\PAFDATA\ - the trailing "\" is optional
  41.  
  42.    You may also control the names which are printed in the output report  by
  43.    specifying  "less than"  or  "greater than"  limitations.  If you want to
  44.    see all names with a count less than some limit,  add the "/LT" parameter
  45.    to your command line.  Likewise if you want to see all names with a count
  46.    greater than some limit, add the  "/GT"  parameter.  These two parameters
  47.    are mutually exclusive.  Only  the  first one specified after the command
  48.    will  be  effective  if both parameters are included on the same command.
  49.  
  50.    For example,  if you want to list only those names which occur more  than
  51.    25 times in your database use the command:  PAFNMLS /GT25.
  52.  
  53.    If  you  want to see those names which  are in NAME2.DAT but do not which
  54.    presently appear in your data files, use the command: PAFNMLS /LT1
  55.  
  56.    You  may mix one of these parameters on the same command line with a data
  57.    path name if desired.
  58.    Version 2          PAFNMLS.DOC - List PAF Name File Counts         Page 2
  59.  
  60.    Version History:
  61.  
  62.    Version 2 was released January 1, 1994.
  63.  
  64.    Additions:
  65.       New  optional parameters are /GT, /LT, /H and FilePath.   The  heading
  66.       now shows  which  directory  the  data  is  contained in and any other
  67.       parameter included on the command line.
  68.  
  69.    Errors corrected:
  70.       A  number  of  errors  from  version  one were corrected in version 2.
  71.       The report title line and the documentation were corrected.   The last
  72.       name in the  NAME2.DAT  file  is  now sorted properly.  Marriage place
  73.       names  are  now  counted  correctly.   Names in the NAME2.DAT file are
  74.       suppose to end with binary zero.  If one doesn't,  it no longer causes
  75.       the program to abort.
  76.  
  77.    Improvements:
  78.       Converted from  TurboBasic  to PowerBasic resulting in a twofold speed
  79.       improvement and the ability to handle much larger name files. The sort
  80.       now  ignores  upper and lower case.  Minor format changes were made in
  81.       both  the  printed  output  and the screen layout.  Error handling was
  82.       improved.
  83.  
  84.    Version 1 was released September 1, 1993.
  85.       This was the initial release of PAFNMLS.
  86.  
  87.    You can reach me to report success or  problems, or  make suggestions via
  88.    the following:
  89.  
  90.            CompuServe:      71522,3314
  91.            GEnie:           M.ST.CLAIR2
  92.            FidoNet NetMail: Mike Stclair at node 312/13
  93.  
  94.            As Mike Stclair on these BBS conferences:
  95.                   FidoNet   GenSoft (Genealogy Software)
  96.                   FidoNet   Genealogy
  97.                   RIME      Roots
  98.                   ILink     Genealogy
  99.  
  100.            By U.S. Mail as:
  101.                   Mike St. Clair
  102.                   327 North 800 East
  103.                   American Fork, Utah  84003
  104.  
  105.    The latest version of PAFNMLS will be found on GSDS BBSes  throughout the
  106.    country.  This version will be PAFNMLS2.ZIP  on  BBSes,  PAFNMLS2.EXE  on
  107.    GEnie, and PAFNML.ZIP on CompuServe.
  108.    Version 2          PAFNMLS.DOC - List PAF Name File Counts         Page 3
  109.  
  110.    The  following  is  an  example  of  the  printed  output report which is
  111.    produced by PAFNMLS:
  112.  
  113.    01-01-94    PAFNMLS V.2 - PAF Names with Counts by Field Type     PAGE  21
  114.             Data From Directory E:\PAFDATA\STCLAIR - Parameter /GT0
  115.  
  116.                              =====Other Names====  ====Place Names===  Temple
  117.    PAF Name         Surname  # 1  # 2  # 3  Title  # 1  # 2  # 3  # 4  Names
  118.    ================ =======  ===  ===  ===  =====  ===  ===  ===  ===  ======
  119.    Hobart           .......    1  ...  ...  .....  ...  ...  ...  ...  ......
  120.    Hochstrasser        136
  121.    Holt                  1   ...  ...  ...  .....  ...  ...  ...  ...  ......
  122.    Homer                       4
  123.    Hood River       .......  ...  ...  ...  .....    3    4  ...  ...  ......
  124.    Hopedale Cem                                      2
  125.    Hopkins               1   ...  ...  ...  .....  ...  ...  ...  ...  ......
  126.    Horace                      3
  127.    Horton                2   ...  ...  ...  .....  ...  ...  ...  ...  ......
  128.    Houston                     1    5
  129.    Howard                7     1    6    1  .....  ...  ...  ...  ...  ......
  130.    Howe                  2     1
  131.    Howes                 2   ...  ...  ...  .....  ...  ...  ...  ...  ......
  132.    Hubbard               1
  133.    Huber                 1   ...  ...  ...  .....  ...  ...  ...  ...  ......
  134.    Hubert                      1    1
  135.    Hudson                4   ...  ...  ...  .....  ...  ...  ...  ...  ......
  136.    Hueselmann            1
  137.    Huff                  4   ...  ...  ...  .....  ...  ...  ...  ...  ......
  138.    Hyrum                       1    2                1
  139.    I.               .......  ...    4  ...  .....  ...  ...  ...  ...  ......
  140.    IA                                                          6
  141.    ID               .......  ...  ...  ...  .....  ...  ...   48    2  ......
  142.    IFALL                                                                   79
  143.    II               .......  ...  ...  ...      4  ...  ...  ...  ...  ......
  144.    III                                          3
  145.    IL               .......  ...  ...  ...  .....  ...  ...   52  ...  ......
  146.