home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / GAPRAP13.ZIP / GAPWRAP.DOC < prev    next >
Text File  |  1995-01-04  |  7KB  |  162 lines
  1.  
  2.  
  3.                          GAPwRAP Version 1.3
  4.  
  5.                    Copyright (c) 1992 RoboSoft Systems
  6.                          All rights reserved.
  7.  
  8.  
  9.  
  10.     GAPwRAP can be used with the GAP UPCHECK.BAT processing to 
  11.     provide upload file date filtering, to filter and reformat the
  12.     FILE_ID.DIZ description to a form more suitable for use with GAP,
  13.     and to add a line to the extended description giving details about 
  14.     the archive content.  The detail includes how many files are in an 
  15.     archive, the date of the oldest file, and the date of the newest 
  16.     file.  It expects the contents of the archive file to already be 
  17.     dearchived into a test directory that contains ONLY the dearchived 
  18.     files.
  19.  
  20.  
  21.     The calling format for GAPwRAP is:
  22.  
  23.  
  24.     GAPwRAP [/f] [/x] [/r[<cols>]] [/d] <test_dir> <work_dir> 
  25.              [<oldest_date> <newest_date>]
  26.  
  27.  
  28.     The first four parameters, /f, /x, /r, and /d are optional, but MUST 
  29.     be the first parameters on the command line if you're going to use 
  30.     them. You must specify at least the test_dir and the work_dir.  The 
  31.     file filter dates are optional, but both must be specified if the 
  32.     date filter is to be used.  
  33.  
  34.     If the /f parameter is specified, all high-ASCII characters will 
  35.     be Filtered from the description.  The intent of this is to get 
  36.     rid of those cute boxes that look great on PCBoard systems but
  37.     look like doo-doo if the description is reformatted.
  38.  
  39.     If the /x parameter is specified, all Xcode sequences will be 
  40.     filtered from the description.  If you don't like technicolor file 
  41.     listings, this is the way to go.
  42.     
  43.     If the /r parameter is specified, the description will be 
  44.     Reformatted to fit a line <cols> characters long.  <cols> will 
  45.     default to 72 if not specified.  If you use the /r parameter you 
  46.     should also use the /f parameter or you will end up with some 
  47.     pretty unreadable descriptions. 
  48.  
  49.     If the /d parameter is specified, all files in the <test_dir> will
  50.     be deleted by GAPwRAP before it exits.
  51.  
  52.     GAPwRAP assumes the contents of the uploaded file have been 
  53.     de-archived into a "test" directory.  This would normally be done
  54.     in UPCHECK.BAT if you're going to scan the upload for viruses. 
  55.     This "test" directory is NOT created by GAP or by GAPwRAP.  You 
  56.     must create it manually or have your UPCHECK.BAT create it.  If 
  57.     you run a multi-node system, each node should have its own test 
  58.     directory.  (A good place to put it is under the WORK directory 
  59.     created for each node.)
  60.  
  61.     The test_dir is the path to the directory in which the dearchived 
  62.     files reside.
  63.  
  64.     The work_dir is the path of the GAP upload work directory.  This 
  65.     is passed to UPCHECK.BAT as %2.
  66.  
  67.     The date filter, if used, must have both the oldest_date and the 
  68.     newest_date.  (They can both be the same.)  If the oldest file in 
  69.     the test_dir is dated prior to the specified oldest_date, GAPwRAP 
  70.     will return ERRORLEVEL 1.  If the newest file in the test_dir is 
  71.     dated prior to the specified newest_date, GAPwRAP will return 
  72.     ERRORLEVEL 2.  (Note: If you want to differentiate between these
  73.     two conditions in your batch file, you MUST check for ERRORLEVEL 2
  74.     before checking for ERRORLEVEL 1 since DOS will consider the IF
  75.     to be true for an ERRORLEVEL greater than or equal to the specified
  76.     ERRORLEVEL.)
  77.  
  78.     Dates must be specified in the form YYMMDD, where YY is the 
  79.     two-digit year, MM is the two-digit month, and DD is the two-digit
  80.     day of the month.  (e.g. 5 November 1992 would be 921105.)
  81.  
  82.     If a FILE_ID.DIZ file exists in the test_dir, GAPwRAP will copy 
  83.     it to the work_dir and add a line of the form 
  84.     
  85.           Files: xx  Oldest: xx/xx/xx  Newest: xx/xx/xx 
  86.     
  87.     to the end of work_dir copy of FILE_ID.DIZ.  If FILE_ID.DIZ
  88.     already contains ten or more lines of description or something 
  89.     that appears to be a Files/Oldest/Newest line, nothing will be 
  90.     added.
  91.  
  92.     If there is no FILE_ID.DIZ in the test_dir, GAPwRAP will look 
  93.     for DESC.SDI.  If there is a DESC.SDI, it will be copied to the 
  94.     work_dir.  No changes will be made to DESC.SDI.
  95.  
  96.     Please note that any changes to FILE_ID.DIZ are made to the copy 
  97.     in the work_dir, not the original.  The contents of the ZIP file 
  98.     are completely unchanged by GAPwRAP.
  99.  
  100.     Here's an excerpt from my UPCHECK.BAT file to show how GAPwRAP 
  101.     can be used.  The blank lines were added for clarity.
  102.  
  103.  
  104.         SET TEST_DIR=C:\GAP\TEST\    
  105.         SET C_PORT=2
  106.  
  107.         .
  108.         .   Stuff missing
  109.         .
  110.  
  111.  
  112.     :ZIP
  113.  
  114.     REM Check ZIP integrity
  115.  
  116.         PKUNZIP -t %1 > Fail.Txt
  117.         IF ERRORLEVEL 1 GOTO Bad
  118.         GAPECHO %C_PORT%  File Integrity Ok#Now Checking for Viruses...
  119.         DEL Fail.Txt  > nul
  120.  
  121.     REM UnZIP to test_dir and scan for viruses
  122.  
  123.         PKUNZIP %1 %TEST_DIR%
  124.         SCAN %TEST_DIR%*.* /D /NOMEM
  125.         IF ERRORLEVEL 1 GOTO Bad
  126.         GAPECHO %C_PORT%  No Viruses Detected!
  127.  
  128.     REM Check for old files and add #files/dates to FILE_ID.LNG/DIZ
  129.  
  130.         GAPwRAP /f /r72 /d %TEST_DIR% %2 800101 890101
  131.         IF ERRORLEVEL 1 GOTO Too_Old
  132.         GOTO Comment
  133.  
  134.         .
  135.         .   Stuff missing
  136.         .
  137.  
  138.  
  139.     Questions or comments about this program can be directed to the 
  140.     Sysop at The Cookie Jar (714-997-0350) or to Jay Heyl at The 
  141.     Crow's Nest.  As is usual with software, I take no responsibility 
  142.     whatsoever for this program or your use of it.  If you use it and 
  143.     it fries your FAT, scrambles your hard drive, or in any way 
  144.     performs in a manner you didn't expect, you're on your own.
  145.  
  146.     GAPwRAP is copyrighted software, but it may be used in a 
  147.     non-commercial environment without payment of any fee.  GAPwRAP
  148.     may be freely distributed on any BBS or electronic information
  149.     service.  Commercial disk vendors may distribute GAPwRAP as long
  150.     as the charge for such distribution does not exceed $5.
  151.  
  152.     If you're absolutely in love with this program and can't keep 
  153.     yourself from expressing your appreciation, gifts may be sent to:
  154.     Jay Heyl, RoboSoft Systems, P.O. Box 2221, Orange, CA  92669.
  155.     I'm particularly fond of Cabernet and chocolate truffles.  Money
  156.     is an acceptable alternative if neither of the above is convenient.
  157.  
  158.     If you like GAPwRAP, you might want to check out the other GAP 
  159.     utilities from RoboSoft Systems.  See the enclosed file GAP-PRO.TXT 
  160.     for details.
  161.  
  162.