home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT103A.ZIP / PS44.EXE / lha / PSEARCH.DOC < prev    next >
Text File  |  1990-07-12  |  70KB  |  1,558 lines
  1.  
  2.                        PSEARCH 4.4a  Registration Request
  3.  
  4.         Thank you for your registration.  It is sincerely appreciated!
  5.         --------------------------------------------------------------------
  6.         VISA/Mastercard  orders  are only accepted through telephone orders.
  7.         Call the Public (Software) Library at 800-242-4775 to order NOW!
  8.         --------------------------------------------------------------------
  9.  
  10.         _____ Registration of all Patriquin Utilities with
  11.                 disk and bound User's Guide (over $125 value!)......$45.00
  12.  
  13.         When you register the below versions, you will receive registration
  14.         codes along with the latest version of the utility.
  15.  
  16.         _____ PSEARCH   -- Advanced find files with text............$20.00
  17.         _____ PCOPY     -- Advanced windowed DOS COPY alternative...$20.00
  18.         _____ PALERT    -- Warns you of low disk space..............$15.00
  19.         _____ PATTR     -- Manage attributes of DOS files...........$10.00
  20.         _____ PDAILY    -- Automatically execute commands once/day..$10.00
  21.         _____ PDELETE   -- Save space with automatic disk cleanup...$15.00
  22.         _____ PPRINT    -- Advanced file print w/special formats....$15.00
  23.  
  24.         _____ Next Update  Please send me the next version
  25.                            automatically when it is available.......$15.00
  26.  
  27.         _____ Update a registered set with new disk and manual.
  28.                  Registered users only Ser: __________   ...........$15.00
  29.  
  30.         *******************************************************************
  31.                       Disk Size?     5 1/4     3 1/2
  32.         *******************************************************************
  33.  
  34.         Name: __________________________________________________
  35.  
  36.         Company: _______________________________________________
  37.  
  38.         Address: _______________________________________________
  39.  
  40.                  _______________________________________________
  41.  
  42.         City: ________________________  State: ________  Zip: __________
  43.  
  44.         Please register the software under the following name:
  45.  
  46.              ____________________________________________________________
  47.  
  48.         I learned about the utilities from: ____________________________
  49.  
  50.         If BBS (name/number)____________________________________________
  51.  
  52.              Send to: Patri-Soft
  53.                       P.O. Box 8263
  54.                       San Bernardino, CA  92412
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                    P S E A R C H
  65.  
  66.  
  67.  
  68.                              -------------------------
  69.                              Users Guide and Reference
  70.                              -------------------------
  71.  
  72.  
  73.  
  74.  
  75.                                     Version 4.4a
  76.                                      July 1990
  77.  
  78.  
  79.  
  80.  
  81.                                           ┌─────────┐
  82.                                     ┌─────┴───┐     │              (tm)
  83.                                     │         │o    │──────────────────
  84.                                     │   ┌─────┴╨──┐ │  Association of
  85.                                     │   │         │─┘  Shareware
  86.                                     └───│    o    │    Professionals
  87.                                     ────│    ║    │────────────────────
  88.                                         └────╨────┘    * Member *
  89.  
  90.  
  91.  
  92.  
  93.  
  94.                            Patriquin's BBS  714-369-9766 
  95.  
  96.               Copyright 1986, 1987, 1988, 1989, 1990 by Patri-Soft
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.      PSEARCH Users Guide/Reference                Copyright 1990 Patri-Soft
  104.      ----------------------------------------------------------------------
  105.  
  106.                                Table of Contents
  107.  
  108.  
  109.      Introduction. . . . . . . . . . . . . . . . . . . . . . . . .   1
  110.      Features. . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  111.      Using PSEARCH . . . . . . . . . . . . . . . . . . . . . . . .   3
  112.         Using PSEARCH Menu Mode. . . . . . . . . . . . . . . . . .   3
  113.            Function Selection Menu . . . . . . . . . . . . . . . .   3
  114.            Text Search Entry Display . . . . . . . . . . . . . . .   5
  115.            File Name Search Entry Menu . . . . . . . . . . . . . .   6
  116.            Special Editing Functions . . . . . . . . . . . . . . .   7
  117.            Advanced Options Entry Menu . . . . . . . . . . . . . .   8
  118.            PSEARCH output data display . . . . . . . . . . . . . .   9
  119.         PSEARCH Command Line Mode. . . . . . . . . . . . . . . . .  11
  120.            Command Parameters. . . . . . . . . . . . . . . . . . .  11
  121.         Setting Default parameters in the DOS Environment. . . . .  22
  122.      Screen Colors and Monitor Support . . . . . . . . . . . . . .  23
  123.      Pausing the Search. . . . . . . . . . . . . . . . . . . . . .  23
  124.      Bonus Features for Registered Users . . . . . . . . . . . . .  23
  125.      Maintenance History . . . . . . . . . . . . . . . . . . . . .  24
  126.      Registering PSEARCH and other Patri-Soft Utilities. . . . . .  27
  127.      Site Licenses . . . . . . . . . . . . . . . . . . . . . . . .  28
  128.      VISA/MasterCard Telephone Registration Orders . . . . . . . .  28
  129.      PSEARCH Registration form . . . . . . . . . . . . . . . . . .  29
  130.      Reporting Problems  . . . . . . . . . . . . . . . . . . . . .  30
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.                                      i
  152.  
  153.  
  154.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  1
  155.      --------------------------------------------------------------------
  156.  
  157.      Introduction
  158.      ------------
  159.  
  160.      PSEARCH lets you easily locate lost or forgotten files on hard
  161.      disks or diskettes.  Since hard disk technology has made 70, 80,
  162.      150 megabyte, and larger hard disks commonplace, users keep more
  163.      information than ever stored in their PC systems.  It is not
  164.      uncommon for users to have over 2000 files on their hard disks.
  165.      This proliferation of files makes it very difficult to store files
  166.      with names and directory structures that can be easily remembered
  167.      and retrieved when files are later needed.
  168.  
  169.      When you need to find a file on your disk but do not know its
  170.      filename or even directory, you most always know something unique
  171.      about this file. If not, you would probably not be searching for
  172.      it.  This unique information might me a person's name, a product
  173.      name, a type of process, or even a location.  Whatever it is,
  174.      PSEARCH can take this information and use it to search all files on
  175.      the disk to identify one or more files that contain this unique
  176.      data.
  177.  
  178.      Since PSEARCH can reduce your search from a list of 2000 files to
  179.      just a few files, your job of locating a file becomes effortless.
  180.      Quick examination of a few files easily lets you know if the
  181.      desired file is on your disk.
  182.  
  183.      PSEARCH users have saved thousands of dollars in time searching for
  184.      files, and time that would have been used to recreate lost files.
  185.      PSEARCH becomes a invaluable tool for all hard disk users.
  186.  
  187.      PSEARCH goes farther than searching for data. Once files are found,
  188.      you can automatically invoke other DOS programs and utilities to
  189.      process them.  PSEARCH becomes a powerful driver for other programs.
  190.  
  191.      In addition to being flexible, PSEARCH is fast!  Our review of
  192.      available text search utilities showed PSEARCH to be the best
  193.      performer.  Our advanced search algorithm combined with
  194.      flexible selection and exclusion criteria insure PSEARCH can
  195.      find your files in the fastest possible time.
  196.  
  197.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  2
  198.      --------------------------------------------------------------------
  199.  
  200.      PSEARCH has functions and features that make it useful in many
  201.      different situations.  After reviewing this documentation and use
  202.      PSEARCH, we are confident you will find a permanent place for it in
  203.      your arsenal of tools.
  204.  
  205.      Here are a list of some of the many possible uses for PSEARCH.
  206.  
  207.      **   List all files on a hard disk that match a wildcard
  208.           specification.
  209.  
  210.      **   Show the names of any files containing specified text
  211.  
  212.      **   Show text lines of any file containing a specified string.
  213.  
  214.      **   Look for word "Mrs" in any file and preserve case in search.
  215.  
  216.      **   Find 123 files containing the word "BUDGET" and print their name.
  217.  
  218.      **   Compile all C programs that refer to the "RECDESC.H" include
  219.           file.
  220.  
  221.      **   Find a word processing document containing the name "Wiffle".
  222.  
  223.      **   Delete any *.DOC files containing "To: Mr. Johnson".
  224.  
  225.      **   Locate all readonly files existing on a disk.
  226.  
  227.      **   List all files updated today.
  228.  
  229.      **   Build a DOS command to archive manually selected files from one
  230.           or more directories.
  231.  
  232.      **   Search multiple drives attached to the system for text or a file
  233.           name
  234.  
  235.      **   Search for a file name even if it has been archived into .ZIP,
  236.           .ARC or .LZH formats.
  237.  
  238.      **   Limit text search to WORDS, PREFIXES, or SUFFIXES. This greatly
  239.           enhances the search by returning only the data you want.
  240.  
  241.      **   Ability to exclude files from the search process to greatly
  242.           improve search performance.
  243.  
  244.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  3
  245.      --------------------------------------------------------------------
  246.  
  247.      Using PSEARCH
  248.      -------------
  249.  
  250.      PSEARCH may be executed directly from the DOS prompt or using menus
  251.      that guide you through the process of entering search
  252.      specifications.  Both techniques use the same 'PS' command. PSEARCH
  253.      determines the difference in modes by the presence or absence of
  254.      command line parameters.  When no command parameters are used, menu
  255.      operation is selected.
  256.  
  257.  
  258.      Using PSEARCH Menu Mode
  259.      -----------------------
  260.  
  261.      To start PSEARCH using the menu mode, enter the PS command at the
  262.      DOS prompt and press the <Enter> key.  The following menu will
  263.      be displayed...
  264.  
  265.  
  266.      --------------------------------------------------------------------
  267.      PSEARCH - File Searcher                 Copyright 1990 by Patri-Soft
  268.                                                                                 
  269.                     F U N C T I O N   S E L E C T I O N                         
  270.                                                                                 
  271.             Select the PSEARCH activity you want to perform...                  
  272.                                                                                 
  273.                                                                                 
  274.                  Text Search.  Find Files Containing Text                       
  275.                  Name Search.  Find Files using name patterns                   
  276.                  Help                                                           
  277.                  Exit to DOS                                                    
  278.                                                                                 
  279.  
  280.      --------------------------------------------------------------------
  281.                              PSEARCH Main Menu
  282.  
  283.  
  284.      The PSEARCH menu provides entry to PSEARCH processing.  Menu items
  285.      may be selected by using an highlight bar positioned over the first
  286.      menu item when PSEARCH is started.  Use the cursor arrow keys to
  287.      move the the highlight bar to the function desired and press the
  288.      <Enter> key to start the action.  You may quickly select any item
  289.      by pressing the key relating to the first character of the menu
  290.      item.  For example, press <N> to start a file name search.
  291.  
  292.  
  293.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  4
  294.      --------------------------------------------------------------------
  295.  
  296.      Following is a description of each menu item:
  297.  
  298.      Text Search.  Activates PSEARCH's text search facility.  You will
  299.                    be presented with a entry menu to allow you to enter
  300.                    specifications PSEARCH is to use to search for data.
  301.  
  302.                    Text Search is PSEARCH's ability to search within
  303.                    files to find specific text.  It allows you to
  304.                    automatically scan you systems disks to locate files
  305.                    containing specific data contents.  For example, you
  306.                    can find all files on the system that contain the
  307.                    name 'Jones'.
  308.  
  309.      Name Search.  Activates the Name search facility.  Name search
  310.                    allows you to use PSEARCH to locate files on your
  311.                    system by the contents of their file names.
  312.  
  313.                    The DIR command provied with DOS only allows you to
  314.                    locate files within any one single directory.  When
  315.                    you have many directories and maybe even multiple
  316.                    hard disks, it becomes impracticle to use the DIR
  317.                    command to locate a file when you do not know what
  318.                    directory it exists in.
  319.  
  320.                    PSEARCH name search can automatically search all
  321.                    directories and even all disk devices to find a
  322.                    specific or pattern file name.
  323.  
  324.      Help          PSEARCH's command line help provides very complete
  325.                    help information on all of PSEARCH's facilities. The
  326.                    help is provided primarily for those that want to use
  327.                    PSEARCH's command line mode of operation but is
  328.                    useful for all to use as a quick reference of
  329.                    PSEARCH's abilities.
  330.  
  331.                    PSEARCH help consists of several pages of scrollable
  332.                    data.  When you exit the help, you will be returned
  333.                    to PSEARCH's main menu.
  334.  
  335.      Exit to DOS.  You may exit PSEARCH menu mode by either selecting
  336.                    the Exit menu item or by simply pressing the <ESCAPE>
  337.                    key from menu mode.
  338.  
  339.                    Upon exiting, PSEARCH will display how long it has
  340.                    been active and provide a summary of its results.
  341.  
  342.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  5
  343.      --------------------------------------------------------------------
  344.  
  345.      The Text Search Entry Display
  346.      -----------------------------
  347.  
  348.      The following display is shown as a result of selecting the Text
  349.      Search option from PSEARCH's main menu.  It allows you to enter
  350.      specifications indicating the data PSEARCH is to locate.
  351.  
  352.      --------------------------------------------------------------------
  353.      PSEARCH - File Searcher                 Copyright 1990 by Patri-Soft
  354.  
  355.                            Text Search Specification
  356.  
  357.       Path to Search: _______________________________________________
  358.  
  359.       Text(1): _____________________________________________
  360.       Text(2): _____________________________________________
  361.       Text(3): _____________________________________________
  362.       Text(4): _____________________________________________
  363.       Text(5): _____________________________________________
  364.  
  365.        __ Match All?   (Y=All Text must be found  N=Find any matches)
  366.        __ Search Directories  (blank=Current S=System(all)  P=Path only)
  367.        __ Exclude files and directories entered in PSEARCHT.EXC?
  368.        __ Case Sensitive Search? (Y=Match exact text   N=Ignore case)
  369.        __ Qualify (blank=none W=Find Word  P=Prefix S=Suffix)
  370.        __ Showing found text? (Y=ALL N=none F=First match R=Related Text)
  371.        __ Show linenumbers for found text? (Y/N)
  372.        __ Stop scrolling when display full (Y/N)
  373.        __ Pause on each found match?
  374.        _____    For multiple drive search drives to search
  375.        _____    If multiple text, text must within n characters
  376.  
  377.      Keys:  <F3> DOS      <F9> Advanced Options        <F10> Start Search
  378.      --------------------------------------------------------------------
  379.                             Text Search Entry Menu
  380.  
  381.  
  382.      See the command parameter portion of this document for a complete
  383.      description of all the parameters you are allowed to specify on
  384.      this display.
  385.  
  386.      Once all data is entered, you may immediately start the search by
  387.      pressing the <F10> key, or may specify advanced search options by
  388.      pressing the <F9> key.  The advanced options entry menu allows
  389.      further specifications to be made.  You may use the <F3> key to
  390.      temporarily exit to a PSEARCH window to execute DOS commands. You
  391.      may enter any DOS command in this window.
  392.  
  393.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  6
  394.      --------------------------------------------------------------------
  395.  
  396.      The F10 key may be pressed from any location on this display.  If
  397.      you use the <Enter> key to proceed through each item on the
  398.      display, pressing <Enter> on the last item will begin the search.
  399.  
  400.      All specifications on this display except for pathname and search
  401.      text are maintained in a special PSEARCH control file. This file
  402.      (PSEARCH.DAT) is created the first time you run PSEARCH and is
  403.      placed in the same directory as the PSEARCH program file (PS.EXE).
  404.      This control file allows PSEARCH to retain your search
  405.      specifications for the next time you use it.
  406.  
  407.  
  408.      The File Name Search Entry Display
  409.      ----------------------------------
  410.  
  411.      The File Name Search Display allows you to enter specifications
  412.      PSEARCH is to use while searching for files by name on your system.
  413.  
  414.      --------------------------------------------------------------------
  415.      PSEARCH - File Searcher                 Copyright 1990 by Patri-Soft
  416.                                                                                 
  417.                          Find File Specification
  418.                                                                                 
  419.         Path to Search: ____________________________________________
  420.                                                                                 
  421.                                                                                 
  422.                                                                                 
  423.                                                                                 
  424.        __  Search Directories (blank=Current S=System(all) P=Path only)
  425.        __  Exclude files and directories entered in PSEARCHF.EXC?
  426.        __  Search Archived Files (ZIP/ARC/LZH)? (N=none A=Yes B=Both)
  427.        __  Stop scrolling when display full (Y/N)
  428.        __  Pause on each found match?
  429.        __  Flex Search:  =none  S=Sound like  V=NoVowels  C=CharsOnly
  430.  
  431.        _____     For multiple drive search, letter of drives
  432.  
  433.  
  434.  
  435.                                                          
  436.                                                                                 
  437.      Keys:  <F3> DOS       <F9> Advanced Options       <F10> Start Search
  438.      --------------------------------------------------------------------
  439.  
  440.      This entry screen works like the Text Entry display discussed earlier.
  441.      See the command parameter descriptions for more information about the
  442.      parameters you may enter.
  443.  
  444.  
  445.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  7
  446.      --------------------------------------------------------------------
  447.  
  448.      Special Editing Functions
  449.      -------------------------
  450.  
  451.      Special edit functions are provided to enhance your capability
  452.      to specify DOS pathname and text specifications.  These following
  453.      features are available on all specification entry screens.
  454.  
  455.         Field Edit  --  You are presented with pathname and text
  456.                         specifications from prior executions on the
  457.                         parameter input displays.  You may use the
  458.                         shown value by simply pressing <Enter>.
  459.  
  460.                         You may change the value by first pressing a
  461.                         field edit key such as left or right cursor
  462.                         arrow, <INS>, or <DEL>.  Then you may edit
  463.                         the field as desired.
  464.  
  465.                         Entering any other value causes the current
  466.                         field to disappear and to be replaced by the
  467.                         keyed in value.
  468.  
  469.         Restore Field   Press alt-X when you are editing a field to
  470.                         restore it to its original value.
  471.  
  472.         Lower Case      Press alt-L to convert all characters in the
  473.                         field to lower case.
  474.  
  475.         Upper Case      Press alt-U to convert all characters in the
  476.                         field to upper case.
  477.  
  478.         Captialize      Press alt-C to cause all words in the field to
  479.                         be capitalized and other characters to be changed
  480.                         to lower case.
  481.  
  482.         Reverse         Press alt-R to reverse the characters in the
  483.                         in the field (first=last and last=first).
  484.  
  485.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  8
  486.      --------------------------------------------------------------------
  487.  
  488.      Advanced Options Entry Display
  489.      ------------------------------
  490.  
  491.      The Advanced Options Entry Display allow specification of advanced
  492.      options to be used for both Text and File name searches.  These
  493.      options are not necessary for PSEARCH to function and may be
  494.      ignored if desired.
  495.  
  496.      --------------------------------------------------------------------
  497.      PSEARCH - File Searcher                 Copyright 1990 by Patri-Soft
  498.                                                                                 
  499.                           Advanced Options Screen                               
  500.                                                                                 
  501.        __ Print and Display all results? (Y/N)
  502.        __ Log and Display all results? (Y/N)    Log file PSLOG.TXT
  503.        ____  Files Attributes U=Updated H=Hidden S=System R=Readonly
  504.  
  505.           For each matching file PSEARCH can generate and optionally
  506.           execute any desired command.  Specify the command below:
  507.  
  508.        __ Action?  blank=none  W=Write to PSCMDS.BAT file  X=Execute
  509.                                P=Execute command with pause after each
  510.  
  511.         Execute Command: _____________________________________________
  512.  
  513.           The following characters may be used in the command to
  514.           generate commands with the matching directory and filename.
  515.                &=path  #=Filename  !=File  @=/  ~=Archive name
  516.                For example, to copy all matching files to drive A:
  517.                    Command: COPY & A:
  518.  
  519.  
  520.       Keys:       <F3> DOS           <F10> Start Search
  521.      --------------------------------------------------------------------
  522.                       Advanced Options Entry Screen
  523.  
  524.      See subsequent sections in this document for more information about
  525.      the advanced specifications that may be entered on this display.
  526.      Once all specifications are entered you begin the search by
  527.      pressing the <F10> key on any field, or by pressing the <Enter> key
  528.      from the last entry field on the display.
  529.  
  530.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page  9
  531.      --------------------------------------------------------------------
  532.  
  533.      The PSEARCH Output Data Display
  534.      -------------------------------
  535.  
  536.      The following display is a sample of PSEARCH output as a result of
  537.      a TEXT Search request.
  538.  
  539.      --------------------------------------------------------------------
  540.      PSEARCH - File Searcher                 Copyright 1990 by Patri-Soft
  541.      Searching *.* for (this)  Opt ==> SHOW MULT ANYCASE MORE
  542.      --------------------------------------------------------------------
  543.      Searching *.* files for string (this)
  544.  
  545.      ======> FINANC.LTX       3287  16FEB89  6:42p
  546.      I am unable to determine what happened to this specific order.
  547.      to me.  I may be having trouble with this new address.  I know
  548.      In any case, I have corrected the problem and hope this package
  549.      normally sent to users.  If this is
  550.  
  551.      ======> ENHANREQ.LTR     2733   1MAR89  6:04a
  552.             drives.  This invokes the no⌐window mode.
  553.  
  554.      ======> HUFFMAR          1658  10MAR89  7:35a
  555.             A copy of the agreement is supplied with this
  556.  
  557.      ======> PRINT.TXT        1104   4MAY89  7:47a
  558.             receive no royalties from this product but I have agreed
  559.  
  560.      ======> LTR.LTR          2821   9JUN89  9:54a
  561.             drives.  This invokes the no-window mode.
  562.  
  563.      ** More?  <Enter> for more, <C> for continuous, <ESC> terminate ***
  564.      --------------------------------------------------------------------
  565.      Path(#1) C:\WP                               27  FILE=  WILLAM.BRO
  566.      --------------------------------------------------------------------
  567.                          PSEARCH Output Display
  568.  
  569.  
  570.      The top and bottom portion of the output display are reserved for
  571.      statistical information to keep you aware of what PSEARCH is
  572.      searching during processing.  The center portion of the display
  573.      shows the data found that matches the search specifications.
  574.  
  575.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 10
  576.      --------------------------------------------------------------------
  577.  
  578.      For each found text match, PSEARCH displays the file name and data
  579.      matching the search criteria.  The filename is shown on a line
  580.      before the matching text.  This line also shows the date and time
  581.      the file was last updated or created and the size of the file in
  582.      characters. If DOS attributes are present in the DOS directory
  583.      entry for the file, they are also shown.
  584.  
  585.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 11
  586.      --------------------------------------------------------------------
  587.  
  588.      PSEARCH Command Line Mode
  589.      -------------------------
  590.  
  591.      The following section describes the use PSEARCH using command
  592.      line specifications.  These specifications all you to enter
  593.      all PSEARCH options directly on the PSEARCH command when it is
  594.      entered to DOS.  Although more difficult to master, the command
  595.      line mode is the easiest and fastest to use once you learn how
  596.      to use PSEARCH.
  597.  
  598.  
  599.      Command Parameters
  600.      ------------------
  601.  
  602.      Command parameters control PSEARCH's may different features when it
  603.      is use in command line mode at the DOS prompt. They are easy to
  604.      understand and learn, and provide you need to quickly locate all
  605.      files. Remember that each parameter is summarized in the online
  606.      help display. Just type PS at the DOS promot.
  607.  
  608.  
  609.      COMMAND FORMAT:
  610.  
  611.      PS [fspec] /T:text /F /S /C /P /PR /PF /MO /O:nn/N:nn /NW /TA
  612.                 /X[F][P]:cmd /AT:c /FW /FP /FS /DR:xxx /SO /AR /AO
  613.  
  614.  
  615.      PS - PS is the name of the PSEARCH command.
  616.      PS actually refers to Patriquin's PSEARCH. Enter the command without
  617.      any parameters for menus and help.
  618.  
  619.      [fspec]
  620.            Enter the DOS file specification for the directory and file
  621.            names to be searched. If no directory name is specified the
  622.            current directory will be searched. If the /S option is
  623.            specified, the directory name portion of this parameter is
  624.            not used.
  625.  
  626.            Like DOS, use the '*' to indicate the last part of a filename
  627.            or filename extension may be any set of characters.  Also
  628.            like DOS, use the '?' to indicate that any single position of
  629.            a filename may be any character.
  630.  
  631.            In addition to DOS, you may place an '*' anywhere in the
  632.            filename to indicate any set of characters may exist in this
  633.            point in the name.
  634.  
  635.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 12
  636.      --------------------------------------------------------------------
  637.  
  638.  
  639.      SPECIAL FLEX FILENAME SEARCHING CONTROL CHARACTERS
  640.  
  641.            The filename specification may contain a full DOS pathname
  642.            including the standard DOS wildcard characters * and ?. In
  643.            addition the special characters '~', '!', or ';' may be
  644.            placed immediately before the filename to specify special
  645.            filename find criteria.
  646.  
  647.                 ~ SOUNDEX -- Select any filename that sounds like the
  648.                              specified name
  649.                      ~WORD would select:
  650.                             WORD WOOORD WRD WOOD WORLD
  651.  
  652.                 ; NOVOWEL -- Select equal filenames but ignore vowels
  653.                              AEIOU in name
  654.  
  655.                      !WOORD would select:
  656.                             WoRD WoooRD WieRD WRD
  657.  
  658.                 ! CHARS -- Select any filenames that contain the
  659.                            characters entered
  660.                      !WD would select:
  661.                             WorD.dat WilDone.dat lstWorD.x
  662.  
  663.            Following are examples:
  664.  
  665.              1.    *.EXE
  666.              2.    TEST*.*
  667.              3.    *TEST*.*
  668.              4.    DO?FIX.*
  669.              5.    PC*XX.*
  670.              6.    C:\DOS\*.*
  671.              7.    \TEST\*.*
  672.              8.    !WD*.*
  673.              9.    ~WORD.*
  674.  
  675.  
  676.      /AO   Archive type files Only - If you have files on your system
  677.            that are compressed into archive files with DOS extension
  678.            names of .ZIP, .ARC, or .LZH, PSEARCH is to search only these
  679.            files. This parameter is only useful for file name searching.
  680.            PSEARCH does not decompress these file contents for text
  681.            search requests.
  682.  
  683.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 13
  684.      --------------------------------------------------------------------
  685.  
  686.  
  687.            When specified, this parameter specifies that all archive
  688.            files are to be internally searched for filenames compressed
  689.            in them that meed the specified file specification.
  690.  
  691.            Note, you do not specify .ARC, .ZIP, or .LZH in the PSEARCH
  692.            file specification.  PSEARCH will automatically find and
  693.            search these files.
  694.  
  695.  
  696.      /AR   ARchive type files as well as normal files -  PSEARCH will
  697.            search both archive files and non-archive files for matching
  698.            filename specifications.  Use only for file name searches.
  699.            (See also the /AO command parameter).
  700.  
  701.  
  702.      /AT:c ATtributes - Specifies that PSEARCH is to search for files
  703.            having one or more of the attributes specified by the /AT:
  704.            parameter.
  705.  
  706.                 U - Updated,the ARCHIVE bit is on to indicate the file
  707.                     has been updated since the last backup.
  708.  
  709.                 R - Readonly,Files marked with Readonly attribute.
  710.  
  711.                 H - Hidden,Files marked with Hidden attribute.
  712.  
  713.                 S - System, Files marked with System attribute.
  714.  
  715.            Use /AT:U to locate all files that have been updated since
  716.            your last backup was done.
  717.  
  718.            Use /AT:H to determine what hidden files exist on your
  719.            disks.
  720.  
  721.  
  722.      /C Case - Indicates that text search requests are to be case
  723.            sensitive.  That is, exact upper/lower case searching
  724.            will be done.
  725.  
  726.            Normally it is easier to let PSEARCH find text data
  727.            regardless of its case.  This allows you to be sure to find
  728.            any possible matches.
  729.  
  730.            Exact case searching is useful for those cases where you know
  731.            the text is specified in an exact way.  It potentially
  732.            reduces the number of false matches that may be encountered
  733.            during the search.
  734.  
  735.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 14
  736.      --------------------------------------------------------------------
  737.  
  738.      /DR:  DRive list. If the drive is not specified in the main
  739.            pathname, PSEARCH will search the current disk device. /DR:
  740.            indicates one or more drives that the search is to be
  741.            performed on. The following example indicates the search is
  742.            to be done on drives C and D.
  743.  
  744.                /DR:cd
  745.  
  746.            The drive list is especially useful for searching all drives
  747.            on a system containing multiple hard disks.  Specify this
  748.            parameter in the PSEARCH= environment variable to force it to
  749.            be in effect for all command line executions.
  750.  
  751.  
  752.      /DS   Directory path search.  Normally PSEARCH will search only the
  753.            current directory or the entire disk of /S is also specified.
  754.            The /DS parameter indicates PSEARCH is to search the
  755.            specified or current directory and all of its subordinate
  756.            directories for files.
  757.  
  758.            This parameter is useful for those system that have well
  759.            structured hard disk directories.  For example, PSEARCH can
  760.            easily search all word processing directories if all these
  761.            directories are subordinate to a single high level directory
  762.            name.
  763.  
  764.            If you have a directory structure like the following...
  765.  
  766.                C:\                    Root directory
  767.                C:\WPSYS\              Word processing system files
  768.                C:\WP\                 Word processing data files
  769.                C:\WP\PLANNING\        Planning documents
  770.                C:\WP\MEMOS\           Memos
  771.                C:\WP\STANDARD\        Polocies and Procedures
  772.  
  773.            Use the following PSEARCH command to search for all documents
  774.            containing the text "emergency"...
  775.  
  776.                PS C:\WP\*.*/t:emergency/ds
  777.  
  778.            Only the word processing document files will be searched.
  779.            All other directories on your hard disk will be ignored.
  780.  
  781.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 15
  782.      --------------------------------------------------------------------
  783.  
  784.      /EX   Exclude files.  Primarily intended for text search requests,
  785.            the exclude facility allows you to provide a list of pathname
  786.            and filename specifications that are to be excluded from
  787.            PSEARCH processing.  Since searching through data on your
  788.            hard disk requires extensive processing and disk read time,
  789.            excluding files from the process will save you time, and will
  790.            reduce the number of false matches displayed for your
  791.            requests.
  792.  
  793.            The most common files to exclude from text search processing
  794.            is product program and control files.  These files constitute
  795.            a large portion of your hard disk's used space and
  796.            unnecessarily lengthen the time it takes searches to locate
  797.            the desired data.
  798.  
  799.            The exclude facility is implemented with two actions.  First,
  800.            you will need to create an exclude specification file and
  801.            place it in the same directory where PSEARCH is installed on
  802.            your hard disk.  This file will contain the names of all the
  803.            files and paths to be excluded.  You may specify DOS pattern
  804.            names to exclude groups of files with a single specification.
  805.  
  806.            Like DOS, use the '*' to indicate the last part of a filename
  807.            or filename extension may be any set of characters.  Also
  808.            like DOS, use the '?' to indicate that any single position of
  809.            a filename may be any character.
  810.  
  811.            In addition to DOS, two additional pattern features are
  812.            available.  You may place an '*' anywhere in the filename to
  813.            indicate any set of characters may exist in this point in the
  814.            name.  For pathnames, you may place an '**' at the end of a
  815.            directory path specification to indicate the specification
  816.            applies to the specified directory and all subordinate
  817.            directories.  Using '**', you can exclude an entire path with
  818.            a single specification.
  819.  
  820.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 16
  821.      --------------------------------------------------------------------
  822.  
  823.  
  824.            Following are examples:
  825.  
  826.              1.    *.EXE
  827.              2.    *.COM
  828.              3.    TEST*.*
  829.              4.    *TEST*.*
  830.              5.    DO?FIX.*
  831.              6.    PC*XX.*
  832.              7.    C:\DOS\*.*
  833.              8.    \TEST\*.*
  834.              9.    D:\GAMES**\*.*
  835.  
  836.            Explanations for the above examples:
  837.              1.  Excludes all filenames with the extension .EXE from
  838.                  processing.
  839.  
  840.              2.  Excludes all filenames ending with extension .COM.
  841.  
  842.              3.  Excludes all filenames beginning with the letters
  843.                  "TEST" from processing.
  844.  
  845.              4.  Excludes all filenames having the characters "TEST"
  846.                  anywhere in the first portion of the filename.
  847.  
  848.              5.  Exclude files having 'DO' as the first 2 characters of
  849.                  the filename, and 'FIX' as the 4th, 5th, and 6th
  850.                  filename characters.  The 3rd character of the filename
  851.                  may be any character.
  852.  
  853.              6.  Exclude files having a name beginning with the 2
  854.                  characters PC and where the first portion of the
  855.                  filename ends with the characters 'XX'.  Any 0 to 4
  856.                  characters may exist between the 'PC' and 'XX' in the
  857.                  first portion of the filename.
  858.  
  859.              7.  Exclude all files from the DOS directory on drive C:.
  860.  
  861.              8.  Exclude all files from the TEST directory existing
  862.                  on any drive searched.
  863.  
  864.              9.  Exclude all files from the D:\GAMES\ directory and
  865.                  also exclude all files and directories subordinate
  866.                  to the GAMES directory.
  867.  
  868.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 17
  869.      --------------------------------------------------------------------
  870.  
  871.            Exclude file names --
  872.  
  873.               Since you may want to exclude different files from
  874.               file find and text search requests, a different
  875.               exclude file name exists for each.
  876.  
  877.                  PSEARCHF.EXC  --  File Find exclude specifications
  878.                  PSEARCHT.EXC  --  Text Search exclude specifications
  879.  
  880.               These files may be created using most any word processor
  881.               or text editor.  If you have no word processor or editor
  882.               you may use the EDLIN text editor provided with your DOS
  883.               system.
  884.  
  885.               The exclude files must exist in the same directory the
  886.               PS.EXE file is located on.  PS.EXE is the name of the
  887.               PSEARCH program file.
  888.  
  889.            Activating exclude --
  890.  
  891.               Exclude will only be functional when the /EX command
  892.               parameter is specified.  When /EX is specified, you must
  893.               have a valid exclude file.  PSEARCH will not continue
  894.               without one.  If you wish exclude to be active during all
  895.               executions, specify /EX as part of the PSEARCH= DOS
  896.               environment variable.  See later in the documentation for
  897.               a description of this feature.
  898.  
  899.  
  900.      /F    Find File in the current directory.  Normally PSEARCH will
  901.            search all directories to find a file.  Use the /F parameter
  902.            to limit PSEARCH to search only the specified or current
  903.            directory.
  904.  
  905.  
  906.      /FP   Find Prefix - (use with /T:) Indicates that matching text
  907.            must be at the end of an existing word.  Designed primarily
  908.            for word searches, find prefix qualifies the search to help
  909.            you find exactly the match you want.
  910.  
  911.  
  912.      /FS   Find Suffix - (use with /T:) Works like find prefix, except
  913.            finds the matching text only if it preceeds an existing word.
  914.  
  915.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 18
  916.      --------------------------------------------------------------------
  917.  
  918.      /FW   Find Word - (use with /T:) The text to be searched for is a
  919.            word. Only select text that is a complete word. A word is
  920.            defined as any string of characters and numbers that is not
  921.            preceded or succeeded with other characters or numbers.
  922.  
  923.            In "This", "This" is a word. "is" is not a word.  A search
  924.            like    PS *.*/t:is/fw   would show matches for is but will
  925.            not match on the "is" characters in "this".
  926.  
  927.  
  928.      /L    Line numbers.  When you are searching DOS text files for
  929.            specific text (/T: parm used), use the /L parameter when you
  930.            want PSEARCH to determine and display the number of the line
  931.            associated with the text displayed.
  932.  
  933.            DOS text files are those files that have a carriage return
  934.            and line feed at the end of each line of text.  A good
  935.            example of these is DOS batch command files (*.BAT).  Word
  936.            processing files often do not use this format and so line
  937.            number specifications are not often useful for them.
  938.  
  939.  
  940.      /N:nnn Newdays - Indicates that only files created or updated
  941.            within the last nnn days are to be selected for processing.
  942.            /N:1 causes any files updated within the last day to be
  943.            selected. To search for files updated on the current date,
  944.            specify /N:0.
  945.  
  946.  
  947.      /ND   No Data.  For text searches, PSEARCH normally displays the
  948.            text data lines for matching data found in files searched.
  949.            If you only need the filenames shown, use the /ND parameter
  950.            to deactivate the text display.
  951.  
  952.  
  953.      /NM   No Multiples.  For text search specifications, causes
  954.            PSEARCH to only search for a single matching text
  955.            in any file and displays only one match.  Other matches
  956.            may exist in the file.
  957.  
  958.  
  959.      /NO   No mOre - Normally PSEARCH will stop at the end of each full
  960.            display of lines.  You may press <ESCAPE> to terminate
  961.            processing, <C> to disable more and display without stopping
  962.            again, or press any other key to display another page of the
  963.            display and stop again.  /NO disables this feature.
  964.  
  965.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 19
  966.      --------------------------------------------------------------------
  967.  
  968.      /NM   Use of the /NM parameter will shorten your display of
  969.            output and may improve search performance by stopping
  970.            the search of a file after a single match is shown.
  971.  
  972.  
  973.      /NW   No Windows.  PSEARCH normally operates in full screen
  974.            window mode.  To deactivate this feature and DISplay all
  975.            output in normal DOS line mode specify this parameter.
  976.  
  977.            The /NW parameter causes PSEARCH to use BIOS type screen
  978.            writes to display output to the display.  The /NW parameter
  979.            may be useful when you have special devices or TSR's
  980.            active that screen or capture output going through these
  981.            interfaces.
  982.  
  983.  
  984.      /O:nnn Olddays - Indicates that only files older than nnn days are
  985.            to be selected for processing. /O:365 will cause files over
  986.            one year old to be selected.
  987.  
  988.  
  989.      /P    Pause - Pause  PSEARCH will pause whenever a match of
  990.            filename or text in a file is found. You may terminate the
  991.            search or continue by pressing any key.
  992.  
  993.  
  994.      /PF   Print to File - If you want to direct print to an output
  995.            file, enter /PR. The file PSPRINT.DAT will be created in the
  996.            current directory.  The resulting file may be edited or
  997.            viewed using your current word processor, text editor, or the
  998.            DOS TYPE command.
  999.  
  1000.  
  1001.      /PR   PRint - Causes all screen output to also be directed to the
  1002.            output printer device.  This allows you to have a printed
  1003.            record of PSEARCH results.
  1004.  
  1005.  
  1006.      /R:nnn  Near specification for multiple text searches.  You may use
  1007.            the /R parameter when you have also specified multiple /T:
  1008.            parameters to cause PSEARCH to search for multiple sets of
  1009.            text.  /R specifies a number of characters that may exist
  1010.            between the first characters of the text to be searched.  In
  1011.            other words, the text will only be considered a match if it
  1012.            is within n characters of all other text specified.
  1013.  
  1014.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 20
  1015.      --------------------------------------------------------------------
  1016.  
  1017.            Use the /R when you want to find values related to one
  1018.            another and know the values will exist within close proximity
  1019.            of each other in the file.  The following example will search
  1020.            files for the name 'Jones' and will identify a letter to this
  1021.            person by indicating the search is only to search for the
  1022.            name 'jones' when it also exists near the letter salutation
  1023.            'Dear'.  The /R:50 value indicates the two values must be
  1024.            within 50 characters of each other in the file.
  1025.  
  1026.                 PS *.*/t:jones/t:near/r:50/ta
  1027.  
  1028.  
  1029.      /RT   Related text.  During text searches /RT will cause PSEARCH
  1030.            to attempt to display up to 10 lines of text related to the
  1031.            matching text being shown.  In many cases, less than 10
  1032.            lines of text may be shown when PSEARCH detects unprintable
  1033.            data or changes in paragraph structure.
  1034.  
  1035.            When /RT is specified, each display of matched text will be
  1036.            separated by horizontal bar lines to help you better see the
  1037.            groups of text being displayed.
  1038.  
  1039.  
  1040.      /S    System - Indicates that all directories on all hard disk
  1041.            drives are to be searched.  If a directory or drive is
  1042.            specified as part of the pathname, only it will be searched.
  1043.  
  1044.  
  1045.      /SO   Turns the PSEARCH signal sounds off.
  1046.  
  1047.  
  1048.      /T:text to be searched
  1049.            Text - Specifies the text to be found for text search
  1050.            requests. The text string may contain any characters. A
  1051.            terminating command line or the following slash character
  1052.            will signal the end of the text to be searched. If this is
  1053.            the last parameter on the command any trailing spaces will
  1054.            not be included in the search. To include trailing spaces,
  1055.            terminate the string with an ending slash character.
  1056.  
  1057.            Text may be specified in upper or lower case. Unless the /C
  1058.            parameter is specified to force exact text matches, the
  1059.            search will be made for any match regardless of case.
  1060.  
  1061.            Strings may also be single or double quoted. This allows for
  1062.            special characters to be included in the search string such
  1063.            as / characters.
  1064.  
  1065.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 21
  1066.      --------------------------------------------------------------------
  1067.  
  1068.            Examples:
  1069.  
  1070.             /T:BUDGET /T:Budget /T:Mr.  Jones/
  1071.             /T:"01/01/88"
  1072.  
  1073.            Note, to include a trailing space as part of search text, you
  1074.            must follow search text by another / command parameter. For
  1075.            example:
  1076.  
  1077.             PS *.C/T: SMITH /TA
  1078.  
  1079.            Up to five (5) /T: parameter specifications may be included
  1080.            for text search requests.  This allows PSEARCH to search for
  1081.            five different texts on a single search of a disk or
  1082.            directory. When multiple text is specified, consider the use
  1083.            of the /TA parameter to force PSEARCH to find all text in a
  1084.            single file before considering the file a match.
  1085.  
  1086.            The /T: parameter serves the purpose of indicating to PSEARCH
  1087.            of the search is to be for text in a file or for file names.
  1088.            Any command line execution of PSEARCH without the /T:
  1089.            parameter will cause PSEARCH to assume the request is to
  1090.            locate files by name only.
  1091.  
  1092.  
  1093.      /TA   Text 'AND'.  Used for mutiple text searches.  Indicates
  1094.            that all text must be found in the file for a PSEARCH
  1095.            to display a match.  Without /TA specified, any matching
  1096.            text will be displayed.
  1097.  
  1098.  
  1099.      /X:xxx eXecute - Build and execute a DOS command whenever a
  1100.            filename match or a text match is found. xxx is the DOS
  1101.            command to be executed.
  1102.  
  1103.            The command may either be a standard DOS command or the name
  1104.            of a DOS batch command file. The command will be executed
  1105.            with a second copy of COMMAND.COM. The command data may
  1106.            contain the following special characters to allow for
  1107.            substitution values.
  1108.  
  1109.               # - Always replaced with the selected filename
  1110.  
  1111.               & - Always replaced with the selected path/filename
  1112.  
  1113.               ! - Always replaced with the filename without extension
  1114.  
  1115.               @ - Replaced with a slash to allow for command parameters
  1116.                   to be specified in executed commands.
  1117.  
  1118.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 22
  1119.      --------------------------------------------------------------------
  1120.  
  1121.  
  1122.            Examples:
  1123.  
  1124.               /X:ERASE &To delete selected files
  1125.               /X:ARC A OLD123.ARC # To use ARC utility to archive
  1126.                                     file
  1127.               /X:TYPE & To type the file
  1128.               /X:LOTUS Start 123 for the file
  1129.  
  1130.  
  1131.      /XF:xxx eXecute File - Works like /X except that the command is not
  1132.            executed, it is generated and placed in a DOS batch command
  1133.            file named PSCMDS.BAT in the current directory. This file may
  1134.            be edited before it is executed.
  1135.  
  1136.  
  1137.      /XP:xxx eXecute with Pause - Functions in the same way as the /X
  1138.            parameter except that you are asked to indicate if the
  1139.            command is to be executed for each selected file.
  1140.  
  1141.  
  1142.      Specification of default parameters
  1143.      -----------------------------------
  1144.  
  1145.      Default parameters are parameters that do not need to be specified
  1146.      each time PSEARCH is started. Any PSEARCH parameter may be
  1147.      specified as a default parameter.
  1148.  
  1149.      Use the DOS SET command to specify the parameter name and contents
  1150.      to be used by PSEARCH each time it is started. The following
  1151.      example indicates the /EX exclude parameter specification is to be
  1152.      automatically provided to PSEARCH each time it is used in the
  1153.      command mode.
  1154.  
  1155.        SET PSEARCH=/D/M
  1156.  
  1157.      Once this DOS command is issued, each subsequent use of PSEARCH
  1158.      will operate as if these parameters have been specified on the
  1159.      command line. The SET command is most commonly placed in the
  1160.      AUTOEXEC.BAT file so it may be in effect every time your machine is
  1161.      started.
  1162.  
  1163.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 23
  1164.      --------------------------------------------------------------------
  1165.  
  1166.      Screen colors and monitor support
  1167.      ---------------------------------
  1168.  
  1169.      PSEARCH checks the DOS equipment flags to determine what type of
  1170.      monitor you have on your system. This is usually always correct
  1171.      except for one specific information. For those users running a
  1172.      composite monitor with a color graphics card, the screens may not
  1173.      be displayed correctly. If this occurs, use the DOS MODE command to
  1174.      set your environment to black and white. This can be done at system
  1175.      startup or just before starting PSEARCH. Beware that some
  1176.      applications incorrectly reset these indicators and they may need
  1177.      to be reset before again running PSEARCH. Following is an example,
  1178.      see the DOS reference for more information about setting the
  1179.      monitor with the MODE command.
  1180.  
  1181.         DOS MODE command example ===>  MODE BW80
  1182.  
  1183.  
  1184.      Pausing the Search
  1185.      ------------------
  1186.  
  1187.      Even if the Pause parameter is not specified, you may pause the
  1188.      search at any time by pressing any keyboard key. At the end of the
  1189.      next process PSEARCH will pause. You will then have the opportunity
  1190.      to continue processing, use a function key, or exit from PSEARCH.
  1191.  
  1192.  
  1193.      Bonus features for registered users
  1194.      -----------------------------------
  1195.  
  1196.      To encourage users to register PSEARCH, the following features of
  1197.      PSEARCH are made available only to registered users. Once you have
  1198.      entered registration information you are provided as a result of
  1199.      registering PSEARCH, the bonus functions will automatically become
  1200.      available for use.
  1201.  
  1202.       /RT - Ability to show related text for search matches
  1203.       /PR - Direct display output to the line printer
  1204.       /PF - Direct display output to a print file
  1205.       /SO - Turn off the sound
  1206.       /DR: - Multiple drive support is limited to 2 drives
  1207.       Use of the PSEARCH= environment variable.
  1208.  
  1209.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 24
  1210.      --------------------------------------------------------------------
  1211.  
  1212.      Program Maintenance History
  1213.      ---------------------------
  1214.  
  1215.      There is an ongoing commitment to improve PSEARCH as long as there
  1216.      is expressed need by PSEARCH users. I do respond to your requests.
  1217.      The enhancements below reflect both user requests and my own ideas.
  1218.      Please let me know of your needs, maybe they can appear on this
  1219.      list in the future.
  1220.  
  1221.      ------------------------------------------------------------------
  1222.  
  1223.      Version 1.0      March 1, 1986
  1224.           --  PSEARCH Version 1.0 was released in March 1st, 1986
  1225.  
  1226.      Version 2.0      April 8, 1986
  1227.           PSEARCH Version 2.0 was released April 8th, 1986. It
  1228.               upgraded version 1 with the following new features.
  1229.  
  1230.           -- Ability to search in .ARC files for filenames /AR /AO
  1231.           -- Find text by WORD, PREFIX, or SUFFIX /FW /FP /FS
  1232.           -- Returns back to menus after search is complete
  1233.           -- Extract data to file implemented
  1234.           -- Fix to show found text un upper/lower case
  1235.           -- /SO to turn sound off
  1236.           -- Ability to exclude .COM and .EXE files from search
  1237.           -- Ability to search all drives attached to system /DR:abc
  1238.  
  1239.      Version 3.0      September 7, 1986
  1240.           PSEARCH Version 3.0 was released Sept. 7th, 1986. It upgraded
  1241.           version 2 with the following new features.
  1242.  
  1243.           -- Sound alike and other new filespec wildcards (! ; ~).
  1244.           -- More menu options on the Peak menu.
  1245.           -- Correction to retrieve proper environment string to be used
  1246.              when executing DOS commands.
  1247.  
  1248.      Version 3.3      July 5, 1987
  1249.           -- Change registration so there is no longer a need to have
  1250.              the PSEARCH.REG file exist in the root directory.
  1251.  
  1252.           -- Text searches will not attempt to search .ARC files. Since
  1253.              these files are compressed it makes no sense to search them
  1254.              for text.
  1255.  
  1256.           -- Use environment field PS= to specify default command
  1257.              parameters.
  1258.  
  1259.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 25
  1260.      --------------------------------------------------------------------
  1261.  
  1262.      Version 3.4      September 16, 1987
  1263.  
  1264.           -- Ignore ~ ! and ; filename search characters unless they are
  1265.              in the first position of the filename. Previous versions
  1266.              file searches would fail if these characters were found in
  1267.              any position but the first.
  1268.  
  1269.           -- Correct filename matching. If file XXX would not be found
  1270.              if pattern name of XXX.* was specified.
  1271.  
  1272.           -- When print option was used with menus, when processing
  1273.              completed, menu text was printed to the printer. Corrected.
  1274.  
  1275.  
  1276.      Version 3.8      March 1, 1988
  1277.  
  1278.           -- Add ability to accept " or ' quoted strings in text search
  1279.              input command data. This is for the /T: parameter only.
  1280.  
  1281.  
  1282.      Version 4.0      February 22,1990
  1283.  
  1284.           This version is essentially a rewrite of the original PSEARCH
  1285.           facility.  All the changes are too numerous to mention.
  1286.           Following is a list of the most significant changes.
  1287.  
  1288.           Enhancements...
  1289.           -- Add ability to search up to 5 text strings
  1290.           -- AND/OR capability on text strings
  1291.           -- New exclude file allows user to specify file names
  1292.           -- New menu structure
  1293.           -- Near parameter to force multiple text matches to be within
  1294.              n characters of each other.
  1295.           -- /NW implements no window mode for those that need or prefer
  1296.              DOS style displays.
  1297.           -- /DS parameter allows a single directory path including all
  1298.              subordinate directories to be searched.
  1299.           -- The limit of the number of directories that can be searched
  1300.              greatly enhanced.  The maximum number of directories is
  1301.              related to the amount of free memory available to PSEARCH.
  1302.  
  1303.           Items removed...
  1304.           -- The Peak feature has been removed.
  1305.           -- The 5 text strings replaces the ability to specify a ?
  1306.              in the text search string.
  1307.           -- The exclude file replaces the /SK command to skip
  1308.              .COM and .EXE files.
  1309.  
  1310.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 26
  1311.      --------------------------------------------------------------------
  1312.  
  1313.  
  1314.      Version 4.1      February 26, 1990
  1315.           -- System lockup during speaker beeps.  Also improper beeps.
  1316.           -- Set sounds off as default
  1317.           -- Set pause at full screen (more) as default in command mode
  1318.  
  1319.      Version 4.2      March 9, 1990
  1320.           -- Added /RT parm to show related text
  1321.           -- Added field edit capabilities.
  1322.           -- Removed more line from display after user pressed a key
  1323.           -- Replaced /MO with /NO.  More was made default.
  1324.  
  1325.      Version 4.3      May 4, 1990
  1326.           -- Corrected errors encountered when processing .ZIP files
  1327.              containing directory names as well as filenames.
  1328.           -- Corrected problem where PSEARCH ignored the drive
  1329.              specification for the path to be searched.
  1330.           -- Added directory name to filename display on search display
  1331.           -- Added a screen of condensed help.
  1332.           -- Improved screen I/O performance
  1333.           -- Removed requirement to place quotes around text to be
  1334.              searched for in command line.  You may now search for
  1335.              data containing spaces.
  1336.                  PS *.TXT/T:Joe Doe
  1337.           -- File find now searches all hard disk drives unless a
  1338.              specific drive is specified.
  1339.           -- /S parameter causes all hard disk drives to be scanned
  1340.              unless a specific drive is specified in the supplied
  1341.              pathname.
  1342.  
  1343.      Version 4.4a     July 11, 1990
  1344.  
  1345.           -- When PS *.exe/DS used.  The same directory was searched
  1346.              3 times.  This only happened when directory had no
  1347.              subdirectories.  PS was fixed to scan the directory once.
  1348.           -- For network operation  -- added auto skipping of any files
  1349.              DOS denied access to.  A message is printed for each file
  1350.              that is bypassed.
  1351.           -- Detect bad exclude file specifications and stop processing.
  1352.              Processing used to continue but not select any files.
  1353.           -- PSEARCH was searching all directories for a file even when
  1354.              a specific pathname was specified.  The search is now
  1355.              limited to just the specified pathname.
  1356.           -- Support multiple drive parameter (/DR:) when directory name
  1357.              specified.  Allows multiple drives to be searched for a
  1358.              single directory name.
  1359.           -- PS *.* /AT:u stopped displaying output when readonly,
  1360.              hidden, system, updated file displayed.
  1361.           -- Added [=blank and ]=\ to /X: command substitution
  1362.  
  1363.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 27
  1364.      --------------------------------------------------------------------
  1365.  
  1366.         Registering The Utilities
  1367.         -------------------------
  1368.  
  1369.         PSEARCH is distributed under the Shareware concept. This allows
  1370.         users to evaluate software for a short time to determine if it
  1371.         is useful to them.  If you decide the software is of value to
  1372.         you and decide to keep and use, you are required to register it.
  1373.  
  1374.         This concept allows for quality software to be distributed at a
  1375.         reasonable cost.  Hundreds of hours of my time has been invested
  1376.         in PSEARCH.  Continued registration will justify the continued
  1377.         upgrading of this utility to insure it remains up to date with
  1378.         current technology.  In any case, I do greatly appreciate all
  1379.         users that care enough to register.  I try to provide the best
  1380.         possible software for all you faithful supporting users.
  1381.  
  1382.         You may use the order form on the next page when registering.
  1383.  
  1384.         Send registration requests to:
  1385.  
  1386.                   Patri-Soft
  1387.                   P.O. Box 8263
  1388.                   San Bernardino, CA   92412
  1389.  
  1390.         The registration charge is a one time fee that entitles you to
  1391.         all future versions of the product.  These may either be
  1392.         obtained from normal Shareware sources or from me.  I do not
  1393.         automatically  send product updates to registered users.  It is
  1394.         impossible to provide automatic upgrades at the low costs of
  1395.         these utilities.  If you would like to receive the next version
  1396.         of the software, add an additional $15 to your order and
  1397.         indicate on the order form you wish to receive the next update
  1398.         version.  You will be sent the next version along with an
  1399.         optional order form to request subsequent releases.
  1400.  
  1401.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 28
  1402.      --------------------------------------------------------------------
  1403.  
  1404.         Site Licenses
  1405.         -------------
  1406.  
  1407.         I do welcome organizations to Site License one or more utilities
  1408.         at a reduced cost.   Site Licenses allow you to be confident all
  1409.         users in your organization are using authorized versions of the
  1410.         utilities.
  1411.  
  1412.         Following is a schedule of site license fees at the time this
  1413.         document was created.  I will honor these fees until January 1,
  1414.         1991.
  1415.  
  1416.            Site license fees --
  1417.  
  1418.                 5 - 10 copies    $150        51-100 copies   $1000
  1419.                11 - 30 copies    $200       101-200 copies   $2000
  1420.                31 - 50 copies    $600       201-400 copies   $3500
  1421.                                      Unlimited copy license  $5000
  1422.  
  1423.  
  1424.         A site is considered to be one individual company at a given
  1425.         location.  Different departments located as the same address
  1426.         are considered to be part of the same site.
  1427.  
  1428.         To help companies avoid problems with software taken home for
  1429.         personal use, any employee having use of PREBACK as part of a
  1430.         site license agreement, also is allowed to use the software
  1431.         on any machine for their own personal use. This may be at the
  1432.         site location or any other location.
  1433.  
  1434.         Contact us through CompuServe, our support BBS or by mail for a
  1435.         site license agreement.  Please state the number of copies you
  1436.         are interested in.  Site license users will receive free
  1437.         telephone support and maintenance for one year on the product.
  1438.         Additional years of maintenance may be purchased at 20% of the
  1439.         original site license fee.
  1440.  
  1441.  
  1442.         VISA / Mastercard / Telephone Registration
  1443.         ------------------------------------------
  1444.  
  1445.         You may place a telephone order for the utilities using your
  1446.         credit card by calling Nelson Ford's Public (Software) Library.
  1447.  
  1448.              Telephone orders: 800-242-4775
  1449.                                713-665-7017 outside USA
  1450.  
  1451.         The PSL supplies Shareware software at a nominal cost to its
  1452.         customers.  Consider them for all your Shareware needs.
  1453.  
  1454.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 29
  1455.      --------------------------------------------------------------------
  1456.                        PSEARCH 4.4a  Registration Request
  1457.  
  1458.         Thank you for your registration.  It is sincerely appreciated!
  1459.         --------------------------------------------------------------------
  1460.         VISA/Mastercard  orders  are only accepted through telephone orders.
  1461.         Call the Public (Software) Library at 800-242-4775 to order NOW!
  1462.         --------------------------------------------------------------------
  1463.  
  1464.         _____ Registration of all Patriquin Utilities with
  1465.                 disk and bound User's Guide (over $125 value!)......$45.00
  1466.  
  1467.         When you register the below versions, you will receive registration
  1468.         codes along with the latest version of the utility.
  1469.  
  1470.         _____ PSEARCH   -- Advanced find files with text............$20.00
  1471.         _____ PCOPY     -- Advanced windowed DOS COPY alternative...$20.00
  1472.         _____ PALERT    -- Warns you of low disk space..............$15.00
  1473.         _____ PATTR     -- Manage attributes of DOS files...........$10.00
  1474.         _____ PDAILY    -- Automatically execute commands once/day..$10.00
  1475.         _____ PDELETE   -- Save space with automatic disk cleanup...$15.00
  1476.         _____ PPRINT    -- Advanced file print w/special formats....$15.00
  1477.  
  1478.         _____ Next Update  Please send me the next version
  1479.                            automatically when it is available.......$15.00
  1480.  
  1481.         _____ Update a registered set with new disk and manual.
  1482.                  Registered users only Ser: __________   ...........$15.00
  1483.  
  1484.         *******************************************************************
  1485.                       Disk Size?     5 1/4     3 1/2
  1486.         *******************************************************************
  1487.  
  1488.         Name: __________________________________________________
  1489.  
  1490.         Company: _______________________________________________
  1491.  
  1492.         Address: _______________________________________________
  1493.  
  1494.                  _______________________________________________
  1495.  
  1496.         City: ________________________  State: ________  Zip: __________
  1497.  
  1498.         Please register the software under the following name:
  1499.  
  1500.              ____________________________________________________________
  1501.  
  1502.         I learned about the utilities from: ____________________________
  1503.  
  1504.         If BBS (name/number)____________________________________________
  1505.  
  1506.              Send to: Patri-Soft
  1507.                       P.O. Box 8263
  1508.                       San Bernardino, CA  92412
  1509.  
  1510.      PSEARCH Users Guide/Reference    Copyright 1990 Patri-Soft   Page 30
  1511.      --------------------------------------------------------------------
  1512.  
  1513.                       Reporting Problems  (PSEARCH 4.4a)
  1514.  
  1515.         I welcome all comments or enhancement suggestions.  Please
  1516.         document each item clearly and provide printed examples, if
  1517.         possible. Please be sure to include this form with all requests.
  1518.         It will help to make sure we can provide you with the best
  1519.         possible service.
  1520.  
  1521.  
  1522.         Name: __________________________________________________________
  1523.  
  1524.         Company: _______________________________________________________
  1525.  
  1526.         Address: _______________________________________________________
  1527.  
  1528.                   _______________________________________________________
  1529.  
  1530.         City: __________________________________  State: _______________
  1531.  
  1532.         Zip: ______________________________
  1533.  
  1534.         Telephone: _______ / ________________________ (Home / Work)
  1535.  
  1536.  
  1537.         Date: _________________________     Machine Type:_______________
  1538.  
  1539.  
  1540.         Name of Utility: _______________________ DOS Level: ____________
  1541.  
  1542.         Description of problem or enhancement:
  1543.  
  1544.         ________________________________________________________________
  1545.  
  1546.         ________________________________________________________________
  1547.  
  1548.         ________________________________________________________________
  1549.  
  1550.         ________________________________________________________________
  1551.  
  1552.         Suggested solution:
  1553.  
  1554.         ________________________________________________________________
  1555.  
  1556.         ________________________________________________________________
  1557.  
  1558.