home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT103B.ZIP / WPGRAB.COM / WPGRAB.DOC < prev    next >
Text File  |  1988-02-28  |  17KB  |  580 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                      WPGRAB
  10.  
  11.  
  12.                               P A T R I Q U I N ' S
  13.  
  14.                        Word Processing File Selection Aid
  15.  
  16.  
  17.                                        by
  18.  
  19.  
  20.                                 Norm J. Patriquin
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                   User's Guide
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                         Patriquin's BBS  --  714-369-9766
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                   March 1, 1988
  44.  
  45.  
  46.  
  47.  
  48.                         Copyright 1987 by Norm Patriquin
  49.  
  50.                                 Table of Contents
  51.  
  52.  
  53.  
  54.      WPGRAB  --  Select file for Word Processing activity  . . . . . . .    1
  55.  
  56.      Command Parameters  . . . . . . . . . . . . . . . . . . . . . . . .    3
  57.  
  58.      Supplied DOS batch files  . . . . . . . . . . . . . . . . . . . . .    5
  59.  
  60.      Registering WPGRAB  . . . . . . . . . . . . . . . . . . . . . . . .    6
  61.  
  62.      WPGRAB 1.6 Registration . . . . . . . . . . . . . . . . . . . . . .    7
  63.  
  64.      Reporting Problems with WPGRAB 1.6  . . . . . . . . . . . . . . . .    8
  65.  
  66.      Maintenance Log . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.                                           2
  103.      WPGRAB  --  Select file for Word Processing activity
  104.  
  105.  
  106.      For some  time now I have wanted a facility in Word Perfect1 to allow me
  107.      to continue processing either the last  document I  was working  with or
  108.      one of  the more  recent ones.   I  sometimes lose  track of what I have
  109.      named files and have to go searching through directories looking to find
  110.      the ones I need.
  111.  
  112.      This utility was developed to make my life easier.  Maybe it can benefit
  113.      you too.  WPGRAB simply scans  the  DOS  directory  to  locate  the most
  114.      recently updated  files.  It then presents them to you so you can review
  115.      and select a file from them to process.  Once you have  selected a file,
  116.      WPGRAB places  a command  with the filename in it in a DOS batch command
  117.      file to be executed.   The  following batch  file is  an example  of its
  118.      operation.
  119.  
  120.      Batch file  named WPS.BAT.   A  typical use would be to just type in WPS
  121.      and let it do the work, but you  might also  give it  a filename pattern
  122.      and qualify its search.
  123.  
  124.  
  125.                     cd\wp
  126.                     echo off
  127.                     cls
  128.                     wpgrab %1 /C:\perfect\wp
  129.                     if errorlevel 2 goto error
  130.                     wpgrab$$
  131.                     :error
  132.  
  133.      Assume  we  started  WPGRAB  with  the  WPS command.  WPGRAB scanned the
  134.      directory and found  the  most  recent  files  to  processed.    It then
  135.      displays a screen displaying the following information.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.                          
  150.  
  151.           1    Word  Perfect  is  a  registered  trademark  of  Word  Perfect
  152.                Corporation.
  153.  
  154.  
  155.                                           1
  156.      *****************************************************************
  157.  
  158.      WPGRAB   1.6             Copyright 1987       by: Norm Patriquin 
  159.      -----------------------------------------------------------------
  160.      List of the 15 most recently updated files.       Use /h for HELP
  161.      -----------------------------------------------------------------
  162.            A --  PCOPY.MAS      11SEP87   6:29a      931 
  163.            B --  ALTF.MAC       11SEP87   6:32a        7 
  164.            C --  L.BK!          13SEP87   1:49p      931 
  165.            D --  L.LTR          13SEP87   2:01p     1052 
  166.            E --  X.BK!          13SEP87   2:02p      931 
  167.            F --  PS.BK!         13SEP87   2:21p      959 
  168.            G --  PS.LTR         13SEP87   2:28p      987 
  169.            H --  PDISK.BK!      13SEP87   2:32p     1320 
  170.            I --  PDISK.LTR      13SEP87   2:38p     1332 
  171.            J --  PCOPY.LTR      13SEP87   2:43p      943 
  172.            K --  PPRINT.BK!     13SEP87   3:09p      820 
  173.            L --  PPRINT.LTR     13SEP87   3:11p      846 
  174.            M --  X              13SEP87   3:12p      846 
  175.            N --  WPSELTMP.BAT   17SEP87  10:12p       20 
  176.            O --  {WP}BACK.1     17SEP87  10:30p    11844 
  177.       
  178.      Press a letter to select a file from the list, <ESC> to exit, or 
  179.      <ENTER> to select the most recent file ({WP}BACK.1) 
  180.       
  181.      Waiting for your selection...  
  182.  
  183.      *****************************************************************
  184.  
  185.  
  186.      WPGRAB now waits for you to select the file to be processed.
  187.  
  188.      .    Press <Enter> to automatically select the most recent file found in
  189.           the directory.  This is the filename at the bottom of the list.
  190.  
  191.      .    Press a  letter from A to O to select one of the files shown on the
  192.           display.  These  files  are  listed  sorted  by  date  and  time in
  193.           ascending order.
  194.  
  195.      .    Use the up and down arrow keys to select the file to process.  Then
  196.           press the <enter> key to begin processing.
  197.  
  198.      .    Press <ESCape> to terminate the process and not select any file.
  199.  
  200.      .    Press </> to start the command without a filename.
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.                                           2
  209.  
  210.      WPGRAB can actually be used for interfacing to any command  that accepts
  211.      individual filenames  as input.  Consider using it for editors, listers,
  212.      word processors, and other utilities.
  213.  
  214.  
  215.      Command Parameters
  216.  
  217.      WPGRAB has a few simple  command  parameters  to  modify  its operation.
  218.      Here is how they operate:
  219.  
  220.  
  221.           COMMAND FORMAT:
  222.  
  223.           WPGRAB [fspec]      [/C:xxxx]  [/L]  [/D]  [/H]  [/X]
  224.                               [/SS]  [/SC]  [/SV]  [/SA]
  225.  
  226.  
  227.           [fspec]   Enter the  DOS file  specification for  the directory and
  228.                     file names to be  searched.    If  no  directory  name is
  229.                     specified the current directory will be searched.
  230.  
  231.           /C:xxx    WPGRAB  normally  builds  a  WP  command  followed by the
  232.                     pathname/filename selected.  If you desire  to use WPGRAB
  233.                     for  another  utility,  specify  the -C command parameter
  234.                     followed by the command  to be  used.   This can  also be
  235.                     used to specify a pathname to locate a command in.
  236.  
  237.                          /C:\perfect\wp
  238.  
  239.                          The above  example would  start the  WP command from
  240.                          the \perfect\ directory.
  241.  
  242.                          /C:del
  243.  
  244.                          The above command would  use the  DOS delete command
  245.                          to delete the file specified.
  246.  
  247.  
  248.           /L        The  /L  parameter  has  no  other values to specify.  It
  249.                     simply causes  WPGRAB  to  select  the  most  recent file
  250.                     processed  and  not  ask  the  user to select a file.  It
  251.                     would be used when you know you want the most recent file
  252.                     processed.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                           3
  262.  
  263.           /D        WPGRAB normally  builds a DOS batch file with the command
  264.                     to be executed.    A  more  efficient  way  to  start the
  265.                     command  is  to  start  it  while WPGRAB is still active.
  266.                     This is what the /D parameter causes WPGRAB to do.
  267.  
  268.                     The disadvantage here is that about 30K of memory will be
  269.                     used by  WPGRAB and  will not  be available  to your word
  270.                     processor.   If you  have plenty  of memory,  this is the
  271.                     most efficient way to process.
  272.  
  273.  
  274.           /H        Causes WPGRAB to display help information.
  275.  
  276.  
  277.           /SS       The input  pattern name  will be used as a soundex search
  278.                     argument to locate files to list.  A soundex search is an
  279.                     algorithm to find words that sound like the word entered.
  280.                     For example,  if you specify  a pattern  name of  TOM*, a
  281.                     filename of  THOM, TOOM,  or TIM  would also be returned.
  282.                     This is great for locating filenames when you do not know
  283.                     the exact spelling.
  284.  
  285.  
  286.           /SV       As the  directory is searched, the filenames are compared
  287.                     without  the  vowels  in  the  pattern  or  the directory
  288.                     filename.    In  this  way,  if  you  slightly misspell a
  289.                     filename, it may still be located.
  290.  
  291.  
  292.           /SC       Instead of comparing for  an exact  match on  the pattern
  293.                     name, WPGRAB will show any filename that contains all the
  294.                     characters in the  pattern  supplied.    For  example, if
  295.                     WPGRAB  DISK  was  entered,  the following files would be
  296.                     shown:
  297.  
  298.                          ATDISK.BAT
  299.                          DDIISSK.TXT
  300.                          DISK.EXE
  301.                          DISH_KAT.EXE
  302.  
  303.  
  304.           /SA       Processes as if /SS,  /SV and  /SC were  all specified to
  305.                     list  the  most  possible  matches  to  the  pattern name
  306.                     specified.
  307.  
  308.  
  309.           /X        eXempt  --  Files with the following  extensions will not
  310.                     be  presented   for  selection  when  this  parameter  is
  311.                     specified;  .EXE  .ARC  .COM  .LIB  .OBJ .BAK .BK!
  312.  
  313.  
  314.                                           4
  315.      Supplied DOS batch files
  316.  
  317.      The following .BAT files are provided with WPGRAB as examples and to get
  318.      you started as soon as possible.
  319.  
  320.           WPL.BAT
  321.  
  322.                Use  the  WPL  command  to  automatically select the last file
  323.                processed and invoke your word processor  or other application
  324.                to process  it.  You will not get a chance to select a file to
  325.                process.
  326.  
  327.                     echo off
  328.                     cls
  329.                     rem Automatically starts the word processor for the
  330.                     rem most recent file in the directory.
  331.                     cd\wp
  332.                     wpgrab %1 /C:\perfect\wp /l /X
  333.                     if errorlevel 2 goto error
  334.                     wpgrab$$
  335.                     :error
  336.  
  337.           WPS.BAT
  338.  
  339.                     echo off
  340.                     cls
  341.                     rem Lists 15 most recent files and allows you to select
  342.                     rem for processing.  If no file is selected processing is
  343.                     rem terminated.
  344.                     cd\wp
  345.                     wpgrab %1 /C:\perfect\wp/x
  346.                     if errorlevel 2 goto error
  347.                     wpgrab$$
  348.                     :error
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                                           5
  368.      Registering WPGRAB
  369.  
  370.      WPGRAB is distributed under the Shareware concept.   This makes  them it
  371.      available for  anyone to  try without  obligation.   If you decide it is
  372.      useful and want to  keep it,  I ask  that you  register your  use of it.
  373.      This will allow for continued support and maintenance of the program and
  374.      will help to encourage that  more  quality  software  be  made available
  375.      through this method.   I ask all corporate and government users register
  376.      their copies.
  377.  
  378.      The form on the following page indicates registration  costs and  may be
  379.      used to register any or all of the utilities.
  380.  
  381.           Send registration requests to:
  382.  
  383.                          Norm Patriquin
  384.                          P.O. Box 8263
  385.                          San Bernardino, CA   92412
  386.  
  387.  
  388.      The  registration  charge  is  a  one  time fee that entitles you to all
  389.      future versions of the program.    These  may  either  be  obtained from
  390.      normal Shareware sources or directly from me.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                           6
  421.      WPGRAB 1.6 Registration
  422.      Please register  the following  utilities.   I have enclosed the fees as
  423.      marked below.
  424.  
  425.      _____ PALERT - Notify you when disk space is low....    $15.00
  426.      _____ PATTR - Modify file attributes................    $10.00
  427.      _____ PCOPY & PMOVE - like a super DOS copy.........    $15.00
  428.      _____ PDAILY - execute a program once a day.........    $10.00
  429.      _____ PDELETE - like super DOS erase facility.......    $15.00
  430.      _____ PPRINT - extensive printing of text files.....    $15.00
  431.      _____ PSEARCH - find files and text search..........    $15.00
  432.      _____ WPGRAB - start a command with recent filename.    $15.00
  433.      _____ PTOUCH - modify files date and time...........   No Charge
  434.      _____ ARCFDATE - modify dates on .ARC type files....    $15.00
  435.  
  436.  
  437.      _____ Users Guide for all utilities and disk........
  438.                (Does not include registration)               $15.00
  439.  
  440.      _____ Registration of all Patriquin Utilities with
  441.               program disk and User's Guide..............   $45.00
  442.  
  443.      _____ Update of newest Patriquin Utility disk with
  444.               manual.  ...................................  $15.00
  445.  
  446.      ****************************************************************
  447.  
  448.      Name: ________________________________________________________
  449.  
  450.      Company: _____________________________________________________
  451.  
  452.      Address: ______________________________________________________
  453.  
  454.               ______________________________________________________
  455.  
  456.      City: __________________________  State: ________  Zip: ________
  457.  
  458.      I learned about the utilities from: ____________________________
  459.  
  460.      If BBS indicate name and number please._________________________
  461.  
  462.      ____________________________________________________
  463.  
  464.      Please register the software under the following name:
  465.  
  466.      ____________________________________________________
  467.  
  468.                Send to:  Norm Patriquin
  469.                          P.O. Box 8263
  470.                          San Bernardino, CA  92412
  471.  
  472.  
  473.                                           7
  474.      Reporting Problems with WPGRAB 1.6
  475.      I welcome all comments or enhancement suggestions. Please  document each
  476.      item clearly  and provide  printed examples if possible.  Please be sure
  477.      to include this form with all requests, it will help to make sure we can
  478.      provide you with the best possible service.
  479.  
  480.  
  481.      Name: _______________________________________________________
  482.  
  483.      Company: ____________________________________________________
  484.  
  485.      Address:   _________________________________________________
  486.  
  487.                 ______________________________________________________
  488.  
  489.      City: __________________________________  State: _______________
  490.  
  491.      Zip: ______________________________
  492.  
  493.      Telephone: _______ / ________________________ (Home / Work)
  494.  
  495.  
  496.      Date: _________________________
  497.  
  498.  
  499.      Name and version of Utility: ___________________________________
  500.  
  501.      Description of problem or enhancement:
  502.  
  503.      ____________________________________________________________
  504.  
  505.      ____________________________________________________________
  506.  
  507.      ____________________________________________________________
  508.  
  509.      ____________________________________________________________
  510.  
  511.      Suggested solution:
  512.  
  513.      ____________________________________________________________
  514.  
  515.      ____________________________________________________________
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                           8
  527.      Maintenance Log
  528.  
  529.            17SEP87  NJP 1.0  program developed
  530.  
  531.            20SEP87  NJP 1.1  corrected bug and improved performance
  532.  
  533.            26SEP87  NJP 1.2  Added day of week to display
  534.  
  535.            29SEP87  NJP 1.3  Added -X to exclude .ARC .EXE .COM
  536.  
  537.            08OCT87  NJP 1.4  Add selection bar
  538.  
  539.            30OCT87  NJP 1.4  Save directory on -d option
  540.  
  541.            22FEB88  NJP 1.5  Add .BK! and .BAK to exclude from -x
  542.  
  543.            23FEB88  NJP 1.5  correct soundex.  add /S1 /S2 /S3
  544.  
  545.            29FEB88  NJP 1.6  Make new help. Add /S4 make parms /
  546.                              Change special searches to /SS /SV /SC /SA
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.                                           9
  580.