home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / ZIP / WWPACK / WWP304 / SHELL / WWS.DOC next >
Encoding:
Text File  |  1996-01-05  |  10.8 KB  |  241 lines
  1.  
  2.  
  3.  
  4.          WWPACK Shell 1.00                     easy shell for WWPACK
  5.  
  6.          Copyright (c) 1995-96 by Piotr Warezak, Lodz, Poland
  7.  
  8.          6 January 1996   Lodz, Poland           All Rights Reserved
  9.  
  10.  
  11.  
  12.          Please feel free to contact with us:
  13.  
  14.                   Authors' address:      awarezak@krysia.uni.lodz.pl
  15.  
  16.                   American Distributor:              gjereza@crl.com
  17.  
  18.                   German Distributor:            support@vgasoft.com
  19.  
  20.  
  21.  
  22.      Introduction
  23.      ──────────────────────────────────────────────────────────────────────
  24.  
  25.          WWPACK Shell is a very small program which makes WWPACK easier
  26.      to use. With WWPACK, you can pack and unpack any DOS EXE file by using
  27.      only a few keys and a clear colorful screen, and without having to
  28.      know any parameter.
  29.  
  30.          Note that WWS is only a shell. You must have a registered version
  31.      of WWPACK to use all its features! 
  32.  
  33.  
  34.      Installation
  35.      ──────────────────────────────────────────────────────────────────────
  36.  
  37.         Start WWPACK Shell by entering 'WWS' at the DOS command prompt. To
  38.      configure, press the F9 key. Use the mouse or the UP, DOWN and SPACE
  39.      keys to change the configuration of WWPACK and WWPACK Shell. Enter the
  40.      full path and filename for WWPACK.EXE, EXEINFO.EXE, and WWVIR.EXE
  41.      files. If you have a favourite unpacker (like UNP or TRON) please let
  42.      WWS know - it will use it to unpack files compressed with PKLITE,
  43.      LZEXE and others. WWPACK Shell will also let you use external viewers
  44.      and editors (like HIEW).
  45.  
  46.  
  47.      Getting started
  48.      ──────────────────────────────────────────────────────────────────────
  49.  
  50.         When you run WWPACK Shell, a special screen will show you a list of
  51.      subdirectories and EXE files.  To move between directories, WWS uses
  52.      the same keys as The Norton Commander or RAR archiver.
  53.         Please try UP, DN, PG-UP, PG-DN, HOME, END and INS keys to move the
  54.      bar, select, and unselect files. Similarly, the PLUS and MINUS keys
  55.      will let you select files by masking them.
  56.         WWPACK Shell lets you use the mouse too. Press the left button to
  57.      run commands; the right button to select files or abort windows.
  58.  
  59.  
  60.      Commands
  61.      ──────────────────────────────────────────────────────────────────────
  62.  
  63.         WWS Function keys:
  64.      F1   display a very short help screen;
  65.      F2   pack selected files with 'PR', 'P', 'PP' or 'PU' command;
  66.      F3   show header information on EXE file under the cursor bar
  67.           (this key runs EXEINFO program from the WWPACK package);
  68.      F4   unpack selected files;
  69.           WWPACK Shell uses WWPACK to unpack WWPACKed files and external
  70.           unpackers to unpack files compressed with another compressor
  71.           (use F9 to define your favourite EXE unpacker);
  72.      F5   check CRC of selected files (files must be packed with WWPACK3.03
  73.           or newer!);
  74.           You will see one of these messages for every file checked:
  75.             WWP CRC OK   - the file is not damaged;
  76.             WWP w/o CRC  - the file is packed with WWPACK 3.02a or earlier,
  77.                 or 'PR' command was used to pack it (WWPACKed without CRC);
  78.             not WWPACKed - the file is not WWPACKed, so can not be checked;
  79.             Bad WWP CRC! - the file is damaged.
  80.      F7   scan all EXE files for viruses (this key runs WWVIR with *.EXE
  81.           parameter);
  82.      F8   delete selected files;
  83.      F9   configure WWPACK and WWPACK Shell (lets you change compression
  84.           options, screen size, etc.);
  85.      F10  (or ALT-X)  quit to DOS;
  86.  
  87.      ALT-F1  show the "about" window;
  88.      ALT-F2  optimize header of an EXE file;
  89.      ALT-F3  view file under the cursor bar (executes external viewer);
  90.      ALT-F4  edit file under the cursor bar (uses external editor);
  91.      ALT-F5  run WWPACK with the specified parameters. Use '!' as a last
  92.              parameter for processing files selected in the file window.
  93.              (example: type 'T !' and WWPACK will test all selected EXE
  94.               files; enter 'PP !' and all selected files will be packed
  95.               with password);
  96.      ALT-F8  delete all backup files (*.OLD and *.OLP) stored in the
  97.              current directory. Be careful. Use this command only if you
  98.              are sure that all EXE files work without any problems!
  99.      ALT-F9  change WWPACK's configuration (this command is not useful
  100.              since you can use F9 key to configure WWPACK and shell in one
  101.              window);
  102.      ALT-F10  shell to DOS (run COMMAND.COM). WWPACK Shell takes you only
  103.               a few kb of your DOS low memory while shelling to DOS!
  104.  
  105.        Four additional (and very important) keys:
  106.      ALT-D   select drive (with mouse you can click on the path bar at the
  107.              top of the screen to change the drive);
  108.      ALT-P   change compression method ('PR',...,'PU');
  109.      CTRL-L  show disk and directory info (eg. number of WWPACKed files);
  110.      CTRL-O  (or ESC)  show work screen (you can click at the right top of
  111.              the screen instead of using CTRL-O key combination).
  112.  
  113.        You can run most of these commands by moving the mouse cursor to the
  114.      bottom of the screen and pressing the left button. To change the
  115.      current drive, move the cursor to the top of the screen and press left
  116.      button.
  117.  
  118.  
  119.      Example
  120.      ──────────────────────────────────────────────────────────────────────
  121.  
  122.          Here is an example of how to use WWPACK + WWPACK Shell:
  123.  
  124.          Let's say you received a new shareware program that consist of
  125.      three EXE files and some DOC files.  To use WWPACK + WWPACK Shell:
  126.      -  run shell (ie. enter 'WWS' at the DOS prompt)
  127.      -  select all three EXE files (with PLUS or INS keys)
  128.      -  press F2 key and follow WWPACK's messages
  129.      -  quit WWPACK Shell
  130.         Now check if all WWPACKed EXE files work as before.
  131.      If yes:
  132.      -  run shell
  133.      -  press ALT-F8 to delete all backup files (*.OLD)
  134.      -  quit the shell.
  135.      If no:
  136.      -  then something is wrong with the new .EXE file. To recover the old
  137.         file, delete the new .EXE file and replace it with the backup copy
  138.         of the original (the file with the .OLD file extension).
  139.  
  140.  
  141.      Problems
  142.      ──────────────────────────────────────────────────────────────────────
  143.  
  144.          You'll need 500 KB of free conventional memory. That's why we use
  145.      swap technology in WWS. To swap a program, you'll need free XMS or EMS
  146.      memory or some free space on your disk.
  147.          If you have problems with some commands (eg. you can not run
  148.      EXEINFO under shell), one of these parameters may help you:
  149.      -xms   don't use XMS memory for swapping
  150.      -ems   don't use EMS memory for swapping
  151.      -disk  don't swap memory to the disk
  152.          If you do not have free EMS or XMS memory, you should specify
  153.      the directory for the swap file.  From the DOS command line, enter
  154.      "TEMP=<dir>" or "TMP=<dir>" (As an alternative, you may want to add
  155.      this line to your autoexec.bat file: "SET TEMP=<drive>:\". Where
  156.      "drive" is the appropriate drive letter).
  157.  
  158.          Additional parameter:  '-all' tells the shell to show all files
  159.      (and not just .EXE files).
  160.  
  161.          Two other parameters: '-mono' and '-color' lets you change screen
  162.      colors (of course '-color' works only with color graphic cards).
  163.  
  164.          WWPACK Shell can work with almost all standard text resolutions.
  165.      It always runs in the resolution you normally use. However, if you
  166.      want to change the number of rows, please use the -XX paramster, where
  167.      XX is one of the following values:  25/28/30/34/35/40/43/48/50/60,
  168.      or please use the configuration menu. Note that textmodes with more
  169.      than 25 lines will work with EGA(VGA) graphic cards only!
  170.          If you cannot reach the menu with the mouse cursor, your mouse
  171.      driver is probably incompatible with the nonstandard text modes. In
  172.     this case, please try another driver.
  173.  
  174.          WWPACK Shell needs full paths for running external programs.
  175.      You HAVE TO enter full paths in the configuration menu!
  176.  
  177.  
  178.      History
  179.      ──────────────────────────────────────────────────────────────────────
  180.  
  181.      WWShell 1.00   6 January 96      Added mouse control, DOS shell
  182.          capability, and *.COM file compatibility. New configuration
  183.          window. Added WWPACK execute window (ALT-F5). WWShell is now
  184.          bundled as part of the WWPACK package.
  185.  
  186.      WWShell 0.91   24 August 95      Added 80x50 textmode, improved TUI,
  187.          added CTRL-L diskinfo window, ALT-F3 and ALT-F4 commands (external
  188.          viewer and editor).
  189.  
  190.      WWShell 0.90   30 July 95        Initial release.
  191.  
  192.  
  193.      From the author
  194.      ──────────────────────────────────────────────────────────────────────
  195.  
  196.          I am a second year student of computer science. I wrote this
  197.      program to help convince people to use WWPACK. Someone told me that
  198.      it would be nice to use a menu instead of long commands. So why not?
  199.          I am going to continue improving this program, so I think that the
  200.      next version can be expected soon (sorry but I don't know how soon...)
  201.  
  202.          This version of shell was designed for WWPACK 3.04. It WILL NOT
  203.      work with WWPACK 3.03 and earlier versions!
  204.  
  205.  
  206.      Why WWPACK?
  207.      ──────────────────────────────────────────────────────────────────────
  208.  
  209.          Because:
  210.      - it has the highest compression ratio of all EXE file compressors;
  211.      - it was designed to create files that runs on any PC-compatible
  212.        systems (XT up to Pentium);
  213.      - it packs with password;
  214.      - uses paths and wildcards;
  215.      - uses CRC technology (public domain CRC program!);
  216.      - uses configuration menu;
  217.      - can detect ANY virus attached to the EXE file previously compressed
  218.        with WWPACK - with the help of WWVIR and CRC programs;
  219.  
  220.         and, because with this shell it is a VERY EASY program to use!
  221.  
  222.  
  223.      License info
  224.      ──────────────────────────────────────────────────────────────────────
  225.  
  226.          WWShell program is freeware. You can use it without registering.
  227.  
  228.          However, please remember that using WWPACK Shell without WWPACK
  229.      is not possible.  WWPACK itself is not freeware. This means that you
  230.      can use this shell only IF YOU HAVE A REGISTERED COPY OF WWPACK!
  231.  
  232.  
  233.      All programs mentioned in this documentation are trademarks of their
  234.      respective owners. They are used for identification purposes only.
  235.  
  236.      The Norton Commander is a commercial shell program by Symantec.
  237.      RAR archiver is a shareware archiver by Eugene Roshal.
  238.      WWPACK is the copyright of Piotr Warezak and Rafal Wierzbicki.
  239.      ──────────────────────────────────────────────────────────────────────
  240.      End of the documentation file.
  241.