home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / utilities / dirutils / visualshell / readme < prev    next >
Encoding:
Text File  |  1992-10-28  |  7.1 KB  |  210 lines
  1.         Visual Shell (VSh) v1.17
  2.         ========================
  3.  
  4. Copyright:
  5. ----------
  6.  
  7.       © Copyright 1992, Freeware, All rights reserved
  8.  
  9.    Distribution EXCLUSIVELY permitted to Fred Fish for his PD software
  10.    library. Distribution via FTP allowed too. Other forms of distribution
  11.    need the permission of the author.
  12.  
  13.    No guarantee of any kind is made that this program is 100% reliable.
  14.    You use it on your own risk.
  15.  
  16.  
  17. Preface:
  18. --------
  19.  
  20. VSh is a sort of disk utility, but unlike other tools of this kind it
  21. doesn't open a new window or screen for its own, but VSh shares the console
  22. window with the CLI it was started from. VSh is fully keyboard driven and
  23. makes NO use of the mouse. The inspiration for VSh was the well known MS Dos
  24. tool NORTON COMMANDER.
  25.  
  26.  
  27. Informations:
  28. -------------
  29.  
  30. VSh can be started from any CLI or shell, e.g. WShell, AShell or NewShell.
  31. To use VSh you must run the shareware console handler ConMan written by
  32. William S. Hawes and have a copy of the ARP library in the directory libs:
  33. before running the program.
  34.  
  35. VSh overlays the CLI or Shell window and the user work with it in the
  36. normal way. The reduced CLI output area can be enlarged at any time by
  37. turning off the file requesters of VSh (F1). For command input VSh uses the
  38. function keys, ESC, HELP and the numeric pad keys. With the configuration
  39. menu (Shift+Alt+Help) the position and size of the CLI window, the number
  40. of CLI lines and other features can be changed.
  41.  
  42. VSh supports command line arguments, e.g. the option HIDE to start VSh with
  43. file requesters turned off. The command line template can be displayed with
  44. the standard keyword '?' (vsh ?).
  45.  
  46. Vsh consist of two parts. The first part found in directory 'c' is called
  47. 'VSh' and the second part found in directory 'l' is called 'VShSegment'.
  48. VShSegment is the main program, which will be made resident by the start up
  49. code VSh. The resident part can be removed from memory with the option
  50. REMOVE of VSh.
  51.  
  52.  
  53. Main function keys:
  54. -------------------
  55.  
  56. F1  = toggle display mode, switch between SHOW and HIDE mode
  57. F2  = copy active file requester to nonactive one
  58. F3  = view selected file as ASCII or hex dump
  59. F4  = edit selected file, call external editor
  60. F5  = copy marked files from active to nonactive file requester
  61. F6  = move or rename marked files from active to nonactive file requester
  62. F7  = make new directory in active file requester
  63. F8  = delete marked files from active file requester
  64. F9  = show ConMan command line history
  65. F10 = quit VSh
  66. F11 = show devices, assigns and volumes in active file requester
  67. F12 = show infos about other file requester in active one
  68. F13 = show contents of selected file in active file requester
  69. F14 = search file by pattern, start from path given in active file requester
  70. F15 = new filter pattern for active file requester
  71. F16 = build directory tree for device in active file requester
  72. F17 = compare contents of both file requesters
  73.  
  74. ALT F1
  75.  :      = user defined functions
  76. ALT F10
  77.  
  78. SHIFT ALT F1 = change user defined functions, special symbols:
  79.  :                [] -> insert selected file name at this position
  80.  :                ;  -> delimiter for function key name (max. 6 chars)
  81. SHIFT ALT F10  example: run copy [] prt:;Print
  82.  
  83.  
  84. View function keys:
  85. -------------------
  86.  
  87. F1  = jump to line specified by number
  88. F2  = search string in file (hex string with a leading $)
  89. F3  = continue searching with same search string
  90. F4  = toggle view mode (ASCII or hex dump)
  91. F5  = send current page to printer
  92. F6  = send whole text to printer
  93. F10 = quit view
  94.  
  95.  
  96. History function keys:
  97. ----------------------
  98.  
  99. F1  = jump to line specified by number
  100. F2  = search string in history
  101. F3  = continue searching with same search string
  102. F4  = send current page to printer
  103. F5  = send whole history to printer
  104. F10 = quit history
  105.  
  106.  
  107. Configuration function keys:
  108. ----------------------------
  109.  
  110. F1  = load old configuration file 's:VSh.Config'
  111. F2  = save new configuration file 's:VSh.Config'
  112. F3  = use default configuration
  113. F4  = use selected configuration
  114. F10 = quit configuration
  115.  
  116.  
  117. Numeric pad keys:
  118. -----------------
  119.  
  120. 1       = move cursor in file list to bottom of list
  121. 2       = move cursor in file list down by one entry
  122. 3       = move cursor in file list down by one page
  123. 4       = read parent directory
  124. 5       = read current directory once again
  125. 6       = read directory under cursor
  126. 7       = move cursor in file list to top of list
  127. 8       = move cursor in file list up by one entry
  128. 9       = move cursor in file list up by one page
  129. 0       = mark or unmark selected entry in active file requester
  130. .       = insert file name in command line
  131. -       = select entries to mark by pattern (* = mark all)
  132. ENTER   = run file, execute script or enter directory under cursor
  133. SHIFT 4 = read root directory
  134. SHIFT 6 = read directory under cursor to nonactive file requester
  135. SHIFT 0 = unmark all selected entries
  136. SHIFT . = insert file name with full path in command line
  137. SHIFT - = select entries to unmark by pattern (* = unmark all)
  138. ALT -   = toggle num lock for normal numeric key pad
  139.  
  140.  
  141. Other keys:
  142. -----------
  143.  
  144. TAB            = toggle active file requester
  145. HELP           = show this help pages
  146. SHIFT HELP     = show about page
  147. SHIFT ALT HELP = change configuration
  148. ALT <Taste>    = speed search, use <SHIFT ENTER> to continue searching
  149. ESC            = quit any function
  150.  
  151.  
  152. Configuration menu:
  153. -------------------
  154.  
  155. Left edge                = horizontal position of left upper edge of VSh
  156.                            window
  157. Top Edge                 = vertical position of left upper edge of VSh
  158.                            window
  159. Width                    = width of VSh window
  160. Height                   = height of VSh window
  161. Number of CLI lines      = number of CLI lines (min file requester
  162.                lines = 14)
  163. Scroll speed             = scroll speed (1 = slow, 2 = normal, 3 = fast)
  164. Keyboard type            = keyboard type (1 = A1000, 2 = A500, A2000, A2500
  165.                            or A3000), used for numeric key pad mapping
  166. Dump mode                = displayed characters in view or quick view mode
  167.                            (1 = all characters, 2 = no control characters
  168.                            [0-31 and 128-159], 3 = only ASCII characters
  169.                            [32-126])
  170. Path for editor          = full path name for external editor
  171. Options for editor       = additional options for editor, e.g. STICKY for
  172.                            TxEd+
  173.  
  174.  
  175. Patterns:
  176. ---------
  177.  
  178. VSh uses the pattern matching function of the ARP library. All valid
  179. AmigaDOS and Unix wild cards and combinations from both are possible.
  180.  
  181.    Attention: Patterns are case sensitive !!!
  182.  
  183.    AmigaDos: # ? ( | )
  184.    Unix    : * ? ( | ) [ ] ~
  185.  
  186.    Example: ~(*.info|*.INFO) = select all files without the extension
  187.                                '.info' AND '*.INFO'
  188.             *.[cC]           = select all files with the extension '.c' OR
  189.                                '.C'
  190.  
  191. Requirements:
  192. -------------
  193.  
  194. - Shareware Console Handler `ConMan' v1.3+ from William S. Hawes
  195. - arp.library v39+
  196.  
  197.  
  198. Author:
  199. -------
  200.  
  201.    Torsten Jürgeleit
  202.    Am Sandberg 4
  203.    W-5270 Gummersbach
  204.    Germany
  205.    Phone: ++49 2261 27400
  206.  
  207.    Bug reports, flames, donations etc. are welcome !
  208.    I may be reached via eMail: mike@miba.obb.sub.org
  209.    Since this is a neighbour, it may take some time to answer :)
  210.