home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / compress / aview351.zip / AVIEW.DOC < prev    next >
Text File  |  1993-05-10  |  20KB  |  460 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │  ████┐  ██┐ ██┐ ██┐ ██████┐ ██┐  ██┐                                        │
  3. │ ██┌─██┐ ██│ ██│ ██│ ██┌───┘ ██│  ██│                             AVIEW V3.5 │
  4. │ ██████│ ██│ ██│ ██│ █████┐  ██│█┐██│                                        │
  5. │ ██┌─██│ └█│ █┌┘ ██│ ██┌──┘  ███┌███│                                        │
  6. │ ██│ ██│  └██┌┘  ██│ ██████┐ ██┌┘└██│   Copyright (C) 1992-93 by Chris Buijs │
  7. │ └─┘ └─┘   └─┘   └─┘ └─────┘ └─┘  └─┘                                        │
  8. └─────────────────────────────────────────────────────────────────────────────┘
  9.  
  10.   AVIEW is a simple archive-viewer utility for the Norton Commander, it
  11.   views ARC, ARJ, LZH, PAK, ZIP and ZOO archives automatically, it shows
  12.   lots of info about the files in the archive, you can also tag files and
  13.   unpack them, all operations also work on archive-in-archive!
  14.  
  15.  
  16.   AVIEW is made for usage under the Norton Commander, however, the Norton
  17.   Commander is NOT needed to use AVIEW, AVIEW can also be used stand-alone,
  18.   it contains a full featured file-selector.
  19.  
  20.  
  21.   This utility is here-by placed in Public Domain and can be concidered
  22.   freeware, this utility may not be sold, hired, leased or modified, it may
  23.   be freely copied as a complete package.
  24.  
  25.  
  26.   This documentation is a quick-help to setup AVIEW, for more information
  27.   you can study the AVIEW.CTL and WHATSNEW.nn files.
  28.  
  29.  
  30.   To print this documentation, type on the DOS-Prompt:
  31.  
  32.     COPY AVIEW.DOC LPT1:
  33.  
  34.   followed by an ENTER, change 'LPT1:' to the device you use to print.
  35.  
  36. ┌─────────────────────────────────────────────────────────────────────────────┐
  37. │ ▒▒▒▒ Requirements ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  38. └─────────────────────────────────────────────────────────────────────────────┘
  39.  
  40.   AVIEW requires:  MS/PCDOS V3.3x or higher.
  41.                    350 KB of free conventional memory.
  42.                    A (microsoft compatible) mouse (optional).
  43.  
  44.   The following programms may be needed (optional);
  45.  
  46.   For extracting, updating, converting and viewing archives-in-archives:
  47.   ───────────────────────────────────────────────────────────────────────────
  48.   ARJ.EXE                   from Robert K. Jung.
  49.   LHA.EXE                   from Haruyasu Yoshizaki.
  50.   PAK.EXE                   from NoGate Consulting.
  51.   PKUNPAK and PKPAK         from PKWare.
  52.   PKUNZIP.EXE and PKZIP.EXE from PKWare.
  53.   ZOO.EXE                   from Rahul Dhesi.
  54.  
  55.  
  56.   For file-viewing/editing:
  57.   ───────────────────────────────────────────────────────────────────────────
  58.   WPVIEW.EXE                from Symantec (Peter Norton Computing).
  59.   NCEDIT.EXE                from Symantec (Peter Norotn Computing).
  60.  
  61.  
  62.   All the above programms are optional and can be replaced by others, this
  63.   can be done by changing the parameters in the AVIEW.CTL file, see the
  64.   sample AVIEW.CTL for more information.
  65.  
  66. ┌─────────────────────────────────────────────────────────────────────────────┐
  67. │ ▒▒▒▒ Parameters ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  68. └─────────────────────────────────────────────────────────────────────────────┘
  69.  
  70.   Syntax:  AVIEW [[<Drive>:][<Path>\][<Filename>]] [/?] [/M] [/N] [/25]
  71.                  [/35] [/40] [/43] [/50]
  72.  
  73.            <Drive>    - Drive where archive is on.
  74.  
  75.            <Path>     - Path where archive is stored.
  76.  
  77.            <Filename> - Archive-file.
  78.  
  79.            /?         - Gives a help-screen about the parameters.
  80.  
  81.            /M         - Starts up AVIEW in monochrome mode.
  82.  
  83.            /N         - Force AVIEW not to swap itself out of memory.
  84.  
  85.            /25        - Starts up AVIEW in 25 lines per screen mode.
  86.  
  87.            /35        - Starts up AVIEW in 35 lines per screen mode (EGA).
  88.    
  89.            /40        - Starts up AVIEW in 40 lines per screen mode (EGA)
  90.  
  91.            /43        - Starts up AVIEW in 43 lines per screen mode (VGA)
  92.  
  93.            /50        - Starts up AVIEW in 50 lines per screen mode (VGA)
  94.  
  95.  
  96.   When no drive/path/file parameters are given, AVIEW will startup with a
  97.   file-selector, with this file-selector you can select a file to view.
  98.   With the file-selector you can also switch between drives, directorys
  99.   and files.
  100.  
  101.   When only a drive or path is given as parameter, aview will startup the
  102.   file-selector in the given drive/directory.
  103.  
  104.   AVIEW automatically detects how many lines per screen are used at startup
  105.   and will use the number of lines per screen detected, this can be
  106.   overridden with one of the above parameters or with the SCREENMODE
  107.   parameter in the AVIEW.CTL file.
  108.  
  109. ┌─────────────────────────────────────────────────────────────────────────────┐
  110. │ ▒▒▒▒ Installation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  111. └─────────────────────────────────────────────────────────────────────────────┘
  112.  
  113.   STANDALONE
  114.   ───────────────────────────────────────────────────────────────────────────
  115.   - Copy AVIEW.EXE and AVIEW.CTL to a directory in your PATH, AVIEW.CTL must
  116.     be located in the same directory as AVIEW.EXE.
  117.   - Edit the AVIEW.CTL file with a plain ascii-editor and change the
  118.     parameters so that AVIEW will work correctly on your system.
  119.   - Your now ready to run AVIEW.
  120.  
  121.    
  122.  
  123.   THE NORTON COMMANDER Versions prior to V4.0
  124.   ───────────────────────────────────────────────────────────────────────────
  125.   - Copy AVIEW.EXE, AVIEW.CTL and AVIEWNC.EXE to the directory where
  126.     the Norton Commander is installed.
  127.   - Run the AVIEWNC utility, this utility will update your NC.EXT file.
  128.   - Delete AVIEWNC.EXE, only needed for installing AVIEW in the NC.EXT file.
  129.   - Edit the AVIEW.CTL file with a plain ascii-editor and change the
  130.     parameters so that AVIEW will work correctly on your.
  131.   - Restart The Norton Commander.
  132.   - Your now ready to run AVIEW.
  133.  
  134.     NOTE: After installing AVIEW in The Norton Commander, you can view an
  135.           archive by pressing ENTER or F3.
  136.  
  137.  
  138.  
  139.   THE NORTON COMMANDER V4.0
  140.   ───────────────────────────────────────────────────────────────────────────
  141.   - Copy AVIEW.EXE, AVIEW.CTL and AVIEWNC4.EXE to the directory where
  142.     the Norton Commander is installed.
  143.   - Run the AVIEWNC4 utility, this utility will update your NC.CFG and
  144.     NC.EXT files.
  145.   - Delete AVIEWNC4.EXE, only needed for installing AVIEW in the NC.CFG and
  146.     NC.EXT files.
  147.   - Edit the AVIEW.CTL file with a plain ascii-editor and change the
  148.     parameters so that AVIEW will work correctly on your system.
  149.   - Restart The Norton Commander.
  150.   - Your now ready to run AVIEW.
  151.  
  152.     NOTE: When you run AVIEW under The Norton Commander V4.0, you can only
  153.           use AVIEW on a file by pressing F3, when you press ENTER in
  154.           NC V4.0, the internal file-view will be activated, this CANNOT
  155.           be changed to use AVIEW instead.
  156.  
  157.     NOTE 2: I discovered that when you use F3 under the Norton Commander V4.0
  158.             that NC V4.0 doesn't swap itself out of memory, this can give
  159.             problems/errors executing some external utilitys.
  160.  
  161. ┌─────────────────────────────────────────────────────────────────────────────┐
  162. │ ▒▒▒▒ AVIEW.CTL ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  163. └─────────────────────────────────────────────────────────────────────────────┘
  164.  
  165.   For customizing the operations of AVIEW, you can edit the AVIEW.CTL 
  166.   control file, its a plain ascii-file, see the example AVIEW.CTL for more
  167.   information, the following commands can be used in the control file to
  168.   configure AVIEW:
  169.  
  170.  
  171.   ALTERNATELAYOUT
  172.   ───────────────────────────────────────────────────────────────────────────
  173.   With this command you tell AVIEW to use the alternate list-layout of the
  174.   archive-lister, the alternate list-layout includes lesser information
  175.   but shows the full-paths of the files in the archive.
  176.  
  177.  
  178.   NOCOLOR
  179.   ───────────────────────────────────────────────────────────────────────────
  180.   With this command you force AVIEW in black and white mode, this can be
  181.   handy for laptop-users with LCD-Screens.
  182.  
  183.  
  184.   NOMOUSE
  185.   ───────────────────────────────────────────────────────────────────────────
  186.   When you have a mouse, and it is detected by AVIEW, you can force AVIEW 
  187.   with this command to ignore the mouse and not use it.
  188.  
  189.  
  190.   NOSWAP
  191.   ───────────────────────────────────────────────────────────────────────────
  192.   With this command you force AVIEW not to swap itself out of memory when
  193.   executing an external utility, this is NOT advisable.
  194.  
  195.  
  196.   VIEWER <Trigger> <Viewer> [<Parameters>]
  197.   ───────────────────────────────────────────────────────────────────────────
  198.   With this command you can define up to 20 viewers to use to view files from
  199.   an archive, <Trigger> is a file-extension which triggers <Viewer> to view
  200.   a file, <Trigger> must not be more then 3 chars and may include wildcards,
  201.   DON'T include the period (.) in the trigger-extension. When no viewers are
  202.   defined, WPVIEW is taken for all type of files.
  203.  
  204.  
  205.   EDITOR <Trigger> <Editor> [<Parameters>]
  206.   ───────────────────────────────────────────────────────────────────────────
  207.   With this command you can define up to 20 editors to use to edit files from
  208.   an archive, <Trigger> is a file-extension which triggers <Editor> to edit
  209.   a file, <Trigger> must not be more then 3 chars and may include wildcards,
  210.   DON'T include the period (.) in the trigger-extension. When no editors are
  211.   defined, NCEDIT is taken for all type of files.
  212.  
  213.  
  214.   EXTRACTPATH <Path>
  215.   ───────────────────────────────────────────────────────────────────────────
  216.   The path to use for extracting files to, when this path isn't defined,
  217.   AVIEW will prompt for a path before extracting any files.
  218.  
  219.  
  220.   SCREENMODE <Lines>
  221.   ───────────────────────────────────────────────────────────────────────────
  222.   With this statement you can define how many lines per screen AVIEW must
  223.   use, valid numbers are 25, 35, 40, 43 and 50, note that you will need an
  224.   EGA or VGA adaptor when you use numbers greater than 25.
  225.  
  226.   SORT <Key> [Ascending|Descending]
  227.   ───────────────────────────────────────────────────────────────────────────
  228.   With this parameter you define how to sort the file-list as default, there
  229.   are 6 sort-keys:
  230.  
  231.     NAME      - For sorting on file-name
  232.     EXTENSION - For sorting on file-extension.
  233.     ORGSIZE   - For sorting on original (uncompressed) file-size.
  234.     CMPSIZE   - For sorting on compressed file-size.
  235.     RATIO     - For sorting on ratio.
  236.     DATETIME  - For sorting on date and time.
  237.     METHOD    - For sorting on compression-method.
  238.     UNSORTED  - For no sorting (Unsorted).
  239.  
  240.   Optional you can also define the sort-direction, default is ascending:
  241.  
  242.     ASCENDING  - Sort ascending.
  243.     DESCENDING - Sort descending.
  244.   
  245.   The default sorting is on filename, ascending.
  246.  
  247.  
  248.   TEMPPATH <Path>
  249.   ───────────────────────────────────────────────────────────────────────────
  250.   With this command you define the path AVIEW must use as work-directory,
  251.   this can be a ram-drive which will speed-up AVIEW dramatically, in this
  252.   directory AVIEW will creates its own tempory directorys, these tempory
  253.   directorys will be deleted when AVIEW doesn't need them anymore, note
  254.   that the directory specified with TEMPPATH is NOT deleted, nor the
  255.   files that exist in it, this has been changed since V3.0.
  256.  
  257.  
  258.   SCANNER [<Path>\]<Filename> [<Parameters>]
  259.   ───────────────────────────────────────────────────────────────────────────
  260.   With this command you can define the virus-scanner to use for scanning the
  261.   file unpacked with the unpack function, when no virus-scanner is defined,
  262.   NO scan will be performed.
  263.  
  264.  
  265.   ZOOMSPEED <Milliseconds>
  266.   ───────────────────────────────────────────────────────────────────────────
  267.   With this command you can define the zoom-speed of the popup-windows that
  268.   build up onto the screen, 0 will give an immidiate popup, the default
  269.   zoomspeed is 10.
  270.  
  271.   ┌─────────────────────────────────────────────────────────────────────────┐
  272.   │ With the following commands you can define the parameters used by AVIEW │
  273.   │ for using the external archive-utilitys.                                │
  274.   │ For normal operation of AVIEW, you don't need to change this, all the   │
  275.   │ following commands are optional, the sample commands in the sample      │
  276.   │ AVIEW.CTL file reflects the standard default configuration of AVIEW.    │
  277.   └─────────────────────────────────────────────────────────────────────────┘
  278.  
  279.  
  280.   xxxADD <Command-line>
  281.   xxxDELETE <Command-Line>
  282.   xxxEXTRACT <Command-Line>
  283.   xxxUNPACK <Command-Line>
  284.   xxxUPDATE <Command-Line>
  285.   xxxRESPONSE <Response-char>
  286.   ───────────────────────────────────────────────────────────────────────────
  287.   With these commands you can configure the interface between AVIEW and the
  288.   external archive-utilitys, the xxx can be ARC, ARJ, LHA, PAK, ZIP or ZOO.
  289.   xxxADD      - Defines which parameters to use for adding a file to
  290.                 an archive, this is used for the ADD function (F7), and for
  291.                 creating new archives with the CONVERT function (F5).
  292.   xxxDELETE   - Defines which parameters to use for deleting a file or files
  293.                 from an archive, this is used for the DELETE function
  294.                 (F8 or DEL).
  295.   xxxEXTRACT  - Defines which parameters to use for extracting a file or files
  296.                 from an archive, this is used for the extract-function.
  297.   xxxUNPACK   - Defines which parameters to use for extracting ONE file from
  298.                 an archive WITHOUT path, this is used internally in AVIEW.
  299.   xxxUPDATE   - Defines which parameters to use for updating a file in an
  300.                 archive, this is used after you edited a file from an archive.
  301.   xxxRESPONSE - Defines which charachter to use before a file name to tell
  302.                 the archiver that it is a response file, AVIEW defines
  303.                 automatically when to use this or not.
  304.  
  305.   NOTE: There are two variables, %A and %F, these two must ALWAYS exist in
  306.         the above parameters (except xxxRESPONSE), %A will be replaced by
  307.         AVIEW with the name of the archive processed, and %F with a filename
  308.         for adding/deleting/updating, note that AVIEW will automatically add
  309.         the response-file-char before the filename when needed.
  310.         The variables %A and %F are NOT optional!
  311.  
  312. ┌─────────────────────────────────────────────────────────────────────────────┐
  313. │ ▒▒▒▒ Operation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  314. └─────────────────────────────────────────────────────────────────────────────┘
  315.  
  316.   SWAPPING:
  317.   ───────────────────────────────────────────────────────────────────────────
  318.   When executing an external utility, AVIEW will first try to swap itself out
  319.   of memory, AVIEW will firstly try to swap to expanded memory (EMS), when
  320.   not succesfull, AVIEW will try to swap to extenden memory (XMS), and when
  321.   that's not enough, AVIEW will try to swap itself to disk.
  322.   AVIEW will need 350 KB free EMS,XMS or DISK-Space to swap, when not, AVIEW
  323.   will NOT execute the external utility and aborts with an error.
  324.  
  325.  
  326.  
  327.   MOUSE:
  328.   ───────────────────────────────────────────────────────────────────────────
  329.   AVIEW has mouse-support, when a mouse is detected it will be used
  330.   automatically, the mouse is used in file-lists, menu's and the
  331.   file-selector.
  332.  
  333.   Click once on an entry to highlight it, click it twice for selecting it.
  334.  
  335.   Clicking at the top or bottom of a menu, or at the top or bottom of a
  336.   file-list will scroll the cursor-bar.
  337.  
  338.   The function-keys at the bottom of the screen can offcourse also be clicked.
  339.  
  340.   The (most) right mouse-button will act as the ESC key.
  341.  
  342.   Archive-Viewing Keys:
  343.   ───────────────────────────────────────────────────────────────────────────
  344.   F1           - Help, some info which keys you can use.
  345.  
  346.   F2           - Unpack, extracts file under selection-bar or all tagged 
  347.                  files from archive.
  348.  
  349.   F3 or ENTER  - View file, also for archive-in-archive.
  350.  
  351.   F4           - Edit file, after editing AVIEW will ask if you want to update
  352.                  the archive with the edited file.
  353.  
  354.   F5           - Convert, you can convert the archive you are viewing to
  355.                  another archive-format.
  356.  
  357.   F6 or ALT-S  - Sort, sort file list.
  358.  
  359.   F7           - Add, add files to archive, when on the input-field, press
  360.                  F2 to activate the file-selector.
  361.  
  362.   F8 or DEL    - Delete, Delete file under selection-bar or all tagged files
  363.                  from archive.
  364.  
  365.   F9 or ALT-J  - jump to DOS.
  366.  
  367.   F10 or ESC   - Step back one archive when nested-viewing is used, or exit.
  368.  
  369.   SHIFT-F2     - Same as F2 only now you can enter an extraction-path.
  370.  
  371.   SHIFT-F9     - Print file under cursor-bar.
  372.  
  373.   CTRL-F1      - Toggle Ascending/Descending sorting.
  374.  
  375.   CTRL-F2      - Same as F2 only now the current directory is taken as
  376.                  extraction path.
  377.  
  378.   CTRL-F3      - Sort list on filename.
  379.  
  380.   CTRL-F4      - Sort list on extension.
  381.  
  382.   CTRL-F5      - Sort list on original size.
  383.  
  384.   CTRL-F6      - Sort list on compressed size.
  385.  
  386.   CTRL-F7      - Sort list on ratio.
  387.  
  388.   CTRL-F8      - Sort list on date/time.
  389.  
  390.   CTRL-F9      - Sort list on method.
  391.  
  392.   CTRL-F10     - Do not sort list (Unsorted).
  393.  
  394.   ALT-F3       - View file, same as F3, only now you can select a viewer to
  395.                  use from the viewers list.
  396.  
  397.   ALT-F4       - Edit file, same as F4, only now you can select a editor to
  398.                  use from thr editors list.
  399.  
  400.   ALT-F9       - Switch between EGA/VGA line mode (43 or 50) and 25 line mode.
  401.  
  402.   ALT-L        - Toggle between standard and alternate file-list-layout.
  403.  
  404.   INS or SPACE - Tag/Untag files.
  405.  
  406.   Gray +       - Wildcard selection.
  407.  
  408.   Gray -       - Wildcard de-selection.
  409.  
  410.   Gray *       - Revert selection.
  411.  
  412.   File-Selector Keys:
  413.   ───────────────────────────────────────────────────────────────────────────
  414.   F1           - Help, some info which keys you can use.
  415.  
  416.   F2           - Change drive/directory.
  417.  
  418.   F3 or ENTER  - Select a drive/directory or file to view.
  419.  
  420.   F6           - Rename directory/file.
  421.  
  422.   F7           - Create directory.
  423.  
  424.   F8 or DEL    - Delete directorys/files.
  425.  
  426.   F9 or ALT-J  - jump to DOS.
  427.  
  428.   F10 or ESC   - Quit.
  429.  
  430.   INS or SPACE - Tag/Untag files.
  431.  
  432.   Gray +       - Wildcard selection.
  433.  
  434.   Gray -       - Wildcard de-selection.
  435.  
  436.   Gray *       - Revert selection.
  437.  
  438. ┌─────────────────────────────────────────────────────────────────────────────┐
  439. │ ▒▒▒▒ Contact/Support ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  440. └─────────────────────────────────────────────────────────────────────────────┘
  441.  
  442.   For bug-reports, suggestions and other things concerning AVIEW you can
  443.   contact me at the following BBS:
  444.  
  445.     Action Board Zaandam
  446.     +31-(0)75-704890
  447.     1200, 2400 and 9600 HST V42/V42Bis.
  448.     Located in The Netherlands
  449.     24 Hours a day reachable.
  450.  
  451.   Just try to yell the sysop or write a message to me.
  452.  
  453.   I can also can be reached on COMPUSERVE under 100117,3242 (Chris Buijs).
  454.   COMPUSERVE can also be called for the latest version of AVIEW, it can
  455.   be found in the IBMSYS forum in library 6 (File Utilitys).
  456.   
  457.  
  458.                                         Have Fun,
  459.                     Chris Buijs
  460.