;------------------------------------------------------------------------------
; AVIEW V4.8 Help-Text, Copyright (C) 1992-95 by Chris Buijs.
; For correct operation: DON'T EDIT THIS FILE!!!!
;------------------------------------------------------------------------------
[Main]
┌──────────────────────────────────────────────────────────────────────┐
│                 The Norton Commander Archive Viewer                  │
│                  Copyright (C) 1992-95 by C. Buijs                   │
└──────────────────────────────────────────────────────────────────────┘

  Welcome to the AVIEW help-system, this help-system can be used as an
  on-line reference of all the functions of AVIEW.

  Choose the subject you want help on.

  Help on: #Archive-Lister#    #Input-Fields#    #Info#
           #AVIEW.CTL#         #Help#            #Credits#
           #File-Selector#     #Parameters#      #InterNet#
[Archive-Lister]
Archive-Lister Help
───────────────────
With the archive-lister you can view the contents of an ARC, ARJ, HYP,
LZH, PAK, RAR, SQZ, UC2, ZIP or ZOO archive (also there SFX variants),
the archive-lister also can view archives in archives (up to 16 deep).

The archive-viewer can be used to view files, edit files, or manipulate
archives.

#Archive-Lister Keys#
[Archive-Lister Keys]
Archive-Lister Keys
───────────────────
F1          - Help            CTRL-F1  - Ascend/Descend sorting
F2          - Extract         CTRL-F2  - Extract to current path
F3 or ENTER - View file       CTRL-F3  - Sort on name
F4          - Edit file       CTRL-F4  - Sort on extension
F5          - Convert         CTRL-F5  - Sort on original size
F6 or ALT-S - Sort list       CTRL-F6  - Sort on compressed size
F7          - Add file(s)     CTRL-F7  - Sort on ratio
F8 or DEL   - Delete file(s)  CTRL-F8  - Sort on date/time
F9 or ALT-J - DOS-Shell       CTRL-F9  - Sort on method
F10 or ESC  - Quit            CTRL-F10 - No sort (Unsorted)

Alpha-Numeric keys can be used for speed-search.

#Archive-Lister Keys 2#
[Archive-Lister Keys 2]
Archive-Lister Keys 2
─────────────────────
ALT-L       - Change screen-layout     SHIFT-F2  - Extract to any path
                                       SHIFT-F7  - Create file
UP/DOWN     - Go up/down one entry     SHIFT-F9  - Print file
HOME/END    - Go to begin/end of list  SHIFT-F10 - Print archive-list

INS/SPACE   - Tag/Untag files          ALT-F2    - Extract without paths
Gray +/-    - Wildcard Tag/Untag       ALT-F3    - Select viewer and view
Gray *      - Invert selections        ALT-F4    - Select editor and edit
                                       ALT-F9    - EGA/VGA Lines
ALT-X       - Exit AVIEW immidiate
[AVIEW.CTL]
AVIEW.CTL
─────────
AVIEW.CTL is an plain ascii-file that can be edited to fully configure
all the functions of AVIEW, the following commands are availble:

#Archiver-Commands#    #NOCOLOR#               #SORT#
#ASKDELETE#            #NOEMS#                 #SWAPMODE#
#ASKEXIT#              #NOENVTEMP#             #SWAPPATH#
#ASKSCAN#              #NOMOUSE#               #TEMPPATH#
#AUTOIGNORE#           #NOPATHS#               #TEMPREMOVE#
#DATEFORMAT#           #NOSNOW#                #VIEWER#
#EDITOR#               #NOXMS#                 #WAIT#
#EXTRACTPATH#          #SCANNER#
#FSSORT#               #SCREENMODE#
#IGNORE#               #SHOWSPECIAL#
[Archiver-Commands]
Archiver-Commands
─────────────────
With the following commands you can define the parameters that must
be used for the external archiver-utilities, the 'xxx' in the
commands must be replaced by ARC, ARJ, HYP, LHA, PAK, RAR, SQZ,
ZIP, UC2 or ZOO.

There are two variables, %A and %F, thes two must ALWAYS exist in one
of the commands (except xxxRESPONSE and xxxTEST), %A will be replaced
by AVIEW with the name of the archive processed, and %F with a
filename for adding, deleting and updating, note that AVIEW will
automatically add the response-file-char before the filename when
needed. The variables %A and %F are NOT optional!

#xxxADD#         #NOxxx#           #xxxRESPONSE#     #xxx_TO_xxx#
#xxxDELETE#      #xxxUNPACK#       #xxxSFX#
#xxxEXTRACT#     #xxxUPDATE#       #xxxTEST#
[NOPATHS]
NOPATHS
───────
With this command you instruct AVIEW to NOT extract any paths from
archives when the extract function is used.
[NOSNOW]
NOSNOW
──────
With this command you tell AVIEW to supress snow on (old) CGA-Cards.
[SWAPMODE]
SWAPMODE <Mode>
───────────────
With this command you tell AVIEW how to swap before an external
utility is executed, there are 5 modes:

0 - Swap to EMS/Disk.
1 - Swap to EMS/XMS/Disk (Default).
2 - Swap to XMS/Disk.
3 - Swap to XMS/EMS/Disk.
4 - Swap to Disk.
[SWAPPATH]
SWAPPATH <Path>
───────────────
With this command you define the directory where AVIEW must write
his swap-files when used, use a ramdisk to speed-up AVIEW.

#EXTRACTPATH#    #TEMPPATH#
[WAIT]
WAIT
────
With this command you force AVIEW to wait for a keypress after
each external utility executed.
[DATEFORMAT]
DATEFORMAT <Dateformat>
───────────────────────
With this statement you can define how the file-date is shown, include
MM for month, DD for day and YY for year, the sepparation-chars can be
freely defined, default is MM/DD/YY
[NOCOLOR]
NOCOLOR
───────
With this statement you force AVIEW in black and white mode, this can
be handy for laptop-users who have a LCD-Screen.
[NOEMS]
NOEMS
─────
With this statement you force AVIEW to NOT use any EMS memory.
[NOENVTEMP]
NOENVTEMP
─────────
With this statement you tell AVIEW to ignore the TEMP environment
variable.
[NOXMS]
NOXMS
─────
With this statement you force AVIEW to NOT use any XMS memory.
[NOMOUSE]
NOMOUSE
───────
With this statement you force AVIEW to ignore the mouse when detected.
[VIEWER]
VIEWER <Trigger> <Viewer> [<Parameters>]
────────────────────────────────────────
With this command you can define up to 64 viewers, with <Trigger> you
specify the file-specs which must trigger the viewer, the <Trigger>
may include wildcards. Default viewer when non-defined is WPVIEW for
all type of files.

The variable %F can be used to pass the file-name selected in AVIEW to
the viewer.

NOTE: You must specify the filename AND extension instead of only
      the extension as in previous versions of AVIEW.

#EDITOR#
[EDITOR]
EDITOR <Trigger> <Editor> [<Parameters>]
────────────────────────────────────────
With this command you can define up to 32 editors, with <Trigger> you
specify the file-specs which must trigger the editor, the <Trigger>
may include wildcards. Default editor when non-defined is NCEDIT for
all type of files.

The variable %F can be used to pass the file-name selected in AVIEW to
the editor.

NOTE: You must specify the filename AND extension instead of only
      the extension as in previous versions of AVIEW.

#VIEWER#
[EXTRACTPATH]
EXTRACTPATH <Path>
──────────────────
With this command you define the path where files must be extracted to,
when this command is NOT used, AVIEW will prompt you for a path.

#SWAPPATH#    #TEMPPATH#
[SCREENMODE]
SCREENMODE <Lines>
──────────────────
With this statement you can define how many lines per screen AVIEW must
use, valid number of lines are 25, 35, 40, 43 and 50, note that a
number greater than 25 needs a EGA of VGA display-adapter.
[SORT]
SORT <Key> [Ascending|Descending]
─────────────────────────────────
With this statement you can define how AVIEW must sort the archive-list
as default, valid sort-keys are: NAME, EXTENSION, ORGSIZE, CMPSIZE,
DATETIME, METHOD and UNSORTED, optional you can specify with ASCENDING
or DESCENDING the default sort direction, default is ASCENDING.
[FSSORT]
FSSORT <Key> [Ascending|Descending]
───────────────────────────────────
With this statement you can define how AVIEW must sort the file-selector
list as default, valid sort-keys are: NAME, EXTENSION, SIZE, DATETIME
and UNSORTED, optional you can specify with ASCENDING or DESCENDING
the default sort direction, default is ASCENDING.
[TEMPPATH]
TEMPPATH <Path>
───────────────
With this command you define the path AVIEW must use as work-directory,
this can be a ram-drive which will speed-up AVIEW dramatically, when
the directory does not exist, it will be created.

#EXTRACTPATH#    #SWAPPATH#    #TEMPREMOVE#
[TEMPREMOVE]
TEMPREMOVE
──────────
With this command you tell AVIEW to remove the complete TEMPPATH when
AVIEW is finished.

NOTE: All directories/files in the TEMPPATH will be deleted.

As default, AVIEW only deletes temporary files.

#TEMPPATH#
[SHOWSPECIAL]
SHOWSPECIAL
───────────
With this command you force AVIEW to use special 'hidden' files as
normal files, special 'hidden' files are for example the files
beginning with U$~ in an UC2 archive.

As default, AVIEW ignores special 'hidden' files.
[SCANNER]
SCANNER <Scanner> [<Parameters>]
────────────────────────────────
With this command you define the virus-scanner to use after files are
unpacked with the unpack function, when no scanner is defined, no
virus-scan will be performed.
[AUTOIGNORE]
AUTOIGNORE
──────────
With this command you tell AVIEW to ignore the extension defined with
the VIEWER command automatically.
[ASKSCAN]
ASKSCAN
───────
With this command you force AVIEW to ask you if the virus-scanner
must be executed after extracting files from an archive.
[ASKDELETE]
ASKDELETE
─────────
With this command you force AVIEW to ask you if you are sure when
deleting files.
[ASKEXIT]
ASKEXIT
───────
With this command you force AVIEW to ask you if you are sure when
exiting AVIEW.
[IGNORE]
IGNORE <File-Specs>
───────────────────
With this command you tell AVIEW to NOT determine the archive-type
of a file when it matches the <File-Specs>, when a file matches it
it is passed to an external viewer.
[xxxADD]
xxxADD <Command-Line>
─────────────────────
Defines which parameters to use for adding a file to an archive, this
is used for the ADD function.

#xxxDELETE#    #xxxEXTRACT#    #NOxxx#         #xxxTEST#
#xxxUNPACK#    #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
[xxxDELETE]
xxxDELETE <Command-Line>
────────────────────────
Defines which parameters to use for deleting a file or files from an
archive, this is used for the DELETE function

#xxxADD#       #xxxEXTRACT#    #NOxxx#         #xxxTEST#
#xxxUNPACK#    #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
[xxxEXTRACT]
xxxEXTRACT <Command-Line>
─────────────────────────
Defines which parameters to use for extracting a file or files from
an archive, this is used for the extract-function.

#xxxADD#       #xxxDELETE#     #NOxxx#         #xxxUNPACK#
#xxxTEST#      #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
[xxxUNPACK]
xxxUNPACK <Command-Line>
────────────────────────
Defines which parameters to use for extracting ONE file from an
archive WITHOUT path, this is used internally in AVIEW.

#xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
#xxxTEST#      #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
[xxxUPDATE]
xxxUPDATE <Command-Line>
────────────────────────
Defines which parameters to use for updating a file in an archive,
this is used after you edited a file from an archive.

#xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
#xxxTEST#      #xxxUNPACK#     #xxxRESPONSE#   #xxxSFX#
[xxxRESPONSE]
xxxRESPONSE <Response-Char>
───────────────────────────
Defines which charachter to use before a file name to tell the
archiver that it is a response file, AVIEW defines automatically
when to use this or not.

#xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
#xxxTEST#      #xxxUNPACK#     #xxxUPDATE#     #xxxSFX#
[NOxxx]
NOxxx
─────
Disable one of the supported archivers, the 'xxx' can be ARC,
ARJ, HYP, LZH, PAK, RAR, SQZ, UC2, ZIP or ZOO.
[xxxTEST]
xxxTEST
───────
Defines which parameters to use to test an archive.

#xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
#xxxRESPONSE#  #xxxUNPACK#     #xxxUPDATE#     #xxxSFX#
[xxxSFX]
xxxSFX
──────
Defines which parameters or external utility to use for creating
self-extracting (SFX) archives.

Syntax:  xxxSFX <Type> <Parameters|Command-Line>

For type you can define PARAM or EXEC, with PARAM you can define
the parameters to use with the xxxADD statement, with EXEC you
can define the command-line to execute.

#xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
#xxxRESPONSE#  #xxxUNPACK#     #xxxUPDATE#     #xxxTEST#
[xxx_TO_xxx]
xxx_TO_xxx
──────────
With this command you can define the external utility to use
to convert an archive from one archive-format to another.
[File-Selector]
File-Selector Help
──────────────────
The file-selector is started when AVIEW is started without any
file-specification or with a file-specification which contain
any wildcards (* or/and ?), with the file-selector you can pick
a file to view from any drive or directory.

The file-selector also has some file-manipulating functions to
manage your files.

Alpha-Numeric keys can be used for speed-search.

#File-Selector Keys#
[File-Selector Keys]
File-Selector Keys
──────────────────
F1          - Help                        Gray +/-  - Wildcard tag/untag
F2          - Change drive/directory      Gray *    - Invert selections
F3 or ENTER - View directory/file         INS/SPACE - Tag/Untag
F4          - Edit file
F5          - Convert archive             CTRL-F1   - Asc./Des. Sorting
F6          - Rename directory/file       CTRL-F2   - Filter
F7          - Create directory            CTRL-F3   - Sort on name
F8 or DEL   - Delete files/directories    CTRL-F4   - Sort on extension
F9 or ALT-J - DOS-Shell                   CTRL-F5   - Sort on size
F10 or ESC  - Quit                        CTRL-F8   - Sort on date/time
                                          CTRL-F10  - No sort (Unsorted)
#File-Selector Keys 2#
[File-Selector Keys 2]
File-Selector Keys 2
────────────────────
ALT-F3 - Select viewer and view file      LEFT-ARROW  - Parent directory
ALT-F4 - Select editor and edit file      RIGHT-ARROW - Enter directory
ALT-F5 - Compress files to archive        BACKSLASH   - go to ROOT dir.
ALT-F6 - DeCompress files from archive
ALT-F9 - EGA/VGA Lines

UP/DOWN     - Move cursor-bar up/down
HOME/END    - Move cursor-bar to begining/end of list
PGUP/PGDN   - Move cursor-bar one page up/down

ALT-S       - Sort listing
ALT-X       - Exit AVIEW immidiate
[Input-Fields]
Input-Fields Help
─────────────────
AVIEW uses it's own routines for getting input from the user,
this goes in a user-friendly manner, several options are
availble when AVIEW is waiting for some input.

#Input-Fields Keys#
[Input-Fields Keys]
Input-Fields Keys
─────────────────
F1         - Help, This Screen
F2         - File-selector

LEFT/RIGHT - Move cursor-bar left/right
HOME/END   - Move cursor-bar to begining/end of line

INS        - Switch between insert/overtype mode

DEL        - Delete char under cursor
BACKSPACE  - Delete char left of cursor
CTRL-Y     - Delete line
CTRL-HOME  - Delete from cursor to begin of line
CTRL-END   - Delete from cursor to end of line
[Help]
Help on the Help-System
───────────────────────
Use the cursor-keys to jump from topic to topic in the help-text,
press ENTER to go to the help-text about the topic, press ESC to
return to the previous help-screen.
[Parameters]
Parameters
──────────
Miscellaneous:                   Display:
/C  - Define .CTL file           /M  - Monochrome mode (LCD)
/NE - Don't use any EMS          /25 - Use 25 lines per screen
/NP - Don't extract paths        /35 - Use 35 lines per screen
/NT - Don't use TEMP variable    /40 - Use 40 lines per screen
/NV - Don't scan for viri        /43 - Use 43 lines per screen
/NX - Don't use any XMS          /50 - Use 50 lines per screen
/T  - Show ARC-Type (File-sel.)
/W  - Wait after shell
/!  - Display swapping msgs


#Syntax#   #File-Selector#   #Parameters 2#
[Parameters 2]
Parameters 2
────────────
Sorting:                         Swapping:
/A  - Sort acsending             /X0 - Swap to EMS/Disk
/D  - Sort descending            /X1 - Swap to EMS/XMS/Disk
/SC - Sort on compressed size    /X2 - Swap to XMS/Disk
/SD - Sort on date               /X3 - Swap to XMS/EMS/Disk
/SE - Sort on extension          /X4 - Swap to Disk
/SM - Sort on method
/SN - Sort on name
/SO - Sort on original size
/SR - Sort on ratio
/SU - Do not sort (Unsorted)     #Syntax#   #File-Selector#
[Syntax]
AVIEW Parameter Syntax
──────────────────────
AVIEW <FileSpec> /? /! /25 /35 /40 /43 /50 /A /C:<CTL-FILE> /D /M /NE
                    /NP /NT /NV /NX /SC /SD /SE /SM /SN /SO /SR /SU /T
                    /W /X0 /X1 /X2 /X3 /X4

All parameters are optional, when a file must be specified, it must
be the first parameter (may contain wildcards).
[Info]
Contacting the Author
─────────────────────
If you have suggestions, bug-reports or other things concerning AVIEW,
you can contact me (Chris Buijs) at:

BBS       : Action Board Zaandam, Tel: 31-(0)75-704890 (Also FAX!)

FidoNet   : Chris Buijs, Point: 2:280/407.16

CompuServe: Chris Buijs, ID: 100117,3242

#InterNet#  : cbuijs@xs4all.nl

SnailMail : Chris Buijs
            De Spil 22
            1507 CX Zaandam
            The Netherlands
[Credits]
Credits
───────
Hereby i want to thank all alpha/beta/gamma-testers (all over the
world) for there support and suggestions, keep up the good work!

Special thanks go to:

Jonas I. Hammerberg for a registered copy of Squeeze-It!

Michael Cookson and Xenophon Tsakanikas for making AVIEW
availble on #InterNet#.
[INTERNET]
INTERNET
────────
AVIEW can be downloaded from the following Anonymous FTP-Sites:

ftp.iaccess.za:/pub/bbsing/longword


Or on World Wide Web (WWW):

http://www.xs4all.nl/~cbuijs/html/longword.htm
;------------------------------------------------------------------------------
; EOF
