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