home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / disk / nosey_ii / nosey_ii.doc < prev   
Text File  |  1993-03-24  |  12KB  |  262 lines
  1.  
  2.    p **************************** q
  3.    p *                          * q
  4.    p *     NOSEY II             * q
  5.    p *     Version 1.5          * q
  6.    p *     Copyright 1993   /~  * q
  7.    p *     F10 Software   @/    * q
  8.    p *                          * q 
  9.    p **************************** q
  10.  
  11.  
  12.    WHAT IS NOSEY ?
  13.  
  14.    If you are like me, you have many disks filled with ZNETs, AEOs,
  15.    lists of on-line library files and word processor documents.
  16.   
  17.    When you want to find information on a subject you have to load a file
  18.    into your text reader and then do a search. Wrong file, OK, load the
  19.    next file and search again - this is very time consuming. Here is where
  20.    NOSEY II comes in. NOSEY lets you search up to 50 files at a time and
  21.    matches can be printed to your printer or to a disk file. Boolean AND,
  22.    OR and NOT searches are supported. Nosey II runs as a program or a desk
  23.    accessory.
  24.  
  25.    NOSEY is not a text reader, it is a locator. You may want to use your
  26.    normal text reader to peruse the file once you've located the
  27.    information you need.
  28.  
  29.    To use Nosey as an program, change the file extension from .ACC to PRG
  30.    1 Meg and under ST owners will probably want to use Nosey as a program
  31.  
  32.    **********************************************************************
  33.    *                                                                    *
  34.    *   Nosey II is shareware which means that it can be freely          *
  35.    *   distributed. It is not "public domain". If you decide that this  *
  36.    *   program is valuable enough for you to keep and use, please pay   *
  37.    *   for it. The price is $10.                                        *
  38.    *           Make out your check to:                                  *
  39.    *                                                                    *
  40.    *           Frank Vuotto                                             *
  41.    *           F10 Software                                             *
  42.    *           Box 2201                                                 *
  43.    *           Taos, New Mexico - 87571                                 *
  44.    *                                                                    *
  45.    *   NOTE: This DEMO version of NOSEY has a 15 minute time limit      *
  46.    *                                                                    *
  47.    *   Registered users can contact me by mail for a free upgrade.      *
  48.    *   Thanks in advance for your support.                              *
  49.    *                                                                    *
  50.    **********************************************************************
  51.  
  52.    ======================================================================
  53.    SELECTING FILES
  54.    ======================================================================
  55.  
  56.    Clicking on a box in the files list brings up the ST file selector.
  57.    Selecting a file adds it into the search list.
  58.  
  59.    SELECT MULTI
  60.    Select up to 50 files. When you have selected all the files you want
  61.    to search, click the file selector "CANCEL" button.
  62.  
  63.    SELECT ALL
  64.    Automatically selects the first (up to) 50 files in a directory and
  65.    adds them to search list. The two buttons labeled "1-25" and "26-50"
  66.    toggle between showing the first and second 25 selected files. All
  67.    selected files are searched.
  68.  
  69.    CLEAR
  70.    Deselects all files on the search list.
  71.  
  72.    CULL
  73.    While cull is selected, clicking on a file name clears it from the
  74.    search list. It is often easier to use SELECT ALL and then CULL the
  75.    files you don't want searched.
  76.  
  77.    FILE MASK
  78.    If a file mask is selected only files with that extender are shown in
  79.    the file selector and selected with SELECT ALL. The default is ".*"
  80.    which shows all files. Note that the last box ".ASC" can be edited.
  81.    You can switch the input cursor between the search string input and
  82.    this box with the up and down arrows on the middle ST keypad. Be sure
  83.    to select this box by clicking on it after changing the file extension.
  84.  
  85.    WILDCARD:
  86.    File selection by wildcard is also available. Typing "XYZ" in the
  87.    wildcard box will cause only files that start with XYZ to show in the
  88.    file selector or be selected with Select ALL. "?YZ" shows files with
  89.    "YZ" as their second and third characters (etc).
  90.  
  91.    ======================================================================
  92.    SEARCH STRING OPTIONS
  93.    ======================================================================
  94.  
  95.    Up to 26 characters may be entered into the search string field. Using
  96.    spaces can help "clean up" a search. For example "st" will find
  97.    "start" and "stop"  but "st " won't. You can change the search string
  98.    during a search while Nosey is paused.
  99.  
  100.    BOOLEAN SEARCH
  101.    Nosey supports Boolean logic AND,OR and NOT. Boolean words are
  102.    entered into a search string by holding the Control key while
  103.    pressing the A, O or N key.
  104.  
  105.           AND     Control/a     shows up facing arrow
  106.           OR      Control/o     shows left side of Atari symbol
  107.           NOT     Control/n     shows right side of Atari symbol
  108.  
  109.    Boolean operators help you to define the search string more clearly.
  110.  
  111.                            calamus<control/a>font
  112.                            /          |          \
  113.                      1st string    Boolean     2nd string
  114.                                    symbol
  115.  
  116.    This example will only show a match if "calamus" AND "font" are in
  117.    the same line of text.
  118.  
  119.    Only one Boolean word can be used and the 1st and 2nd strings must be
  120.    found on the same line during a search (This may be expanded on in
  121.    the future if there is enough interest).
  122.  
  123.    CASE 
  124.    When selected, only a match with the same case as the search string
  125.    will be located.
  126.  
  127.    ======================================================================
  128.    FORMAT
  129.    ======================================================================
  130.  
  131.    ASCII
  132.    This is the default format. If the document shows strange line spacing
  133.    or incomplete lines, try the "OTHER" format
  134.  
  135.    WW
  136.    If you have ever tried to view Word Writer files with an ASCII viewer
  137.    you undoubtable noticed that in .DOC files the words are separated with
  138.    funny characters. In the WW format, these are changed to spaces.
  139.  
  140.    OTHER
  141.    The OTHER format attempts to accommodate all other word processor
  142.    documents by reading the file 1 character at a time until it finds
  143.    a carriage return, a line feed or it has input 80 characters. It will
  144.    sometimes split a word with some document types. I have tested this
  145.    mode with Wordflair, STW and Calamus .CTX files. If you have a document
  146.    that the OTHER or ASCII format will not handle, send me a copy and I
  147.    will try to make NOSEY compatible.
  148.  
  149.    NOTE: Both the WW and OTHER format are slower than ASCII since extra
  150.    processing is involved.
  151.  
  152.    ======================================================================
  153.    SEARCH
  154.    ======================================================================
  155.  
  156.    When a match is found, an 80 character line containing the search
  157.    string is displayed in inverse text at the bottom of the dialog box 
  158.    and the line preceding it in the file is displayed above it. NOSEY 
  159.    will search non-ASCII files but expect some strange displays. If
  160.    a file cannot be found or there is some other problem, the file is
  161.    skipped and the search continued.
  162.  
  163.    NEXT MATCH
  164.    When a match is found, NOSEY will pause and wait for "NEXT MATCH" to 
  165.    be selected before continuing the search. The return key also selects
  166.    NEXT MATCH.
  167.  
  168.    ======================================================================
  169.    DISPLAY OPTIONS
  170.    ======================================================================
  171.  
  172.    SHOW PROGRESS
  173.    The location and line number are continually updated if "PROG"
  174.    is selected. Progress reports slow a search considerably.
  175.    When a match is found, the location, line and match numbers are
  176.    always reported.
  177.    
  178.    SCROLL
  179.    If you select "Scroll", every line of the file will be shown at the
  180.    selected scroll speed.
  181.  
  182.    DOWN ARROW
  183.    Displays the next line in the file.
  184.  
  185.    UP ARROW
  186.    Moves the display a few lines previous.
  187.  
  188.    PREVIOUS MATCH
  189.    Displays the previous match. Sometimes Nosey will go back 2 matches
  190.    when previous is selected.
  191.  
  192.    SHOWMORE
  193.    Selecting SHOWMORE shows several lines preceding and after a match.
  194.    While in the SHOWMORE mode you can print what is displayed and move
  195.    around in the file with the up and down arrows. Selecting "Top"
  196.    moves you to the start of the current file. Note that moving around
  197.    the file in SHOWMORE does not affect where the search will resume when
  198.    "Return To Search is selected.
  199.  
  200.    ======================================================================
  201.    PRINT OPTIONS 
  202.    ======================================================================
  203.  
  204.    PRINT
  205.    Prints what is currently displayed to your printer or to a disk file
  206.    if one has been selected. You can use the up and down arrows together
  207.    with "Print" to print more of the file surrounding the match.
  208.  
  209.    L#, T and B Boxes
  210.    If L# is selected the line and match numbers are included in the
  211.    printout. If T is selected the line previous to the match (the top
  212.    line of the results display) is printed and B includes the line
  213.    containing the match. You will probably always want B selected and
  214.    line numbers help separate consecutive matches.
  215.  
  216.    NOTE * Nosey is somewhat intelligent while printing. If L# is selected
  217.    and matches are found on 2 or more consecutive lines only the first
  218.    line number is printed. Likewise, Nosey will not print a line if it
  219.    is exactly the same as the last line printed or it is blank. This cuts
  220.    down on the amount of redundant printing when both T and B are
  221.    selected.
  222.  
  223.    DISK
  224.    The print to disk option is selectable only while Nosey is paused.
  225.    Enter a name for the destination file or select a file from the file
  226.    selector.  If the file already exists, you can choose to overwrite the
  227.    file, append the new information to the end of the file or cancel
  228.    the print to disk function. DO NOT print to a file that is on the
  229.    search list! Print to disk works great to a ram disk.
  230.  
  231.    AUTO
  232.    The auto print function is also selectable only while Nosey is paused.
  233.    When selected, AUTO prints every match to your printer or to a disk
  234.    file if DISK has been selected. Often AUTO print may not give you the
  235.    results you desire because you don't have a choice of what is printed.
  236.    With the manual print function you can use the up and down arrows to
  237.    select what is printed. Sometimes the match and the line after it more
  238.    clearly represent what you are looking for. This is especially true
  239.    with GEnie file lists.
  240.  
  241.    CANCELING A SEARCH
  242.    There are two boxes containing diamonds on either side of "Search
  243.    In Progress". Clicking the left box abandons the search and selecting
  244.    the right box advances the search to the next file (if there is one).
  245.  
  246.    RESTART
  247.    Selecting the small "R" box allows you to restart the current file
  248.    or the entire search.
  249.  
  250.    ======================================================================
  251.    Any suggestions for improving NOSEY are welcome.
  252.    
  253.    F10 Software support is available on the GEnie MIDI Bulletin Board
  254.    (m430;1), Category 3, Topic 41. If you have any suggestions, problems
  255.    or comments, you can post them there or contact me via Email.
  256.    
  257.    Frank              /~                                       
  258.    F10 Software     @/                                         
  259.    GEnie F.VUOTTO                                              
  260.    ======================================================================
  261.  
  262.