home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / compress / stlth23.zip / STEALTH.DOC < prev    next >
Text File  |  1993-09-01  |  22KB  |  622 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.               ██▀▀▀▀
  9.               ██▄▄▄▄ ▀▀██▀▀ ██▀▀▀  ██▀▀█  ██  ▀▀██▀▀ ██  █
  10.                    █   ██   ██▀▀   ██▀▀█  ██    ██   ██▀▀█
  11.               ▄▄▄▄▄█   ██   ██▄▄▄  ██  █  ██▄▄  ██   ██  █
  12.              2.3  (c) 1994 David Smith  All rights reserved
  13.  
  14.  
  15.  
  16.  
  17.               --==≡≡ THE Archive Converter for 1994 ≡≡==--
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. ==========  QUICK START !  ==================================================
  29.  
  30.  
  31.         Put STEALTH.EXE in a "test" directory containing some archives.
  32.  
  33.         Make sure STEALTH.EXE is in your "PATH=" statement.
  34.  
  35.         Type: STEALTH.EXE
  36.  
  37.         Now watch as all the archives are converted to your favorite
  38.         compressor!  This program finds them all: PAK ZIP HAP SQZ LZH
  39.         plus tons more, then converts them to your 'favorite' archiver.
  40.  
  41.         Now type: CD\
  42.  
  43.         Notice that STEALTH.LOG has been written there.  Use EDIT.COM
  44.         from DOS 5+ and look at it.  Just type: EDIT STEALTH.LOG
  45.  
  46.         All action from Stealth has been written, including dates, times
  47.         and DOS commands that it used.
  48.  
  49.               Type: STEALTH /?   for a quick help screen!
  50.  
  51.  
  52.  
  53. =============================================================================
  54.  
  55.  
  56.  
  57.         Advanced users:  Welcome to the world of Stealth.  This program
  58.         is quite unique, because it will convert ANY archive to ANY
  59.         other archive.  The advantages of this over other competition
  60.         programs (like ZZAP, SHEZ, etc...) is:
  61.  
  62.         ■   It supports every major archiver available!  ARJ, ARC, LHA,
  63.             HAP, SQZ, DWC, PAK, ZIP 1.1 and 2.0, ICE, LHARC, LARC,
  64.             HYPER, SDN, FCOMPACT, and ZOO.
  65.  
  66.         ■   It can recognize PKZIP 1.1 files and PKZIP 2.0 "normal"
  67.             compressed files, then convert them to PKZIP -EX "extra"
  68.             compression.  This will save you a ton of hard disk
  69.             space!
  70.             NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1
  71.                   format.  Therefore, all 2.0 "stored" archives are
  72.                   flagged as version 1.1.
  73.  
  74.         ■   Leave PKZIP -AV files alone, plus virus scanning using any
  75.             of the three most popular scanners!
  76.  
  77.         ■   Recognizes embedded directories, and can include them with
  78.             the conversion.
  79.  
  80.         ■   Is perfect for SYSOPS, since it can be run as an "event" to
  81.             update all .ZIP files, or be used as an upload processor.
  82.             Even add comments or strip them from the files...
  83.  
  84.         ■   You can "customize" STEALTH to almost any configuration.
  85.             Include some archives, but not others, recurse subdirectories,
  86.             leave SFX files alone, delete files after processing,
  87.             plus MORE.
  88.  
  89.         ■   Keeps an accurate log of all activity.
  90.  
  91.         ■   Lists archived files (registered version) using its own
  92.             'internal' compression viewer (super-fast!).
  93.  
  94.  
  95.  
  96.         No other utility can do this!  Plus STEALTH recognizes even
  97.         DWC, SQZ, and LARC self-extracting files.  Please notice
  98.         that NO OTHER ARCHIVE program can do that.
  99.  
  100.         Is hard disk space important?  That PKZIP file you downloaded
  101.         yesterday... it is probably in 1.1 format.  In fact, most of
  102.         your PKZIP'ed files are 1.1 or else 2.0 "normal" compressed.
  103.  
  104.         Use STEALTH to maximize their compression.  You can save 60,000
  105.         bytes of disk space on a few files, and several megabytes if
  106.         you re-archive every downloaded file.  Doing that manually will
  107.         take FOREVER.  And even batch files are no good, since they are
  108.         so slow.  But, you can be assured of accuracy and speed with STEALTH!
  109.  
  110.  
  111.  
  112.                  STEALTH is extrememly simple:
  113.  
  114.         1. Edit STEALTH.CFG to your satisfaction (see below for details)
  115.            (or just use STL_CFG.EXE to create your OWN stealth.cfg)
  116.  
  117.         2. Include STEALTH.EXE and STEALTH.CFG in your path
  118.  
  119.         3. Go to a directory containing some old archives.
  120.  
  121.         4. Type: STEALTH.EXE    (or  STEALTH *.*)
  122.  
  123.  
  124.         Now note that Stealth processes the entire directory!  The
  125.         only filespec you need (optional) is *.*.  Stealth ruthlessly
  126.         converts everything it can find using your .CFG file.
  127.  
  128.         NOTE: You can use STEALTH *.*  or  STEALTH *.ZIP  .....
  129.  
  130.         And wala, you are all done.
  131.  
  132.         If you change your mind on archives, or want to change something,
  133.         STEALTH.CFG is easy to edit.
  134.  
  135.         Take your favorite editor and change it around.
  136.         NOTE:  If Stealth cannot locate STEALTH.CFG file, it will use
  137.                its own defaults.
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.     IMPORTANT NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1
  147.                     format.  Therefore, all 2.0 "stored" archives are
  148.                     flagged as version 1.1.
  149.  
  150.  
  151.  
  152.  
  153.  
  154. ========= USING STEALTH.CFG FILE ============================================
  155.  
  156.         Included here is STEALTH.CFG, a configuration file for this program.
  157.  
  158.         Use the enclosed STL_CFG.EXE program for a quick and easy way
  159.         to create Stealth.cfg.  Just fill in the blanks, and change
  160.         the values to what you like best.
  161.  
  162.         Press [F10] to save Stealth.cfg and exit.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.         Now you can change it by using a text editor, and type out
  169.         which options you want to use.  The format is:
  170.  
  171.    ---------------------------------------------------------------------
  172.         Put the archiver you want everything converted to.
  173.  
  174.         [archiver]  =  archiver
  175.  
  176.         Whereas archiver could be:
  177.             PKZIP1     ARJ    LHA    DWC
  178.             PKZIP2     PAK    ZOO    ARC6
  179.             SQUEEZE    ICE    HAP    LARC
  180.             HYPER      FCOMPACT      LHARC
  181.    ---------------------------------------------------------------------
  182.         Next, put all the archives you want converted to YOUR archiver.
  183.         For instance, if you put LHA here, all .LZH files will be
  184.         converted.
  185.  
  186.         [archiver]  =  convert
  187.  
  188.         Whereas archiver could be:
  189.             PKZIP1     ARJ    LHA    DWC
  190.             PKZIP2     PAK    ZOO    ARC6
  191.             SQUEEZE    ICE    HAP    LARC
  192.             HYPER                    LHARC
  193.    ---------------------------------------------------------------------
  194.         Now, do you want to strip all comment files in the archivers
  195.         found?
  196.  
  197.         NO       =  strip comment
  198.    ---------------------------------------------------------------------
  199.         And do you want to add your own comment file to the archives
  200.         that are converted?
  201.  
  202.         NO       =  add comment
  203.    ---------------------------------------------------------------------
  204.         Then, what comment file do you want added?  (leave this line
  205.         out if you want to comment added)
  206.         NOTE: Make sure that the filename is left justified!  No spaces
  207.               should be on the left of the filename!
  208.  
  209.         B:\COMMENT.DAV  =  comment file
  210.    ---------------------------------------------------------------------
  211.         When .EXE self-extracting archives are found, do you want
  212.         them extracted?
  213.  
  214.         NO       =  executables
  215.    ---------------------------------------------------------------------
  216.         If PKZIP 2.0 files are found that have been compressed using
  217.         "normal" compression, do you want them to be re-compressed
  218.         using "EXTRA" compression?
  219.         NOTE: This will immediately change your ARCHIVER to PKZIP 2.0
  220.  
  221.         NO       =  make ZIPs -EX
  222.    ---------------------------------------------------------------------
  223.         Do you want to recurse the subdirectories?  If YES, then all
  224.         directories beneath the current one will be processed also!
  225.  
  226.         NO       =  recurse subdirs
  227.    ---------------------------------------------------------------------
  228.         As a default, STEALTH logs all activity into \STEALTH.LOG.
  229.         This makes it easy to see what happened, and keep track of
  230.         what went where.
  231.  
  232.         yes            =  create log file
  233.         \STEALTH.LOG   =  log file location
  234.    ---------------------------------------------------------------------
  235.         Also as default, STEALTH deletes the old archives, so that
  236.         your hard disk is not cluttered with old and new versions.
  237.         That would make it extremely difficult to sort through them!
  238.  
  239.         yes       =  delete files
  240.    ---------------------------------------------------------------------
  241.  
  242.  
  243.   ┌────────────────────────────────────────────────────────────────────┐
  244.   │  =-=-=-=-=-=-=    THE REGISTERED VERSION ONLY    =-=-=-=-=-=-=-=   │
  245.   └────────────────────────────────────────────────────────────────────┘
  246.  
  247.         If you want to scan your archives for viruses, you can utilize
  248.         any of the three most popular virus scanners avaiable.  Just
  249.         include the "check for viruses" line, then choose one of the
  250.         scanners listed below (NOTE: You can only specify one)
  251.  
  252.         yes       =  CHECK FOR VIRUSES
  253.  
  254.         VIRUSCAN  =  VIRUS PROGRAM          /* McAfee's */
  255.         F-PROT    =  VIRUS PROGRAM
  256.         TBSCAN    =  VIRUS PROGRAM
  257.    ---------------------------------------------------------------------
  258.         Many PKZIP files have a -AV seal attached to them.  Most people
  259.         (including SYSOPS) may not want to break those sealed files,
  260.         since a "sealed file is a safe file".  If a PKZIP is -AVed, then
  261.         you can be pretty sure no one has tampered with it.
  262.  
  263.         no        =  break PKZIP AV files
  264.    ---------------------------------------------------------------------
  265.         STEALTH has an internal "archive viewer" that allows you to
  266.         see what's inside an archive before/as it is processed.  This
  267.         will allow a clear representation of the file.  Actually,
  268.         the viewer is FASTER than any other I have found.  Try it out!
  269.  
  270.         yes       =  list files before processing
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290. ============  ATTENTION SYSOPS!  ===========================================
  291.  
  292.         STEALTH can save you tons of hard disk space, and serve as a
  293.         processor for uploads.
  294.  
  295.         If some new member uploads you an ancient archive (PAK or ZOO),
  296.         or some unknown self-extracting .EXE archive, how do you
  297.         find out what it is?
  298.  
  299.         It could be a cool game that everybody likes, but the lamer has
  300.         given you a useless file.
  301.  
  302.         STEALTH will instantly recognize the .EXE file as DWC, ZOO, PAK,
  303.         ARJ, PKZIP 1.1, PKZIP 2.0, ARC, LHA, etc.
  304.         Then it will convert it to your BBS's archiver, with no problem.
  305.         Even embedded paths are saved!
  306.  
  307.      **** Included is UPLOAD.CFG configuration for upload processing ****
  308.  
  309.  
  310.         Is your BBS's hard disk getting full?  Run STEALTH as an event
  311.         once a week and convert all of your PKZIP 1.1 and 2.0 "normal"
  312.         compressed files to PKZIP 2.0 "EXTRA" compression!
  313.         That will save MEGABYTES of space (a friend of mine saved over
  314.         2 megabytes on one directory of uploads)
  315.  
  316.      **** Included is EVENT.CFG configuration for event processing ****
  317.  
  318.  
  319.         Plus you can comment all the processed files with your own
  320.         BBS comment file, or simply strip the old comments from
  321.         them.
  322.  
  323.         And registration is only $15.00!  That includes LIFETIME
  324.         upgrades, BBS and mail support (unlimited), plus more...
  325.  
  326.         To register, send $15.00 to:
  327.  
  328.                         David Smith
  329.                        1104 Mason Dr
  330.                        Hurst TX 76053
  331.  
  332.         and please fill out the enclosed form for your own "customized"
  333.         PKZIP, ARJ switches.  I know many people have favorites, or want
  334.         to include their "-AV" validation in files.
  335.                 With registration, YOU CAN!
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353. =========  PLEASE READ THIS!  ===============================================
  354.  
  355.         Please think about what you put into STEALTH.CFG before starting
  356.         the program.
  357.  
  358.   1.    If your "Archiver" and "convert" file types are the same, then
  359.         all files will be processed twice:
  360.  
  361.                 PKZIP2   =   Archiver
  362.                 PKZIP2   =   convert
  363.                 PAK      =   convert
  364.                 ARJ      =   convert
  365.  
  366.         because STEALTH will convert all the .ARJ and .PAK files, then
  367.         convert them again because they are now PKZIP 2.0 files!
  368.  
  369.  
  370.  IMPORTANT NOTE: If you specify MAKE ZIPS -EX, then Stealth assumes
  371.                  you want to use PKZIP 2.0 as your default archiver.
  372.                    It will process files as such!
  373.  
  374.  
  375.   2.    If you have 20 archives with the same name:
  376.  
  377.                 ANOTHER.PAK
  378.                 ANOTHER.ARJ
  379.                 ANOTHER.ZIP
  380.                 ANOTHER.SDN
  381.                 ANOTHER.ZOO
  382.                 ANOTHER.ARC
  383.  
  384.         all of the contents of ALL THE ARCHIVES will be converted into
  385.         your new file.  So, if you said:  PKZIP2  =  Archiver
  386.         then ANOTHER.PAK's contents will be stuffed into ANOTHER.ZIP,
  387.         and ANOTHER.ARJ's contents will be also.  And you will lose
  388.         the original files.  So please don't name several archives
  389.         the same file name, then include all those types in your
  390.         STEALTH.CFG file!
  391.  
  392.   3.    Embedded directories are NOT processed if you use:
  393.  
  394.                   yes  =  recurse subdirs
  395.  
  396.         Why?  Because when you re-compress the file, then you will include
  397.         all subdirectories under the current one.  And if you are in
  398.         the root directory, your whole hard drive will be sucked up into
  399.         the new compressed file!
  400.  
  401.   4.    Please don't STRIP a file's comments, then ADD a comment.  If you
  402.         ADD a comment, then the old one is automatically deleted.
  403.  
  404.   5.    Please make sure ALL FILENAMES IN STEALTH.CFG are left justified!
  405.         For example, your comment file should look like:
  406.  
  407.         ║
  408.         ║C:\PCBOARD\COMMENT.FIL
  409.         ║
  410.                         instead of:
  411.  
  412.         ║
  413.         ║       C:\PCBOARD\COMMENT.FIL
  414.         ║
  415.  
  416.         Because to get the filename, an ASCII 'zero' is placed wherever
  417.         a 'space' character is.  And the filename won't register unless
  418.         it's left justified.
  419.  
  420.  
  421.  
  422.             NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1
  423.                   format.  Therefore, all 2.0 "stored" archives are
  424.                   flagged as version 1.1.
  425.  
  426.  
  427.  
  428.   7.    Due to the "human" nature of my C++ compiler, if you have
  429.         a THICK layer of subdirectories (more than 10), and each have
  430.         the exact same filenames, one or two files may be skipped.
  431.         This is because the Data Transfer Area of DOS thinks that it
  432.         already processed that file.  This should also be fixed in the
  433.         next version.
  434.  
  435.   8.    Also NOTE: Any unsuccessful de-compression of a file will
  436.         result in the original not being erased.  So if STEALTH does
  437.         not get an errorlevel of 0, then it aborts the erasure process.
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. ===================  WHERE IS DWC?  =========================================
  451.  
  452.      ARJ, PKZIP, DWC, PAK and all the other archivers can be found at:
  453.  
  454.                  ╔═════════════════════════════════╗
  455.                  ║  Hogard Software Solutions BBS  ║
  456.                  ║      4533 Marblearch Drive      ║
  457.                  ║  Grand Prairie, Tx  75052-4629  ║
  458.                  ║         ASP Member BBS          ║
  459.                  ╟─────────────────────────────────╢
  460.                  ║ (214) 641-6292  up to 38,400bps ║
  461.                  ╟─────────────────────────────────╢
  462.                  ║       SysOp: Chuck Hogard       ║
  463.                  ╚═════════════════════════════════╝
  464.  
  465.         The SysOp is a great guy, and has all of these files available
  466.         for download.  And while you are there, check out the
  467.         Dave's Unique Utilities section.  It has all my stuff, and
  468.         is updated weekly.
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482. =============  REGISTRATION  ================================================
  483.  
  484.         Register now for only $15.00.  With registration, you get:
  485.  
  486.                 1. Unlimited free upgrades
  487.                 2. Unlimited tech support via BBS and mail
  488.                 3. The nagging "REGISTER NOW" reminder goes away
  489.                 4. Customize your own PKZIP options, plus all
  490.                    other archiver's switches!
  491.                 5. Includes -AV support for PKZIP
  492.                 6. Super-advanced features coming up
  493.  
  494.  
  495.    ┌────────────────────────────────────────────────────────────────┐
  496.    │                                                                │
  497.    │      SEE THE ENCLOSED REGISTER.DOC FILE FOR INFORMATION        │
  498.    │                                                                │
  499.    └────────────────────────────────────────────────────────────────┘
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513. =============  TECHNICAL STUFF  =============================================
  514.  
  515.     Because of the complicated nature of Stealth, problems may arise.
  516.     Here is a list of common difficulties people have written me with:
  517.  
  518.  
  519.       1. Stealth does not process ARJ files properly.
  520.  
  521.     You need at least version 2.39 of ARJ in order to process the switches
  522.     I use.  Of course, the registered Stealth offers customized switches!
  523.  
  524.  
  525.       2. I use STEALTH D:\FILES\*.* and nothing happens.
  526.  
  527.     Of course not.  You must be in the directory with your archivers in
  528.     order to convert them.  If you want to do the above, try:
  529.         D:
  530.         CD\FILES
  531.         STEALTH *.*
  532.  
  533.  
  534.       3. I used Stealth on several PKZIP 2.0 files to make them -EXTRA
  535.          compressed, but nothing happened.
  536.  
  537.     In cases where it could be ANYTHING gone wrong, use the following
  538.     special switch:
  539.  
  540.                 STEALTH *.* /X/+ > LOGIT
  541.  
  542.     This will run Stealth, show technical debugging information that I
  543.     need, and pipe the output into a new file called "LOGIT".
  544.     Now just send the file "LOGIT" to me, along with your STEALTH.LOG,
  545.     and I can sort out what the problem is.
  546.  
  547.     Just upload the files for me at the Hogard Systems BBS, on CompuServe,
  548.     or simply mail them to me at my home address on a disk (any size).
  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.  
  580.  
  581.  
  582.    ███████╗ ██╗   ██╗ ██████╗  ██████╗   ██████╗  ██████╗  ████████╗ ██████╗
  583.    ██╔════╝ ██║   ██║ ██╔══██╗ ██╔══██╗ ██╔═══██╗ ██╔══██╗ ╚══██╔══╝ ╚════██╗
  584. ╓──███████╗ ██║   ██║ ██████╔╝ ██████╔╝ ██║   ██║ ██████╔╝    ██║      ▄███╔╨─╖
  585. ║  ╚════██║ ██║   ██║ ██╔═══╝  ██╔═══╝  ██║   ██║ ██╔══██╗    ██║      ▀▀══╝  ║
  586. ║  ███████║ ╚██████╔╝ ██║      ██║      ╚██████╔╝ ██║  ██║    ██║      ██╗    ║
  587. ║  ╚══════╝  ╚═════╝  ╚═╝      ╚═╝       ╚═════╝  ╚═╝  ╚═╝    ╚═╝      ╚═╝    ║
  588. ║                                                                             ║
  589. ║                                                                             ║
  590. ║      Support for this program is available in the following ways:           ║
  591. ║                                                                             ║
  592. ║                                                                             ║
  593. ║          ╓──┐ ╓──┐ ╓─╥─┐ ╥──┐ ╥  ┬  ╓─┐ ╥──┐ ╥──┐ ╥  ┬ ╥──┐                 ║
  594. ║          ║    ║  │ ║ ║ │ ╟──┘ ║  │  ╙─┐ ╟─   ╟─┬┘ ╙╖┌┘ ╟─                   ║
  595. ║          ╙──┘ ╙──┘ ╨ ╨ ┴ ╨    ╙──┘ ╙──┘ ╨──┘ ╨ ┴   ╙┘  ╨──┘                 ║
  596. ║          User ID:  71441,2723                                               ║
  597. ║          I usually log on every other day and check my mail.                ║
  598. ║                                                                             ║
  599. ║                                                                             ║
  600. ║                       ▄▄▄▄▄▄  ▄▄▄▄▄▄  ▄▄▄▄▄▄▄                               ║
  601. ║                       █ ▄▄ █▄ █ ▄▄ █▄ █ ▄▄▄▄█                               ║
  602. ║                       █ ▄▄▄ █ █ ▄▄▄ █ █▄▄▄▄ █                               ║
  603. ║                       █▄▄▄▄▄█ █▄▄▄▄▄█ █▄▄▄▄▄█                               ║
  604. ║          Drop me a line on the Hogard Systems Bulletin Board                ║
  605. ║                     David Smith   (214) 641-6292                            ║
  606. ║                                                                             ║
  607. ║                                                                             ║
  608. ║                 ▄██▄   ▄██▄  ▄███████▄   ▄█▄  ▄██▄                          ║
  609. ║                 █████▄█████ ████▀▀▀████ █████ ████                          ║
  610. ║                 ███████████ ████▄▄▄████ █████ ████                          ║
  611. ║                 ████   ████ ███████████ █████ ████                          ║
  612. ║                 ████   ████ ████   ████ █████ ████▄▄▄▄▄▄▄                   ║
  613. ║                 ▀██▀   ▀██▀ ▀██▀   ▀██▀  ▀█▀   ▀████████▀                   ║
  614. ║                               Write to:                                     ║
  615. ║                                                                             ║
  616. ║                              David Smith                                    ║
  617. ║                            1104 Mason Dr.                                   ║
  618. ║                            Hurst TX 76053                                   ║
  619. ║                                                                             ║
  620. ╙─────────────────────────────────────────────────────────────────────────────╜
  621.  
  622.