home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / a / apdz26.zip / APP-DIZ.DOC next >
Text File  |  1993-03-17  |  13KB  |  355 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.    ██████████                                 █████████
  15.    ██      ██                                 ██       ██   ██
  16.    ██      ██                                 ██       ██
  17.    ██████████  ██████████  ██████████         ██       ██   ██   ███████
  18.    ██      ██  ██      ██  ██      ██  █████  ██       ██   ██        ▄
  19.    ██      ██  ██      ██  ██      ██         ██       ██   ██    ▄ ▀
  20.    ██      ██  ██████████  ██████████         █████████     ██   ███████
  21.                ██          ██
  22.                ██          ██
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                         Apply-Diz by Dataware Software
  30.  
  31.                                  Version 2.6
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                
  44.                                 
  45.                                Copyright (C) 1992-93
  46.                                         by
  47.                                     Tom Carroll
  48.  
  49.  
  50.                                 All rights reserved
  51.  
  52.  
  53.  
  54.                                  The Data Shop BBS
  55.                             (509)582-9493 (HST/DS 16.8)
  56.                                    Kennewick, WA
  57.                               FIDO address (1:347/110)
  58.  
  59.                               MAGIC FILE NAME: APPDIZ
  60.     ┌──────────────┐
  61.     │ INTRODUCTION │
  62.     └──────────────┘
  63.  
  64.     Apply-Diz is a utility designed to ease the burden of sysops trying to 
  65.     describe files, that either had their descriptions lost in the process of
  66.     a file transfer, or they are old enough that you just can't remember.  It
  67.     places the burden of describing files back onto the users and authors that
  68.     upload files without a description file such as FILE_ID.DIZ or DESC.SDI in
  69.     which Apply-Diz will make a FILE_ID.DIZ from the user supplied description
  70.     and compress it into the archive.  Apply-Diz can automatically detect
  71.     archives by signature, and extract or compress into the archive based on
  72.     this signature, no more relying on file suffixes.
  73.     
  74.     Apply-Diz has two purposes, one is to enhance the service that some of the
  75.     larger BBS's offer by insuring no matter what kind of file or archive
  76.     received on their system, either uploaded by users, downloaded from another
  77.     BBS, or copied to the system from monthly mailings, Apply-Diz will make
  78.     sure that two descriptions exist for the archive, one in the PCBoard(tm)
  79.     directory format, and the other in a FILE_ID.DIZ. (one of the two has to
  80.     exist, but neither one is overwritten if they both exist.)  This is a very
  81.     appealing feature that other sysops will appreciate if they subscribe to
  82.     your BBS and download your files for use on their systems.
  83.  
  84.     Two is the major reason Apply-Diz was invented.  I run a BBS, and I really
  85.     don't have all the time in the world to mess around with file descriptions,
  86.     and since I'm a programmer I tend to hold on to old archives, and then
  87.     forget what they are.  So I decided to cut half my workload and just write
  88.     a utility. (hmmm...  what am I saying?)
  89.     
  90.     You're probably asking your self "What is this guy babbling about?"  Well,
  91.     it's time to cut to the chase and show you how to operate it...
  92.  
  93.     ┌──────────────┐
  94.     │  DISCLAIMER  │
  95.     └──────────────┘
  96.  
  97.     This software is provided as is without warranty or guarantee either
  98.     expressed or implied.  The author will not be held responsible for ANY
  99.     damages that may result in the use of this program, including revenues
  100.     lost.  The Author will, however, be responsible for a full refund of the
  101.     purchasers registration cost should the software not be capable of
  102.     operating on the purchasers computer.
  103.  
  104.     Apply-Diz software and this document are Copyright (C) 1992 by Tom Carroll. 
  105.     All rights reserved.
  106.  
  107.     ┌──────────────┐
  108.     │   LICENSE    │
  109.     └──────────────┘
  110.  
  111.     This program is released as SHAREWARE.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.     Apply-Diz v2.6                                                       Page 2
  119.     You are free to use this version of the program for a period of 30 days,
  120.     upon which, you must either register the software, or delete it from your
  121.     system with the exception of the original archive, which may be freely
  122.     distributed as outlined below.  Please refer to the ORDER.FRM included in
  123.     the distribution archive for registration information.
  124.  
  125.     No one may alter, modify, or reverse engineer Apply-Diz for any reason,
  126.     including but not limited to decompiling-compiling, patching, or
  127.     disassembling.
  128.  
  129.     You may freely distribute & copy this program for others subject to the
  130.     above restrictions and the following:
  131.  
  132.          ■ Apply-Diz is copied in unmodified form including this file. 
  133.          ■ There is no charge for copying except for the cost of disks.
  134.          ■ Apply-Diz is not included in another software package without
  135.            the express written permission of Tom Carroll
  136.  
  137.     You may operate Apply-Diz on one computer system at a time, one computer
  138.     system is defined as a single XT/AT/PC which operates solely by itself, or
  139.     multi-node BBS running the same BBS software and all nodes are connected
  140.     to a central file server.
  141.  
  142.     Should Apply-Diz need to be operated on more that one computer system, a
  143.     site license will be negotiated.
  144.  
  145.     ┌──────────────┐
  146.     │   SUPPORT    │
  147.     └──────────────┘
  148.  
  149.     If you should find any problems with this program, or you have any requests
  150.     or recommendations, you may reach me on my BBS, or at the FIDO address
  151.     listed on the front cover.  I may also be reached in the FIDO PCBNET,
  152.     SaltAir, UN'I, ILink, Global-Net, or Source-Net sysop conferences.
  153.  
  154.     ┌──────────────┐
  155.     │    FILES     │
  156.     └──────────────┘
  157.  
  158.     Files included in this archive:
  159.  
  160.               APP-DIZ.DOC  - This manual
  161.               APP-DIZ.ERR  - Sample error file
  162.               APP-DIZ.EXE  - The Apply-Diz executable
  163.               APP-DIZ.HIS  - Apply-Diz History information file
  164.               APP-DIZ.LOG  - Sample log file
  165.               APP-DIZ.XLD  - Sample exclude file
  166.               FILE_ID.DIZ  - Description file for Apply-Diz
  167.               ORDER.FRM    - Registration form & ordering info
  168.               PROGRAMS.DWS - Other programs by Dataware Software
  169.  
  170.     I originally compressed this program as APDZnn.ARJ, but it may be
  171.     compressed with any other archive program you wish to use.
  172.  
  173.     The latest version will always be available on my BBS using the magic
  174.     filename of APPDIZ.
  175.  
  176.  
  177.     Apply-Diz v2.6                                                       Page 3
  178.     Sometimes, there may be a need for debug code to be released.  This code is
  179.     used to track down specific problems which aren't normally encountered on
  180.     my system.  I have a 386/sx-25 w/4megs of RAM, and DOS 5.0, which should be
  181.     pretty standard and generic, but sometimes this doesn't present an
  182.     optimal testing environment, so please, if you're having problems, and
  183.     debug code is available, feel free to FREQ APDEBUG from me, or if you're
  184.     registered on my BBS call and download APPDIZ.ARJ from conference #1.
  185.  
  186.     If APPDIZ.ARJ isn't available, then you're the first person that has
  187.     found a problem, so please leave me your specifics so I may be able to
  188.     trouble shoot the problem(s).
  189.  
  190.     ┌──────────────┐
  191.     │  EXECUTION   │
  192.     └──────────────┘
  193.  
  194.     Apply-Diz is fully command line driven.
  195.  
  196.     The syntax for calling it is as follows:
  197.  
  198.     APP-DIZ <ARCHIVE> <PCBDIRLIST> { /Cx /INFO /NL /Rx /WKd: }
  199.  
  200.     <ARCHIVE> = Full path and filename(s) of the archive to be processed.
  201.  
  202.     <PCBDIRLIST> = Full PCBoard file directory listing to be processed.
  203.  
  204.     { Optional switches }
  205.  
  206.     /CD  = Process files in CD-ROM mode.  (Does not add FILE_ID.DIZ)
  207.     
  208.     /CF* = only checks for a FILE_ID.DIZ within the archive.
  209.  
  210.     /CP* = only checks for a description in the PCB DIR file.
  211.  
  212.     /INFO = Will add an archive information line to the PCBoard(tm) DIR list.
  213.             (i.e.  Files: nn Newest: mm-dd-yy Oldest: mm-dd-yy)
  214.  
  215.     /IO = Info line only.  (i.e. Files: nn Newest: mm-dd-yy Oldest: mm-dd-yy)
  216.  
  217.     /NL = Turns of the logging feature.  This is a good idea if you're going
  218.           to process a directory with many files.  It is on by default.
  219.  
  220.     /RF = Will overwrite the FILE_ID.DIZ file in the archive or create it if
  221.           it doesn't already exist.
  222.  
  223.     /RP = Will overwrite the PCBoard(tm) description with the FILE_ID.DIZ, or
  224.           DESC.SDI file within the archive.
  225.  
  226.     /WK = Allows Apply-Diz to use a work drive.  The drive must be specified
  227.           as DRIVE:.  (i.e.  /WKD: )
  228.  
  229.    * - The /Cx switch is only used for speed.  If a file is found to not have
  230.        either description Apply-Diz will default to normal mode for that file.
  231.    
  232.    +Wild cards "*" may be specified on the command line for the archive file
  233.     name.  (i.e.  C:\UPLOAD\*.ARJ or C:\UPLOAD\*.* is valid)
  234.     
  235.  
  236.     Apply-Diz v2.6                                                       Page 4
  237.     You may at anytime during the processing of files press the <esc> key to
  238.     abort the process.  This really only has it's advantage in batch mode
  239.     operation since it will continue to process the present file it is working
  240.     on to ensure all open files are properly closed.
  241.  
  242.     ┌──────────────┐
  243.     │    NOTES     │
  244.     └──────────────┘
  245.  
  246.     At anytime, you may just type APP-DIZ without any command line arguments
  247.     and a help screen similar to this one will appear.
  248.  
  249.     You must specify the complete path for the archive name and the PCBoard
  250.     file directory listing.
  251.  
  252.    +In the registered version of App-Diz you may specify wild cards on the
  253.     command line for the processing of all files in one directory. (This is
  254.     refered to as Batch mode)
  255.  
  256.     If you are using an unregistered evaluation copy, insure you have command
  257.     line arguments correct if you run this utility in your nightly event
  258.     because there is a pause that requires input from the keyboard if they
  259.     are incorrect.
  260.  
  261.     Any description lines in the PCBoard directory that you do not wish to 
  262.     be included in the FILE_ID.DIZ may be excluded by adding the unique
  263.     beginning string for that line in the exclude file.  See the sample
  264.     APP-DIZ.XLD for more details.  This file must be named APP-DIZ.XLD and
  265.     located within the same directory as the executable.
  266.  
  267.     Apply-Diz will make a log file, or append to an existing one while
  268.     processing files.  Please refer to the enclosed sample log file.  Apply-Diz
  269.     will report each action/non-action taken on a particular file, and why it
  270.     didn't take any action if that is the case.  This file is not controlled
  271.     for size, so make sure you keep an eye on it, or it could grow very large
  272.     in a short amount of time.
  273.  
  274.     If an error should occur while processing the files, Apply-Diz will make a
  275.     report to an APP-DIZ.ERR file which will be located in the same directory
  276.     as the executable.  This too is appended for later viewing.  Again this
  277.     file isn't monitored for size either.
  278.     
  279.     ┌──────────────┐
  280.     │ LIMITATIONS  │
  281.     └──────────────┘
  282.  
  283.     Apply-Diz is incapable of scanning self extracting files at this time.  It
  284.     will skip all files that have the suffix's of .EXE, .COM, .TXT, .GIF, .PCX,
  285.     .SDA, and .TIC.  If you have problems with any other files making App-Diz
  286.     abort the process, please let me know and I will add code to not allow
  287.     those types of files to be scanned.
  288.  
  289.     Apply-Diz is NOT Desqview aware, or capable of working with locked files.
  290.     All PCBoard directories should be processed while all nodes are down.
  291.  
  292.     You must have the following archiver's for the defined archive types in
  293.     your path so Apply-Diz can manipulate it:
  294.  
  295.     Apply-Diz v2.6                                                       Page 5
  296.     ARC - ARC by System Enhancement Associates, Inc.
  297.     ARJ - ARJ by Robert K. Jung
  298.     LHA - LHARC by Haruyasu Yoshizaki
  299.     PAK - PAK by NoGate Consulting
  300.     ZIP - PKZip by PKWare, Inc.
  301.     ZOO - ZOO by Rahul Dhesi
  302.  
  303.     Apply-Diz must be executed from the current directory, or located somewhere
  304.     in your path statement.
  305.  
  306.     If a work drive is not specified Apply-Diz will create a work directory
  307.     off the root directory called APP-DIZ.  All logs and scratch files will
  308.     remain there until processing is completed or aborted.  If there is an
  309.     error during execution, all attempts are made to remove this directory
  310.     and clean all associated files.  The files created in the APP-DIZ
  311.     directory are:  TMP_ID.DIZ, FILE_ID.DIZ, APP-DIZ.LOG, and ARCINFO.LST.
  312.  
  313.     This software is fully functional.  However, there is a 20 second delay
  314.     after each execution.  Registration will remove this delay and also
  315.     allow the processing of all files within the specified directory known
  316.     as batch mode processing.
  317.  
  318.     These are the only limitations to this program.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.     
  326.     
  327.     
  328.     
  329.     
  330.     
  331.     
  332.     
  333.     
  334.     
  335.     
  336.     
  337.     
  338.     
  339.     
  340.     
  341.     
  342.     
  343.     
  344.     
  345.     
  346.     
  347.     
  348.     
  349.     
  350.     
  351.     
  352.     
  353.  
  354.     Apply-Diz v2.6                                                       Page 6
  355.