home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / ZIP / WWPACK / WWP304 / WWPACK.DOC < prev    next >
Encoding:
Text File  |  1996-01-05  |  21.4 KB  |  549 lines

  1.       ┌────────────────────────────────────────────────────────────┐
  2.       │  WWPACK is shareware.  If you register you can get a free  │
  3.       │               upgrade from a BBS or FTP site!              │
  4.       │ See the bottom of this file for more info on registration. │
  5.       └────────────────────────────────────────────────────────────┘
  6.  
  7.  
  8.  
  9.         WWPACK 3.04   a powerful executable file compressor for DOS
  10.  
  11.         Copyright (c) 1993-96 by Piotr Warezak and Rafal Wierzbicki
  12.  
  13.         6 January 1996   Lodz, Poland           All Rights Reserved
  14.  
  15.  
  16.  
  17.       We are happy to provide our e-mail addresses.  Please feel free
  18.          to inform us of any problems at the following addresses.
  19.  
  20.                            Authors:  awarezak@krysia.uni.lodz.pl
  21.  
  22.               American distributor:  gjereza@crl.com
  23.  
  24.                 German distributor:  support@vgasoft.com
  25.  
  26.  
  27.  
  28.        The latest shareware version of WWPACK can always be found on:
  29.  
  30.            o  Slovak Antivirus Center:
  31.               ftp.elf.stuba.sk    /pub/pc/pack
  32.  
  33.            o  SimTel mirrors, directory  /SimTel/msdos/execomp
  34.               (eg.  oak.oakland.edu  or  ftp.cyf-kr.edu.pl)
  35.  
  36.            o  The ClipBoard BBS
  37.               (415) 293 0454
  38.               8N1  2400-28800bps
  39.               24 hours, San Francisco
  40.  
  41.            o  WWPACK is FREQable (file requestable) from
  42.               The ClipBoard BBS,
  43.               FidoNet 1:125/454
  44.               The magic name is WWPACK.
  45.  
  46.            o  VGA-Copy Headquarters BBS
  47.               +49-441-972955
  48.               8N1  USRobotics V34
  49.               24 hours, Germany
  50.  
  51.            o  WWPACK is file requestable from
  52.               VGA-Copy Headquarters,
  53.               FidoNet 2:2426/2240
  54.               The magic name is WWPACK.
  55.  
  56.            o  ftp-mailserver:  fileserv@vgasoft.com
  57.  
  58.  
  59.  
  60. *** This program is  shareware.  It may be freely  used for three weeks. But
  61. *** during this trial period no files packed with WWPACK may be distributed.
  62. *** If you are going to continue  using this product or distribute any files
  63. *** compressed with WWPACK you must register and pay for a full version.
  64.  
  65. *** The shareware  version WWPACK  can only be  distributed or copied if all
  66. *** files are  complete and intact, no changes  have been made, and a charge
  67. *** of no more than $5.00 is made for distributing the program!
  68. *** WWPACK  can be freely  uploaded to any  BBS, online system or  something
  69. *** similar, and can be freely included on any CD-ROM.
  70.  
  71. *** Warning: WWPACK is provided "as-is" without warranty of any kind!
  72.  
  73. *** The original  version WWPACK is distributed in  the ZIP file  containing
  74. *** WWP304.EXE RAR 1.55 SFX archive with Authenticy Verification information
  75. *** "by Piotr Warezak and Rafal Wierzbicki".
  76.  
  77.  
  78.  
  79. WHAT IS A WWPACK?
  80.  
  81.   WWPACK is a powerful EXE file compressor. This program compresses most
  82.   DOS executable files. Compressed programs use less disk space because
  83.   they are much smaller. All files run EXACTLY as before.
  84.  
  85.  
  86. REQUIREMENTS TO RUN WWPACK.
  87.  
  88.   WWPACK works on any machine with about 450Kb free DOS memory. Remember that
  89.   the faster machine you use the less time you need to compress an EXE file.
  90.  
  91. Requirements to run EXE files compressed with WWPACK.
  92.  
  93.   A file compressed with WWPACK will run on IBM or compatible based systems
  94.   like the XT, AT, 80286, 80386, 80486, Pentiums, laptops, and palmtops
  95.   (eg. the Hewlett Packard HP95LX).  DOS 2.0 or higher is required.
  96.  
  97.  
  98. WWPACK'S COMMANDS  -  to get a very short help type:  WWPACK /?
  99.  
  100.   To pack an EXE file enter:
  101.       WWPACK FILENAME.EXE
  102.   or  WWPACK P FILENAME.EXE
  103.   When complete, the file will be smaller and work as before.
  104.   The packing process can be interrupted by using the CTRL+Break keys.
  105.  
  106.   To pack a relocation table enter:  WWPACK PR FILENAME.EXE
  107.  
  108.   TESTING EXE FILES.
  109.  
  110.     Command 'T' lets you see if the file is already compressed by any
  111.     executable file compressor. WWPACK recognizes files compressed by LZEXE,
  112.     PKLITE and many many other compressors.
  113.     Usage:  WWPACK T FILENAME.EXE
  114.     Additional command  WWPACK T  checks automatically all EXE files stored
  115.     in the current directory.
  116.  
  117.   OPTIMIZING HEADERS.
  118.  
  119.     If you want to optimize a header of an EXE file use:
  120.         WWPACK O FILENAME.EXE
  121.     Sometimes the header can be a bit shorter but in most cases nothing will
  122.     change.
  123.  
  124.   ADDITIONAL COMMANDS: 'PD' and 'UD'.
  125.  
  126.     WWPACK has two commands that you can use on any file you want:
  127.     'PD' and 'UD'  (pack data and unpack data).
  128.  
  129.     Command 'PD' will pack a data file.
  130.     Example:  WWPACK PD PROGRAM.DAT
  131.  
  132.     Command 'UD' will unpack any file packed with 'PD'.
  133.     Example:  WWPACK UD PROGRAM.DAT
  134.  
  135.     Note: Normally, a packed data file is unusable. Therefore, you must first
  136.     unpack it (ie  'PD' and 'UD' options are similar to PKZIP's 'a' and 'e'
  137.     commands).
  138.     Please see the WWPACK Pascal Support procedures for info how to use
  139.     WWPACKed data files in your programs. With our TPU files, you can read
  140.     WWPACKed files and decompress them directly to memory!
  141.  
  142.  
  143. CAN I USE WILDCARDS?
  144.  
  145.   Sure! WWPACK lets you to use '*' and '?' in every command.
  146.  
  147.   Examples:
  148.     to compress all EXE files in the current directory just type:
  149.        WWPACK P *.EXE
  150.  
  151.     to optimize headers of all EXE files type:
  152.        WWPACK O *.EXE
  153.  
  154.     to pack all files (as data) enter this command:
  155.        WWPACK PD *.*
  156.  
  157. CAN I USE PATHS?
  158.  
  159.   Of course you can!
  160.  
  161.   Example:
  162.     command  WWPACK P C:\UTILITY\TEST.EXE  will compress TEST.EXE file stored
  163.     in C:\UTILITY directory.
  164.  
  165.  
  166. CONFIGURATION MENU.
  167.  
  168.   We wanted to make WWPACK easy to use. You don't have to remember any
  169.   options because you can set everything in a special configuration menu.
  170.  
  171.   To configure the program enter:  WWPACK C.  Now use number keys to set some
  172.   useful options.
  173.   1  -  do you want WWPACK to make backup files?
  174.         Select 'ON' and you will always get OLD and OLP files.
  175.   2  -  select 'ON' if you want to get more information about every file
  176.         that is being compressed.
  177.   3  -  please select 'ON' if you want to compress files with overlays or
  178.         'OFF' if you don't want to compress such a files. If you choose 'ASK'
  179.         WWPACK will always ask you if the file should be compressed or not.
  180.   4  -  select 'ON' if you want WWPACK to compress already compressed files.
  181.   5  -  sometimes WWPACK is slow, so selecting 'ON' is a good idea.
  182.  
  183.   When you set all options, press 'S' key to save them or 'ESC' to exit
  184.   without saving. You may use the 'T' key to set the default configuration.
  185.  
  186.  
  187. PARAMETERS AND SWITCHES.
  188.  
  189.   Here is list of parameters that you may use while working with WWPACK:
  190.  
  191.   -adv  use advanced mode
  192.   -b-   tells WWPACK not to make backup files
  193.   -b+   always make backups (OLD and OLP files)
  194.   -o-   don't pack files with overlays
  195.   -o+   always pack files with overlays
  196.   -p-   don't pack already packed files
  197.   -p+   pack already packed files
  198.   -y    assume 'YES' on all queries (WWPACK will proces automatcally all
  199.         files)
  200.  
  201.   Example:
  202.      WWPACK P -B- -O+ -Y MYPROG.EXE
  203.   means: pack MYPROG.EXE file; don't make backup; pack even if the file
  204.   contains an overlay. Process automatically the file (no questions while
  205.   packing).
  206.  
  207.  
  208. PACKING FILES FROM THE LIST FILE.
  209.  
  210.   A special option:  -@FileName  lets you to process only selected files.
  211.   To pack only a few files from the current directory, you can create
  212.   a special file, for example:  WWPACK.LST  (name of this file is not
  213.   important). This file should contain the names of all files you want to
  214.   process. Every name should begin from a new line. There musn't be any
  215.   free lines in the list file!
  216.  
  217.   Here is an example of a list file:
  218.     --- cut here ---
  219.     MYFILE.EXE
  220.     ANYFILE.EXE
  221.     anotHer.EXE
  222.     --- cut here ---
  223.   This small file tells WWPACK to process only three files. All other files
  224.   from the current directory will be skipped.
  225.   To use this list file type:
  226.      WWPACK P -@WWPACK.LST
  227.  
  228.   Note, that wildcards and paths aren't allowed in the list file!
  229.  
  230.  
  231. BACKUP FILES.
  232.  
  233.   Not every EXE file can be compressed with WWPACK. That's why this program
  234.   creates backups. In case of problems you can restore the original file.
  235.  
  236.   Remember:
  237.     Original FILENAME.EXE file is always renamed to FILENAME.OLD file
  238.     while compressing or optimizing, and to FILENAME.OLP when decompressing.
  239.  
  240.   HINT:
  241.     If you forgot to make a backup while compressing an EXE file, try
  242.     undeleting or unerasing it!
  243.  
  244.  
  245. FILES THAT CAN'T BE PACKED.
  246.  
  247.   Some files can't be compressed with WWPACK.
  248.  
  249.   o  programs that check the CRC of a file
  250.   o  files that store configuration data internally
  251.   o  drivers that can be loaded in a config.sys file
  252.   o  some files with overlays
  253.   o  Windows and OS/2 files ('NE' and 'LE' programs)
  254.   o  some COM files (COM file may not work after conversion to EXE format)
  255.   o  files that contain more than 15000 relocation entries
  256.  
  257.   Some files are automatically recognized by WWPACK. But sometimes it's
  258.   impossible to predict if the file can be compressed. You just have to
  259.   check every compressed EXE file!
  260.  
  261.  
  262. CRC MODULE: "Be sure that the file isn't damaged"
  263.  
  264.   WWPACK uses special module that adds CRC code to EVERY compressed EXE file.
  265.   This unique technology lets you to check if any WWPACKed EXE file has been
  266.   damaged or infected by a virus.
  267.  
  268.   To check files you may use WWVIR or CRC program.
  269.  
  270.   HINTS FOR PROGRAMMERS:
  271.   o You may freely add CRC program to your commercial and noncommercial
  272.     products. It's public domain!  (However, you must have the enhanced
  273.     version of WWPACK to distribute WWPACKed programs)
  274.   o CRC module checks almost EVERY byte of compressed EXE file: from the
  275.     beginning ('MZ' signature) to the very end.
  276.     Warning: CRC module doesn't check overlays!
  277.  
  278.  
  279. ERRORS AND OTHER MESSAGES.
  280.  
  281.   WWPACK is quite an intelligent program and sometimes it may show some kind
  282.   of an error message. But don't worry. Just read the comment and you will
  283.   find an explanation for the problem (WWPACK has almost 30 error messages!).
  284.  
  285.   From time to time you may see some question also (it depends on a
  286.   configuration that you have chosen).
  287.  
  288.   Here is a list of important questions and messages that you may meet when
  289.   working with WWPACK:
  290.  
  291.    Delete FILENAME file to make a new backup file [Y/n]?
  292.      WWPACK must know if the old backup file can be deleted. Press 'Y' key
  293.      to continue processing or 'N' to quit (and save an old backup).
  294.  
  295.    File not processed.
  296.      You didn't let WWPACK process the file (for example you didn't let
  297.      WWPACK delete an old backup file).
  298.  
  299.    Relocation table is already packed.
  300.      You can't use 'PR' command because the relocation table is already
  301.      packed. Please try the 'P' command to get a higher compression ratio.
  302.  
  303.    The file FILENAME has set attribute READ ONLY. Change file attribute [Y/n]?
  304.      The file has set the READ ONLY attribute. To process it the attribute
  305.      must be deleted. Press 'Y' key to continue packing or 'N' to stop WWPACK.
  306.  
  307.    The file contains Debug_Info. Do you want to remove it [Y/n]?
  308.      The file contains some data that aren't required by a program. These
  309.      data can be removed - the file will be much shorter. Press 'Y' if you
  310.      want WWPACK to remove Debug_Info or 'N' to process the file without
  311.      removing it.
  312.  
  313.    The file size stored in the header is bigger then the real file size.
  314.    The processed file may not work. Continue [Y/n]?
  315.      The file is probably damaged but you may want WWPACK to pack it.
  316.      This message is rarely seen.
  317.  
  318.    Warning: the file contains an overlay XXX bytes. Continue [Y/n/r]?
  319.      The file that you want to process contains an overlay. Press 'Y' to pack
  320.      or optimize the file or 'N' if you don't want to process it. Press 'R'
  321.      to remove an overlay and then process the file (not recommended really).
  322.  
  323.    Warning: the file is already packed with ....
  324.    Do you want to pack it [Y/n]?
  325.      The file is already packed but WWPACK may try to pack it.
  326.      Press 'Y' if you want WWPACK to process the file or 'N' to quit.
  327.  
  328.    Warning: there are some identical relocation entries.
  329.      This message shows that the file may not work after compression because
  330.      the relocation table contains incorrect data.
  331.  
  332.    Warning: this is COM file. Convert it to EXE format [Y/n]?
  333.      The file you want to process is not an EXE. Press 'Y' if you want to
  334.      convert it to EXE format or 'N' to quit.
  335.  
  336.  
  337.   Note that you must select between Yes or No. Pressing the Enter key alone
  338.   will always select the default answer.
  339.  
  340.  
  341. HOW DOES WWPACK WORK?
  342.  
  343.   First it compresses EXE file; then it adds a small extract code. When you
  344.   load the packed file into memory, the computer first runs this extract 
  345.   code and then the unpacked program.
  346.  
  347.   It's simple, isn't it?
  348.  
  349.  
  350. HOW DOES WWPACK COMPARE TO THE OTHER COMPRESSORS?
  351.  
  352.   Read this short table and compare:
  353.   (Note: All sizes are in bytes)
  354.  
  355.                      qp.exe       ncmain.exe    ndd.exe       total size
  356.       Unpacked       86,842       212,393       383,874       683,109
  357.  
  358.       TINYPROG       53,520       117,632       225,440       396,592
  359.       LZEXE          52,983       116,980       224,646       394,609
  360.       PKLITE         52,289       115,354       222,995       390,638
  361.       DIET           52,694       116,044       220,799       389,527
  362.       AVPACK         51,943       113,252       217,622       382,817
  363.       AINEXE         51,534       111,350       210,955       373,839
  364.       COMPACK        51,052       111,180       210,956       373,188
  365.       JAM            51,204       109,556       208,292       369,052
  366.       UCEXE          51,053       109,157       205,557       365,767
  367.       WWPACK         49,787       106,209       200,293       356,289
  368.  
  369.       To make this comparison we used these popular shareware programs:
  370.       AINEXE 2.1 by Transas Marine Ltd.
  371.       AVPACK 1.22 by Andrei Volkov
  372.       COMPACK 4.5 by W.J. Collis
  373.       DIET 1.45 by Teddy Matsumoto
  374.       JAM 2.11 bu Eugen Vasilchenko
  375.       LZEXE 0.91 by Fabrice Bellard
  376.       PKLITE 1.50 by PKWARE
  377.       TINYPROG 3.9 by Tranzoa, Co.
  378.       UCEXE 2.4 by Ad Infinitum Programs
  379.       and of course our WWPACK 3.04 with 'P' command.
  380.  
  381.       List of files we used to compress:
  382.       QP.EXE (Quattro pro 4.0),
  383.       NCMAIN.EXE (Norton Commander 4.0),
  384.       NDD.EXE (Norton Utility 8.0).
  385.  
  386.   Is WWPACK very powerful?  Try it and find out!
  387.  
  388.  
  389. FREQUENTLY ASKED QUESTIONS
  390.  
  391.   Q: Why should I register WWPACK?  There are many other freeware executable
  392.      file compressors!
  393.   A: Sure. But please compare the compression ratio. Please compare other
  394.      functions. Is there another compressor as easy to use and yet so
  395.      advanced? Does it give you a CRC module, a virus detector,
  396.      a configuration menu, a shell program or useful Pascal procedures?
  397.      Note that if you register WWPACK, you can easily upgrade from the ftp
  398.      site or BBS where WWPACK is available. So if you register, you will
  399.      essentially get the next version for free simply by downloading the
  400.      newest version (IT WILL BE FREEWARE FOR YOU!).
  401.  
  402.   Q: Can I use WWPACK instead of PKZIP or RAR?
  403.   A: No. With PKZIP or RAR you can pack all kinds of files but you can't
  404.      normally use the packed programs.
  405.      With WWPACK you can compress only EXE files, however, they will still
  406.      run normally!
  407.      So the best way is to use two compression programs: first use WWPACK
  408.      on all EXE files and then use RAR or PKZIP.
  409.  
  410.   Q: Does WWPACK work with Stacker and DoubleSpace?
  411.   A: Sure. We have tested WWPACK with those programs and everything has
  412.      worked correctly. What's more you will have more space on the stacked
  413.      drive when you compress all your EXE files.
  414.  
  415.   Q: Is it possible to detect a virus in a compressed file?
  416.   A: No. You can't check if there is a virus under the WWPACK's code.
  417.      That's why everytime you compress some files you must be sure that
  418.      they are virus free!
  419.  
  420.   Q: Can I run DOS compressed files under Windows 3.1 and Windows 95?
  421.   A: Sure. You can use Windows or DOS.
  422.  
  423.   Q: Why is the compression ratio of 'PR' so poor?
  424.   A: It isn't poor. This command compresses only relocation tables.
  425.  
  426.   Q: What's the relocation table?
  427.   A: It's a part of an EXE file. It contains special data that are needed
  428.      to load and then execute program.
  429.  
  430.   Q: Why can't some overlaid files be compressed?
  431.   A: Because when you compress such a file the overlay offset changes
  432.      and the compressed program may not find an overlay.
  433.  
  434.   Q: I want to create a program that will show if the EXE file is already
  435.      compressed. How can I check if it's packed with WWPACK?
  436.   A: Please see our WWPACK Pascal Support package (\PASCAL directory).
  437.      With our functions and units you will not only recognize WWPACKed
  438.      EXE files. We gives you procedures, that will let you scan WWPACKed
  439.      files for viruses! Please see our examples and CRC source code for
  440.      complete information about how to use Pascal Support units.
  441.  
  442.  
  443. HINTS
  444.  
  445.   o  If you want to compress the file that is already packed with EXEPACK
  446.      you should first unpack it. You will get a higher compression ratio.
  447.   o  Always make backups (especially when you compress files with overlays).
  448.      Why? To make WWPACK much safer.
  449.   o  Allow WWPACK to remove Debug_Info.
  450.      The file without Debug_Info can be up to 10% smaller.
  451.  
  452.  
  453. Here are some words about us (authors):
  454.  
  455.   We are twenty. We are students of the University of Lodz. Piotr studies
  456.   computers (second year). Rafal is a student of International Economical
  457.   and Political Relations (second year also).
  458.  
  459.   We will improve our program because we like it and it gives us great
  460.   satisfaction. That's why we are waiting for your suggestions.
  461.  
  462. We would like to thank these people for their suggestions and beta-testing:
  463. Thank you!
  464.  
  465.   Marcel Barbulescu & Cristi Bradiceanu (The DOP), Peter Hubinsky (Slovak
  466.   Antivirus Center), George Jereza (The ClipBoard BBS), Karl Loncarek,
  467.   Piotr Kuciel, Thomas Monkemeier (VGA Software GmbH), Konrad Olejnik,
  468.   Ralph Roth (ROSE), Grzegorz Zgondek and Romuald Zylla.
  469.  
  470. We would like to thank to all people, who have tried earlier versions of
  471. WWPACK, especially to all registered users of WWPACK.
  472.  
  473.  
  474. WWPACK'S CODE INFORMATION:
  475.   written in
  476.     Turbo Pascal, ver. 7.0   (source code: 3690 lines)
  477.     assembler 8088   (1478 lines)
  478.   utility package and WWPACK Shell:
  479.     written in Turbo Pascal 7.0   (6219 lines)
  480. Software we used to create WWPACK:
  481.   Borland Pascal 7.0, Turbo Assembler 3.2, Turbo Debugger 3.2
  482.     by Borland International
  483.   DocGen II, FileTime 0.1, FTC 2.1, Perfidious 1.0  by Piotr Warezak
  484.   EatMem 1.1c  by TifaWARE
  485.   HackStop 1.11  by Ralph Roth - ROSE
  486.   RAR archiver 1.55  by Eugene Roshal
  487.  
  488.  
  489. REGISTERING WWPACK.
  490.  
  491.    Have you decided to register?  That's very kind of you. Thanks! The more
  492.    registrations we get the more improvements we will make to this program.
  493.  
  494.    Now please choose the version of WWPACK that you are interested in:
  495.  
  496.    Registered - cost is $29.
  497.      This version includes the 'U' command which unpacks compressed EXE
  498.      files and the 'PP' command used to protect programs with a password.
  499.      Special offer for public domain and freeware authors:
  500.        if you don't charge any money for your programs you can freely
  501.        distribute them compressed with WWPACK registered version!
  502.  
  503.    Enhanced - cost is $49.
  504.      This version contains an additional features:
  505.      * a special 'PU' command that creates unextractable files;
  506.        programs compressed with our 'PU' HARD compression method are
  507.        unextractable by "intelligent" unpackers like CUP 1.2, UUP 1.4,
  508.        UNP 4.11 and TRON 1.21. Additionaly, all files packed with 'PU'
  509.        command are encrypted!
  510.      * -d  option will let you create demonstration EXE files (the packed
  511.        file will run before DD-MM-YY).
  512.      * included Pascal programs will let you read compressed data files
  513.        and create auto virus detection routines for your programs!
  514.      You must get an Enhanced version if you want to sell any programs
  515.      compressed with WWPACK or use WWPACK Pascal Support units!
  516.  
  517.    How about upgrades?
  518.      FREE!
  519.      If you register our program today you will get WWPACK.REG file which
  520.      is good for all future versions of WWPACK. All you have to do is
  521.      download the current shareware version from a BBS or ftp site.
  522.  
  523.    OK. I want to register but what should I do?
  524.  
  525.      Just fill in the REGISTER.DOC (or REGISTER.GER) file and then send it
  526.      to the one of the following addresses:
  527.  
  528.      American distributor:  The ClipBoard BBS
  529.                             159 Valdez Avenue
  530.                             San Francisco, CA 94112
  531.  
  532.      German distributor:    VGA-Software GmbH     for Austria, Germany, Suisse
  533.                             D-26039  Germany
  534.  
  535.      European distributor:  Piotr Warezak         for Europe (except countries
  536.                             ul. Edukacyjna 31     mentioned above)
  537.                             90-155  Lodz
  538.                             Poland
  539.  
  540.      We will send you the key file: WWPACK.REG which will activate the full
  541.      version of WWPACK which features the 'U' (unpack) and 'PP' (pack with
  542.      password) commands.
  543.  
  544.  
  545. All programs mentioned in this documentation are trademarks of their
  546. respective owners. They're used for identification purposes only.
  547.  
  548. End of the WWPACK documentation file.
  549.