home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / private / namev303.zip / NAMEVIEW.DOC < prev    next >
Text File  |  1992-09-09  |  146KB  |  2,963 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                      -
  12.                                   /     \                           -
  13.                                 /        |                       /     \
  14.                               /                                /        |
  15.                             /                                /
  16.                           /                                /
  17.                         - - - - -          - - - - -     /
  18.                       /           \      /           \ /
  19.                      |             |/--\|             |
  20.                      |   N A M E   |    |   V I E W   | 
  21.                      |             |    |             | 
  22.                      |             |    |             | 
  23.                       \           /      \           / 
  24.                         - - - - -          - - - - -
  25.  
  26.  
  27.  
  28.                                     ver 3.03
  29.  
  30.  
  31.  
  32.  
  33.                    A Message Reader/Printer/Sorter which will
  34.  
  35.                    highlight in reverse video every occurrence
  36.  
  37.                    of every search word/name which is entered
  38.  
  39.                    in the support file search list.  Messages
  40.  
  41.                     can be printed immediately, or stored in
  42.  
  43.                       any of 20 user defined archive files.
  44.  
  45.  
  46.  
  47.                            REQUIRES DOS 2.11 OR LATER!
  48.                       Files included in NAMEVIEW version 3.03
  49.  
  50.  
  51.        NAMEVIEW.EXE      - The main program file.
  52.  
  53.        NAMEVIEW.DAT      - A sample of the type of file used to support
  54.                            NAMEVIEW.EXE.  You'll have to write your own .DAT
  55.                            file(s) or modify this one in order for the
  56.                            program to search for your list of names and
  57.                            other words.
  58.  
  59.        NAMEVIEW.DOC      - This documentation file.  Do not be intimidated
  60.                            by the size of the DOC file.  There is much more
  61.                            information in the documentation than you need to
  62.                            run the program.  The only MUST READ section is
  63.                            the chapter on Set Up.  The rest of the informa-
  64.                            tion has been made available for those who would
  65.                            like to know more about the program, its numerous
  66.                            features, and how it runs.
  67.  
  68.        DEMO.KDM          - A file included so you can immediately run a
  69.                            quick demo of NAMEVIEW.  It includes information
  70.                            on what is new for this version, a quick tutorial
  71.                            on what you need to know to use NAMEVIEW, and a
  72.                            few actual messages to let you see how NAMEVIEW
  73.                            really works.
  74.  
  75.        DEMOVIEW.BAT      - A batch file which will start NAMEVIEW and run a
  76.                            demo using the other files provided for this pur-
  77.                            pose.  Type DEMOVIEW + <ENTER> for the demonstra-
  78.                            tion.
  79.  
  80.        README.1ST        - An ASCII file containing any last minute documen-
  81.                            tation corrections or other information that you
  82.                            should be aware of (may not be present).
  83.  
  84.        TED.COM           - A simple text editor (by Tom Kihlken of PC maga-
  85.                            zine).  TED is distributed free with this package
  86.                            to make it easy to write and/or modify your NAME-
  87.                            VIEW.DAT file.  TED is not a part of the NAMEVIEW
  88.                            package.
  89.  
  90.        TED.DOC           - Documentation for the TED text editor.
  91.  
  92.  
  93.                               NAMEVIEW Documentation
  94.  
  95.        This documentation file can be easily printed by using your DOS PRINT
  96.        command.  Line your paper up so that your printer's print head is
  97.        approximately one inch down from the page perforation.  If started in
  98.        this manner, NAMEVIEW.DOC will print with one inch top and bottom
  99.        margins.
  100.                                  COPYRIGHT NOTICE
  101.  
  102.                               Copyright 1990 - 92 by
  103.  
  104.                                       Ray Cox
  105.  
  106.                                  17410 Huntersglen
  107.                               Humble, TX  77396-1622
  108.                                    713-454-6074
  109.  
  110.  
  111.        The NAMEDROP and NAMEVIEW set of programs are copyrighted and will
  112.        remain my property.  This program is not FreeWare!
  113.  
  114.        You may use, copy, and distribute the NAMEDROP and NAMEVIEW shareware
  115.        program files provided that:
  116.  
  117.             1.  ALL of the original files are included WITHOUT MODIFICATION
  118.                 when you copy and distribute the shareware version of the
  119.                 program.
  120.             2.  You do not charge for use, copying, or distribution.
  121.             3.  Registered versions of NAMEVIEW are not to be distributed,
  122.                 but backup copies may be made for your own use.
  123.  
  124.             If you find that the NAMEVIEW program is useful, saves you time,
  125.        and in general makes your message hunting easier, you can register in
  126.        one of two ways:  
  127.  
  128.        1.  You can become a life-time user for a registration fee of $10. 
  129.        This is a "paper" registration only.  The shareware version is fully
  130.        functional, so no "registered" version will be sent with a $10 regis-
  131.        tration.  
  132.  
  133.        2.  If you would like a personally serialized copy of NAMEVIEW (beg
  134.        message is also removed) then send $15 with your registration.  You
  135.        will be sent a personal copy of the latest version.  
  136.  
  137.        Either type of registration entitles you to download and use any and
  138.        all future versions which you find on your BBS system.  If you want
  139.        to upgrade to a later version of your personally serialized copy,
  140.        then send $5 for this service.  
  141.  
  142.        I have spent countless hours writing, revising, testing, documenting,
  143.        uploading, etc., this program - hours which I could have spent on
  144.        genealogy!  It is also very reasonably priced.  If you try NAMEVIEW
  145.        and decide to use it regularly, the only ethical thing to do is to
  146.        register.  Your only other choice is not to use it.
  147.  
  148.             A form is provided in Appendix E (last page of documentation)
  149.        for your convenience in registration.
  150.               NAMEVIEW BBS Message Searching/Reading/Storing Program
  151.  
  152.  
  153.                                  Table of Contents
  154.                                                                       Page #
  155.        1.  Background
  156.             a.  Glossary . . . . . . . . . . . . . . . . . . . . . . . . 3
  157.             b.  What is NAMEVIEW . . . . . . . . . . . . . . . . . . . . 4
  158.             c.  Program speed considerations . . . . . . . . . . . . . . 4
  159.  
  160.        2.  Quick Start
  161.             a.  How to run a quick demo. . . . . . . . . . . . . . . . . 6
  162.             b.  NAMEVIEW Conventions . . . . . . . . . . . . . . . . . . 7
  163.  
  164.        3.  Set Up - Preparing to Use NAMEVIEW
  165.             a.  Saving your message downloads. . . . . . . . . . . . . . 9
  166.             b.  Converting *.MSG files, Blue Wave packets, etc . . . . . 10
  167.             c.  The NAMEVIEW.DAT Data File in General. . . . . . . . . . 10
  168.             d.  NAMEVIEW.DAT file - Message Format Section . . . . . . . 11
  169.             e.  NAMEVIEW.DAT file - File Name Section. . . . . . . . . . 13
  170.             f.  NAMEVIEW.DAT File - Search List Section. . . . . . . . . 14
  171.             g.  Sample NAMEVIEW.DAT File . . . . . . . . . . . . . . . . 15
  172.             h.  NAMEVIEW.DAT File Tips . . . . . . . . . . . . . . . . . 16
  173.             i.  Floppy disk set up . . . . . . . . . . . . . . . . . . . 16
  174.             j.  Hard disk set up . . . . . . . . . . . . . . . . . . . . 17
  175.  
  176.        4.  Start Up - How to start NAMEVIEW
  177.             a.  Command Line Entries . . . . . . . . . . . . . . . . . . 18
  178.             b.  Command Line Parameters. . . . . . . . . . . . . . . . . 18
  179.             c.  Configuration Line Parameters. . . . . . . . . . . . . . 20
  180.             d.  File Menu Operation. . . . . . . . . . . . . . . . . . . 21
  181.             e.  Set Up Menu Operation. . . . . . . . . . . . . . . . . . 22
  182.  
  183.        5.  Program Operation - How to use NAMEVIEW
  184.             a.  Information Line - Action Messages . . . . . . . . . . . 23
  185.             b.  Information Line - Additional Message Lines Incication . 24
  186.             c.  Information Line - Messages Processed. . . . . . . . . . 24
  187.             d.  Information Line - Names Found . . . . . . . . . . . . . 24
  188.             e.  Information Line - Hot Key Area. . . . . . . . . . . . . 24
  189.             f.  Help System. . . . . . . . . . . . . . . . . . . . . . . 26
  190.             g.  Early Termination of Program Execution . . . . . . . . . 27
  191.             h.  Normal Program Termination . . . . . . . . . . . . . . . 27
  192.  
  193.        6.  NAMEVIEW Features
  194.             a.  Active Parameter Switching . . . . . . . . . . . . . . . 28
  195.             b.  AutoLoad Feature . . . . . . . . . . . . . . . . . . . . 28
  196.             c.  Automated Caps Lock/Num Lock Adjusting . . . . . . . . . 28
  197.             d.  Automatic DESQView Detection . . . . . . . . . . . . . . 29
  198.             e.  Book Mark Feature. . . . . . . . . . . . . . . . . . . . 29
  199.             f.  Command Line Interface . . . . . . . . . . . . . . . . . 29
  200.             g.  Custom Message Screen Colors . . . . . . . . . . . . . . 29
  201.             h.  Display Adapter Detection. . . . . . . . . . . . . . . . 30
  202.  
  203.                                           1
  204.             i.  Enhanced DAT File Capability . . . . . . . . . . . . . . 30
  205.             j.  Error Message Display. . . . . . . . . . . . . . . . . . 30
  206.             k.  Escape Key Function. . . . . . . . . . . . . . . . . . . 30
  207.             l.  Extended Keyboard Interface. . . . . . . . . . . . . . . 30
  208.             m.  Fail Safe Message Processing . . . . . . . . . . . . . . 30
  209.             n.  Floppy User Enhancement. . . . . . . . . . . . . . . . . 31
  210.             o.  Force Mono Function  . . . . . . . . . . . . . . . . . . 31
  211.             p.  Help System. . . . . . . . . . . . . . . . . . . . . . . 31
  212.             q.  Intelligent End-of-File Detection. . . . . . . . . . . . 31
  213.             r.  Line Wrap Check. . . . . . . . . . . . . . . . . . . . . 32
  214.             s.  Mark File Option . . . . . . . . . . . . . . . . . . . . 32
  215.             t.  Message Display Mode . . . . . . . . . . . . . . . . . . 33
  216.             u.  Message File Deletion Option . . . . . . . . . . . . . . 33
  217.             v.  Message Review Keys. . . . . . . . . . . . . . . . . . . 33
  218.             w.  Name(s) Found in Message Indication. . . . . . . . . . . 33
  219.             x.  NoEcho Mode. . . . . . . . . . . . . . . . . . . . . . . 34
  220.             y.  Print Device Customizing . . . . . . . . . . . . . . . . 34
  221.             z.  Print Message (using "P"). . . . . . . . . . . . . . . . 34
  222.             aa. Print Message (using "F"). . . . . . . . . . . . . . . . 34
  223.             bb. Reverse Read (Back Up) Command . . . . . . . . . . . . . 35
  224.             cc. Search List Tailoring  . . . . . . . . . . . . . . . . . 35
  225.             dd. Search Parameters  . . . . . . . . . . . . . . . . . . . 35
  226.             ee. Smart Point & Shoot Download File Selection. . . . . . . 35
  227.             ff. Sort Files:  User or Default Naming. . . . . . . . . . . 35
  228.             gg. Sort Files:  Writing to Disk . . . . . . . . . . . . . . 35
  229.             hh. Sound. . . . . . . . . . . . . . . . . . . . . . . . . . 36
  230.             ii. Special Search . . . . . . . . . . . . . . . . . . . . . 36
  231.             jj. Upper Case Check . . . . . . . . . . . . . . . . . . . . 36
  232.  
  233.        Appendix A - Ways to Write Your NAMEVIEW.DAT file
  234.             a.  Word Processing Software . . . . . . . . . . . . . . . . 38
  235.             b.  TED. . . . . . . . . . . . . . . . . . . . . . . . . . . 38
  236.  
  237.        Appendix B - Problems and Error Messages. . . . . . . . . . . . . 39
  238.             a.  Information Line Messages. . . . . . . . . . . . . . . . 39
  239.             b.  Miscellaneous Problems . . . . . . . . . . . . . . . . . 39
  240.             c.  Specific Error Messages. . . . . . . . . . . . . . . . . 40
  241.  
  242.        Appendix C - Upgrade Enhancements . . . . . . . . . . . . . . . . 42
  243.  
  244.        Appendix D - Registration and Support . . . . . . . . . . . . . . 49
  245.             a.  Registration form. . . . . . . . . . . . . . . . . . . . 50
  246.             b.  Upgrade form . . . . . . . . . . . . . . . . . . . . . . 50
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.                                           2
  258.                                ***  Background  ***
  259.  
  260.  
  261.                                      Glossary
  262.  
  263.        Current File - The file which was most recently chosen from the Smart
  264.        Point & Shoot file listing.  The full path and filename will be
  265.        displayed on both menu screens.  In addition, it will be displayed on
  266.        the Sort File List Help screen.
  267.  
  268.        Download File - a file downloaded (captured) from a BBS which con-
  269.        tains multiple messages.  Your modem software may call this a capture
  270.        file or a log file.  For maximum efficiency, select the BBS option
  271.        for continuous read while capturing the file.
  272.  
  273.        File Menu Option Screen - the first screen you see on loading NAME-
  274.        VIEW (if the AutoLoad command line parameter is not used).  This menu
  275.        is used to change directories, list and choose download files, list
  276.        and choose DAT files, toggle the AutoLoad parameter, and when ap-
  277.        plicable, delete or mark files.
  278.  
  279.        Help Screen - any of the three help screens which can be called up on
  280.        your display.
  281.  
  282.        Hit - occurs when one of your search words is found in a message that
  283.        is contained within your download file.
  284.  
  285.        Message(s) - the individual message(s) which are contained within
  286.        your download file.
  287.  
  288.        Message Format Block - a four (optionally five) line section of the
  289.        NAMEVIEW.DAT file which contains one or more filename extensions, the
  290.        First Line key word(s), the Subject Line key word(s), the Last Line
  291.        key word(s) of each message, and optionally, a Configuration Line.
  292.  
  293.        Message Screen - the screen seen while you are reading messages.  It
  294.        includes 24 lines for message viewing plus an Information Line at the
  295.        bottom.
  296.  
  297.        Message Unit - a "message" created by NAMEVIEW to contain the "Over-
  298.        flow" from a previous message which exceeded 238 lines in length.
  299.  
  300.        Program Disk - for floppy disk users; the disk on which your
  301.        NAMEVIEW.EXE and NAMEVIEW.DAT files are kept.
  302.  
  303.        Program Files -  refers collectively to NAMEVIEW.EXE and
  304.        NAMEVIEW.DAT; it does not include the download file or any of the
  305.        files written by NAMEVIEW.
  306.  
  307.        Search Name(s) - this term is synonymous with "search word(s)". 
  308.        Since NAMEVIEW was originally designed for use by genealogists, and
  309.        they are principally interested in searching for names, this term
  310.  
  311.                                           3
  312.        will occasionally be used.
  313.  
  314.        Search Word(s) - (a) word(s) from the list you create in the
  315.        NAMEVIEW.DAT file.  All messages in the download file will be search-
  316.        ed to see if they contain any of the search words.  Search word is
  317.        synonymous with search name.
  318.  
  319.        Set Up Menu Screen - seen only after a download file has been chosen
  320.        (from the File Menu Option screen or the AutoLoad feature) and if the
  321.        "X" command line parameter is not used.  This menu is used to enter
  322.        Special Search items, and to change operating parameters, if desired,
  323.        prior to searching and reading the download file.
  324.  
  325.        Sort Files - The user defined filenames which are stored in and read
  326.        from the NAMEVIEW.DAT (or NAMEVDAT.*) file(s) and assigned to the 10
  327.        Function keys (and 10 ALT + Function keys).  Individual messages are
  328.        added to these files at the user's discretion.
  329.  
  330.  
  331.                                  What is NAMEVIEW?
  332.  
  333.             NAMEVIEW is a message reader/printer/sorter combined with the
  334.        search capabilities of NAMEDROP (primarily a searching program).  It
  335.        was originally created so that genealogists could read rapidly
  336.        through large download files with the program highlighting all in-
  337.        stances of names/words contained in an essentially unlimited (in
  338.        size) search list.  NAMEVIEW is adaptable enough to be useful to
  339.        anyone who needs to search message downloads for large or small
  340.        numbers of interest items.  While using NAMEVIEW to read messages,
  341.        you can select output of individual messages to the printer, or to
  342.        any of 20 user definable Sort Files.  As program operation and
  343.        searching are quite fast, your time saved in searching for important
  344.        words/names with this program will probably be substantial.
  345.  
  346.             Simplicity of set up and use were foremost in my mind when the
  347.        program was written.  Only one support file is necessary
  348.        (NAMEVIEW.DAT, to be detailed later) regardless of the number of
  349.        message formats which will be searched.  Also, there is no practical
  350.        limit to the number of search words (also stored in the NAMEVIEW.DAT
  351.        file), so the program need only be run once for each downloaded file
  352.        to be read.
  353.  
  354.  
  355.                            Program Speed Considerations
  356.  
  357.             Speed of operation was, in most cases, the primary consideration
  358.        during the programming of NAMEVIEW.  My objective was to make use of
  359.        any time available for searching.  While you are viewing and paging/-
  360.        scrolling through an onscreen message, NAMEVIEW is rapidly scanning
  361.        ahead finding and searching the next message to be presented.  In
  362.        most cases, the search will probably be completed before you are
  363.        finished with the present message, making the next message immediate-
  364.  
  365.                                           4
  366.        ly available whenever you ask for it.
  367.  
  368.             There are, however, many variables which will affect the speed
  369.        at which NAMEVIEW will do its job.  Microprocessor speed, disk speed
  370.        (hard or floppy), the number of names in your search list, the size
  371.        of each message in your download file, and other choices that can be
  372.        made from the menu will all affect the speed of operation.  
  373.  
  374.             NAMEVIEW's work is disk intensive, as it is constantly reading
  375.        through your download file.  Thus, the biggest difference in program
  376.        speed depends on whether you are using a floppy or a hard disk sys-
  377.        tem.  
  378.  
  379.             NAMEVIEW is not a throughput program.  Once it is started, it
  380.        doesn't work steadily until it is finished.  Instead, it accepts
  381.        input from the operator as to when to continue after a message is
  382.        presented onscreen.  For this reason, no benchmark tests are really
  383.        possible.  If you have an 8088 system running at the original
  384.        4.77MHz, you may not be overly impressed with program speed.  If you
  385.        have an 8088/8086 running at 10MHz, program speed becomes more im-
  386.        pressive.  If you have an 80286 or better machine, regardless of
  387.        speed, hold on to your hat!
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                           5
  420.                                ***  Quick Start  ***
  421.  
  422.  
  423.                               How to run a quick demo
  424.  
  425.             Enough files have been included in the NAMEV###.ZIP set to
  426.        enable you to run a quick demo of the program prior to setting up
  427.        your own NAMEVIEW.DAT file.  You will need the NAMEVIEW.EXE file, the
  428.        NAMEVIEW.DAT file provided (which happens to include my own list of
  429.        names), the DEMOVIEW.BAT file, and the DEMO.KDM file (a tutorial
  430.        combined with a set of sample messages to show you what the program
  431.        will do with them).
  432.  
  433.        Floppy disk users:
  434.  
  435.             Place these four files on one disk and place the disk in drive
  436.        A.  Make sure that drive A is the default drive if you have more than
  437.        one floppy drive.  If you are looking at the DOS prompt on your
  438.        screen, merely typing "A:" (don't include the quotes, just type the
  439.        A and the colon!) followed by the <ENTER> key should do it.  See
  440.        your DOS manual for details on default drives if you have questions.
  441.  
  442.        Hard disk users:
  443.  
  444.             Place all four files in the same subdirectory on your hard disk,
  445.        then make that drive and subdirectory the current one.  If you have
  446.        questions on making subdirectories (MKDIR or MD) and/or changing
  447.        directories (CHDIR or CD), see your DOS manual.
  448.  
  449.        All users:
  450.  
  451.             Now type "DEMOVIEW" (again, don't type the quote marks, type the
  452.        word between quotes) and press <ENTER>.  A short instruction screen
  453.        will give you enough directions to get started, and then NAMEVIEW
  454.        will be loaded.  Once the Set Up menu is onscreen, you can experiment
  455.        with the menu selections if you like by pressing any highlighted
  456.        letter until the setup shows the desired options.  You can get help
  457.        by pressing "H", and in fact, most of the program's operation can by
  458.        understood by looking through the three available help screens (<Esc>
  459.        gets you out of Help).  When you are ready to start, press <ENTER>
  460.        and the demo program will begin.
  461.  
  462.             The first "message" you will see is a "what's new" rundown on
  463.        the current version.  This is followed by a tutorial section to
  464.        familiarize you with the NAMEVIEW commands.  When you have finished
  465.        with the tutorial, you will see some actual messages which will show
  466.        how NAMEVIEW's highlighting normally works.  When all messages have
  467.        been seen, the "Last Message.." action indicator will appear.  Press
  468.        the <Esc> key to exit NAMEVIEW, or "M" to go back to the "File Menu
  469.        Options" screen.  
  470.  
  471.             If you like what you saw on the demo, then continue on with the
  472.        set up chapter so you can customize the program for your own use!
  473.  
  474.                                           6
  475.                                NAMEVIEW Conventions
  476.  
  477.             This section pulls together many items which are found scattered
  478.        throughout the documentation file.  Use it to help your overall
  479.        understanding of what NAMEVIEW needs to give you the most benefit
  480.        from its features, or as a quick answer to questions which may come
  481.        up from time to time.  Information is available in more detail in the
  482.        individual sections covering these items.
  483.  
  484.  
  485.        Support Files -
  486.  
  487.             The only support file NAMEVIEW requires is NAMEVIEW.DAT.  It may
  488.             also use NAMEDROP.DAT if you have one, or you may create addi-
  489.             tional support files (usually so you can use different search
  490.             lists) using the naming convention NAMEVDAT.*.  NAMEVIEW.DAT
  491.             must be in the default drive and directory when NAMEVIEW is
  492.             started.
  493.  
  494.  
  495.        Download Files -
  496.  
  497.             You may name your download file anything you want, but it is
  498.             suggested that you use mmmdd.xxx format where mmm is a three
  499.             character month identifier, dd is a two digit day (of the month)
  500.             identifier, and xxx is a file extension which is found in at
  501.             least one of the Message Format Blocks in your support file. 
  502.             This naming convention must be used for the AutoLoad feature to
  503.             work.  If you use another naming convention, do not use the "!",
  504.             "$", or "#" characters.  NAMEVIEW needs to have these characters
  505.             reserved for its own use.  Also, filenames should not be over
  506.             seven characters long (to the left of the period), as NAMEVIEW
  507.             needs to add an additional character at times.
  508.  
  509.  
  510.        Message Format Blocks -
  511.  
  512.             These are in your support file(s) and tell NAMEVIEW how your
  513.             messages are configured.  You must have at least one, and up to
  514.             ten can be stored in each support file.
  515.  
  516.             You must have a Message Format Block listing a particular file
  517.             name extension before a file using that extension will show up
  518.             in the file list to be loaded.
  519.  
  520.  
  521.        Command Line Parameters - 
  522.  
  523.             A      =  Activate (A)utoLoad feature
  524.             Cdddd  =  Set Custom Message Screen (C)olors as specified
  525.             M      =  Force Display into (M)ono mode
  526.             Pd     =  Set (P)rint device as specified
  527.             X      =  Start reading without stopping at Set Up menu
  528.  
  529.                                           7
  530.        Configuration Line (in Message Format Block) Parameters -
  531.  
  532.             D  Display  default is - Messages containing SEARCH WORDS
  533.             U  Upper Case Check    - default is YES
  534.             L  Line Wrap Check     - default is YES
  535.             S  Sound               - default is OFF
  536.             E  NoEcho Mode         - default is OFF
  537.  
  538.             All Configuration parameters return to their defaults when a new
  539.             download file is loaded, unless a Configuration Line in the
  540.             appropriate Message Format Block dictates otherwise.
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.                                           8
  585.                    ***  SET UP - Preparing to Use NAMEVIEW  ***
  586.  
  587.  
  588.                            Saving your Message Downloads
  589.  
  590.             I will not attempt to cover the use of a modem and communica-
  591.        tions program in downloading message files.  There are, however,
  592.        certain conventions which must be followed, and others that are
  593.        recommended in order for NAMEVIEW to function correctly.
  594.  
  595.             Dial into your BBS and set your terminal program to capture (or
  596.        log) to file.  Then download your messages by using the (BBS) command
  597.        to read messages without stopping.  For ease in cataloging, it is
  598.        suggested that your capture file be named as follows:
  599.  
  600.             MMMDD.NNN    (example - JAN01.TRS)
  601.  
  602.             where - 
  603.  
  604.                  MMM  =  the first three letters of the month (i.e. JAN)
  605.                  DD   =  the two digit day of the month (i.e. 01,28, etc.)
  606.                  NNN  =  a three letter abbreviation of the conference or
  607.                          BBS from which the message file was downloaded
  608.                          (i.e. NGC for National Genealogical Conference, KDM
  609.                          for The Kingdom BBS, etc.)
  610.  
  611.             For example, a file which you download from the Kingdom BBS on
  612.        January 1, would be named JAN01.KDM.  
  613.  
  614.        NOTE:  This format is mandatory if you plan on using the Autoload
  615.        feature!  In addition, the exclamation point (!), the pound sign (#),
  616.        and the dollar sign ($) are reserved filename characters to be used
  617.        by the NAMEVIEW program only.  If you use these characters, certain
  618.        NAMEVIEW features will be negated, and the program's usefulness to
  619.        you will be greatly reduced.
  620.  
  621.             If you don't ever plan on AutoLoading, then the format described
  622.        above is not mandatory, as any filename will work.  It will, however,
  623.        reduce confusion and help catalog your downloads.  
  624.  
  625.             If you choose to use another filename format, it is recommended
  626.        that the length of your filename (the portion to the left of the
  627.        "period") be restricted to seven characters or less.  Certain fea-
  628.        tures of NAMEVIEW cause download file names to be changed by the
  629.        addition of a character.  If your filename is eight characters long,
  630.        the eighth character is replaced with NAMEVIEW's special character. 
  631.        When other NAMEVIEW features remove the extra character, NAMEVIEW
  632.        does not replace the originally deleted eighth character.  
  633.  
  634.             The filename extension (portion to the right of the "period") is
  635.        the one place where you must be consistent.  The extension that you
  636.        use MUST be found in the first line of one of the "message format
  637.        blocks" (see the next section for details) stored in the NAMEVIEW.DAT
  638.  
  639.                                           9
  640.        file.  Otherwise, NAMEVIEW will not show the file in the selection
  641.        list, and you will not be able to read it.
  642.  
  643.  
  644.                      Converting *.MSG files and Other Formats
  645.  
  646.             If you download messages as a "point" or via a "mail handler"
  647.        then your messages may be saved individually in *.MSG or similar
  648.        format, or in a special continuous format such as a QWK packet. 
  649.        NAMEVIEW will not work on files saved in these special formats, but
  650.        several programs are available which will convert them to a con-
  651.        tinuous ASCII format file which is compatible with NAMEVIEW.  The
  652.        following programs have not been tested by me, but the information
  653.        listed has been taken from message traffic describing their use:
  654.  
  655.             Program      Use
  656.             --------     -------------------------------------------------
  657.             SAVECHO      combines *.MSG files into 1 continuous ASCII file
  658.             Mexport      combines *.MSG files into 1 continuous ASCII file
  659.             B2T          converts BlueWave packets to continuous text
  660.             QWKTXT40     converts QWK packets to continuous text
  661.             HARDCOPY     (unknown - but designed for NAMEVIEW compatibility)
  662.  
  663.  
  664.                        The NAMEVIEW.DAT Data File in General
  665.  
  666.             In discussing the NAMEVIEW.DAT file, all items apply to any
  667.        support file which you create for use with NAMEVIEW.  There is no
  668.        limit to the number of support files you can create and use with
  669.        NAMEVIEW.  The only requirement is that additional support files must
  670.        follow the naming scheme of NAMEVDAT.*.  You can use anything you
  671.        like for a file extension, but a numbering (NAMEVDAT.1, NAMEVDAT.2,
  672.        etc.) or lettering (NAMEVDAT.A, NAMEVDAT.B, etc.) system is recom-
  673.        mended for easier cataloging.  Support files in general will be
  674.        referred to as DAT files, even though your file name extension may be
  675.        other than DAT.
  676.  
  677.             NAMEVIEW.DAT begins with an optional Comment Line.  If this
  678.        Comment Line is included, it must begin with the "@" character, so
  679.        NAMEVIEW will recognize it as a comment, and consist of no more than
  680.        78 characters.  When the DAT file list is onscreen, this comment may
  681.        be displayed for the DAT file which is highlighted by pressing "R"
  682.        (Remark).
  683.  
  684.             After the optional Comment Line, the NAMEVIEW.DAT file consists
  685.        of three sections:  the Message Format section, the File Name sec-
  686.        tion, and the Search List section.  Users of NAMEDROP, who have
  687.        already made a NAMEDROP.DAT file, will find that the formats are very
  688.        similar.  The only differences between the two are the addition of an
  689.        optional Configuration Line in each Message Format Block, and the
  690.        File Name section in the NAMEVIEW.DAT file.  In fact, if NAMEVIEW
  691.        cannot find a NAMEVIEW.DAT file, it will automatically look for a
  692.        NAMEDROP.DAT file and use it if it is available!  If you add a File
  693.  
  694.                                          10
  695.        Name section to a NAMEDROP.DAT file, it can be used by both NAMEDROP
  696.        and NAMEVIEW (NAMEDROP will ignore the File Name section).  
  697.  
  698.             Perhaps the easiest way to make your personalized NAMEVIEW.DAT
  699.        file, once you have read over the following instructions, would be to
  700.        load the NAMEVIEW.DAT file provided with the demo and simply make any
  701.        necessary changes.  Several message format blocks are included in the
  702.        sample, and chances are that one of them will work with the message
  703.        format your BBS uses.
  704.  
  705.  
  706.                     NAMEVIEW.DAT File - Message Format Section
  707.  
  708.             The Message Format section is composed of one or more (max of
  709.        10) Message Format Blocks.  If you download messages from only one
  710.        conference or one BBS, or if all of your download files will have the
  711.        same format, regardless of source, then you may need only one message
  712.        format block.  Multiple message format blocks are necessary only if
  713.        you download messages of more than one format, or if you desire
  714.        different configurations, as defined in the Configuration Line (we're
  715.        coming to that!), for different files.  In this case, a separate
  716.        message format block is needed for each different format.  
  717.  
  718.             The first line of your NAMEVIEW.DAT file (other than a Comment
  719.        Line) will be the first line of your first (and possibly only) Mes-
  720.        sage Format Block.  The first line of a Message Format Block lists
  721.        the filename extension(s) which you use for message download files
  722.        which are formatted in accordance with that message format block.  
  723.  
  724.        A complete Message Format Block (MFB) is composed as follows:
  725.  
  726.        Sample MFB      Explanation (NOT part of the NAMEVIEW.DAT file!)
  727.        ------------    ------------------------------------------------
  728.        TRS             - the filename extension(s) using this format block
  729.        From:           - First Line key word (or group of characters)
  730.        Subject:        - Subject Line key word (or group of characters)
  731.         * Origin:      - Last Line key word (or group of characters)
  732.        DULSE           - Configuration Line (optional)
  733.        ~               - separates multiple message format blocks (use ^ to
  734.                          start filename section if only one message format
  735.                          block is used)
  736.  
  737.             Your First Line key word should be a word (or group of charac-
  738.        ters) which is consistently found at the beginning (on the leftmost
  739.        side of the top line) of each message contained in your download
  740.        file.  This entry is used by NAMEVIEW to determine the beginning of
  741.        each message in turn to be searched.  Some typical First Line key
  742.        words are:  "From:", "Message #:", "Date:", "Msg #:"
  743.  
  744.             Your Subject Line key word should be a word (or group of charac-
  745.        ters) which is consistently found at the beginning of the line that
  746.        states the subject of each message.
  747.  
  748.  
  749.                                          11
  750.             Your Last Line key word should be a word (or group of charac-
  751.        ters) which is consistently found on the leftmost side of the last
  752.        line of each message contained in your download file.  This entry is
  753.        used by NAMEVIEW to determine the end of each message being searched. 
  754.        Although the line found containing your Last Line key word is not
  755.        searched, this line is written to any Sort files chosen, is printed
  756.        if either Print option is chosen, and is shown onscreen, if appli-
  757.        cable.
  758.  
  759.             The Configuration Line is optional and can contain as many or as
  760.        few (or none!) of the letters D, U, L, S, and E as you desire.  Any
  761.        letter placed on a Configuration Line will cause the parameter con-
  762.        trolled by that letter (covered in the Configuration Line Parameters
  763.        section) to be toggled to the opposite of the default setting when a
  764.        file with an extension listed in that same Message Format Block is
  765.        loaded.  See the Configuration Line Parameters section for more
  766.        details about the use of these settings.
  767.  
  768.             Filename extension(s) (on the first line of each Message Format
  769.        Block) must be in UPPER case.  Upper and lower case MUST BE ACCURATE
  770.        when entering the rest of your message format block information.
  771.  
  772.        NOTE:  If your downloaded messages have NO key word which consistent-
  773.        ly appears on the leftmost side of the last line of each message,
  774.        then leave a blank line (with NO spaces) for the Last Line key word. 
  775.        In this case, you will have to run NAMEVIEW with NoEcho mode toggled
  776.        ON while reading download files which use this Message Format Block.
  777.  
  778.        NOTE:  The entry for "Last Line key word" (" * Origin:" in sample
  779.        above) must be entered EXACTLY as it appears in your messages.  YOU
  780.        MUST INCLUDE ANY LEADING SPACES, IF ANY, WHICH APPEAR ON THIS LINE.
  781.        If NO leading spaces precede your key word, then DON'T include them. 
  782.        NAMEVIEW will not be able to correctly identify individual messages
  783.        if this is not done. 
  784.  
  785.        NOTE:  Although the term "key word" is used in the descriptions of
  786.        the parameters discussed above, do not be misled.  It is not neces-
  787.        sary for these "key words" to end with a space character or to con-
  788.        sist of a complete word (some users have been under the impression
  789.        that the space was necessary so NAMEVIEW would recognize the "key
  790.        word" as a stand-alone word).  If your "key words" end with a colon,
  791.        as most of them do, then using the colon character as the last char-
  792.        acter of your "key word" will work fine.  Using as many characters as
  793.        consistently appear at the end of each message will improve NAME-
  794.        VIEW's accuracy in defining message separation.
  795.  
  796.             Enter up to ten message format blocks as necessary for your
  797.        needs.  Use a single tilde (~) on a line by itself to separate the
  798.        preceding message format block from the next message format block.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.                                          12
  805.                        NAMEVIEW.DAT File - File Name Section
  806.  
  807.             The second section of the NAMEVIEW.DAT file is the File Name
  808.        section.  A single caret (^) on a line by itself signals the end of
  809.        the Message Format Block section and the start of the File Name
  810.        section (the caret should be in between your last Message Format
  811.        Block and the first file name you wish to assign).  You can enter up
  812.        to 20 file names, which will be assigned to function keys 1 - 10 and
  813.        then to ALT + function keys 1 - 10 in the order in which they are
  814.        found in the .DAT file.  The file name section is composed as fol-
  815.        lows:
  816.  
  817.        Sample Block    Explanation (NOT part of the NAMEVIEW.DAT file!)
  818.        ------------    ------------------------------------------------
  819.        ^               - signals start of file name section 
  820.        C:\NGC\SENT     - first file name  (assigned to F1) 
  821.        A:RECEIVED      - second file name (assigned to F2)
  822.        TO_CHECK        - third file name  (assigned to F3)
  823.        TO_ANSER.       - fourth file name (assigned to F4)
  824.        GENERAL.DAT     - last file name   (assigned to F5, as 5th filename) 
  825.        ~~              - signals end of File Name section and start of name
  826.                          (search) list section 
  827.  
  828.             If you enter file names without an extension, as in the first
  829.        three file names in the example above, NAMEVIEW will automatically
  830.        add the extension "NMV" (NaMeView).  If you would prefer not to have
  831.        the default extension added, simply end your file name with a period,
  832.        as in the fourth file name assigned above (TO_ANSER.).  If you want
  833.        your own extension on your file name, simply enter the full file name
  834.        + extension, and NAMEVIEW will assign your full file name, as in
  835.        "GENERAL.DAT" above.
  836.  
  837.             In the above example, only five file names are assigned from the
  838.        DAT file, but the first 10 functions keys will all be assigned a file
  839.        name.  If you enter any number of file names less than 10, the re-
  840.        maining file names (up to a total of 10) will be assigned the program
  841.        default names of the function key pressed + the extension "NMV".  
  842.  
  843.             Notice also that full drive and path specifications can be given
  844.        as well as file names.  Any file name entered without a path will be
  845.        written to the default drive and subdirectory, but any file name
  846.        entered with a [drive][path] will be written to in accordance with
  847.        those directions.  Your file name entries can be checked at any time
  848.        by calling the (Filename) Help Screen.  All file names are shown in
  849.        their complete format (the last 24 characters are shown, if your
  850.        entries are longer than that) on the NAMEVIEW Filename Help page (see
  851.        Help section for details).
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.                                          13
  860.             With a File Name section in your NAMEVIEW.DAT file as described
  861.        above, file names would be assigned to the 10 function keys as fol-
  862.        lows:
  863.  
  864.        F1 -  C:\NGC\SENT.NMV  (default extension added)
  865.        F2 -  A:RECEIVED.NMV   (default extension added)
  866.        F3 -  TO_CHECK.NMV     (default extension added)
  867.        F4 -  TO_ANSER.        (no extension added - suppressed with period)
  868.        F5 -  GENERAL.DAT      (your extension added, as it was specified)
  869.        F6 -  F6.NMV           (default filenames and extension used for
  870.        F7 -  F7.NMV            remainder of files, as no more filenames
  871.        F8 -  F8.NMV            were specified)
  872.        F9 -  F9.NMV
  873.        F10 - F10.NMV
  874.  
  875.  
  876.                       NAMEVIEW.DAT File - Search List Section
  877.  
  878.             The last section of the .DAT file is your search list.  The end
  879.        of the File Name section and the start of the Search List is signaled
  880.        by a double tilde (~~) on a line by itself.  Each search list item
  881.        (or name) is placed on a separate line.  Search words may consist of
  882.        any sequence of characters (letters, numbers, and punctuation) which
  883.        you wish to find.  Search words may be entered in UPPERCASE, lower
  884.        case, or MiXeD Case, as only the sequence of characters is important. 
  885.        There is no practical limit on the length of a search word, and there
  886.        is no practical limit on the number of search words in your list.
  887.  
  888.             More than one word can be entered on the same line as a single
  889.        search list item.  For example, if you use Family Roots software, and
  890.        would like to be shown all instances of "Family Roots" as you read
  891.        messages, then "Family Roots" (without the quote marks, of course)
  892.        should be entered on a line by itself.  
  893.  
  894.        NAMEVIEW is not confused with multiple occurrences of the same search
  895.        word in separate entries.  In other words, you can have the following
  896.        entries in your search list without causing problems:
  897.  
  898.             North
  899.             South
  900.             North Carolina
  901.             South Carolina
  902.             Carolina
  903.             Virginia
  904.             West Virginia
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.                                          14
  915.                              Sample NAMEVIEW.DAT File
  916.  
  917.             In order to clarify the above separate examples, a complete
  918.        (almost) NAMEVIEW.DAT file is given below:
  919.  
  920.        NAMEVIEW.DAT    Explanation (NOT part of the NAMEVIEW.DAT file)
  921.        ------------    ------------------------------------------------
  922.        @Sample comment     - Comment line (optional, up to 78 characters)
  923.        TRS PAS KDM     \     (notice that more than one file name extension
  924.        From:             \    may be included in a MFB)
  925.        Subject:            -  First Message Format block
  926.         * Origin:        /
  927.        D               /   - (Configuration Line)
  928.        ~                   -  Divider for additional format block
  929.        HPC             \
  930.        Msg #:            \
  931.        Topic:              -  Second Message Format block
  932.         * Origin         /
  933.        U               /   - (Configuration Line)
  934.        ~                   -  Divider for additional format block
  935.        EDH MSC         \
  936.        Message #:        \
  937.        Subject:            - Third Message Format block
  938.         * Origin:        /   (contains NO Configuration Line)
  939.        ^                   - signals start of File Name section 
  940.        SENT            \
  941.        RECEIVED          \
  942.        TO_CHECK            - File Name section
  943.        TO_ANSER.         /
  944.        GENERAL.DAT     /
  945.        ~~                  - signals start of Name List section 
  946.        Archer          \
  947.        Atwood            \
  948.        .                   - Name List (Search List) section
  949.        .                 /
  950.        .               /
  951.        .     (names until list is completed - no end marker required!) 
  952.  
  953.  
  954.        NOTE:  In the above example, the AutoLoad feature (to be described in
  955.        detail later) would initially load a file with the extension TRS. 
  956.        Successive attempts to AutoLoad files would search for files with
  957.        extensions of PAS, KDM, HPC, EDH, and MSC (in that order).
  958.  
  959.             When you have completed your NAMEVIEW.DAT file, save it in ASCII
  960.        format.  See Appendix A, "Ways to Write Your NAMEVIEW.DAT File" for
  961.        help in doing this if you have questions.
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.                                          15
  970.                               NAMEVIEW.DAT File Tips
  971.  
  972.             If you have a name with several spelling variations (for ex-
  973.        ample, BASYE, BASEE, & BASEY) you can easily put all variations in
  974.        your search list, as the number of entries is essentially unlimited. 
  975.        By doing so, you'll catch a message containing your name regardless
  976.        of which version the originator used.  Although there is no real
  977.        reason to do so, I put all of the primary spellings of my names at
  978.        the beginning of my list.  The secondary spellings are started when I
  979.        have finished entering all of my primary ones.
  980.  
  981.             Entering just the root of a name will probably result in no
  982.        finds at all.  If you tried to cover the three variations given above
  983.        on BASYE by using BAS as one of the search items, your search would
  984.        be unsuccessful.  NAMEVIEW does not find imbedded words (example:  it
  985.        will not find "the" in "theatre").  A "hit" is made only when it is a
  986.        stand-alone word.
  987.  
  988.             Other items you may want to consider putting in your search
  989.        list are county names, city names, the name and/or abbreviation of
  990.        your favorite genealogy program, and things like LDS.  If there is
  991.        anyone on your echo who's messages are always of interest to you, put
  992.        their full BBS name in your search list.  If you like to read mes-
  993.        sages addressed to ALL, then figure out the spacing which will appear
  994.        on your messages' TO line.  For example, you would enter something
  995.        like "To:    ALL" in your search list.
  996.  
  997.             Beware of search words which may turn out to be a nuisance.  For
  998.        example, I have the names "Page" and "North" in my list.  Every time
  999.        there is a reference to a page number, or North Carolina, etc. I get
  1000.        a hit during my search.  Even when I check for uppercase (see fea-
  1001.        tures section), there are still many useless hits on the Page (for
  1002.        obvious reasons) name.  It's up to you to decide if a name like that
  1003.        is important enough to keep in your list.
  1004.  
  1005.             See the Search Parameters description in the Features chapter
  1006.        for information which may give you additional ideas on what needs to
  1007.        be included in your search list.
  1008.  
  1009.             If you have only one Message Format Block, including NMV (or the
  1010.        extension you choose to use with your sort file names) in the first
  1011.        line will enable you to use NAMEVIEW to read any of the Sort Files
  1012.        which you save to.
  1013.  
  1014.  
  1015.                                 Floppy Disk Set Up
  1016.  
  1017.             NAMEVIEW works fine on a floppy disk system, but there will be
  1018.        limitations on the size of the download file that can be handled due
  1019.        to the limited capacity of a floppy disk.
  1020.  
  1021.             If you have two floppy disk drives, one drive can be used ini-
  1022.        tially to load the program.  The same drive can then be used to read
  1023.  
  1024.                                          16
  1025.        your download file, and the second can be used to write your Sort
  1026.        files (specify the correct drive when entering file names in your
  1027.        .DAT file).
  1028.  
  1029.             In any floppy configuration, your floppy drive light will prob-
  1030.        ably seem to light up at unusual times.  This is normal, as the
  1031.        program will be continuously reading and searching for the next
  1032.        message until it is found and readied.
  1033.  
  1034.  
  1035.                                  Hard Disk Set Up
  1036.  
  1037.             NAMEVIEW works best on a hard disk system due to the speed ad-
  1038.        vantage and the numerous ways in which the files can be set up.  The
  1039.        simplest set up is for all files to be in the same directory.  If you
  1040.        desire, the program, DAT, download, and sort files can all be in
  1041.        separate directories, depending on how you like to manage your hard
  1042.        disk.  
  1043.  
  1044.        NOTE:  The only hard set up requirement is that your NAMEVIEW.DAT
  1045.        file MUST be in the default drive and directory when you start NAME-
  1046.        VIEW.  NAMEVIEW will not search your DOS path until it finds your
  1047.        NAMEVIEW.DAT file!
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.                                          17
  1080.                     ***  Start Up - How to start NAMEVIEW  ***
  1081.  
  1082.  
  1083.                                Command Line Entries
  1084.  
  1085.             To start NAMEVIEW from your DOS prompt simply type:
  1086.  
  1087.                  [drive][path]NAMEVIEW <ENTER>
  1088.  
  1089.             No additional parameters are required to start the program.  The
  1090.        drive and path parameters are only necessary if you wish to load
  1091.        NAMEVIEW from other than the default drive and/or directory.  This
  1092.        could also be done via your DOS PATH command if you prefer.  Addi-
  1093.        tional command line parameters MAY be added if you desire.  Consult
  1094.        the "Command Line Parameters" section for details.
  1095.  
  1096.             At this point NAMEVIEW will load and commence.  If a
  1097.        NAMEVIEW.DAT or NAMEDROP.DAT file cannot be found, then the program
  1098.        will produce an error message and stop.  See Appendix B for explana-
  1099.        tions of all possible error messages.
  1100.  
  1101.  
  1102.                               Command Line Parameters
  1103.  
  1104.             After you have run NAMEVIEW several times, you might wish to
  1105.        customize certain aspects of its operation.  This can be done by
  1106.        including certain parameter characters on the command line when you
  1107.        start NAMEVIEW.  Automatic repetition of these characters can be
  1108.        accomplished via your menu program or a simple batch file.  
  1109.  
  1110.             To enter your customizing changes on the command line, type a
  1111.        space after "NAMEVIEW" and then type the appropriate characters (case
  1112.        does not matter).  Using the menu letters on the command line will
  1113.        take the configuration out of its default mode the same as if you had
  1114.        pressed the letter once when stopped at the NAMEVIEW menu.  If you
  1115.        want a particular feature to run in the default mode, then don't
  1116.        include that menu letter on the command line.  
  1117.  
  1118.        Allowable Command Line entries are as follows:
  1119.  
  1120.             A      =  Activate (A)utoLoad feature
  1121.             Cdddd  =  Set Custom Message Screen (C)olors as specified
  1122.             M      =  Force Display into (M)ono mode
  1123.             Pd     =  Set (P)rint device as specified
  1124.             X      =  Start reading without stopping at Set Up menu
  1125.  
  1126.             In order for the AutoLoad feature to work, the following condi-
  1127.        tions must be met:
  1128.  
  1129.             1.  The "A" parameter must be specified in the command line or
  1130.                 you must toggle AutoLoad ON at the "File Menu Options" menu.
  1131.  
  1132.             2.  Your system (DOS) calender must be correctly set (NAMEVIEW
  1133.                 uses the current system date to formulate the filename to
  1134.                 search for).
  1135.  
  1136.                                          18
  1137.             3.  The file name extension(s) of the file(s) you wish to Auto-
  1138.                 Load must be found in the current DAT file.
  1139.  
  1140.             4.  There must be at least one download file in the current
  1141.                 drive and directory named in accordance with the method
  1142.                 described in the "Saving your Message Downloads" section
  1143.                 (mmmdd.ext) with a name reflecting the current date.
  1144.  
  1145.             Custom Message Screen Colors are set with the "Cdddd" command
  1146.        line entry where "dddd" consists of 2 two-digit number entries.  The
  1147.        first two digits following the "C" specify the foreground color
  1148.        (color of the actual characters themselves) to be used.  The last two
  1149.        digits specify the background color (space surrounding the actual
  1150.        characters) to be used.  These colors are reversed to create the
  1151.        highlighted parts of your messages.  
  1152.  
  1153.        Enter numbers as follows to customize your Message Screen:
  1154.  
  1155.            Color Number     Foreground Color       Background Color
  1156.                 00               Black                  Black
  1157.                 01               Blue                   Blue
  1158.                 02               Green                  Green
  1159.                 03               Cyan                   Cyan
  1160.                 04               Red                    Red
  1161.                 05               Magenta                Magenta
  1162.                 06               Brown                  Brown
  1163.                 07               White                  White
  1164.                 08               Gray                   Black
  1165.                 09               Bright Blue            Blue
  1166.                 10               Bright Green           Green
  1167.                 11               Bright Cyan            Cyan
  1168.                 12               Bright Red             Red
  1169.                 13               Bright Magenta         Magenta
  1170.                 14               Yellow                 Brown
  1171.                 15               Bright White           White
  1172.  
  1173.             Notice that "bright" colors are only available for foreground
  1174.        colors.  However, if the numbers 08 - 15 are used to specify the
  1175.        background color, high intensity characters will appear when the
  1176.        colors reverse temporarily for highlighting.  If you specify numbers
  1177.        other than those given in the chart above, NAMEVIEW will refuse to
  1178.        process them and revert to the default (Cyan letters, black back-
  1179.        ground) settings.
  1180.  
  1181.        NOTE:  Enter numbers exactly as shown.  BOTH digits must be specified
  1182.        for each color (include leading zeros)!  Otherwise, NAMEVIEW will
  1183.        probably ignore your settings!
  1184.  
  1185.             The Print device may be customized with the "Pd" entry, where
  1186.        "d" is a single digit specifying the number of the LPT device to be
  1187.        used.  If, for example, your entry is "P2" then all print requests
  1188.        will be made to LPT2.  If no entry is made, the default LPT1 is used.
  1189.  
  1190.             Notice that the last command line letter entry will allow the
  1191.        program to bypass the Set Up Menu without the requirement for user
  1192.  
  1193.                                          19
  1194.        input from the keyboard.  If no "X" is present in the command line,
  1195.        the program will make its normal pause at the menu.
  1196.  
  1197.             For multiple command line entries, merely type all of the de-
  1198.        sired parameter letters one after the other without separating them
  1199.        with spaces or punctuation.  Command line letters can be entered in
  1200.        any order.
  1201.  
  1202.        Example:  entering the following on the command line - 
  1203.  
  1204.          NAMEVIEW AP2C1402X
  1205.  
  1206.        would load NAMEVIEW, activate the AutoLoad feature, set the printer
  1207.        option to LPT2, set Message Screen colors to Yellow on Green, and
  1208.        bypass the Set Up Menu.  Providing that the AutoLoad feature found a
  1209.        file name reflecting the current date, NAMEVIEW would load that file
  1210.        (bypassing the File Menu), bypass the Set Up menu, and go directly to
  1211.        the Message screen, which would be the first thing you would see!
  1212.  
  1213.  
  1214.                            Configuration Line Parameters
  1215.  
  1216.             Configuration Line parameters are the same as those items which
  1217.        appear on the Set Up menu for you to toggle ON/OFF or YES/NO.  They
  1218.        include Message Display (ALL or Messages Containing Search Words),
  1219.        Line Wrap Check, Upper Case Check, NoEcho Mode, and Sound.  Downloads
  1220.        from different BBS systems and different echos may require different
  1221.        parameter settings based on your needs and wishes.
  1222.  
  1223.             NAMEVIEW operation can be further customized/automated by in-
  1224.        cluding Configuration Lines in the Message Format Blocks of your DAT
  1225.        files.  Configuration Lines may contain any or all of the characters
  1226.        D, U, L, S, and E.  When a file is AutoLoaded, or you choose a file
  1227.        from the Smart Point and Shoot File Selection menu, that file's
  1228.        extension dictates which Message Format Block is selected for message
  1229.        formatting.  If Configuration Line information is included in the
  1230.        selected Message Format Block, it will be used to automatically set
  1231.        the Configuration Line/SetUp menu parameters.
  1232.  
  1233.             Each time a new download file is loaded, any parameters not
  1234.        included in the Configuration Line will be set to their defaults.  If
  1235.        no parameters are found, all settings will return to their defaults. 
  1236.        If you return to the Set Up menu via the File Selection menu without
  1237.        selecting a new download file, no changes to Configuration Line
  1238.        parameters are made.  This lets you retain any interim changes you
  1239.        might have made and wish to repeat until you change files.  The
  1240.        Special Search parameter is always retained, regardless of any of the
  1241.        previous conditions.  These parameters, regardless of how they were
  1242.        initially set, can always be changed while stopped at the Set Up menu
  1243.        or while reading messages.
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.                                          20
  1251.             The default settings for Configuration Line/Set Up menu parame-
  1252.        ters are as follows:
  1253.  
  1254.             Display          - Messages containing SEARCH WORDS
  1255.             Upper Case Check - YES
  1256.             Line Wrap Check  - YES
  1257.             NoEcho Mode      - OFF
  1258.             Sound            - OFF
  1259.  
  1260.        When the following letters are included in Configuration Lines, the
  1261.        associated actions are accomplished:
  1262.  
  1263.             D     =  Display ALL messages
  1264.             U     =  Upper case check will NOT be done
  1265.             L     =  Line Wrap Check turned OFF
  1266.             S     =  Sound will be turned ON
  1267.             E     =  NoEcho Mode Activated
  1268.  
  1269.             The current settings of these parameters are displayed on the
  1270.        Information line while reading messages.
  1271.  
  1272.  
  1273.                                 FILE MENU Operation
  1274.  
  1275.             After a few moments to load, the NAMEVIEW File Menu will appear. 
  1276.        This menu allows you to select the drive and/or path for your down-
  1277.        load or DAT file listing, list files in the default (or optionally
  1278.        selected) drive and directory (Smart Point & Shoot), list DAT files
  1279.        in the default (or optionally selected) drive and directory, toggle
  1280.        the AutoLoad parameter, mark the current file, and delete the current
  1281.        file.  In addition, pressing <Esc> will allow you to exit NAMEVIEW,
  1282.        if desired, even though this option does not appear onscreen.  All
  1283.        menu features are activated by pressing the highlighted letter as-
  1284.        sociated with the feature.  See the features section for full details
  1285.        on all of the menu items.  
  1286.  
  1287.             The Mark file and Delete file options will not be available
  1288.        unless the current file has already been read during the current
  1289.        session.  Additionally, these options are not available when the
  1290.        current file has been "Book Marked."  You will be asked to verify
  1291.        these two selections for safety before action is taken.
  1292.  
  1293.             When the (L)ist Files feature is selected, NAMEVIEW shows you
  1294.        its Smart Point and Shoot file list.  Use the Up and Down arrows to
  1295.        highlight the desired file, then press ENTER to select it.
  1296.  
  1297.             When the (S)elect New DAT File feature is selected, NAMEVIEW
  1298.        shows you all of the NAMEVDAT.* files which it finds in the default
  1299.        or optionally selected drive and directory.  Use the Up and Down
  1300.        arrows to highlight the desired support file, then press ENTER to
  1301.        select and load it.  For any highlighted file, pressing "R" will show
  1302.        the first line remark on screen, if present.  See the "The
  1303.        NAMEVIEW.DAT Data File" section for details on entering a remark.
  1304.  
  1305.  
  1306.  
  1307.                                          21
  1308.             To quickly reselect your default path after initially making a
  1309.        change, press "P" followed immediately by <ENTER> (make a null en-
  1310.        try).
  1311.  
  1312.             The AutoLoad feature can be toggled ON or OFF at any time. 
  1313.        NAMEVIEW will attempt to perform an AutoLoad any time this feature is
  1314.        changed to an ON setting.  If this parameter is left ON, successive
  1315.        AutoLoads are automatically attempted whenever a return to this menu
  1316.        is accomplished and the current file is "marked" or deleted, or if a
  1317.        new DAT file is loaded.
  1318.  
  1319.             You cannot proceed beyond the File Menu until a download file
  1320.        has been chosen.  Once this has occurred, the "<ENTER> for Set UP"
  1321.        prompt will appear at the bottom of the menu.  Press ENTER to con-
  1322.        tinue to the SET UP Menu.  You will be able to return to the File
  1323.        Menu (to select additional files!) at any time from the Message
  1324.        screen by pressing "M"(enu).
  1325.  
  1326.             If you included the AutoLoad parameter on the command line, and
  1327.        the AutoLoad feature found a file to load, the File Menu will be
  1328.        bypassed on initial program start up.  Even if initially bypassed,
  1329.        the File Menu can still be called from the Message screen as pre-
  1330.        viously mentioned.
  1331.  
  1332.  
  1333.                                SET UP MENU Operation
  1334.  
  1335.             The Set UP Menu allows you to change any of NAMEVIEW's operating
  1336.        parameters and optionally to select a Special Search item.  As with
  1337.        the File Menu, options are selected or toggled by pressing the high-
  1338.        lighted key associated with the feature.  <Esc> will allow program
  1339.        termination if desired.
  1340.  
  1341.             The "Find Book Mark" parameter is available (and visible) only
  1342.        if you selected a "Book Marked" file.  If this is the case, the "Find
  1343.        Book Mark" parameter is then automatically set to YES, but can be
  1344.        changed at your discretion.
  1345.  
  1346.             If the "X" command line parameter is used, the Set Up Menu will
  1347.        be bypassed on initial load up.  If additional download files are
  1348.        selected for reading, the Set Up menu will then be available for use.
  1349.  
  1350.             All parameter settings return to their default settings whenever
  1351.        a new download file is selected.  Settings can be automated by in-
  1352.        cluding Configuration Lines in the Message Format Blocks of your DAT
  1353.        file(s).
  1354.  
  1355.             Help is available from the Set Up Menu screen (or any time you
  1356.        are reading messages) by pressing "H".  
  1357.  
  1358.             When you are finished toggling your Set Up Menu selections,
  1359.        press <ENTER> to exit the menu and begin reading messages.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.                                          22
  1365.                  ***  Program Operation - How to use NAMEVIEW  ***
  1366.  
  1367.  
  1368.             Once <ENTER> is pressed at the Set Up menu, NAMEVIEW will switch
  1369.        to the Message Screen, start searching, and present messages onscreen
  1370.        for you to read.  An Information Line will always be present at the
  1371.        bottom of the screen to keep you informed of program progress, ac-
  1372.        tions, available hot keys, and possibly error messages.  A key to the
  1373.        information line is available as one of the Help screens.  The fol-
  1374.        lowing sections are given as full descriptions of the individual
  1375.        Information Line features.
  1376.  
  1377.  
  1378.                         Information Line - Action Messages
  1379.  
  1380.             The first section of the Information Line presents several
  1381.        Action Messages which describe what the program is doing.  A descrip-
  1382.        tion of the Action Messages can be reviewed at any time by pressing
  1383.        "H" for the Help section.  Then PgUp or PgDn until you find the
  1384.        "NAMEVIEW Information Line" Help page.  
  1385.  
  1386.        Action Message              Description
  1387.        --------------              ----------------------------------------
  1388.        Searching...                NAMEVIEW is finding and preparing the
  1389.        (steady)                    next message.  This is the normal message
  1390.                                    which appears immediately after a new
  1391.                                    message is shown onscreen.
  1392.  
  1393.        Searching...                NAMEVIEW has acknowledged your "N" or "R"
  1394.        (blinking)                  keypress asking for the next (or pre-
  1395.                                    vious) message, but is still searching
  1396.                                    for or processing it.  The next message
  1397.                                    will be shown onscreen as soon as it is
  1398.                                    ready.
  1399.  
  1400.        Waiting...                  Shown if NAMEVIEW is able to find and
  1401.        (steady)                    prepare the next message before you are
  1402.                                    ready for it (you haven't pressed "N"
  1403.                                    yet after the current onscreen message
  1404.                                    was shown to you).  The next message will
  1405.                                    be shown immediately when you press "N".
  1406.  
  1407.        Processing!                 Shown while NAMEVIEW is reProcessing the
  1408.        (blinking)                  current onscreen message (which you
  1409.                                    caused by pressing "E" to change the
  1410.                                    NoEcho Mode).
  1411.  
  1412.        Last Message                Shown if the message that is currently
  1413.        (blinking)                  onscreen is the last one meeting your
  1414.                                    criteria in the download file.  Press
  1415.                                    <Esc> if you are ready to exit NAMEVIEW,
  1416.                                    or any other Hot Key for appropriate
  1417.                                    action.
  1418.  
  1419.  
  1420.  
  1421.                                          23
  1422.        Printing message to LPT#    The current onscreen message is being
  1423.        (steady)                    sent to the printer.
  1424.  
  1425.        Adding message to filename  The current onscreen message is being
  1426.        (steady)                    added to (filename).
  1427.  
  1428.  
  1429.               Information Line - Additional Message Lines Indication
  1430.  
  1431.             The next area of the Information Line is used to indicate whe-
  1432.        ther there are more than 24 lines in the current onscreen message. 
  1433.        If a down arrow appears, then the DOWN arrow cursor key (or PgDn, or
  1434.        End) can be used to view additional message lines below those which
  1435.        currently appear on the screen.  If an up arrow appears, then the UP
  1436.        arrow cursor key (or PgUp, or Home) can be used to view additional
  1437.        message lines above those which currently appear on the screen.  It
  1438.        is not uncommon to have both up and down arrows appear in this area
  1439.        simultaneously.  If no arrows appear, then the message is short
  1440.        enough to be seen in its entirety without any scrolling functions
  1441.  
  1442.             In addition, this section may show a blinking "Smiley" face. 
  1443.        This will happen when Display ALL messages is selected and the cur-
  1444.        rent onscreen message contains at least one search word.  This is to
  1445.        alert you to the fact that a search "hit" was found in the onscreen
  1446.        message.  This may not otherwise be apparent to you if the message is
  1447.        longer than 24 lines and no highlighting appears within the first 24
  1448.        lines.
  1449.  
  1450.  
  1451.                        Information Line - Messages Processed
  1452.  
  1453.             The next section of the Information Line keeps a total of the
  1454.        number of messages processed.  This is not the number of messages you
  1455.        have viewed, but rather the number of messages NAMEVIEW has had to
  1456.        process in it's search.
  1457.  
  1458.  
  1459.                           Information Line - Names Found
  1460.  
  1461.             The next section of the Information Line keeps a total of the
  1462.        number of names found.  This total will always be higher than the
  1463.        totals you have seen using NAMEDROP.  This is due to the fact that if
  1464.        the same name is found more than once in a message, NAMEVIEW will add
  1465.        all occurrences of the name to the total.  NAMEDROP would only add
  1466.        one count per name found per message.
  1467.  
  1468.  
  1469.                           Information Line - Hot Key Area
  1470.  
  1471.             The next section of the Information Line gives a listing of the
  1472.        hot keys available for you to control program features and execution. 
  1473.        This listing is shown as:
  1474.  
  1475.             Esc/Fk#/H/N/R/P/F/B/M/D/U/L/S/E
  1476.  
  1477.  
  1478.                                          24
  1479.             The status of the parameters controlled by the last 5 hot keys
  1480.        listed (D/U/L/S/E) are continuously shown.  Except for the Display
  1481.        Messages parameter, any setting which is toggled ON or YES will be
  1482.        shown highlighted (blinking for mono displays).  The Display Messages
  1483.        parameter ("D" character) will be highlighted (blinking) when set to
  1484.        ALL Messages.
  1485.  
  1486.             "ESC" indicates that the ESC key can be used any time to ter-
  1487.        minate program operation.  <Fk#> indicates the function keys and Alt
  1488.        + function keys are active.  Additional keys not shown which may be
  1489.        active depending on message length are the message viewing keys
  1490.        (cursor arrows, PgUp, PgDn, Home, and End).
  1491.  
  1492.             A description of the Hot Keys can be reviewed at any time by
  1493.        pressing "H" for the Help section.  Then PgUp or PgDn until you find
  1494.        the "NAMEVIEW Hot Keys" Help page.  Keys shown in parenthesis below
  1495.        are additional keys which will also activate the described feature. 
  1496.        The Hot Keys are used as follows:
  1497.  
  1498.        Hot Key    Description of Action
  1499.        -------    ---------------------------------------------------------
  1500.        F1-F10     To add the current onscreen message to a Sort file, press
  1501.                   the function key to which the desired filename has been
  1502.                   assigned.  Ten additional Sort files are available by
  1503.                   using Alt + a function key if you provided extra filenames
  1504.                   in your DAT file(s).
  1505.  
  1506.        Esc        Used to return to normal program operation if you are in
  1507.        (Q)        the Help section, or to exit NAMEVIEW during normal pro-
  1508.                   gram operation.  (Pressing "Q" calls the EXIT routine only
  1509.                   when the Last Message prompt is visible).
  1510.  
  1511.        H          Press "H" to view the Help pages available.
  1512.  
  1513.        N          Pressed when you are ready to view the next message.
  1514.        (ENTER)
  1515.        (RT arrow)
  1516.        (space bar)
  1517.  
  1518.        R          Reverse Read, returns you to the previous onscreen
  1519.        (LEFT      message.
  1520.        arrow)
  1521.  
  1522.        P          Press "P" to print the current onscreen message (to LPT#).
  1523.  
  1524.        F          Press "F" to print the current onscreen message (to LPT#)
  1525.                   followed by a Form Feed.
  1526.  
  1527.        B          Inserts a "Book Mark," and returns you to the File Menu.
  1528.  
  1529.        M          Menu Return, returns you to the File Menu.
  1530.  
  1531.        D          Toggles the Message Display parameter (status shown on
  1532.                   Info line).
  1533.  
  1534.  
  1535.                                          25
  1536.        Hot Key    Description of Action (continued)
  1537.        -------    ---------------------------------------------------------
  1538.        U          Toggles the Upper Case check parameter  (status shown on
  1539.                   Info line).
  1540.  
  1541.        L          Toggles the Line Wrap check parameter  (status shown on
  1542.                   Info line).
  1543.  
  1544.        S          Toggles the Sound parameter (status shown on Info line).
  1545.  
  1546.        E          Toggles the NoEcho Mode parameter (status shown on Info
  1547.                   line).
  1548.  
  1549.        PgUp       Selects the previous 22 lines of the onscreen message, if
  1550.                   applicable.  Also used to cycle through the three Help
  1551.                   pages.
  1552.  
  1553.        PgDn       Selects the next 22 lines of the onscreen message, if 
  1554.                   applicable.  Also used to cycle through the three Help
  1555.                   pages.
  1556.  
  1557.        Home       Returns you to the beginning of the message.
  1558.  
  1559.        End        Takes you to the end of the message (shows you the last 24
  1560.                   lines.
  1561.  
  1562.  
  1563.        NOTE:  For those with BIOS supported enhanced keyboards, the grey
  1564.        cursor, PgUp, and PgDn keys will work as well as the white ones. 
  1565.  
  1566.        NOTE:  Under certain conditions, additional messages may temporarily
  1567.        appear in place of the Hot Key listing.  These messages are:
  1568.  
  1569.             Check FIRST LINE Parameter!
  1570.             Check LAST LINE Parameter!
  1571.  
  1572.        See Appendix B - Error Messages and Problems for explanations of
  1573.        these messages.
  1574.  
  1575.  
  1576.                                     Help System
  1577.  
  1578.             NAMEVIEW's Help system consists of three Help pages which can be
  1579.        called at any time (except when the File Menu is onscreen) by press-
  1580.        ing "H".  Once you have called the Help system, PgUp and/or PgDn
  1581.        (and/or the left and right arrow keys) can be used to cycle through
  1582.        the Help pages in either direction.  The three Help pages cover
  1583.        NAMEVIEW Hot Keys, NAMEVIEW Filenames, and the NAMEVIEW Information
  1584.        Line Key.
  1585.  
  1586.             The information contained on the NAMEVIEW Hot Keys Help page and
  1587.        the NAMEVIEW Information Line Key page has been covered elsewhere. 
  1588.        The NAMEVIEW Filename page is a listing of the complete filenames (or
  1589.        the last 24 characters, if longer) assigned to each of the twenty
  1590.        function keys (normal and ALT + function keys).  In addition, it
  1591.  
  1592.                                          26
  1593.        shows the name of the current message download file which is being
  1594.        searched and read.
  1595.  
  1596.             To exit the Help section, press <Esc>.  NAMEVIEW remembers what
  1597.        Help page you were on when you exit.  The next time you call the
  1598.        Help section, you will be returned to that same page.  Most users
  1599.        might want to exit Help while viewing the NAMEVIEW Filename page. 
  1600.        Then when you wish to add to a Sort file and can't remember the
  1601.        function key to which the desired file name was assigned, pressing
  1602.        "H" will immediately return you back to the NAMEVIEW Filenames page. 
  1603.        Of course, exiting the Help section will return you to the same
  1604.        screen page of the message you were viewing when Help was selected.
  1605.  
  1606.  
  1607.                       Early Termination of Program Execution
  1608.  
  1609.             NAMEVIEW can be terminated at any time (except while viewing
  1610.        Help screens or the Smart Point & Shoot file list) by pressing the
  1611.        <Esc> key.  If you are viewing the Help screens or the file list,
  1612.        pressing <Esc> will return you to normal program operation.  Another
  1613.        press of <Esc> at this time will start the termination procedure. 
  1614.        Since anyone can make a mistake, you will be prompted to verify that
  1615.        you want to terminate the program before you are actually "dumped." 
  1616.        Pressing "Y" at the termination prompt will dump the program.  Press-
  1617.        ing any other key will return you to normal NAMEVIEW operation.
  1618.  
  1619.  
  1620.                             Normal Program Termination
  1621.  
  1622.             Normal program completion is first signaled by the flashing
  1623.        "Last Message.." prompt in the Action message area of the information
  1624.        line.  Exit at this point via the normal <Esc> key function, or by
  1625.        pressing "Q" (for Quit) when you are finished with the last message. 
  1626.        If you desire, you can return to the File Menu by pressing "M".
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.                                          27
  1650.                             ***  NAMEVIEW Features  ***
  1651.  
  1652.  
  1653.        Active Parameter Switching - 
  1654.             Users can now change the Line Wrap Check, Message Display (ALL
  1655.             or those containing Search Words), Sound, NoEcho Mode, and Upper
  1656.             Case Check parameters at any time while messages are being read. 
  1657.             This is in addition to being able to set/change them via the
  1658.             Message Format Block Configuration Line or at the Set Up menu. 
  1659.             If these settings are changed while viewing messages, a short
  1660.             BEEP will sound to let you know the change has been made (except
  1661.             for the Sound parameter).  It may take one additional message
  1662.             screen for the changes to take affect, since NAMEVIEW is usually
  1663.             already processing the next message while you are viewing the
  1664.             current one.  The status of these parameters is reflected on the
  1665.             Information Line by highlighting (or blinking for mono systems).
  1666.  
  1667.        AutoLoad Feature - 
  1668.             If the AutoLoad command line parameter ("A") is present, NAME-
  1669.             VIEW loads and automatically looks for a download file with a
  1670.             prefix reflecting the current date and a suffix found in your
  1671.             DAT file.  If a file meeting these conditions is present, it is
  1672.             loaded, the "File Menu Options" menu is skipped, and the user is
  1673.             immediately presented with the Set Up menu.  If the file is not
  1674.             found, the "File Menu Options" menu is presented normally.  
  1675.  
  1676.             After reading the initially loaded file and returning to the
  1677.             "File Menu Options" menu, NAMEVIEW will look for additional
  1678.             files with a name reflecting the current date AFTER the prev-
  1679.             iously read file is "marked" or deleted.  Additional (or ini-
  1680.             tial, if the command line parameter wasn't used) AutoLoading can
  1681.             also be triggered by toggling the AutoLoad parameter to ON at
  1682.             the "File Menu Options" menu.  Starting with the 2nd file to be
  1683.             AutoLoaded, NAMEVIEW will remain at the "File Menu Options" menu
  1684.             until <ENTER> is pressed to continue to the SetUp Menu.  
  1685.  
  1686.             Files are searched for in the order in which file suffixes ap-
  1687.             pear in your message format blocks.  NAMEVIEW will continue to
  1688.             AutoLoad additional files in turn until no more are found meet-
  1689.             ing the above criteria.  When no more files are found, this
  1690.             fact is stated onscreen beside the AutoLoad toggle setting. 
  1691.             AutoLoad is reactivated each time a new DAT file is selected
  1692.             provided the AutoLoad parameter is left on (or toggled ON after
  1693.             loading the new DAT file).  Conditions for ensuring that the
  1694.             AutoLoad feature will work are given in the "Command Line En-
  1695.             tries" section of the documentation.
  1696.  
  1697.        Automated Caps Lock/Num Lock Adjusting - 
  1698.             NAMEVIEW doesn't care about the status of your Caps Lock and
  1699.             Num Lock keys and does nothing to change them.  Pressing the
  1700.             appropriate key will activate NAMEVIEW features regardless of
  1701.             the status of the Locking keys.  This means that even the num-
  1702.             bers on the top row of the typewriter keys will activate fea-
  1703.             tures in accordance with the comparable numeric keypad paging
  1704.             and arrow keys.
  1705.  
  1706.                                          28
  1707.        Automatic DESQVIEW Detection -
  1708.             NAMEVIEW automatically detects if it is being run under DesqVIEW
  1709.             and makes the necessary changes to be friendly with this system. 
  1710.             No action is required from the user.
  1711.  
  1712.        Book Mark Feature - 
  1713.             This feature gives you the option of saving your place while
  1714.             searching/reading through a long download file (or even a short
  1715.             one).  After affirming that you want to place a book mark,
  1716.             NAMEVIEW "marks" the last message that was searched.  This "Book
  1717.             Marking" is done by placing a file location code in a special
  1718.             file which NAMEVIEW will create automatically for you.  The
  1719.             special file will have the name of your download file with a
  1720.             dollar sign ($) added.  In addition, your download file name is
  1721.             changed by adding an exclamation point (!) to it.  For example,
  1722.             if your download file is named MAY05.TRS, after placing a book
  1723.             mark, your download file will be named MAY05!.TRS, and the ad-
  1724.             ditional file created will be MAY05$.TRS.  
  1725.  
  1726.             You can now run other programs on your computer, read other
  1727.             files with NAMEVIEW, or even turn your computer off.  For your
  1728.             protection, files which have been "Book Marked" cannot be de-
  1729.             leted (by NAMEVIEW).  When you wish to resume reading your "Book
  1730.             Marked" download file, simply choose it from the file listing
  1731.             (it should be easily recognized because of the "!" in the file-
  1732.             name).  When you get to the Set Up Menu, NAMEVIEW will automati-
  1733.             cally recognize that you have chosen a book marked file, and
  1734.             will automatically set the "Find Book Mark" parameter to YES. 
  1735.             At this point, you have the option of changing this parameter to
  1736.             NO, but if you do, you'll start searching all over at the begin-
  1737.             ning of the file.  If you choose to stay with the YES setting,
  1738.             NAMEVIEW will start searching and show you the next file you
  1739.             would have seen if you had not suspended your original search
  1740.             with the Book Mark function.  After starting operation with a
  1741.             file in which a "Book Mark" was made, NAMEVIEW automatically
  1742.             cleans up after itself by deleting the special file and renaming
  1743.             the download file to its original name (without the "!").
  1744.  
  1745.        Command Line Interface - 
  1746.             A command line interface is available to set Custom Message
  1747.             Screen Colors, force your display into Mono mode, change your
  1748.             print (LPT#) device, set DesqVIEW mode, Autoload a download file
  1749.             with a name reflecting the current date, and to direct the
  1750.             program to start immediately at the Message Screen without a
  1751.             pause at the Menu Screen.  See the "Command Line MENU Operation"
  1752.             section for details.
  1753.  
  1754.        Custom Message Screen Colors - 
  1755.             Message text colors may be customized by using the command line
  1756.             interface.  Menu and Help screens and the Information Line at
  1757.             the bottom of the Message Screen are not affected.  See the
  1758.             Command Line Parameters section for information on how to spe-
  1759.             cify your desired colors.
  1760.  
  1761.  
  1762.  
  1763.                                          29
  1764.        Display Adapter Detection - 
  1765.             NAMEVIEW will detect whether you are using a Monochrome or Color
  1766.             Graphics adapter.  Color adapters will get the full color treat-
  1767.             ment.  Monochrome adapters will get reverse video and high
  1768.             intensity highlighting.  For Mono users, if you can't distin-
  1769.             guish high intensity characters when the menu is onscreen, then
  1770.             your monitor's contrast control needs adjustment (if your screen
  1771.             is still hard to read, see the Force Mono Function).
  1772.  
  1773.        Enhanced DAT File Capability -
  1774.             NAMEVIEW allows as many DAT files as you care to create.  When
  1775.             initially started, NAMEVIEW automatically loads NAMEVIEW.DAT. 
  1776.             If NAMEVIEW.DAT cannot be found in the current drive and direc-
  1777.             tory, NAMEDROP.DAT will be loaded, if found.  Additional DAT
  1778.             files you create must be named using the NAMEVDAT.* format.  It
  1779.             is suggested that you use a numbering (NAMEVDAT.1, NAMEVDAT.2,
  1780.             NAMEVDAT.3, etc.) or lettering (NAMEVDAT.A, NAMEVDAT.B, NAMEV-
  1781.             DAT.C, etc.) system for the suffixes of your additional DAT
  1782.             files.  Any of your additional DAT files can be loaded with the
  1783.             "(S)elect New DAT File:" item any time you are at the "File Menu
  1784.             Options" menu.  This is done with a point-and-shoot selection
  1785.             from a list exactly like the download file list.  A comment line
  1786.             may now be included in your DAT files to help you remember their
  1787.             purpose.  See the "The NAMEVIEW.DAT Data File" section for
  1788.             details.
  1789.  
  1790.        Error Message Display - 
  1791.             NAMEVIEW checks for, protects for, and displays messages for
  1792.             numerous errors.  See Appendix B for a comprehensive description
  1793.             of error messages.  
  1794.  
  1795.        Escape Key Function - 
  1796.             Pressing <Esc> will let you back out of sub-program routines,
  1797.             and finally, terminate program execution.  Esc can be used to
  1798.             terminate NAMEVIEW from the message screen or from either Menu
  1799.             screen.  NAMEVIEW will always ask "Are you SURE you want to exit
  1800.             NAMEVIEW?" before dumping you out of the program.
  1801.  
  1802.        Extended Keyboard Interface - 
  1803.             You can now choose from multiple keys to activate many NAMEVIEW
  1804.             features.  The "N" (Next Message) key action can be duplicated
  1805.             with the ENTER, RIGHT arrow, or Space bar keys, the "R" (Reverse
  1806.             Read) key can be duplicated with the LEFT arrow key, and "Esc"
  1807.             can be duplicated with the "Q" (Quit) key when the "Last Mes-
  1808.             sage.." prompt is visible.  In addition, enhanced keyboard users
  1809.             can use either white or grey versions of the cursor and paging
  1810.             keys.  All activating keys are indicated on the Features Help
  1811.             screen.  Keyboarding is designed so that all message reading
  1812.             functions can be performed conveniently on the numeric keyboard
  1813.             and/or cursor (arrow) keys.
  1814.  
  1815.        Fail Safe Message Processing - 
  1816.             Whenever NAMEVIEW's message size limits (240 lines) are exceed-
  1817.             ed, another message unit is automatically created to handle the
  1818.             excess information.  This results in all information in the
  1819.  
  1820.                                          30
  1821.             download file being available to the user regardless of the
  1822.             formatting problems present in the file.  When any "oversized"
  1823.             message is presented onscreen, it will consist of 240 lines. 
  1824.             The last line will say:
  1825.  
  1826.               ***  Message OVERFLOW...continued in next message unit!
  1827.  
  1828.             The first line of the next message unit which NAMEVIEW created
  1829.             will say:
  1830.  
  1831.               ***  Message OVERFLOW...continued from last message unit!
  1832.  
  1833.             The lines which appear next will be a continuation of the pre-
  1834.             ceding oversized message.
  1835.  
  1836.        Floppy User Enhancement - 
  1837.             Floppy disk users with only one drive can use one floppy disk
  1838.             containing the program files to start the program.  Once the
  1839.             first menu is onscreen, the program disk can be safely exchanged
  1840.             with a second disk containing the download file(s) to be search-
  1841.             ed.  This allows the maximum possible room on the floppy disk
  1842.             for download and Sort files.  If the AutoLoad feature is to be
  1843.             used, however, then the download file which is to be AutoLoaded
  1844.             must be on the disk which is in the current drive (and in the
  1845.             current subdirectory) during program loading.
  1846.  
  1847.        Force Mono Function:  default is OFF - 
  1848.             Some computers have color graphics adapters driving monochrome
  1849.             monitors, with colors being interpreted as "different shades of
  1850.             grey."  If this is the case, NAMEVIEW will probably try to use
  1851.             its full color mode, as it will have detected the color adapter. 
  1852.             This may result in less than optimum readability on your mono-
  1853.             chrome monitor.  If your monochrome monitor seems to be hard to
  1854.             read, you can force NAMEVIEW to run in Mono mode by adding a
  1855.             "M" (for Mono) following a space at the end of your starting
  1856.             command line (for example:  NAMEVIEW M).  The only change forced
  1857.             by this parameter is the screen color set.  This option can
  1858.             also be used for a color monitor, if you would prefer to run the
  1859.             program in black and white!
  1860.  
  1861.        Help System - 
  1862.             A three page help system is built into NAMEVIEW.  Once Help is
  1863.             selected (by pressing "H"), help pages can be cycled forward or
  1864.             backward with the PgUp or PgDn keys (white or grey, for enhanced
  1865.             keyboard users).  The Help page which is onscreen when you exit
  1866.             Help will be the first one you see if you re-select Help.  Help
  1867.             always returns you to the message page you were viewing when
  1868.             Help was selected.
  1869.  
  1870.        Intelligent End of File (EOF) Detection -
  1871.             Due to line noise, file corruption and who knows what else, the
  1872.             DOS end-of-file character sometimes appears within a download
  1873.             file at a location other than the actual end-of-file.  This used
  1874.             to cause normal termination of the program with the "Last Mes-
  1875.             sage" indicator.  NAMEVIEW now ignores all EOF characters and
  1876.  
  1877.                                          31
  1878.             considers itself finished only when it has read the number of
  1879.             bytes reported in the DOS file length.  No indication is given
  1880.             of any EOF characters found within the file.
  1881.  
  1882.        Line Wrap Check - default is ON
  1883.             This feature, which is set ON by default to provide the most
  1884.             fail-safe message parsing and formatting, corrects three dif-
  1885.             ferent download file problems.  The first is caused by line
  1886.             lengths which exceed 80 characters.  This can occur within the
  1887.             body of a message itself, or just on the "tag line."  If it
  1888.             occurs on the "tag line," then multiple messages being loaded/-
  1889.             processed as if they were one message is the most notable sym-
  1890.             ptom.  The second is caused when the message software does not
  1891.             provide a standard carriage return (CR) and line feed (LF) at
  1892.             the end of each line.  What typically happens is that a line
  1893.             will end with a CR and two LF's.  This fools all manner of file
  1894.             reading software into thinking that the subsequent line begins
  1895.             with a LF, and therefore plays havoc with precise screen place-
  1896.             ment, which is critical to NAMEVIEW.  The third problem is
  1897.             caused when the tab character is found at the beginning of a
  1898.             line, which will result in misplaced highlighting.  The majority
  1899.             of these problems occur due to "flaws" (I've been told by BBS
  1900.             software writers it is for "efficiency") in the BBS software
  1901.             which automatically gathers a batch of new messages to be down-
  1902.             loaded.  
  1903.  
  1904.             With this feature left ON, NAMEVIEW will scan each line and make
  1905.             the appropriate adjustments if any of the above problems are
  1906.             found.  There is only a small (under 5%, but increases with the
  1907.             amount of correction which has to be done) speed penalty for
  1908.             retaining this feature.  If you are ABSOLUTELY SURE that none of
  1909.             the problems which this feature corrects are present in your
  1910.             download files, this feature may be deactivated for a resultant
  1911.             increase in search speed.  However, if NAMEVIEW seems to skip or
  1912.             overwrite lines, if you see active scrolling (lines moving up on
  1913.             the screen) which you haven't commanded, if it seems that multi-
  1914.             ple messages are being processed as one, if your Information
  1915.             Line seems to start disintegrating, or if highlighted words ap-
  1916.             pear to be misplaced when messages are presented onscreen, then
  1917.             you will need to leave this feature activated to correct these
  1918.             faults.  Some of these occurrences MAY cause unrecoverable
  1919.             errors (program will freeze or crash). Line Wrap Check can be
  1920.             toggled from the Set Up Menu, at any time while you are reading
  1921.             messages, or set via the Message Format Block Configuration
  1922.             Line.  If toggled while reading messages, a short BEEP will be
  1923.             heard to let you know the change has taken affect.  In addition,
  1924.             if you toggled this option to the ON setting, the current mes-
  1925.             sage will automatically reprocess, which should eliminate any
  1926.             current onscreen problems.  The status of this parameter is
  1927.             indicated on the command line while messages are being read.
  1928.  
  1929.        Mark File Option - 
  1930.             This option appears on the "File Menu Options" menu only after a
  1931.             download file has been searched (even partially).  If you don't
  1932.             wish to delete the file, but wish to leave an indication that
  1933.  
  1934.                                          32
  1935.             you have already read through it, this option will give you that
  1936.             indication.  After you have affirmed that you want the current
  1937.             download file marked, NAMEVIEW will add a pound sign (#) to the
  1938.             filename.  For example, if the original file name was MAY05.TRS,
  1939.             after marking, the filename will be MAY05#.TRS.  Files thus
  1940.             marked can be easily picked out when they are listed for selec-
  1941.             tion by NAMEVIEW.  If the AutoLoad parameter is ON, searching
  1942.             for additional qualified files will continue after using the
  1943.             Mark File option on the current file.
  1944.  
  1945.        Message Display Mode:  default is "Messages containing SEARCH WORDS"
  1946.             If "ALL messages" is selected, all messages will be shown on-
  1947.             screen in turn, regardless of whether or not any search "hits"
  1948.             were made in the current message.  If "Messages containing
  1949.             SEARCH WORDS" is selected, only those messages in which at least
  1950.             one "hit" was made will be shown onscreen.  This parameter can
  1951.             be toggled from the Set Up Menu, at any time while you are
  1952.             reading messages, or set via the Message Format Block Configura-
  1953.             tion Line.  If toggled while reading messages, a short BEEP will
  1954.             be heard to let you know the change has taken affect.  The
  1955.             status of this parameter is indicated on the command line while
  1956.             messages are being read.
  1957.  
  1958.        Message File Deletion Option - 
  1959.             This feature is active only when visible on the "File Menu
  1960.             Options" Menu.  You will be asked to verify this choice before
  1961.             the file is erased.  The only file that is erased with this
  1962.             feature is the filename listed on the "File Menu Options" Menu
  1963.             screen.  If there is no file listed, or if the file listed has
  1964.             been "book marked," then this option will not be available.  No
  1965.             Sort Files are ever erased by NAMEVIEW.  
  1966.  
  1967.        Message Review Keys -
  1968.             Numerous keys are available to review those individual messages
  1969.             which are longer than 24 lines (one screen page).  Line scroll-
  1970.             ing is available using the UP and DOWN arrow keys.  The Home key
  1971.             takes you to the beginning and shows you the first 24 lines. 
  1972.             The End key takes you to the end and shows you the last 24
  1973.             lines.  PgDn will move you 22 lines down from the current posi-
  1974.             tion (the previous two bottom lines will be at the top of the
  1975.             screen) unless there are less than 22 lines remaining.  In this
  1976.             case, PgDn acts like the End key and shows you the last 24
  1977.             lines.  PgUp works like PgDn, only in reverse.
  1978.  
  1979.        Name(s) Found in Message Indication -
  1980.             If you select the "Read ALL Messages" menu option, and a search
  1981.             "hit" was made in the current onscreen message, a "Smiley"
  1982.             character in the Additional Message Lines indication section of
  1983.             the Information Line will blink at you.  This will help alert
  1984.             you to the fact that a search "hit" was found in the onscreen
  1985.             message even if it does not appear in the initial onscreen
  1986.             portion of the message.  This feature is not active if you use
  1987.             the "Read messages containing SEARCH WORDS" menu option, thus
  1988.             avoiding the useless nuisance of constant blinking.
  1989.  
  1990.  
  1991.                                          33
  1992.        NoEcho Mode:  default is OFF - 
  1993.             It is a characteristic of certain BBS systems that the Origin
  1994.             line is not added to messages until they are "echoed," or sent
  1995.             to another BBS system.  This results in all of these non-Echoed
  1996.             local messages being displayed simultaneously by NAMEVIEW as a
  1997.             single message (and possibly resulting in overflow to another
  1998.             message unit).  If the noEcho mode is set to ON, NAMEVIEW will
  1999.             use only the "First Line" entry as a message separator instead
  2000.             of the "Last Line" entry in your DAT file.  If you see several
  2001.             messages that seem to be strung together without Origin lines,
  2002.             set noEcho Mode to ON.  NAMEVIEW will automatically reprocess
  2003.             the current onscreen message and redisplay it whenever this
  2004.             parameter is changed.
  2005.  
  2006.             Using the ON setting will result in your seeing some "between
  2007.             message garbage" whenever it occurs.  Some BBS systems are
  2008.             consistent with what appears at the end of their nonEchoed
  2009.             messages, and some merely end with whatever the user left. 
  2010.             Because of this total lack of predictability, NAMEVIEW will show
  2011.             you EVERYTHING that was sent between successive "First Line"
  2012.             entries.  I recommend you use the ON setting only when you
  2013.             specifically encounter nonEchoed messages, and reset it to OFF
  2014.             when it is no longer needed (when your "Last Line" entry starts
  2015.             reappearing in the messages).  In general (when nonEchoed mes-
  2016.             sages are not present) searching for the "Last Line" parameter
  2017.             will eliminate all "between message garbage."  NoEcho Mode can
  2018.             be toggled from the Set Up Menu, at any time while you are
  2019.             reading messages, or set via the Message Format Block Configura-
  2020.             tion Line.  If toggled while reading messages, a short BEEP will
  2021.             be heard to let you know the change has taken affect.  The
  2022.             status of this parameter is indicated on the command line while
  2023.             messages are being read.
  2024.  
  2025.        Print Device Customizing - 
  2026.             NAMEVIEW can be customized as to the print device written to by
  2027.             the Print Message features.  The default device is LPT1.  Any
  2028.             other LPT device recognized by your computer can now be speci-
  2029.             fied on the command line.  COM ports are not supported due to
  2030.             the number of extra parameters which must also be specified for
  2031.             their use.  See the Command Line Parameters section for details
  2032.             on how to set different LPT devices.
  2033.  
  2034.        Print Message (using "P") - 
  2035.             During message reading, the current onscreen message can be
  2036.             printed immediately by pressing "P".  All printing is sent to
  2037.             LPT1 by default or to your custom chosen device (see Print
  2038.             Device Customizing).  The device being printed to is indicated
  2039.             on the Information Line while printing is in progress.  Using
  2040.             "P" to print a message inserts a few blank lines at the end of
  2041.             each message.  Therefore, several messages can be printed on the
  2042.             same page if you prefer to save paper.
  2043.  
  2044.        Print Message (using "F") - 
  2045.             This feature prints a message exactly as in the above feature
  2046.             with the exception that a form feed is added to each message
  2047.  
  2048.                                          34
  2049.             instead of several blank lines.  This feature is for those who
  2050.             prefer to file each message on a separate piece of paper.
  2051.  
  2052.        Reverse Read (Back Up) Command - 
  2053.             A LEFT arrow or "R" keypress will result in the most previously
  2054.             screened message reappearing on your screen.  Up to 10 previous-
  2055.             ly screened messages can be viewed.
  2056.  
  2057.        Search List Tailoring - 
  2058.             Due to numerous problems with different text editors trying to
  2059.             produce DAT files, NAMEVIEW now automatically strips trailing
  2060.             spaces from all Search List entries and removes any null en-
  2061.             tries from the end of the list.
  2062.  
  2063.        Search Parameters - 
  2064.             NAMEVIEW is written so that a "hit" must be a stand-alone word. 
  2065.             This means that your search word, as found in the download file,
  2066.             must be surrounded by spaces, punctuation, hard return codes, or
  2067.             be at the beginning of a line (or any combination of these) in
  2068.             order for the program to report it as a legitimate find.  For
  2069.             example, if one of your search words is "Cox" the program will
  2070.             find "Cox" but will not find "Wilcox" or "Coxe".  By ignoring
  2071.             imbedded words, the number of nuisance hits in your search is
  2072.             reduced.  This is why it is important to include all spellings
  2073.             of the names (for genealogists) which you are interested in
  2074.             finding, as searching for just the root part of the name will
  2075.             probably result in no success in your search.  All lines (in-
  2076.             cluding the To:, From:, and Subject: lines) are searched for
  2077.             your search words EXCEPT the Origin line when NoEcho mode is
  2078.             OFF.
  2079.  
  2080.        Smart Point & Shoot Download File Selection - 
  2081.             When the "(L)ist File Names" selection is chosen from the "File
  2082.             Menu Options" menu, NAMEVIEW displays only those files with
  2083.             filename extensions appearing in your NAMEVIEW.DAT file.  This
  2084.             shortens the time necessary for you to find the desired file,
  2085.             and eliminates unnecessary errors caused by trying to load files
  2086.             that were not meant for use with NAMEVIEW.  The UP and DOWN
  2087.             arrow keys are used to highlight the desired file.  If the file
  2088.             list is bigger than the display window, up and/or down arrows
  2089.             are displayed to indicate that additional file names are avail-
  2090.             able by scrolling beyond the top or bottom of the window.  Any
  2091.             drive and/or directory can be targeted for file listing.
  2092.  
  2093.        Sort Files:  User or Default Naming - 
  2094.             All sort files (20) can be named (including drive and path
  2095.             parameters) completely at the users discretion.  If file names
  2096.             are not listed in the NAMEVIEW.DAT file, NAMEVIEW will automati-
  2097.             cally assign default filenames to the (first ten) function keys. 
  2098.             See set-up section for details.
  2099.  
  2100.        Sort Files:  Writing to Disk - 
  2101.             NAMEVIEW never overwrites previous Sort File data.  Any NAMEVIEW
  2102.             Sort File write will only add (append) the current message data
  2103.             to the data already in the file.  Sort Files will automatically
  2104.  
  2105.                                          35
  2106.             be created as specified if not previously in existence when you
  2107.             attempt to write to one.  In order to safeguard your data,
  2108.             NAMEVIEW does not "open" a Sort File until you elect to write
  2109.             data to it.  The file is then opened, the data is written, and
  2110.             the file is immediately closed.  If you use floppies for your
  2111.             Sort File writes, this means you can change floppy disks in your
  2112.             Sort File drive between Sort File writes (not advisable for
  2113.             single floppy drive users).  The Information Line will tempo-
  2114.             rarily change to show you which Sort File is currently being
  2115.             written to during the Sort File write.
  2116.  
  2117.        Sound:  default is OFF -
  2118.             If sound ON is selected, different chimes will be heard depend-
  2119.             ing on the setting of the "Read Selection" parameter.  If "Read
  2120.             Messages containing Search Words" is selected, a short chime
  2121.             will sound as NAMEVIEW completes its processing of each message. 
  2122.             If you have selected "Read ALL Messages", a longer chime will
  2123.             sound whenever a message is presented onscreen which contains a
  2124.             "hit".  A warning chime will sound if <Esc> was pressed, and a
  2125.             program completion chime will sound as the program is exited. 
  2126.             Program execution is slowed with the Sound parameter ON, as it
  2127.             takes a certain amount of time to sound the message counting
  2128.             chime (approximately .15 seconds, regardless of microprocessor
  2129.             type) and during this time, no other processing takes place.  A
  2130.             warning tone will sound, regardless of the Sound parameter
  2131.             setting, if a key press is inappropriate or if the Delete option
  2132.             is selected.  Sound effects can be toggled from the Set Up Menu,
  2133.             at any time while you are reading messages, or set via the
  2134.             Message Format Block Configuration Line.  A special chime sounds
  2135.             when this parameter is toggled ON.  The status of this parameter
  2136.             is indicated on the command line while messages are being read.
  2137.  
  2138.        Special Search:  default is OFF
  2139.             When selected from the Set Up Menu, permits entry of a single,
  2140.             special search item for a speed search.  When this feature is
  2141.             used, your normal search list will be ignored, and the download
  2142.             file will be searched for this single item only.  If your search
  2143.             item is found in any message, that message will be displayed
  2144.             onscreen with all occurrences of the special search item in
  2145.             reverse video.  All other NAMEVIEW key functions remain the
  2146.             same.  This is the fastest possible search, as only one item has
  2147.             to be searched for instead of your entire search list.  Select
  2148.             "Input Special Search" (press "I") again to erase a search item
  2149.             which was previously entered.  
  2150.  
  2151.        Upper Case Check:  default is ON
  2152.             When this parameter is ON, NAMEVIEW will not return a "hit"
  2153.             unless the first character of the found word/name was an upper
  2154.             case letter in the download file being searched.  Leaving this
  2155.             parameter on will reduce the number of nuisance "hits" if all of
  2156.             the words in your search list are proper names.  Can be toggled
  2157.             from the Set Up Menu, at any time while you are reading mes-
  2158.             sages, or set via the Message Format Block Configuration Line. 
  2159.             If toggled while reading messages, a short BEEP will be heard to
  2160.             let you know the change has taken affect.  The status of this
  2161.  
  2162.                                          36
  2163.             parameter is indicated on the command line while messages are
  2164.             being read.
  2165.  
  2166.             The following chart shows how NAMEVIEW will handle different
  2167.             cases depending on how the Upper Case parameter is set:
  2168.  
  2169.                                                     Upper Case Check
  2170.                 Words appearing in download file        ON    OFF
  2171.               +--------------------------------------+------+-----+
  2172.               | PAGE                                 |   *  |  *  |
  2173.               | Page                                 |   *  |  *  |
  2174.               | page                                 |      |  *  |
  2175.               | pAGE                                 |      |  *  |
  2176.               +--------------------------------------+------+-----+
  2177.                             * signifies a "hit"
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.                                          37
  2220.                                     APPENDIX A
  2221.  
  2222.  
  2223.                        Ways to Write Your NAMEVIEW.DAT File
  2224.  
  2225.             There are numerous ways to write or modify your NAMEVIEW.DAT
  2226.        file, as it is merely an ASCII file containing information in a
  2227.        particular format. 
  2228.  
  2229.        Word Processing Software - 
  2230.                 Perhaps the easiest way to create an ASCII file is with your
  2231.             word processor.  Most word processors can read and write ASCII
  2232.             (or DOS text) files, if you know the required commands to do
  2233.             so.  Using your word processor makes writing the file very easy,
  2234.             as you are already familiar and probably very comfortable with
  2235.             your program.  If you are not familiar with reading and writing
  2236.             ASCII files with your word processor, be sure to review your
  2237.             manual for instructions.  
  2238.  
  2239.                 DO NOT try to create NAMEVIEW.DAT by using your normal Save
  2240.             option.  Doing so will result in special formatting codes being
  2241.             saved along with your text, and NAMEVIEW will be unable to read
  2242.             the file correctly.  Check for special quirks of your program
  2243.             that may thwart your efforts for an ASCII save.  For example, I
  2244.             use WordPerfect 4.2 at times to write ASCII files.  The ASCII
  2245.             save is pretty straight-forward (press Ctrl + F5, then choose #1
  2246.             from the menu presented).  The problem comes when you exit the
  2247.             program after your ASCII save.  When you select EXIT, you are
  2248.             asked if you want to save your document.  You MUST choose NO at
  2249.             this point.  If you choose yes, the file is saved again in
  2250.             formatted form, and it will overwrite the ASCII version which
  2251.             you originally saved.
  2252.  
  2253.                 If your word processor is not capable of reading and writing
  2254.             ASCII files, chose one of the other methods available to you.
  2255.  
  2256.        TED - (Tiny EDitor), an excellent full screen editor
  2257.                 TED is a tiny, full screen editor intended for line-oriented
  2258.             files up to 64k in size.  It was written by Tom Kihlken and made
  2259.             available for non-commercial public use by PC Magazine.  It
  2260.             makes full use of the keypad cursor keys for moving and scroll-
  2261.             ing, and it lets you cut, copy, paste, and print.  TED has been
  2262.             distributed free along with the NAMEVIEW files for your con-
  2263.             venience in writing your NAMEVIEW.DAT file.  This is probably
  2264.             the simplest and easiest way to handle your ASCII file process-
  2265.             ing needs.
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.                                          38
  2277.                                     Appendix B
  2278.  
  2279.  
  2280.                            Problems and Error Messages 
  2281.  
  2282.        For DOS error messages which occur prior to NAMEVIEW loading and
  2283.        starting, see your DOS manual.  There are numerous errors which
  2284.        NAMEVIEW specifically guards for.  Errors which occur prior to the
  2285.        presentation of the menu are announced in a prominent error message
  2286.        box.  Errors which occur with menus or once the message screen is
  2287.        entered are presented in the Information Line area.  If you are
  2288.        presented with an "Information Line Error," pressing <ENTER> will
  2289.        erase the error message and resume normal operations.  The operation
  2290.        which caused the error will not be resumed or retried automatically
  2291.        by NAMEVIEW.
  2292.  
  2293.        The following messages may appear on the Information line to alert
  2294.        you of unusual circumstances or to advise you to check certain DAT
  2295.        file parameters:
  2296.  
  2297.        Information Line Message      Description of problem
  2298.        ---------------------------   --------------------------------------
  2299.        Check FIRST LINE Parameter!   NAMEVIEW has searched the entire file
  2300.                                      specified without finding a First Line
  2301.                                      indicator.  This message advises you to
  2302.                                      correct this part of your DAT file in
  2303.                                      order to read the message.  See the
  2304.                                      "NAMEVIEW.DAT file - Message Format
  2305.                                      Section" for details.
  2306.  
  2307.        Check LAST LINE Parameter!    NAMEVIEW has calculated that all of
  2308.                                      your message units have resulted in
  2309.                                      overflow being processed.  This is a
  2310.                                      prime indicator of an incorrect Last
  2311.                                      Line parameter in your DAT file.  See
  2312.                                      the "NAMEVIEW.DAT file - Message Format
  2313.                                      Section" for details.
  2314.  
  2315.  
  2316.  
  2317.                               Miscellaneous Problems
  2318.  
  2319.        If your specified command line colors do not appear:
  2320.  
  2321.             They were probably specified incorrectly on the command line. 
  2322.             Both numbers specified on the command line must be between the
  2323.             values of 0 and 15.  See the "Command Line Parameters" section
  2324.             for details.
  2325.  
  2326.  
  2327.        If each message unit shown onscreen seems to contain several actual
  2328.        messages:
  2329.  
  2330.             You should toggle to NoEcho mode (press "E").  If the onscreen
  2331.             presentation immediately changes to a single message, then
  2332.  
  2333.                                          39
  2334.             remain in NoEcho mode.  If this does not solve the problem, and
  2335.             you are operating with Line Wrap set to OFF, then you need to
  2336.             toggle Line Wrap to ON (press "L").  You can change either/both
  2337.             of these settings at the Set Up Menu, by pressing "E" or "L" to
  2338.             toggle them while viewing messages, or by adding a Configuration
  2339.             Line to the appropriate Message Format Block in your DAT file.
  2340.  
  2341.  
  2342.        If your Information Line seems to partially disintegrate:
  2343.  
  2344.             You are probably operating with Line Wrap Check set OFF and you
  2345.             scrolled down through a message containing lines longer than 80
  2346.             characters.  Toggle Line Wrap Check back ON (press "L") - your
  2347.             Information Line will be rebuilt, NAMEVIEW will reprocess the
  2348.             message to shorten any offending over-length lines, and further
  2349.             scrolling should be without further discrepancies.  Keep your
  2350.             Line Wrap Check ON (default mode) if you encounter this problem
  2351.             often.
  2352.  
  2353.  
  2354.        If NAMEVIEW freezes with only "ENTER to continue" visible on the
  2355.        Information Line:
  2356.  
  2357.             You have encountered an unrecoverable error due to the Line Wrap
  2358.             parameter being toggled OFF.  Restart NAMEVIEW and leave the
  2359.             Line Wrap parameter in the default setting of ON.
  2360.  
  2361.  
  2362.                               Specific Error Messages
  2363.  
  2364.             The following are errors which may be announced after NAMEVIEW
  2365.        has initially loaded:
  2366.  
  2367.        Error Message                      Error Explanation or Fix
  2368.        ===============================    =================================
  2369.        Attempt to ReName - File Al-       You already had a "marked" file
  2370.        ready Exists!                      with the same base name as the
  2371.                                           file you are attempting to "mark." 
  2372.                                           DOS has rejected your attempt to
  2373.                                           make "duplicate" files.
  2374.  
  2375.        Bad format in DAT file, can't      NAMEVIEW can't read your DAT file
  2376.        continue (press ESC to exit)       on initial startup, as it is
  2377.                                           formatted so badly as to be un-
  2378.                                           recognizable.  (If you used your
  2379.                                           word processor to create it, you
  2380.                                           might check to see if you forgot
  2381.                                           to save it in DOS or ASCII format)
  2382.  
  2383.        Can't Access PRINTER, DRIVE,       The printer (LPT#) or disk drive
  2384.        or PATH specified                  you are attempting to access is
  2385.                                           not on line or does not exist.
  2386.  
  2387.                                           The path you specified does not
  2388.                                           exist
  2389.  
  2390.                                          40
  2391.        CAN'T FIND ANY NAME????.DAT        NAMEVIEW has looked for both
  2392.        FILES!  They must be located in    NAMEVIEW.DAT and NAMEDROP.DAT
  2393.        the default Drive and Direc-       files and can't find either in the
  2394.        tory!                              current drive & directory.  Cor-
  2395.                                           rect the problem and restart the
  2396.                                           program.
  2397.  
  2398.        DISK in specified drive is         There is not enough room on the
  2399.        FULL                               disk for the completion of the
  2400.                                           current PRINT operation.
  2401.  
  2402.        DISK Missing, Unformatted,         No disk in drive specified or the
  2403.        Flawed, or Write-Protected         locking lever/door is not lock-
  2404.                                           ed/closed on the specified drive.
  2405.  
  2406.                                           An attempt was made to read or
  2407.                                           write to an unformatted disk.
  2408.  
  2409.                                           Your disk drive hardware has
  2410.                                           detected a physical flaw on the
  2411.                                           disk.
  2412.  
  2413.                                           An attempt to write to a write-
  2414.                                           protected disk was made.  Replace
  2415.                                           disk with non-write-protected
  2416.                                           disk, or remove write protection.
  2417.  
  2418.        Illegal FILENAME (too many or      A filename specified in your NAME-
  2419.        improper characters) -             VIEW.DAT file does not conform to
  2420.                                           DOS filename specifications.  You
  2421.                                           will see this error only when you
  2422.                                           attempt to write to the file using
  2423.                                           the illegal filename.  No error
  2424.                                           checking is done on Sort File
  2425.                                           names when they are read from the
  2426.                                           .DAT file.
  2427.  
  2428.        PRINTER is OFF, OFF-Line, or       Check ON/OFF switch!
  2429.        OUT of PAPER
  2430.                                           Check the printer on-line light
  2431.                                           and correct the situation.
  2432.  
  2433.                                           Add paper!
  2434.  
  2435.        Problem loading DAT file...no      NAMEVIEW couldn't make sense out
  2436.        data loaded                        of the NAME????.DAT or NAMEVDAT.*
  2437.                                           file which you attempted to load. 
  2438.                                           Check for proper formatting (see
  2439.                                           the section on Preparing your
  2440.                                           NAMEVIEW.DAT file) or select
  2441.                                           another support file to use.
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.                                          41
  2448.                                     Appendix C
  2449.  
  2450.  
  2451.                            NAMEVIEW Upgrade Enhancements
  2452.  
  2453.                                Current version 3.03
  2454.  
  2455.        The NAMEVIEW shareware version can be identified as #.##S###, and the
  2456.        registered version can be identified as #.##R###.
  2457.  
  2458.         
  2459.        Version 0.00  -  No number...first BETA test program
  2460.  
  2461.  
  2462.        Version 1.00  -  Original program release
  2463.  
  2464.  
  2465.        Version 1.01  -
  2466.  
  2467.             1.  "Esc" key bug fix.
  2468.             Fixed a bug in the "Esc" routine which would disable the PgUp
  2469.        and PgDn keys if an "Esc" key press was aborted (return to program
  2470.        operation instead of terminating program).
  2471.             2.  Additional Error Routines.
  2472.             Error routine improved to give specific "Duplicate words in
  2473.        search list," "I/O Error...can't continue," and "Probable hardware
  2474.        error in specified drive" error messages.
  2475.  
  2476.  
  2477.        Version 1.02  -
  2478.  
  2479.             1.  Error Routine Bug Fix.
  2480.             Fixed bug in "Probable bad <Last Line> entry in .DAT file"
  2481.        routine.  Program used to hang, necessitating reboot when this error
  2482.        occurred rather than displaying the error message.  NAMEVIEW now
  2483.        correctly identifies and displays the error message before
  2484.        terminating.
  2485.             2.  Print Routine Bug Fix.
  2486.             Fixed a bug which would sometimes dump the program when a
  2487.        message was printed and then immediately saved to an FKey file.
  2488.             3.  Null ".DAT" File Entry Errors Eliminated.
  2489.                  This routine was added to strip any null entries found at
  2490.                  the end of the NAMEVIEW.DAT file, eliminating one of the
  2491.                  most common problems with setting the program up.
  2492.             4.* Added "Name(s) Found in Message Indication.
  2493.                  Added a blinking "Pg" indication that names have been found
  2494.                  in the onscreen message if Read ALL messages parameter is
  2495.                  chosen.
  2496.  
  2497.  
  2498.        for items marked with "*", see the Features section for more details
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.                                          42
  2505.        Version 1.03  -
  2506.  
  2507.             1.* Extended Keyboard Interface added.
  2508.                  NAMEVIEW features can now be activated by several different
  2509.                  keys, depending on your preference.  Grey keys on enhanced
  2510.                  keyboards (with BIOS support) now work.
  2511.             2.* Caps Lock and Num Lock no longer changed.
  2512.                  NAMEVIEW no longer messes with your locking key settings. 
  2513.                  Instead, it will trap all possible combinations of the hot
  2514.                  keys so they will activate regardless of the locking key
  2515.                  settings.
  2516.             3.  Help Section Bug Fix.
  2517.                  Fixed a bug which would cause a crash if Help was selected
  2518.                  while paused at the opening menu.
  2519.  
  2520.  
  2521.        Version 1.04  -
  2522.  
  2523.             1.* Line Wrap Check added.
  2524.                  NAMEVIEW can now check for and correct excessive line
  2525.                  lengths and missing carriage returns.  This is essentially
  2526.                  a fix for errors which are due to BBS software problems.
  2527.             2.  Hot Key bug fix.
  2528.                  Several hot key bugs which crept in with the change over to
  2529.                  the Extended Keyboard Interface have been corrected.
  2530.  
  2531.  
  2532.        Version 2.00  -
  2533.  
  2534.             1.* Smart Point & Shoot download file selection added.
  2535.                  NAMEVIEW displays only those files which have filename
  2536.                  extensions described in your NAMEVIEW.DAT file.  Any drive
  2537.                  and/or directory can be targeted for file listing.
  2538.             2.  Multiple download file reading capability added.
  2539.                  Users can now read numerous download files without having
  2540.                  to reload NAMEVIEW for each one.
  2541.             3.* Mark File feature added.
  2542.                  At your option, you can mark a download file as having been
  2543.                  read without deleting it.
  2544.             4.* Book Mark feature added.
  2545.                  You can now stop in the middle of reading a download file,
  2546.                  mark your place, and return to where you left off later.
  2547.             5.* AutoLoad feature added.
  2548.                  If selected, registered users can automatically load a file
  2549.                  named to reflect the current date on start-up.
  2550.             6.* Reverse Read feature added.
  2551.                  Users can now back up and view previous messages.
  2552.             7.* Print + Form Feed feature added.
  2553.                  Users can now optionally select a print feature which adds
  2554.                  a form feed after your message is printed.
  2555.  
  2556.  
  2557.        for items marked with "*", see the Features section for more details
  2558.  
  2559.  
  2560.  
  2561.                                          43
  2562.             8.* Active parameter switching added.
  2563.                  Users can now change the Line Wrap Check, Message (ALL or
  2564.                  Search Word), Sound, and Upper Case Check parameters at any
  2565.                  time while messages are being read.
  2566.             9.  Right-most spaces and null items are now automatically
  2567.                   trimmed from search list entries.
  2568.                  These items caused lots of problems in getting your search
  2569.                  list set up so NAMEVIEW would work correctly.  NAMEVIEW now
  2570.                  does the work for you!
  2571.            10.  Active menu file-protection feature added.
  2572.                  NAMEVIEW will not let you delete a file which has not been
  2573.                  read yet, or which has been "book marked."
  2574.            11.  Automatically set Find Book Mark parameter.
  2575.                  NAMEVIEW automatically sets the Find Book Mark parameter to
  2576.                  YES when a download file which has had a book mark placed
  2577.                  has been selected.
  2578.            12.  Screen printing routine enhanced.
  2579.                  Printing of highlighted items is now approximately 50%
  2580.                  faster.
  2581.            13.  Prohibition on repeated words in the search list is deleted.
  2582.                  This problem was cured simultaneously with the faster
  2583.                  screen printing routine!
  2584.            14.  Line Wrap check enhanced
  2585.                  Code was changed to eliminate errors (& freeze-ups) which
  2586.                  could occur in some special circumstances.
  2587.  
  2588.  
  2589.        Version 2.01  -
  2590.  
  2591.             1.* Added Custom Message Screen Color ability
  2592.                  Registered versions now allow user defined colors for the
  2593.                  message screen.
  2594.             2.* Print device can now be specified
  2595.                  Registered versions allow user definition of the desired
  2596.                  print device.
  2597.             3.  Added "File Already Exists" error protection.
  2598.                  Protects from crashes if "marking" a file will result in
  2599.                  duplicate file names (another file already has the name
  2600.                  that the current file will have when the "#" is added).
  2601.             4.  Code cleanup & consolidation.
  2602.                  Always trying to make it smaller and faster!
  2603.  
  2604.  
  2605.        Version 2.02  -
  2606.  
  2607.             1.* Fail Safe Message Processing added.
  2608.                  Earlier versions would drop those message lines in excess
  2609.                  of 240 until the next Last Line indicator was found. 
  2610.                  NAMEVIEW now automatically creates a new "Message Unit" to
  2611.                  contain all excess message lines.
  2612.  
  2613.  
  2614.        for items marked with "*", see the Features section for more details
  2615.  
  2616.  
  2617.  
  2618.                                          44
  2619.             2.  Line Wrap checking enhanced for more consistent results.
  2620.             3.  Fixed bug which would load multiple messages if tag lines
  2621.                 exceeded 80 characters.  Line Wrap Check must be selected ON
  2622.                 for this protection to work.
  2623.             4.  Fixed "Lost Cluster" bug.
  2624.                  Versions 2.00 and 2.01 would cause lost clusters on the
  2625.                  disk where directory searches were performed.  See Appendix
  2626.                  D for directions on how to recover lost clusters.
  2627.  
  2628.  
  2629.        Version 2.03  -
  2630.  
  2631.             1.  Fixed Information Line Action Message bug.
  2632.                  Earlier versions would not correctly set and retain the
  2633.                  blinking "Searching" message when Reverse Read was select-
  2634.                  ed.
  2635.             2.  Added Leading Tab detection to Line Wrap Check.
  2636.                  This enhancement was added after experiencing problems with
  2637.                  download file messages in which tab characters were found
  2638.                  at the beginning of a line.  This would cause erroneously
  2639.                  placed highlighting to occur on those lines.
  2640.             3.  Searching speed improved.
  2641.                  Due to coding changes/enhancements, program speed during
  2642.                  Special Search runs has been improved by approximately 10%. 
  2643.                  The improvement for normal searches using your search list
  2644.                  is somewhat less than 10%.
  2645.  
  2646.  
  2647.        Version 2.04  -
  2648.  
  2649.             1.* Intelligent End-of-File Detection.
  2650.                  NAMEVIEW now checks to see if the EOF has actually been
  2651.                  reached whenever it detects the EOF character before ter-
  2652.                  minating with the "Last Message" indicator.
  2653.             2.  Fixed bug which would let the user progress past the File
  2654.                 Menu without having selected a download file.
  2655.  
  2656.  
  2657.        Version 2.05  -
  2658.  
  2659.             1.  True DOS 2.11 - 5.0 Compatibility.
  2660.                  Versions 2.00 through 2.04 would crash when trying to list
  2661.                  files on systems using DOS versions earlier than 3.00. 
  2662.                  Code has been changed to eliminate this problem and file
  2663.                  listing speed has been greatly improved.  Code has been
  2664.                  test run successfully on DOS versions 2.11 through 5.0.
  2665.             2.* Sound usage changed to enhance "hit" detection.
  2666.                  With the sound parameter set "ON", NAMEVIEW will sound a
  2667.                  special chime to signify that a message containing a "hit"
  2668.                  has been placed onscreen when ALL messages are being read. 
  2669.                  (Works the same as the blinking "Pg" on the Information
  2670.                  Line).
  2671.  
  2672.  
  2673.        for items marked with "*", see the Features section for more details
  2674.  
  2675.                                          45
  2676.             3.* Line Wrap Check default parameter changed to ON.
  2677.                  Changed to ON to provide fail-safe message parsing/formatt-
  2678.                  ing.  Those users who read the documentation and therefore
  2679.                  know how to check to see if this parameter is needed may
  2680.                  get the benefits of an increase in search speed.
  2681.             4.* Number of available Sort Files increased.
  2682.                  The number of user-defined sort files has been increased
  2683.                  from 10 to 20.  The first 10 sort files (listed in your DAT
  2684.                  file) are selected by the 10 function keys.  The next 10
  2685.                  sort files are selected by using ALT + Function keys.
  2686.  
  2687.  
  2688.        Version 2.06  -
  2689.  
  2690.             1.* Cleanup routine added.
  2691.                  Cleanup will do an in-depth search of the onscreen message
  2692.                  for those low ASCII characters which may be causing video
  2693.                  formatting problems.  Use it if the screen presentation of
  2694.                  a message appears strange.
  2695.             2.* DESQVIEW compatible mode added.
  2696.                  Differences in video memory assignments when running under
  2697.                  DESQVIEW made it necessary to add this enhancement.  DESQ-
  2698.                  VIEW compatibility is gained at the expense of losing video
  2699.                  "paging" capability.
  2700.             3.  Fixed a bug in the Processing OVERFLOW information message.
  2701.                  Nobody noticed this one, but it is fixed anyway.
  2702.  
  2703.  
  2704.        Version 2.07  -
  2705.  
  2706.             1.* FIDO noEcho mode added.
  2707.                  NAMEVIEW now correctly separates messages which have not
  2708.                  been "echoed" on FIDO BBS systems (no "* Origin" line
  2709.                  added) when this toggle is set to YES.
  2710.             2.  Bad DAT file format error trap and warning message added.
  2711.                  NAMEVIEW will now report an unrecognizable DAT file format
  2712.                  instead of hanging.
  2713.             3.  Fixed a bug in the Back-Up feature.
  2714.                  Nobody noticed this one, but it is fixed.
  2715.             4.  Fixed a bug in the Special Search routine.
  2716.                  NAMEVIEW would not correctly restore the first item in your
  2717.                  search list after a special search if Special Search was
  2718.                  reset to NO.  Another one fixed before it was even
  2719.                  reported!
  2720.  
  2721.  
  2722.        Version 2.08  -
  2723.  
  2724.             1.* NoEcho Mode enhanced.
  2725.                  The original FIDO NoEcho mode was designed to work only
  2726.                  with messages originating on the FIDO network.  This en-
  2727.                  hancement enables NAMEVIEW to separate nonEchoed messages
  2728.                  originating from any network.  The automatic reformatting
  2729.                  feature (on toggling NoEcho mode) was also added.
  2730.  
  2731.  
  2732.        for items marked with "*", see the Features section for more details
  2733.  
  2734.                                          46
  2735.             2.  Keyboard changes for some toggled modes.
  2736.                  The Message Display (ALL or those with "hits") toggle key
  2737.                  was changed from "M" to "D".  This makes all toggle keys
  2738.                  case INsensitive for easier keyboarding (upper or lower
  2739.                  case "M" will now recall the Menu).
  2740.             3.  Command Line entries changed.
  2741.                  Command line entries were changed for compatibility with
  2742.                  the hot key toggles ("D" used on command line to change
  2743.                  Message Display mode).
  2744.             4.  Overflow Message deleted.
  2745.                  This message appeared onscreen so briefly when it was
  2746.                  called, that most users didn't have time to notice it
  2747.                  anyway.
  2748.             5.  Small sorting bug fixed in the download file listing.
  2749.                  Another non-reported bug fix.
  2750.  
  2751.  
  2752.        Version 2.09  -
  2753.  
  2754.             1.  Fixed bug in toggle for NoEcho feature.
  2755.                  This bug caused the NoEcho feature to toggle each time a
  2756.                  new file was selected to read.  It also caused intermittent
  2757.                  problems with reading files.
  2758.             2.  Fixed bug in time display of file listing.
  2759.                  This bug caused random numbers to be displayed in the file
  2760.                  creation time column of the file listing.  Occasionally, it
  2761.                  would also crash the program.
  2762.  
  2763.  
  2764.        Version 3.00  -
  2765.  
  2766.             1.  New linking library used (Crescent Software PDQ).
  2767.                  Linking with the PDQ library has produced a considerable
  2768.                  increase in speed and an EXE file size reduction to ap-
  2769.                  proximately 50% of the size of version 2.09 in spite of
  2770.                  numerous enhancements.  Using the special search feature to
  2771.                  provide a quasi benchmark for continuous file reading/-
  2772.                  searching has shown search times taking less than 1/2 the
  2773.                  time of version 2.09 searches.
  2774.             2.* New Screen Routines added for better message viewing.
  2775.                  True line scrolling as well as Home and End key functions
  2776.                  have been added.  PgUp and PgDn functions were slightly
  2777.                  modified.  Direct video writing is now used for screen
  2778.                  printing for fastest speed and greatest accuracy.
  2779.             3.* Error routines consolidated and simplified.
  2780.                  The number of error messages has been reduced, but enough
  2781.                  information is still provided to allow for recovery of all
  2782.                  expected user/hardware errors.
  2783.             4.  Internally controlled file buffer added.
  2784.                  NAMEVIEW now contains an internal file buffer which it
  2785.                  fully controls.  This has resulted in significant increases
  2786.                  is search throughput due to faster file reads.
  2787.  
  2788.  
  2789.        for items marked with "*", see the Features section for more details
  2790.  
  2791.                                          47
  2792.             5.* Enhanced DAT file capability.
  2793.                  You can now maintain and use an unlimited number of DAT
  2794.                  files.  A descriptive remark can be added to each DAT file
  2795.                  for easy identification and viewing while making DAT file
  2796.                  selections.  A total of 10 Message Format Blocks can now be
  2797.                  defined in each DAT file.
  2798.             6.  Auto parameter setting for each format block.
  2799.                  Each Message Format Block can now contain custom configura-
  2800.                  tion information which is loaded automatically when a file
  2801.                  using that MFB is selected.
  2802.             7.* Autoload enhanced.
  2803.                  The autoload feature now searches successively for current-
  2804.                  ly dated files with any of the suffixes contained in the
  2805.                  current DAT file.
  2806.             8.  CleanUp routine removed.
  2807.                  Changing to direct video writes for screen printing re-
  2808.                  sulted in the CleanUp routine becoming unnecessary.  All
  2809.                  characters are now echoed to the screen exactly as they
  2810.                  were downloaded and stored.
  2811.             9.* Toggle settings now displayed on Information Line
  2812.                  The status of the Configuration settings which can be
  2813.                  toggled while reading messages are now displayed on the
  2814.                  Information Line.  This eliminates any guessing as to what
  2815.                  the current setting for any parameter might be.
  2816.  
  2817.  
  2818.        Version 3.01  -
  2819.  
  2820.             1. *AutoLoad enhanced some more.
  2821.                  The AutoLoad routine call was added after the file kill
  2822.                  routine (should have been there in 3.00!).
  2823.             2.  Made some small code optimizations.
  2824.  
  2825.  
  2826.        Version 3.02  -
  2827.  
  2828.             1.  Changed file input routine for Blue Wave compatibility.
  2829.                  The Blue Wave message bundler uses only a CR code between
  2830.                  each message line rather than the more usual CR/LF
  2831.                  combination.  Earlier versions (prior to 3.00) of NAMEVIEW
  2832.                  used a different file input routine which automatically
  2833.                  compensated for this.  The new file input routine used in
  2834.                  versions 3.00 and later has now been changed to work with
  2835.                  either method of message line delimitation.
  2836.             2.  Corrected Menu display bug.
  2837.                  The File Menu now correctly displays the next AutoLoaded
  2838.                  file following a "Kill" operation.
  2839.  
  2840.  
  2841.        Version 3.03  -
  2842.  
  2843.             1.  Small code change to speed up directory listings.
  2844.  
  2845.  
  2846.        for items marked with "*", see the Features section for more details
  2847.  
  2848.                                          48
  2849.                                     Appendix D
  2850.  
  2851.  
  2852.                              Registration and Support
  2853.  
  2854.        If you become a regular user of NAMEVIEW, please support it by regis-
  2855.        tering.  The forms on the following page are included for your con-
  2856.        venience.  
  2857.  
  2858.        NOTE:  Only 360k, 5 1/4" disks are supported at this time.
  2859.  
  2860.        If you wish to obtain additional information not covered in this
  2861.        documentation or to make comments or suggestions about NAMEVIEW,
  2862.        contact:
  2863.  
  2864.             Ray Cox
  2865.             17410 Huntersglen
  2866.             Humble, TX  77396-1622
  2867.             713-454-6074
  2868.  
  2869.        NAMEVIEW was designed and written for genealogy users.  If you have a
  2870.        question or problem that may be of interest to others, you may ad-
  2871.        dress a message to me, Ray Cox, on the GENSOFT BBS Conference (or the
  2872.        National Genealogical Conference - NGC - if GENSOFT isn't available
  2873.        to you) via any BBS which supports it.  I download and review mes-
  2874.        sages from these conferences at least three times a week, and will
  2875.        answer all messages using that medium.
  2876.  
  2877.        The fee for "paper" registration only (no disk sent!) is $10.00.  For
  2878.        a personally serialized copy (without the "beg" screen) send $15.00. 
  2879.        Upgrades will be provided to registered users for $5.00.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.                                          49
  2906.        NAMEVIEW Registration:  "Paper" ($10.00)____  Send Disk ($15.00)____
  2907.  
  2908.        Name ____________________________________  Phone ___________________
  2909.  
  2910.        Address _________________________________
  2911.  
  2912.        City, State _____________________________   Zip ____________________
  2913.  
  2914.        I understand that my registered version of NAMEVIEW is not for public
  2915.        distribution, but is solely for my own use.
  2916.  
  2917.        Signature ___________________________________
  2918.  
  2919.        Disk configuration:  1 floppy_____ 2 floppy_____ Hard Disk_____
  2920.  
  2921.        Video:  Color_____ Mono_____    System memory:  ___________k
  2922.  
  2923.                Windows_____  DESQView_____
  2924.  
  2925.        Where did you get NAMEVIEW? ______________________________________
  2926.  
  2927.        NAMEVIEW Shareware version number: _______________________________
  2928.        (appears in reverse video bar as v#.##L### while MENU is onscreen)
  2929.  
  2930.        Suggestions, Comments ____________________________________________
  2931.  
  2932.        __________________________________________________________________
  2933.  
  2934.        __________________________________________________________________
  2935.        ==================================================================
  2936.                              NAMEVIEW Upgrade ($5.00)
  2937.  
  2938.        Name ____________________________________  Phone ___________________
  2939.  
  2940.        Address _________________________________
  2941.  
  2942.        City, State _____________________________   Zip ____________________
  2943.  
  2944.        NAMEVIEW serial no. _____________________________________
  2945.        (appears in reverse video bar as v#.##L### while MENU is onscreen)
  2946.  
  2947.        I understand that my registered version of NAMEVIEW is not for public
  2948.        distribution, but is solely for my own use.
  2949.  
  2950.        Signature ___________________________________
  2951.  
  2952.        Problems, Suggestions, Comments: _________________________________
  2953.  
  2954.        __________________________________________________________________
  2955.  
  2956.        __________________________________________________________________
  2957.  
  2958.        __________________________________________________________________
  2959.  
  2960.  
  2961.  
  2962.                                          50
  2963.