home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / RA / PUTDIZ01.ZIP / PUT-DIZ.DOC < prev    next >
Text File  |  1994-02-10  |  15KB  |  275 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ ▒▒▒▒  PUT-DIZ v0.1  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4.  
  5.  
  6.                   Puts FILE_ID.DIZ descriptions into archives
  7.  
  8.                              Written by Mike Ehlert
  9.                     Copyright 1992,93,94 All Rights Reserved
  10.  
  11.                                    Mike Ehlert 
  12.                    PACIFIC COAST MICRO
  13.                                 1879 Campbell Ave.
  14.                            Thousand Oaks, CA. 91360 USA
  15.  
  16.                     A North American RemoteAccess Support Site
  17.               
  18.                 (805) 494-8327 / (805) 494-8427  / (805) 494-9386
  19.  
  20.                         FidoNet: 1:102/1001 and 1:102/1005
  21.  
  22. ┌─────────────────────────────────────────────────────────────────────────────┐
  23. │ ▒▒▒▒  What can this do ?  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  24. └─────────────────────────────────────────────────────────────────────────────┘
  25.  
  26.        PUT-DIZ is an add-on utility for the RemoteAccess 2.01 File Manager.
  27.        It allows you to quickly create FILE_ID.DIZ files in your archives
  28.        which do not already have such a file in them.
  29.        
  30.        Notice that this is the OPPOSITE of GET-DIZ, another RAMGR add-on.
  31.        *****************************************************************
  32.        
  33.        DIZ stands for "Description In Zip", and FILE_ID.DIZ descriptions
  34.        were originally use by PCBoard BBS Software. DESC.SDI is a similar
  35.        description file used by the Software Distribution Network.
  36.  
  37.  
  38.        Notice! By using this program, you might be breaking the law by
  39.        adding non-original files to a programmers archive. The author of
  40.        this program reccomends that you do not use it at all, unless you
  41.        are sure that the archives you process with it are allowed to
  42.        have files added to them! WARNING!
  43.  
  44.  
  45. ┌─────────────────────────────────────────────────────────────────────────────┐
  46. │ ▒▒▒▒  Whats new in version 0.1  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  47. └─────────────────────────────────────────────────────────────────────────────┘
  48.  
  49.       First version. I read in the RA_UTIL echo that someone was looking for
  50.       such a program, so I simply reversed the code in my GET-DIZ program to
  51.       create FILE_ID.DIZ descriptions inside the archives, based on the
  52.       descriptions found in the RA FDB.
  53.        
  54. ┌─────────────────────────────────────────────────────────────────────────────┐
  55. │ ▒▒▒▒  Required Programs  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  56. └─────────────────────────────────────────────────────────────────────────────┘
  57.  
  58.        PUT-DIZ.COM is not a stand alone program, and requires the following
  59.        other programs to properly run:
  60.  
  61.        RAMGR.EXE    (RA Manager which comes with RA 2.01)
  62.        KIS.EXE      (Keyboard Input Simulator by R. van Hoven)
  63.        PKZIP.EXE  (Pkunzip by PKware)
  64.        ARJ.EXE      (Arj by Robert K Jung)
  65.        STAMP.COM    This version requires a date stamper so that the 
  66.                     FILE_ID.DIZ is not newer then the rest of the archive.
  67.        
  68.        The reason that KIS is needed is to stuff keys into the keyboard
  69.        buffer before returning to RAMGR, to force RAMGR to export the FDB
  70.        description into a temporary file, and then forces PUT-DIZ to be called
  71.        again for the next file(s).
  72.        You can freq. or download the latest KIS from any DISP support site
  73.        (the FileDoor dudes), or from me. The current version is KIS_V101.ZIP
  74.        which is only 15k in size. KIS is postcardware (a form of shareware).
  75.  
  76.  
  77.        The reason STAMP is needed is to change the date of the FILE_ID.DIZ
  78.        before adding it to the archive. Otherwise the archive dates would
  79.        add be the current date. STAMP must be in the path.
  80.        
  81. ┌─────────────────────────────────────────────────────────────────────────────┐
  82. │ ▒▒▒▒  Upgrading from a previous version ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  83. └─────────────────────────────────────────────────────────────────────────────┘
  84.  
  85.        Yeah, right.
  86.  
  87. ┌─────────────────────────────────────────────────────────────────────────────┐
  88. │ ▒▒▒▒  Installing  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  89. └─────────────────────────────────────────────────────────────────────────────┘
  90.  
  91.        You must have the %RA% Environment varable set (SET RA=C:\RA).
  92.        ***NOTICE!!!*** Do *NOT* have a trailing backslash on the %RA%
  93.        environment variable or GET-DIZ will not work!
  94.  
  95.        Run RACONFIG > OPTIONS > FILES > RAMGR-FNKEYS
  96.        You will see a box of 5 sysop definable options, most of them are
  97.        probally blank:
  98.  
  99.       ╒══════════════════════════════╡  RAMGR ALT-function key manager  ╞╕
  100.       │                                                                  │
  101.       │ 1  C:\shez\shez.exe @ *M                                         │
  102.       │ 2                                                                │
  103.       │ 3                                                                │
  104.       │ 4                                                                │
  105.       │ 5                                                                │
  106.       │                                                                  │
  107.       ╘══════════════════════════════════════════════════════════════════╛
  108.  
  109.       In the above example, only ALT-F1 is defined, which will cause RAMGR
  110.       to pass the filename currently under the cursor to SHEZ, which is an
  111.       archive viewer. The @ is replaced by RAMGR with the actual path and
  112.       name of the current file. The *M tells RAMGR to swap out of memory
  113.       before shelling to the defined program.
  114.  
  115.  
  116.       PUT-DIZ must be installed in the last slot, so its activated by Alt-F5.
  117.       
  118.  
  119.       *********************************************************************
  120.       To install PUT-DIZ just for ZIP files, enter lines 5 like this:
  121.  
  122.       ╒══════════════════════════════╡  RAMGR ALT-function key manager  ╞╕
  123.       │                                                                  │
  124.       │ 1  c:\shez\shez.exe @ *M                                         │
  125.       │ 2                                                                │
  126.       │ 3                                                                │
  127.       │ 4                                                                │
  128.       │ 5  c:\ra\put-diz.com c:\utils\kis c:\utils\pkunzip -a-o @        │
  129.                               │            │               │    │
  130.                               │            │               │    │
  131.          Path\filename of KIS─┘            │               │    │
  132.          Path\filename of Archiver─────────┘               │    │
  133.          Unarchiver add-new command────────────────────────┘    │
  134.          Converted to Path\filename of current file by RAMGR────┘
  135.  
  136.      
  137.  
  138.       *********************************************************************
  139.       To install GET-DIZ just for ARJ files, enter lines 5 like this:
  140.  
  141.  
  142.       ╒══════════════════════════════╡  RAMGR ALT-function key manager  ╞╕
  143.       │                                                                  │
  144.       │ 1  c:\shez\shez.exe @ *M                                         │
  145.       │ 2                                                                │
  146.       │ 3                                                                │
  147.       │ 4                                                                │
  148.       │ 5  c:\ra\put-diz.com c:\utils\kis c:\utils\arj   -a-n @          │
  149.                               │            │             │    │
  150.                               │            │             │    │
  151.          Path\filename of KIS─┘            │             │    │
  152.          Path\filename of Archiver─────────┘             │    │
  153.          Unarchiver add-new command──────────────────────┘    │
  154.          Converted to Path\filename of current file by RAMGR──┘
  155.  
  156.  
  157.       
  158.        
  159.       Notice that in order to use the RECURSIVE mode, GET-DIZ *MUST* be
  160.       installed in slot #5 (Alt-F5 key).
  161.       > ANY POSITION OTHER THEN 2 WILL NOT WORK!. <
  162.         +++++++++++++++++++++++++++++++++++++++++
  163.       The reason for this is because GET-DIZ stuffs an ALT-F5 into the
  164.       keyboard buffer in order to force RAMGR to call it again after it
  165.       has moved the cursor down to the next file.
  166.     
  167.       It is NOT required to specify the entire path to KIS or to your
  168.       Unarchiver, but PUT-DIZ will run faster if you do. If you don't
  169.       specify these paths, then they must be located in the DOS %PATH%.
  170.  
  171.       It is NOT required to use the *M command to swap out of memory
  172.       before running GET-DIZ, and it's faster if you do not. However
  173.       if your system is running in a very small window then you might
  174.       have to add the *M to the end of the command lines.
  175.  
  176. ┌─────────────────────────────────────────────────────────────────────────────┐
  177. │ ▒▒▒▒  Usage  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  178. └─────────────────────────────────────────────────────────────────────────────┘
  179.  
  180.        Once it's installed, run "RAMGR -F" and select a file area to use.
  181.        You can optionally press Alt-D to change the display mode first.
  182.        
  183.        To use PUT-DIZ, move the cursor to the first file which you wish to
  184.        process. Press Alt-F2 to begin, and RAMGR will call PUT-DIZ once for
  185.        each file from there, all the way down to the last file in the current
  186.        area. So to process an entire area, simply start the cursor at the
  187.        first file (at the top) and press Alt-F5. If you wish to abort the
  188.        process before it has finished, simply press Ctrl-Break twice.
  189.  
  190. ┌─────────────────────────────────────────────────────────────────────────────┐
  191. │ ▒▒▒▒  DesqView Limitations  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  192. └─────────────────────────────────────────────────────────────────────────────┘
  193.  
  194.        PUT-DIZ runs perfectly under Desqview, but KIS 1.01 has a limitation:
  195.        You can not switch windows while GET-DIZ is running, or elce KIS will
  196.        stuff the keyboard buffer into the new current window.
  197.        
  198.        If you don't like this limitation, there are three things you can do:
  199.        1. Ask the KIS author to make KIS more compatible with DV.
  200.        2. Write your own Keyboard Input Simulator to use instead.
  201.        3. Or delete this package and forget you ever saw it. :-)
  202.  
  203. ┌─────────────────────────────────────────────────────────────────────────────┐
  204. │ ▒▒▒▒  Trouble Shooting ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  205. └─────────────────────────────────────────────────────────────────────────────┘
  206.  
  207.       If you could not get PUT-DIZ to work, here's some things to check:
  208.  
  209.       Do *not* have a trailing bakcslash on your %RA% Environment variable.
  210.       Do *not* install it as RECURSIVE in any slot other then #5 in RACONFIG.
  211.       Check that your paths and filenames are entered correctly.
  212.       
  213.       If all elce fails drink another beer, wait 5 minutes, and try again.
  214.       :-) Or give me a netmail and I'll try to help you. 
  215.                
  216. ┌─────────────────────────────────────────────────────────────────────────────┐
  217. │ ▒▒▒▒  Disclaimer  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  218. └─────────────────────────────────────────────────────────────────────────────┘
  219.  
  220.        PUT-DIZ was slight tested, and appears to work on my system (Running 3
  221.        nodes under RA-Pro 2.01 and Desqview). But it comes with NO Warranty.
  222.        Use it at your own risk!
  223.  
  224.        You should test this on your own system, on non-important archives.
  225.        This program could possibly contain bugs which could destroy your
  226.        archives!
  227.  
  228.        In no event shall Mike Ehlert or PACIFIC COAST MICRO be liable for
  229.        any damages caused by PUT-DIZ. The software is supplied as-is.
  230.        
  231. ┌─────────────────────────────────────────────────────────────────────────────┐
  232. │ ▒▒▒▒  Registering  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  233. └─────────────────────────────────────────────────────────────────────────────┘
  234.  
  235.        This version of PUT-DIZ is supplyed as freeware.
  236.        
  237.        If you like it, you will probally want to register GET-DIZ, the
  238.        companion to this program which does the opposite.
  239.  
  240. ┌─────────────────────────────────────────────────────────────────────────────┐
  241. │ ▒▒▒▒  Credits  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  242. └─────────────────────────────────────────────────────────────────────────────┘
  243.  
  244.       Thanks to Andrew Milner, for writing such a fantastic BBS package.
  245.       Thanks to Bruce Bodger, for asking me to become a RA beta tester.
  246.       Thanks to Ron Huiskes, for letting me steal his DOC style.
  247.       Thanks to Rob van Hoeven, for writing Keyboard Input Simulator.
  248.       Thanks to my wife Cindy, for putting up with my BBS addiction.
  249.       Thanks to David Gilmore and Roger Waters for background inspiration.
  250.       Thanks to God for providing cool women, cold beer, and green grass.
  251.  
  252. ┌─────────────────────────────────────────────────────────────────────────────┐
  253. │ ▒▒▒▒  Updates  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  254. └─────────────────────────────────────────────────────────────────────────────┘
  255.  
  256. The latest version of PUT-DIZ can always be file file requested using the
  257. magic name GET-DIZ from PACIFIC COAST MICRO BBS in Southern California.
  258.  
  259. PCM is a North American RemoteAccess Support and Beta site, and offers one
  260. of the largest collections of RA related utilites available. You can logon
  261. quickly using the name GUEST (no password needed). Or create your own
  262. account and tell the questionere that you run a BBS for instant access. 
  263.  
  264. Be sure to (J)oin the Sysops File Conference from the files menu. :-)
  265.  
  266. PCM Node 1:  805-494-8327  USR 16.8k dual
  267. PCM Node 2:  805-494-8427  USR 16.8k dual
  268. PCM Node 3:  805-494-9386  USR 21.6k dual
  269.  
  270. Or Freq. FILES from 1:102/1001 or 1:102/1005 for a list of sysop related
  271. utilities and doors avilable from PACIFIC COAST MICRO, a RA Support site.
  272.  
  273. ┌─────────────────────────────────────────────────────────────────────────────┐
  274. │ ▒▒▒▒  PUT-DIZ v0.1  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  275. └─────────────────────────────────────────────────────────────────────────────┘