home *** CD-ROM | disk | FTP | other *** search
/ swCHIP 1991 January / swCHIP_95-1.bin / utility / amw13 / amw.doc next >
Text File  |  1995-12-09  |  21KB  |  602 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                            ArcMaster for Windows 1.3
  12.  
  13.                                Copyright 1992/93
  14.  
  15.                               All Rights Reserved
  16.  
  17.                           New-Ware Shareware Products
  18.                                8050 Camino Kiosco
  19.                               San Diego, CA 92122
  20.                                  (619) 455-6225
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                  Contents
  34.  
  35.  
  36.           1  Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  2
  37.           2  Version History . . . . . . . . . . . . . . . . . . . . .  2
  38.           3  What is ArcMaster for Windows (AMW)?  . . . . . . . . . .  2
  39.           4  Programs Needed to Operate AMW  . . . . . . . . . . . . .  2
  40.           5  Installing AMW  . . . . . . . . . . . . . . . . . . . . .  4
  41.              5.1  Step 1.  . . . . . . . . . . . . . . . . . . . . . .  4
  42.              5.2  Step 2.  . . . . . . . . . . . . . . . . . . . . . .  4
  43.              5.3  Step 3.  . . . . . . . . . . . . . . . . . . . . . .  4
  44.              5.4  Step 4.  . . . . . . . . . . . . . . . . . . . . . .  4
  45.           6  About the PIF Files . . . . . . . . . . . . . . . . . . .  5
  46.              6.1  About Testing Archives . . . . . . . . . . . . . . .  5
  47.           7  About Shareware . . . . . . . . . . . . . . . . . . . . .  5
  48.           8  How To Register . . . . . . . . . . . . . . . . . . . . .  6
  49.           9  Distribution Files  . . . . . . . . . . . . . . . . . . .  7
  50.              9.1  On-line Help . . . . . . . . . . . . . . . . . . . .  7
  51.           10  The AMW.INI File . . . . . . . . . . . . . . . . . . . .  8
  52.           11  The NEW-WARE.FON File  . . . . . . . . . . . . . . . . .  8
  53.           12  Running DOS Programs in Minimized Mode . . . . . . . . .  9
  54.           13  About File Managers  . . . . . . . . . . . . . . . . . . 10
  55.           14  About Temporary Directory Use  . . . . . . . . . . . . . 10
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                        i
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.   1  Disclaimer
  86.  
  87.  
  88.        New-Ware hereby disclaims all warranties relating to this product,
  89.   whether express or implied, including without limitation any implied
  90.   warranties of merchantability or fitness for a particular purpose. New-Ware
  91.   cannot and will not be liable for any special, incidental, consequential,
  92.   indirect or similar damages due to loss of data or any other reason, even if
  93.   New-Ware or an authorized New-Ware agent has been advised of the possibility
  94.   of such damages.  In no event shall the liability for any damages ever
  95.   exceed the price paid for the license to use software, regardless of the
  96.   form and/or extent of the claim.  The user of this program bears all risk as
  97.   to the quality and performance of the software.
  98.  
  99.  
  100.   2  Version History
  101.  
  102.  
  103.   1.0  -  Initial Release - 10/20/92
  104.   1.1  -  Bug fixes and enhancements (see WHAT'S.NEW) - 10/30/92
  105.   1.2  -  Bug fixes for 1.1 (see WHAT'S.NEW) - 11/30/92
  106.        -  Added Drag & Drop to an Icon Action Window
  107.   1.3  -  The main command option switches were not being properly
  108.           passed to ARJ when compressing.  Fixed.
  109.        -  The conversion function was not properly handling SFX files.
  110.           Fixed.
  111.        -  The Single Arc function was not working for LHA and ARJ.
  112.           Fixed.
  113.        -  The Alt+U key combination was not working.  Fixed.
  114.        -  Problems using the Yank button in the tagged files dialog are
  115.           fixed.
  116.        -  Added support for PKZIP version 2.04c.
  117.  
  118.  
  119.   3  What is ArcMaster for Windows (AMW)?
  120.  
  121.  
  122.        AMW is a Windows 3.1 program designed to make the management of file
  123.   compression systems and the files they produce much easier.  In addition,
  124.   AMW offers normal file management capabilities such as file copy, move, and
  125.   deletion, directory tree management, and more.
  126.  
  127.  
  128.   4  Programs Needed to Operate AMW
  129.  
  130.  
  131.        You will need at least one of the following archive programs in order
  132.   to utilize the full capabilities of AM.
  133.  
  134.  
  135.  
  136.                                      - 2 -
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.             ARJ from Robert K. Jung  -  ARJ230.XXX
  144.             Robert Jung
  145.             2606 Village Road West
  146.             Norwood, Massachusetts 02062
  147.  
  148.             LHA from Haruyasu Yoshizaki  -  LHA213.XXX
  149.             This program is free.
  150.  
  151.             ZIP from PKWARE  -  PKZ204.C
  152.             PKWARE Inc.
  153.             9025 North Deerwood Drive
  154.             Brown Deer, WI 53223
  155.  
  156.        If you anticipate the need to manipulate files compressed in the
  157.   antiquated ARC format, then it is suggested that you acquire the following
  158.   program:
  159.  
  160.             ARCE from Vernon D. Buerg
  161.             Vernon D. Buerg
  162.             139 White Oak Circle
  163.             Petaluma, CA 94952
  164.  
  165.        The file names following the program identifiers reflect the current
  166.   versions.  Please note the .XXX file extension is given because these will
  167.   vary from location to location.  Many are distributed in compressed
  168.   executable (.EXE) format and some are distributed in the PkWare ZIP format.
  169.   You can find these marvelous programs on just about any computer bulletin
  170.   board system (BBS) or commercial on-line access system such as Compuserve
  171.   Information Service (CIS) or Genie.  All of these programs may be accessed
  172.   from the New-Ware BBS.
  173.  
  174.        While not absolutely essential, the user might have available a full-
  175.   featured file browse utility which AMW can call to view/browse the contents
  176.   of a compressed file existing inside an archive.  The recommended program is
  177.   a state-of-the-art browser from Third Millennium Technologies named LI.  AMW
  178.   can be configured to use any file browser that accepts a file path name on
  179.   its command line.  New-Ware feels that LI is the fastest, most compact, and
  180.   most powerful of the available Windows browsers.  LI can be found on almost
  181.   all BBSs in the form of LIxxx.ZIP (or EXE).  Note that the xxx denotes the
  182.   version and version modifier, as in 122.  Be sure to configure AMW so that
  183.   it can locate LI.EXE.
  184.  
  185.        If you choose not to interface with a separate Windows file browser,
  186.   AMW has an internal bare-bones file browser that will suffice for viewing
  187.   normal and compressed files.  This browser does have a text search utility.
  188.   AMW will use the internal browser if you configure AMW with nothing entered
  189.   in the "Viewer:" field.
  190.  
  191.  
  192.  
  193.  
  194.                                      - 3 -
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.   5  Installing AMW
  202.  
  203.  
  204.        Installing AMW is very simple.  Just follow these steps:
  205.  
  206.   5.1  Step 1.
  207.  
  208.        Place the following files either in your Windows directory or some
  209.   other directory of your choice:
  210.  
  211.                       AMW.EXE
  212.                       AMW.HLP
  213.                       NEW-WARE.FON
  214.                       ARCE.PIF
  215.                       ARJ.PIF
  216.                       LIST.PIF
  217.                       LHA.PIF
  218.                       PKZIP.PIF
  219.                       PKUNZIP.PIF
  220.                       SCAN.PIF
  221.                       ZIP2EXE.PIF
  222.                       AMWTEST.PIF
  223.  
  224.   5.2  Step 2.
  225.  
  226.        You must place BWCC.DLL and NEW-WARE.FON in your Windows system
  227.   directory or in the directory from which you will execute AMW.  This is
  228.   MANDATORY!
  229.  
  230.   5.3  Step 3.
  231.  
  232.        Run Windows.  Bring up the Program Manager, select the File menu, and
  233.   then select "Run".  If you placed the AMW files above in a directory other
  234.   than your Windows directory, type in the command:
  235.  
  236.                  C:\MYDIR\AMW.EXE INSTALL C:\MYDIR
  237.  
  238.   Where C:\MYDIR is the DOS path name of that directory.  If you placed the
  239.   files in your Windows directories, just type AMW.EXE and press <Enter>.
  240.  
  241.   5.4  Step 4.
  242.  
  243.        When in AMW, select the "mIsc" pull-down menu and then select
  244.   "Configure-AM".  You can get help via the Help button or the F1 key while in
  245.   the configuration dialog.  Configure AMW according to your needs and save
  246.   the configuration.  AMW.CFG will be saved to and maintained in your Windows
  247.   directory.  If you used the INSTALL C:\MYDIR feature in step 3, then be sure
  248.   to enter C:\MYDIR in the AMW Dir: field before saving the configuration.
  249.  
  250.  
  251.  
  252.                                      - 4 -
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.   6  About the PIF Files
  260.  
  261.  
  262.        AMW is distributed with a group of PIF files.  Once you have initially
  263.   run and configured AMW, be CERTAIN to use the Windows PIF Editor to modify
  264.   the PIF files for your system.  For example, the enclosed PIF files all have
  265.   C:\UTIL\PROGNAME.EXE in the "Program Filename:" field.  You will have to
  266.   edit this field according to the location of ARJ.EXE, LHA.EXE, PKZIP.EXE,
  267.   etc., etc.  Be ABSOLUTELY CERTAIN that no entry is placed in the "Start-up
  268.   Directory:" field!
  269.   If you desire to start a lengthy archiving operation in AMW and then switch
  270.   to another Windows program, you will need to check the background execution
  271.   box in the PIF editor main window.
  272.  
  273.   6.1  About Testing Archives
  274.  
  275.        The AMWTEST.PIF file is used for testing the integrity of ARJ, LZH, and
  276.   ZIP files.  Note that AMWTEST.PIF points to AMWTEST.BAT.  Also note that
  277.   ARJ.EXE, LHA.EXE, and PKUNZIP.EXE must be in the DOS path in order for the
  278.   batch file to work properly.  Of course, you can easily modify the batch
  279.   file to test the first parameter and then branch to a specific command based
  280.   upon that test, as in if %1==PKUNZIP.EXE goto SOMEPLACE.  This scheme is
  281.   necessary to insure that the testing program is run in a normal window and
  282.   that there is a pause so that you can view the results.
  283.  
  284.  
  285.   7  About Shareware
  286.  
  287.  
  288.        AMW is Shareware.  ARJ, ZIP, and LI are also Shareware.  Shareware is
  289.   NOT free.  It is computer software offered for sale at a set price and the
  290.   only real difference between Shareware and other commercial software
  291.   products is the method of distribution and the important "try before you
  292.   buy" feature.  With Shareware you are normally licensed by the owner/author
  293.   of the program to operate the Shareware distribution copy on a trial basis.
  294.   Then if you like it and make regular use of it, you are bound to pay for it.
  295.  
  296.        AMW is a Shareware product.  As such, it is made available to the
  297.   general computing public for evaluation.  Users are licensed to operate
  298.   ArcMaster on their personal computers for the purpose of test and evaluation
  299.   on a trial basis for a limited trial period.  It is not possible to
  300.   reasonably define any definitive limits of a fair and equitable time period
  301.   for evaluation, therefore it is left to the user's judgment and sense of
  302.   fair play as to the time required to make a decision as to its usefulness.
  303.   If the user decides the program is not of sufficient merit to warrant
  304.   purchase through registration with New-Ware, the program should be removed
  305.   from his or her personal computer.  Otherwise, if the program is deemed
  306.  
  307.  
  308.  
  309.  
  310.                                      - 5 -
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.   useful and is in regular use on the user's personal computer system,
  318.   registration with New-Ware is required.
  319.  
  320.        Registered users are those users that elect to pay for AMW and register
  321.   that payment with New-Ware.  By virtue of registration and payment for the
  322.   program, registered users are granted a license to continue to utilize the
  323.   program on their personal computer for as long as they choose.  This license
  324.   authorizes the user to use the program on any personal computer system he or
  325.   she may own so long as the program is operated on only one computer system
  326.   at a time.
  327.  
  328.        Site licenses for use of AMW on multiple computers are available upon
  329.   request at a reduced fee that is based on the number of single machines
  330.   licensed for use.
  331.  
  332.  
  333.   8  How To Register
  334.  
  335.  
  336.        For your convenience, AMW provides a registration dialog in which you
  337.   can quickly fill out and print the registration form.  The dialog can be
  338.   activated from the "About AMW.." System Menu item or the "About AMW..." Help
  339.   Menu item.
  340.  
  341.        The ONLY functional difference between the AMW Shareware distribution
  342.   version and the registered version is that the Shareware version help access
  343.   is via the "About AMW.." dialog.
  344.  
  345.        The price of AMW is $35.00.  Registered users of the DOS version of
  346.   ArcMaster may upgrade to AMW for $10.00.
  347.  
  348.        You may register AMW in one of three ways:
  349.  
  350.             1) By mail with check or money order to:
  351.  
  352.                            New-Ware
  353.                            8050 Camino Kiosco
  354.                            San Diego, CA 92122-1820
  355.  
  356.             2) By telephone with Visa/Mastercard to:
  357.  
  358.                            New-Ware
  359.                            (619) 455-6225
  360.                            8 a.m. to 5 p.m. Pacific Time
  361.                            Monday - Friday
  362.                            8 a.m. to 1 p.m. Pacific Time
  363.                            Saturdays
  364.  
  365.  
  366.  
  367.  
  368.                                      - 6 -
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.             3) Electronically through the New-Ware BBS:
  376.  
  377.                            New-Ware BBS
  378.                            (619) 455-5226
  379.                            24 Hours per day
  380.                            7 Days per week
  381.  
  382.        Special site license rates for licensing multiple copies of ArcMaster
  383.   are available.  Please license fee schedule information.
  384.  
  385.        Foreign (non-US/Canada) orders must include a $2.00 special handling
  386.   fee in addition to the $35.00 registration fee.  Also, no checks on banks
  387.   located outside the United States will be accepted.
  388.  
  389.        California residents MUST include state sales tax with their order.
  390.  
  391.        The Shareware version of AMW may be freely copied and passed on to
  392.   other individual users for their evaluation.  Disk vendors and/or
  393.   distributors that desire to distribute ArcMaster must adhere to the
  394.   guidelines presented in VENDOR.DOC.
  395.  
  396.  
  397.   9  Distribution Files
  398.  
  399.  
  400.        The following files are included in the AMW distribution package:
  401.  
  402.                  AMW.EXE        - Main program
  403.                  BWCC.DLL       - Dynamic Link Library file
  404.                  AMW.HLP        - Help file
  405.                  NEW-WARE.FON   - Font file
  406.                  AM.DOC         - AMW Documentation
  407.                  xxxx.PIF/BAT   - Various Windows PIF/BAT files
  408.                  WHAT'S.NEW     - Latest product info (if needed)
  409.  
  410.        New-Ware prohibits the modification of any of these files in any way,
  411.   shape, or form except by the individual evaluator or purchaser.
  412.  
  413.   9.1  On-line Help
  414.  
  415.        An extensive Windows 3.1 help file is included with AMW.  Operating
  416.   instructions for each AMW function are contained in this file.  To obtain
  417.   help while running AMW you may press the F1 key from just about anywhere in
  418.   the program, press the help button whenever it is visible, or utilize the
  419.   main pull-down help menu.
  420.  
  421.        AMW help is context sensitive.  For example, you can activate one of
  422.   the pull-down menus, move the cursor to a menu item, and press the F1 key to
  423.  
  424.  
  425.  
  426.                                      - 7 -
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.   get help specific to that item.  You can also press F1 or the Help button in
  434.   any of the numerous AMW dialog boxes for context sensitive help.  Note that
  435.   all help requests in the Shareware version go through the "About AMW.."
  436.   dialog.
  437.  
  438.  
  439.   10  The AMW.INI File
  440.  
  441.  
  442.        Whenever AMW is executed, it looks for a text file named AMW.INI in
  443.   your Windows directory.  If found, it loads it.  If not found, AMW will
  444.   create one for you.  You may use any text editor to modify this file.
  445.  
  446.        AMW.INI has two sections.  The first section is entitled [masks].  Up
  447.   to 12 DOS file masks may be entered under this section.  An example is:
  448.  
  449.             [masks]
  450.             *.*
  451.             *.ZIP
  452.             *.LHA
  453.             *.WKS
  454.             *.WRI
  455.  
  456.   AMW will use the mask entries in a drop-down list box from which you can
  457.   select a file mask for one of the two file list windows.
  458.  
  459.        The second section is entitled [progs].  Up to 12 DOS program path
  460.   names and/or Windows PIF files may be entered under this section.  An
  461.   example is:
  462.  
  463.             C:\WINDOWS\CALEND.EXE
  464.             LIST.PIF
  465.             E:\UTIL\NUTHIN\MYPROG.EXE
  466.  
  467.   AMW will use these entries in a drop-down list box from which you can select
  468.   a program to launch.
  469.  
  470.  
  471.   11  The NEW-WARE.FON File
  472.  
  473.  
  474.        The NEW-WARE.FON file is a Windows font that is provided to owners of
  475.   Borland Pascal for Windows.  This font is named BorlandTE  You may elect to
  476.   install this handsome font in your system through the following steps:
  477.  
  478.        1. Run the Control Panel from the Program Manager.
  479.  
  480.        2. Select Fonts from the control panel.
  481.  
  482.  
  483.  
  484.                                      - 8 -
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.        3. Select the Add button.
  492.  
  493.        4. Use the directory/file dialogs to select the directory where
  494.           your copy of NEW-WARE.FON resides.  Select BorlandTE and
  495.           install it.  You might want to check the "Copy to windows
  496.           directory box."
  497.  
  498.        AMW will still load and use the BorlandTE font if don't install the
  499.   font semi-permanently but doing so gives you access to this nice font in
  500.   other areas of Windows.
  501.  
  502.  
  503.   12  Running DOS Programs in Minimized Mode
  504.  
  505.  
  506.        AMW runs ARJ.EXE, LHA.EXE, and PKZIP.EXE as minimized windows programs.
  507.   This is done to reduce the herky-jerky effect of having a DOS window open
  508.   and close briefly.  There are certain circumstances under which any one of
  509.   these programs might issue a prompt and await user keyboard response before
  510.   continuing.  An example is when decompressing files and the decompressor
  511.   needs to know if it's okay to overwrite a file.  You will not see the issued
  512.   prompt because the program is minimized but you will note that he program's
  513.   icon has not been removed and/or that the desired results did not occur.  In
  514.   that case, simply click on the icon to restore the full window and make your
  515.   response.  It's not the smoothest way to operate, but until the archive
  516.   systems are ported to Windows it is the best that can be done.
  517.  
  518.        Testing the integrity of a compressed file is a special case where you
  519.   will certainly wish to see the test results.  AMWTEST.PIF and AMWTEST.BAT
  520.   are provide to handle this special case.  Note that ARJ.EXE, LHA.EXE,
  521.   PKUNZIP.EXE must be in the DOS path if you use AMWTEST.BAT as configured.
  522.   You can configure the batch file to point to a specific location as in the
  523.   following example:
  524.  
  525.   if %1==PKUNZIP.EXE goto CALLUNZIP
  526.   ...
  527.   ...
  528.   :CALLUNZIP
  529.   D:\MYZIPDIR\PKUNZIP.EXE %2 %3 %4 %5 %6
  530.   ...
  531.  
  532.   The use of this batch file is necessary to insert a pause for the purpose of
  533.   examining the test results.
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.                                      - 9 -
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.   13  About File Managers
  550.  
  551.  
  552.        Not all file managers are equal.  AMW interfaces with the Microsoft
  553.   Windows 3.1 file manager (WINFILE.EXE) for drag & drop operations.  Drag &
  554.   Drop may or may or may not work with other Windows file managers.  You'll
  555.   just have to experiment and see.
  556.  
  557.  
  558.   14  About Temporary Directory Use
  559.  
  560.  
  561.        AMW requires a temporary directory in which to store extracted files
  562.   for viewing, scanning, etc., operations.  ARJ, LHA, and PKZIP also require a
  563.   temporary directory for certain operations.  You may specify a temporary
  564.   directory in the AMW configuration dialog.  Be sure that this is an empty
  565.   directory because AMW will delete all files stored there after certain
  566.   operations.  Also, be certain that you do NOT use the specified temporary
  567.   directory as a host of compressed files you intend to view or otherwise
  568.   manipulate.  You may lose those files.
  569.  
  570.        When you first install AMW, it will create a subdirectory in the
  571.   directory that you designated.  For example if you install using  INSTALL
  572.   D:\AMW as parameters, AMW will create D:\AMW\!AMWTMP! as the temporary
  573.   directory.  You can change this later via the AMW configuration dialog and
  574.   remove !AMWTMP! if so desired.
  575.  
  576.        If you execute AMW and it cannot locate its temporary directory,
  577.   you will receive a warning.  Be certain to designate a valid temporary
  578.   directory for AMW use.
  579.  
  580.   Copyright 1992/93 all rights reserved:
  581.  
  582.   New-Ware
  583.   8050 Camino Kiosco
  584.   San Diego, CA 92122-1820
  585.   (619) 455-6225
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                      - 10 -
  601.  
  602.