home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / dos / tools / ncav48bd / aview.hlp < prev    next >
Text File  |  1995-06-17  |  18KB  |  506 lines

  1. ;------------------------------------------------------------------------------
  2. ; AVIEW V4.8 Help-Text, Copyright (C) 1992-95 by Chris Buijs.
  3. ; For correct operation: DON'T EDIT THIS FILE!!!!
  4. ;------------------------------------------------------------------------------
  5. [Main]
  6. ┌──────────────────────────────────────────────────────────────────────┐
  7. │                 The Norton Commander Archive Viewer                  │
  8. │                  Copyright (C) 1992-95 by C. Buijs                   │
  9. └──────────────────────────────────────────────────────────────────────┘
  10.  
  11.   Welcome to the AVIEW help-system, this help-system can be used as an
  12.   on-line reference of all the functions of AVIEW.
  13.  
  14.   Choose the subject you want help on.
  15.  
  16.   Help on: #Archive-Lister#    #Input-Fields#    #Info#
  17.            #AVIEW.CTL#         #Help#            #Credits#
  18.            #File-Selector#     #Parameters#      #InterNet#
  19. [Archive-Lister]
  20. Archive-Lister Help
  21. ───────────────────
  22. With the archive-lister you can view the contents of an ARC, ARJ, HYP,
  23. LZH, PAK, RAR, SQZ, UC2, ZIP or ZOO archive (also there SFX variants),
  24. the archive-lister also can view archives in archives (up to 16 deep).
  25.  
  26. The archive-viewer can be used to view files, edit files, or manipulate
  27. archives.
  28.  
  29. #Archive-Lister Keys#
  30. [Archive-Lister Keys]
  31. Archive-Lister Keys
  32. ───────────────────
  33. F1          - Help            CTRL-F1  - Ascend/Descend sorting
  34. F2          - Extract         CTRL-F2  - Extract to current path
  35. F3 or ENTER - View file       CTRL-F3  - Sort on name
  36. F4          - Edit file       CTRL-F4  - Sort on extension
  37. F5          - Convert         CTRL-F5  - Sort on original size
  38. F6 or ALT-S - Sort list       CTRL-F6  - Sort on compressed size
  39. F7          - Add file(s)     CTRL-F7  - Sort on ratio
  40. F8 or DEL   - Delete file(s)  CTRL-F8  - Sort on date/time
  41. F9 or ALT-J - DOS-Shell       CTRL-F9  - Sort on method
  42. F10 or ESC  - Quit            CTRL-F10 - No sort (Unsorted)
  43.  
  44. Alpha-Numeric keys can be used for speed-search.
  45.  
  46. #Archive-Lister Keys 2#
  47. [Archive-Lister Keys 2]
  48. Archive-Lister Keys 2
  49. ─────────────────────
  50. ALT-L       - Change screen-layout     SHIFT-F2  - Extract to any path
  51.                                        SHIFT-F7  - Create file
  52. UP/DOWN     - Go up/down one entry     SHIFT-F9  - Print file
  53. HOME/END    - Go to begin/end of list  SHIFT-F10 - Print archive-list
  54.  
  55. INS/SPACE   - Tag/Untag files          ALT-F2    - Extract without paths
  56. Gray +/-    - Wildcard Tag/Untag       ALT-F3    - Select viewer and view
  57. Gray *      - Invert selections        ALT-F4    - Select editor and edit
  58.                                        ALT-F9    - EGA/VGA Lines
  59. ALT-X       - Exit AVIEW immidiate
  60. [AVIEW.CTL]
  61. AVIEW.CTL
  62. ─────────
  63. AVIEW.CTL is an plain ascii-file that can be edited to fully configure
  64. all the functions of AVIEW, the following commands are availble:
  65.  
  66. #Archiver-Commands#    #NOCOLOR#               #SORT#
  67. #ASKDELETE#            #NOEMS#                 #SWAPMODE#
  68. #ASKEXIT#              #NOENVTEMP#             #SWAPPATH#
  69. #ASKSCAN#              #NOMOUSE#               #TEMPPATH#
  70. #AUTOIGNORE#           #NOPATHS#               #TEMPREMOVE#
  71. #DATEFORMAT#           #NOSNOW#                #VIEWER#
  72. #EDITOR#               #NOXMS#                 #WAIT#
  73. #EXTRACTPATH#          #SCANNER#
  74. #FSSORT#               #SCREENMODE#
  75. #IGNORE#               #SHOWSPECIAL#
  76. [Archiver-Commands]
  77. Archiver-Commands
  78. ─────────────────
  79. With the following commands you can define the parameters that must
  80. be used for the external archiver-utilities, the 'xxx' in the
  81. commands must be replaced by ARC, ARJ, HYP, LHA, PAK, RAR, SQZ,
  82. ZIP, UC2 or ZOO.
  83.  
  84. There are two variables, %A and %F, thes two must ALWAYS exist in one
  85. of the commands (except xxxRESPONSE and xxxTEST), %A will be replaced
  86. by AVIEW with the name of the archive processed, and %F with a
  87. filename for adding, deleting and updating, note that AVIEW will
  88. automatically add the response-file-char before the filename when
  89. needed. The variables %A and %F are NOT optional!
  90.  
  91. #xxxADD#         #NOxxx#           #xxxRESPONSE#     #xxx_TO_xxx#
  92. #xxxDELETE#      #xxxUNPACK#       #xxxSFX#
  93. #xxxEXTRACT#     #xxxUPDATE#       #xxxTEST#
  94. [NOPATHS]
  95. NOPATHS
  96. ───────
  97. With this command you instruct AVIEW to NOT extract any paths from
  98. archives when the extract function is used.
  99. [NOSNOW]
  100. NOSNOW
  101. ──────
  102. With this command you tell AVIEW to supress snow on (old) CGA-Cards.
  103. [SWAPMODE]
  104. SWAPMODE <Mode>
  105. ───────────────
  106. With this command you tell AVIEW how to swap before an external
  107. utility is executed, there are 5 modes:
  108.  
  109. 0 - Swap to EMS/Disk.
  110. 1 - Swap to EMS/XMS/Disk (Default).
  111. 2 - Swap to XMS/Disk.
  112. 3 - Swap to XMS/EMS/Disk.
  113. 4 - Swap to Disk.
  114. [SWAPPATH]
  115. SWAPPATH <Path>
  116. ───────────────
  117. With this command you define the directory where AVIEW must write
  118. his swap-files when used, use a ramdisk to speed-up AVIEW.
  119.  
  120. #EXTRACTPATH#    #TEMPPATH#
  121. [WAIT]
  122. WAIT
  123. ────
  124. With this command you force AVIEW to wait for a keypress after
  125. each external utility executed.
  126. [DATEFORMAT]
  127. DATEFORMAT <Dateformat>
  128. ───────────────────────
  129. With this statement you can define how the file-date is shown, include
  130. MM for month, DD for day and YY for year, the sepparation-chars can be
  131. freely defined, default is MM/DD/YY
  132. [NOCOLOR]
  133. NOCOLOR
  134. ───────
  135. With this statement you force AVIEW in black and white mode, this can
  136. be handy for laptop-users who have a LCD-Screen.
  137. [NOEMS]
  138. NOEMS
  139. ─────
  140. With this statement you force AVIEW to NOT use any EMS memory.
  141. [NOENVTEMP]
  142. NOENVTEMP
  143. ─────────
  144. With this statement you tell AVIEW to ignore the TEMP environment
  145. variable.
  146. [NOXMS]
  147. NOXMS
  148. ─────
  149. With this statement you force AVIEW to NOT use any XMS memory.
  150. [NOMOUSE]
  151. NOMOUSE
  152. ───────
  153. With this statement you force AVIEW to ignore the mouse when detected.
  154. [VIEWER]
  155. VIEWER <Trigger> <Viewer> [<Parameters>]
  156. ────────────────────────────────────────
  157. With this command you can define up to 64 viewers, with <Trigger> you
  158. specify the file-specs which must trigger the viewer, the <Trigger>
  159. may include wildcards. Default viewer when non-defined is WPVIEW for
  160. all type of files.
  161.  
  162. The variable %F can be used to pass the file-name selected in AVIEW to
  163. the viewer.
  164.  
  165. NOTE: You must specify the filename AND extension instead of only
  166.       the extension as in previous versions of AVIEW.
  167.  
  168. #EDITOR#
  169. [EDITOR]
  170. EDITOR <Trigger> <Editor> [<Parameters>]
  171. ────────────────────────────────────────
  172. With this command you can define up to 32 editors, with <Trigger> you
  173. specify the file-specs which must trigger the editor, the <Trigger>
  174. may include wildcards. Default editor when non-defined is NCEDIT for
  175. all type of files.
  176.  
  177. The variable %F can be used to pass the file-name selected in AVIEW to
  178. the editor.
  179.  
  180. NOTE: You must specify the filename AND extension instead of only
  181.       the extension as in previous versions of AVIEW.
  182.  
  183. #VIEWER#
  184. [EXTRACTPATH]
  185. EXTRACTPATH <Path>
  186. ──────────────────
  187. With this command you define the path where files must be extracted to,
  188. when this command is NOT used, AVIEW will prompt you for a path.
  189.  
  190. #SWAPPATH#    #TEMPPATH#
  191. [SCREENMODE]
  192. SCREENMODE <Lines>
  193. ──────────────────
  194. With this statement you can define how many lines per screen AVIEW must
  195. use, valid number of lines are 25, 35, 40, 43 and 50, note that a
  196. number greater than 25 needs a EGA of VGA display-adapter.
  197. [SORT]
  198. SORT <Key> [Ascending|Descending]
  199. ─────────────────────────────────
  200. With this statement you can define how AVIEW must sort the archive-list
  201. as default, valid sort-keys are: NAME, EXTENSION, ORGSIZE, CMPSIZE,
  202. DATETIME, METHOD and UNSORTED, optional you can specify with ASCENDING
  203. or DESCENDING the default sort direction, default is ASCENDING.
  204. [FSSORT]
  205. FSSORT <Key> [Ascending|Descending]
  206. ───────────────────────────────────
  207. With this statement you can define how AVIEW must sort the file-selector
  208. list as default, valid sort-keys are: NAME, EXTENSION, SIZE, DATETIME
  209. and UNSORTED, optional you can specify with ASCENDING or DESCENDING
  210. the default sort direction, default is ASCENDING.
  211. [TEMPPATH]
  212. TEMPPATH <Path>
  213. ───────────────
  214. With this command you define the path AVIEW must use as work-directory,
  215. this can be a ram-drive which will speed-up AVIEW dramatically, when
  216. the directory does not exist, it will be created.
  217.  
  218. #EXTRACTPATH#    #SWAPPATH#    #TEMPREMOVE#
  219. [TEMPREMOVE]
  220. TEMPREMOVE
  221. ──────────
  222. With this command you tell AVIEW to remove the complete TEMPPATH when
  223. AVIEW is finished.
  224.  
  225. NOTE: All directories/files in the TEMPPATH will be deleted.
  226.  
  227. As default, AVIEW only deletes temporary files.
  228.  
  229. #TEMPPATH#
  230. [SHOWSPECIAL]
  231. SHOWSPECIAL
  232. ───────────
  233. With this command you force AVIEW to use special 'hidden' files as
  234. normal files, special 'hidden' files are for example the files
  235. beginning with U$~ in an UC2 archive.
  236.  
  237. As default, AVIEW ignores special 'hidden' files.
  238. [SCANNER]
  239. SCANNER <Scanner> [<Parameters>]
  240. ────────────────────────────────
  241. With this command you define the virus-scanner to use after files are
  242. unpacked with the unpack function, when no scanner is defined, no
  243. virus-scan will be performed.
  244. [AUTOIGNORE]
  245. AUTOIGNORE
  246. ──────────
  247. With this command you tell AVIEW to ignore the extension defined with
  248. the VIEWER command automatically.
  249. [ASKSCAN]
  250. ASKSCAN
  251. ───────
  252. With this command you force AVIEW to ask you if the virus-scanner
  253. must be executed after extracting files from an archive.
  254. [ASKDELETE]
  255. ASKDELETE
  256. ─────────
  257. With this command you force AVIEW to ask you if you are sure when
  258. deleting files.
  259. [ASKEXIT]
  260. ASKEXIT
  261. ───────
  262. With this command you force AVIEW to ask you if you are sure when
  263. exiting AVIEW.
  264. [IGNORE]
  265. IGNORE <File-Specs>
  266. ───────────────────
  267. With this command you tell AVIEW to NOT determine the archive-type
  268. of a file when it matches the <File-Specs>, when a file matches it
  269. it is passed to an external viewer.
  270. [xxxADD]
  271. xxxADD <Command-Line>
  272. ─────────────────────
  273. Defines which parameters to use for adding a file to an archive, this
  274. is used for the ADD function.
  275.  
  276. #xxxDELETE#    #xxxEXTRACT#    #NOxxx#         #xxxTEST#
  277. #xxxUNPACK#    #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
  278. [xxxDELETE]
  279. xxxDELETE <Command-Line>
  280. ────────────────────────
  281. Defines which parameters to use for deleting a file or files from an
  282. archive, this is used for the DELETE function
  283.  
  284. #xxxADD#       #xxxEXTRACT#    #NOxxx#         #xxxTEST#
  285. #xxxUNPACK#    #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
  286. [xxxEXTRACT]
  287. xxxEXTRACT <Command-Line>
  288. ─────────────────────────
  289. Defines which parameters to use for extracting a file or files from
  290. an archive, this is used for the extract-function.
  291.  
  292. #xxxADD#       #xxxDELETE#     #NOxxx#         #xxxUNPACK#
  293. #xxxTEST#      #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
  294. [xxxUNPACK]
  295. xxxUNPACK <Command-Line>
  296. ────────────────────────
  297. Defines which parameters to use for extracting ONE file from an
  298. archive WITHOUT path, this is used internally in AVIEW.
  299.  
  300. #xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
  301. #xxxTEST#      #xxxUPDATE#     #xxxRESPONSE#   #xxxSFX#
  302. [xxxUPDATE]
  303. xxxUPDATE <Command-Line>
  304. ────────────────────────
  305. Defines which parameters to use for updating a file in an archive,
  306. this is used after you edited a file from an archive.
  307.  
  308. #xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
  309. #xxxTEST#      #xxxUNPACK#     #xxxRESPONSE#   #xxxSFX#
  310. [xxxRESPONSE]
  311. xxxRESPONSE <Response-Char>
  312. ───────────────────────────
  313. Defines which charachter to use before a file name to tell the
  314. archiver that it is a response file, AVIEW defines automatically
  315. when to use this or not.
  316.  
  317. #xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
  318. #xxxTEST#      #xxxUNPACK#     #xxxUPDATE#     #xxxSFX#
  319. [NOxxx]
  320. NOxxx
  321. ─────
  322. Disable one of the supported archivers, the 'xxx' can be ARC,
  323. ARJ, HYP, LZH, PAK, RAR, SQZ, UC2, ZIP or ZOO.
  324. [xxxTEST]
  325. xxxTEST
  326. ───────
  327. Defines which parameters to use to test an archive.
  328.  
  329. #xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
  330. #xxxRESPONSE#  #xxxUNPACK#     #xxxUPDATE#     #xxxSFX#
  331. [xxxSFX]
  332. xxxSFX
  333. ──────
  334. Defines which parameters or external utility to use for creating
  335. self-extracting (SFX) archives.
  336.  
  337. Syntax:  xxxSFX <Type> <Parameters|Command-Line>
  338.  
  339. For type you can define PARAM or EXEC, with PARAM you can define
  340. the parameters to use with the xxxADD statement, with EXEC you
  341. can define the command-line to execute.
  342.  
  343. #xxxADD#       #xxxDELETE#     #xxxEXTRACT#    #NOxxx#
  344. #xxxRESPONSE#  #xxxUNPACK#     #xxxUPDATE#     #xxxTEST#
  345. [xxx_TO_xxx]
  346. xxx_TO_xxx
  347. ──────────
  348. With this command you can define the external utility to use
  349. to convert an archive from one archive-format to another.
  350. [File-Selector]
  351. File-Selector Help
  352. ──────────────────
  353. The file-selector is started when AVIEW is started without any
  354. file-specification or with a file-specification which contain
  355. any wildcards (* or/and ?), with the file-selector you can pick
  356. a file to view from any drive or directory.
  357.  
  358. The file-selector also has some file-manipulating functions to
  359. manage your files.
  360.  
  361. Alpha-Numeric keys can be used for speed-search.
  362.  
  363. #File-Selector Keys#
  364. [File-Selector Keys]
  365. File-Selector Keys
  366. ──────────────────
  367. F1          - Help                        Gray +/-  - Wildcard tag/untag
  368. F2          - Change drive/directory      Gray *    - Invert selections
  369. F3 or ENTER - View directory/file         INS/SPACE - Tag/Untag
  370. F4          - Edit file
  371. F5          - Convert archive             CTRL-F1   - Asc./Des. Sorting
  372. F6          - Rename directory/file       CTRL-F2   - Filter
  373. F7          - Create directory            CTRL-F3   - Sort on name
  374. F8 or DEL   - Delete files/directories    CTRL-F4   - Sort on extension
  375. F9 or ALT-J - DOS-Shell                   CTRL-F5   - Sort on size
  376. F10 or ESC  - Quit                        CTRL-F8   - Sort on date/time
  377.                                           CTRL-F10  - No sort (Unsorted)
  378. #File-Selector Keys 2#
  379. [File-Selector Keys 2]
  380. File-Selector Keys 2
  381. ────────────────────
  382. ALT-F3 - Select viewer and view file      LEFT-ARROW  - Parent directory
  383. ALT-F4 - Select editor and edit file      RIGHT-ARROW - Enter directory
  384. ALT-F5 - Compress files to archive        BACKSLASH   - go to ROOT dir.
  385. ALT-F6 - DeCompress files from archive
  386. ALT-F9 - EGA/VGA Lines
  387.  
  388. UP/DOWN     - Move cursor-bar up/down
  389. HOME/END    - Move cursor-bar to begining/end of list
  390. PGUP/PGDN   - Move cursor-bar one page up/down
  391.  
  392. ALT-S       - Sort listing
  393. ALT-X       - Exit AVIEW immidiate
  394. [Input-Fields]
  395. Input-Fields Help
  396. ─────────────────
  397. AVIEW uses it's own routines for getting input from the user,
  398. this goes in a user-friendly manner, several options are
  399. availble when AVIEW is waiting for some input.
  400.  
  401. #Input-Fields Keys#
  402. [Input-Fields Keys]
  403. Input-Fields Keys
  404. ─────────────────
  405. F1         - Help, This Screen
  406. F2         - File-selector
  407.  
  408. LEFT/RIGHT - Move cursor-bar left/right
  409. HOME/END   - Move cursor-bar to begining/end of line
  410.  
  411. INS        - Switch between insert/overtype mode
  412.  
  413. DEL        - Delete char under cursor
  414. BACKSPACE  - Delete char left of cursor
  415. CTRL-Y     - Delete line
  416. CTRL-HOME  - Delete from cursor to begin of line
  417. CTRL-END   - Delete from cursor to end of line
  418. [Help]
  419. Help on the Help-System
  420. ───────────────────────
  421. Use the cursor-keys to jump from topic to topic in the help-text,
  422. press ENTER to go to the help-text about the topic, press ESC to
  423. return to the previous help-screen.
  424. [Parameters]
  425. Parameters
  426. ──────────
  427. Miscellaneous:                   Display:
  428. /C  - Define .CTL file           /M  - Monochrome mode (LCD)
  429. /NE - Don't use any EMS          /25 - Use 25 lines per screen
  430. /NP - Don't extract paths        /35 - Use 35 lines per screen
  431. /NT - Don't use TEMP variable    /40 - Use 40 lines per screen
  432. /NV - Don't scan for viri        /43 - Use 43 lines per screen
  433. /NX - Don't use any XMS          /50 - Use 50 lines per screen
  434. /T  - Show ARC-Type (File-sel.)
  435. /W  - Wait after shell
  436. /!  - Display swapping msgs
  437.  
  438.  
  439. #Syntax#   #File-Selector#   #Parameters 2#
  440. [Parameters 2]
  441. Parameters 2
  442. ────────────
  443. Sorting:                         Swapping:
  444. /A  - Sort acsending             /X0 - Swap to EMS/Disk
  445. /D  - Sort descending            /X1 - Swap to EMS/XMS/Disk
  446. /SC - Sort on compressed size    /X2 - Swap to XMS/Disk
  447. /SD - Sort on date               /X3 - Swap to XMS/EMS/Disk
  448. /SE - Sort on extension          /X4 - Swap to Disk
  449. /SM - Sort on method
  450. /SN - Sort on name
  451. /SO - Sort on original size
  452. /SR - Sort on ratio
  453. /SU - Do not sort (Unsorted)     #Syntax#   #File-Selector#
  454. [Syntax]
  455. AVIEW Parameter Syntax
  456. ──────────────────────
  457. AVIEW <FileSpec> /? /! /25 /35 /40 /43 /50 /A /C:<CTL-FILE> /D /M /NE
  458.                     /NP /NT /NV /NX /SC /SD /SE /SM /SN /SO /SR /SU /T
  459.                     /W /X0 /X1 /X2 /X3 /X4
  460.  
  461. All parameters are optional, when a file must be specified, it must
  462. be the first parameter (may contain wildcards).
  463. [Info]
  464. Contacting the Author
  465. ─────────────────────
  466. If you have suggestions, bug-reports or other things concerning AVIEW,
  467. you can contact me (Chris Buijs) at:
  468.  
  469. BBS       : Action Board Zaandam, Tel: 31-(0)75-704890 (Also FAX!)
  470.  
  471. FidoNet   : Chris Buijs, Point: 2:280/407.16
  472.  
  473. CompuServe: Chris Buijs, ID: 100117,3242
  474.  
  475. #InterNet#  : cbuijs@xs4all.nl
  476.  
  477. SnailMail : Chris Buijs
  478.             De Spil 22
  479.             1507 CX Zaandam
  480.             The Netherlands
  481. [Credits]
  482. Credits
  483. ───────
  484. Hereby i want to thank all alpha/beta/gamma-testers (all over the
  485. world) for there support and suggestions, keep up the good work!
  486.  
  487. Special thanks go to:
  488.  
  489. Jonas I. Hammerberg for a registered copy of Squeeze-It!
  490.  
  491. Michael Cookson and Xenophon Tsakanikas for making AVIEW
  492. availble on #InterNet#.
  493. [INTERNET]
  494. INTERNET
  495. ────────
  496. AVIEW can be downloaded from the following Anonymous FTP-Sites:
  497.  
  498. ftp.iaccess.za:/pub/bbsing/longword
  499.  
  500.  
  501. Or on World Wide Web (WWW):
  502.  
  503. http://www.xs4all.nl/~cbuijs/html/longword.htm
  504. ;------------------------------------------------------------------------------
  505. ; EOF
  506.