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