home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR14 / STLTH24.ZIP / STEALTH.DOC < prev    next >
Text File  |  1993-11-26  |  18KB  |  552 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.               ██▀▀▀▀
  9.               ██▄▄▄▄ ▀▀██▀▀ ██▀▀▀  ██▀▀█  ██  ▀▀██▀▀ ██  █
  10.                    █   ██   ██▀▀   ██▀▀█  ██    ██   ██▀▀█
  11.               ▄▄▄▄▄█   ██   ██▄▄▄  ██  █  ██▄▄  ██   ██  █
  12.              2.4  (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.         If you want to scan your archives for viruses, you can utilize
  242.         any of the three most popular virus scanners avaiable.  Just
  243.         include the "check for viruses" line, then choose one of the
  244.         scanners listed below (NOTE: You can only specify one)
  245.  
  246.         yes       =  CHECK FOR VIRUSES
  247.  
  248.         VIRUSCAN  =  VIRUS PROGRAM          /* McAfee's */
  249.         F-PROT    =  VIRUS PROGRAM
  250.         TBSCAN    =  VIRUS PROGRAM
  251.    ---------------------------------------------------------------------
  252.         Many PKZIP files have a -AV seal attached to them.  Most people
  253.         (including SYSOPS) may not want to break those sealed files,
  254.         since a "sealed file is a safe file".  If a PKZIP is -AVed, then
  255.         you can be pretty sure no one has tampered with it.
  256.  
  257.         no        =  break PKZIP AV files
  258.    ---------------------------------------------------------------------
  259.         STEALTH has an internal "archive viewer" that allows you to
  260.         see what's inside an archive before/as it is processed.  This
  261.         will allow a clear representation of the file.  Actually,
  262.         the viewer is FASTER than any other I have found.  Try it out!
  263.  
  264.         yes       =  list files before processing
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284. ============  ATTENTION SYSOPS!  ===========================================
  285.  
  286.         STEALTH can save you tons of hard disk space, and serve as a
  287.         processor for uploads.
  288.  
  289.         If some new member uploads you an ancient archive (PAK or ZOO),
  290.         or some unknown self-extracting .EXE archive, how do you
  291.         find out what it is?
  292.  
  293.         It could be a cool game that everybody likes, but the lamer has
  294.         given you a useless file.
  295.  
  296.         STEALTH will instantly recognize the .EXE file as DWC, ZOO, PAK,
  297.         ARJ, PKZIP 1.1, PKZIP 2.0, ARC, LHA, etc.
  298.         Then it will convert it to your BBS's archiver, with no problem.
  299.         Even embedded paths are saved!
  300.  
  301.      **** Included is UPLOAD.CFG configuration for upload processing ****
  302.  
  303.  
  304.         Is your BBS's hard disk getting full?  Run STEALTH as an event
  305.         once a week and convert all of your PKZIP 1.1 and 2.0 "normal"
  306.         compressed files to PKZIP 2.0 "EXTRA" compression!
  307.         That will save MEGABYTES of space (a friend of mine saved over
  308.         2 megabytes on one directory of uploads)
  309.  
  310.      **** Included is EVENT.CFG configuration for event processing ****
  311.  
  312.  
  313.         Plus you can comment all the processed files with your own
  314.         BBS comment file, or simply strip the old comments from
  315.         them.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324. =========  PLEASE READ THIS!  ===============================================
  325.  
  326.         Please think about what you put into STEALTH.CFG before starting
  327.         the program.
  328.  
  329.   1.    If your "Archiver" and "convert" file types are the same, then
  330.         all files will be processed twice:
  331.  
  332.                 PKZIP2   =   Archiver
  333.                 PKZIP2   =   convert
  334.                 PAK      =   convert
  335.                 ARJ      =   convert
  336.  
  337.         because STEALTH will convert all the .ARJ and .PAK files, then
  338.         convert them again because they are now PKZIP 2.0 files!
  339.  
  340.  
  341.  IMPORTANT NOTE: If you specify MAKE ZIPS -EX, then Stealth assumes
  342.                  you want to use PKZIP 2.0 as your default archiver.
  343.                    It will process files as such!
  344.  
  345.  
  346.   2.    If you have 20 archives with the same name:
  347.  
  348.                 ANOTHER.PAK
  349.                 ANOTHER.ARJ
  350.                 ANOTHER.ZIP
  351.                 ANOTHER.SDN
  352.                 ANOTHER.ZOO
  353.                 ANOTHER.ARC
  354.  
  355.         all of the contents of ALL THE ARCHIVES will be converted into
  356.         your new file.  So, if you said:  PKZIP2  =  Archiver
  357.         then ANOTHER.PAK's contents will be stuffed into ANOTHER.ZIP,
  358.         and ANOTHER.ARJ's contents will be also.  And you will lose
  359.         the original files.  So please don't name several archives
  360.         the same file name, then include all those types in your
  361.         STEALTH.CFG file!
  362.  
  363.   3.    Embedded directories are NOT processed if you use:
  364.  
  365.                   yes  =  recurse subdirs
  366.  
  367.         Why?  Because when you re-compress the file, then you will include
  368.         all subdirectories under the current one.  And if you are in
  369.         the root directory, your whole hard drive will be sucked up into
  370.         the new compressed file!
  371.  
  372.   4.    Please don't STRIP a file's comments, then ADD a comment.  If you
  373.         ADD a comment, then the old one is automatically deleted.
  374.  
  375.   5.    Please make sure ALL FILENAMES IN STEALTH.CFG are left justified!
  376.         For example, your comment file should look like:
  377.  
  378.         ║
  379.         ║C:\PCBOARD\COMMENT.FIL
  380.         ║
  381.                         instead of:
  382.  
  383.         ║
  384.         ║       C:\PCBOARD\COMMENT.FIL
  385.         ║
  386.  
  387.         Because to get the filename, an ASCII 'zero' is placed wherever
  388.         a 'space' character is.  And the filename won't register unless
  389.         it's left justified.
  390.  
  391.  
  392.  
  393.             NOTE: PKZIP 2.0 "stored" files are identical to PKZIP 1.1
  394.                   format.  Therefore, all 2.0 "stored" archives are
  395.                   flagged as version 1.1.
  396.  
  397.  
  398.  
  399.   7.    Due to the "human" nature of my C++ compiler, if you have
  400.         a THICK layer of subdirectories (more than 10), and each have
  401.         the exact same filenames, one or two files may be skipped.
  402.         This is because the Data Transfer Area of DOS thinks that it
  403.         already processed that file.  This should also be fixed in the
  404.         next version.
  405.  
  406.   8.    Also NOTE: Any unsuccessful de-compression of a file will
  407.         result in the original not being erased.  So if STEALTH does
  408.         not get an errorlevel of 0, then it aborts the erasure process.
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421. ===================  WHERE IS DWC?  =========================================
  422.  
  423.      ARJ, PKZIP, DWC, PAK and all the other archivers can be found at:
  424.  
  425.                  ╔═════════════════════════════════╗
  426.                  ║  Hogard Software Solutions BBS  ║
  427.                  ║      4533 Marblearch Drive      ║
  428.                  ║  Grand Prairie, Tx  75052-4629  ║
  429.                  ║         ASP Member BBS          ║
  430.                  ╟─────────────────────────────────╢
  431.                  ║ (214) 641-6292  up to 38,400bps ║
  432.                  ╟─────────────────────────────────╢
  433.                  ║       SysOp: Chuck Hogard       ║
  434.                  ╚═════════════════════════════════╝
  435.  
  436.         The SysOp is a great guy, and has all of these files available
  437.         for download.  And while you are there, check out the
  438.         Dave's Unique Utilities section.  It has all my stuff, and
  439.         is updated weekly.
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453. =============  REGISTRATION  ================================================
  454.  
  455.  
  456.    ┌────────────────────────────────────────────────────────────────┐
  457.    │                                                                │
  458.    │      There ain't no registration.  Stealth is FREE !!!         │
  459.    │                                                                │
  460.    └────────────────────────────────────────────────────────────────┘
  461.  
  462.         NOTE: Also, there is NO TECHNICAL SUPPORT for Stealth.
  463.               If you are having problems with this program, please
  464.               re-read the manual, and make sure nothing is wrong.
  465.               If you still have problems, you may want to try some
  466.               other program OTHER THAN Stealth.
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484. =============  TECHNICAL STUFF  =============================================
  485.  
  486.     Because of the complicated nature of Stealth, problems may arise.
  487.     Here is a list of common difficulties people have written me with:
  488.  
  489.  
  490.       1. Stealth does not process ARJ files properly.
  491.  
  492.     You need at least version 2.39 of ARJ in order to process the switches
  493.     I use.  Of course, the registered Stealth offers customized switches!
  494.  
  495.  
  496.       2. I use STEALTH D:\FILES\*.* and nothing happens.
  497.  
  498.     Of course not.  You must be in the directory with your archivers in
  499.     order to convert them.  If you want to do the above, try:
  500.         D:
  501.         CD\FILES
  502.         STEALTH *.*
  503.  
  504.  
  505.       3. I used Stealth on several PKZIP 2.0 files to make them -EXTRA
  506.          compressed, but nothing happened.
  507.  
  508.     In cases where it could be ANYTHING gone wrong, use the following
  509.     special switch:
  510.  
  511.                 STEALTH *.* /X/+ > LOGIT
  512.  
  513.     This will run Stealth, show technical debugging information that I
  514.     need, and pipe the output into a new file called "LOGIT".
  515.     Now just send the file "LOGIT" to me, along with your STEALTH.LOG,
  516.     and I can sort out what the problem is.
  517.  
  518.     Just upload the files for me at the Hogard Systems BBS, on CompuServe,
  519.     or simply mail them to me at my home address on a disk (any size).
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.