Visual Shell (VSh) v1.17 ======================== Copyright: ---------- © Copyright 1992, Freeware, All rights reserved Distribution EXCLUSIVELY permitted to Fred Fish for his PD software library and TIME (A.P.S. -electronic-). Distribution via FTP allowed too. Other forms of distribution need the permission of the author. No guarantee of any kind is made that this program is 100% reliable. You use it on your own risk. Preface: -------- VSh is a sort of disk utility, but unlike other tools of this kind it doesn't open a new window or screen for its own, but VSh shares the console window with the CLI it was started from. VSh is fully keyboard driven and makes NO use of the mouse. The inspiration for VSh was the well known MS Dos tool NORTON COMMANDER. Informations: ------------- VSh can be started from any CLI or shell, e.g. WShell, AShell or NewShell. To use VSh you must run the shareware console handler ConMan written by William S. Hawes and have a copy of the ARP library in the directory libs: before running the program. VSh overlays the CLI or Shell window and the user work with it in the normal way. The reduced CLI output area can be enlarged at any time by turning off the file requesters of VSh (F1). For command input VSh uses the function keys, ESC, HELP and the numeric pad keys. With the configuration menu (Shift+Alt+Help) the position and size of the CLI window, the number of CLI lines and other features can be changed. VSh supports command line arguments, e.g. the option HIDE to start VSh with file requesters turned off. The command line template can be displayed with the standard keyword '?' (vsh ?). Vsh consist of two parts. The first part found in directory 'c' is called 'VSh' and the second part found in directory 'l' is called 'VShSegment'. VShSegment is the main program, which will be made resident by the start up code VSh. The resident part can be removed from memory with the option REMOVE of VSh. Main function keys: ------------------- F1 = toggle display mode, switch between SHOW and HIDE mode F2 = copy active file requester to nonactive one F3 = view selected file as ASCII or hex dump F4 = edit selected file, call external editor F5 = copy marked files from active to nonactive file requester F6 = move or rename marked files from active to nonactive file requester F7 = make new directory in active file requester F8 = delete marked files from active file requester F9 = show ConMan command line history F10 = quit VSh F11 = show devices, assigns and volumes in active file requester F12 = show infos about other file requester in active one F13 = show contents of selected file in active file requester F14 = search file by pattern, start from path given in active file requester F15 = new filter pattern for active file requester F16 = build directory tree for device in active file requester F17 = compare contents of both file requesters ALT F1 : = user defined functions ALT F10 SHIFT ALT F1 = change user defined functions, special symbols: : [] -> insert selected file name at this position : ; -> delimiter for function key name (max. 6 chars) SHIFT ALT F10 example: run copy [] prt:;Print View function keys: ------------------- F1 = jump to line specified by number F2 = search string in file (hex string with a leading $) F3 = continue searching with same search string F4 = toggle view mode (ASCII or hex dump) F5 = send current page to printer F6 = send whole text to printer F10 = quit view History function keys: ---------------------- F1 = jump to line specified by number F2 = search string in history F3 = continue searching with same search string F4 = send current page to printer F5 = send whole history to printer F10 = quit history Configuration function keys: ---------------------------- F1 = load old configuration file 's:VSh.Config' F2 = save new configuration file 's:VSh.Config' F3 = use default configuration F4 = use selected configuration F10 = quit configuration Numeric pad keys: ----------------- 1 = move cursor in file list to bottom of list 2 = move cursor in file list down by one entry 3 = move cursor in file list down by one page 4 = read parent directory 5 = read current directory once again 6 = read directory under cursor 7 = move cursor in file list to top of list 8 = move cursor in file list up by one entry 9 = move cursor in file list up by one page 0 = mark or unmark selected entry in active file requester . = insert file name in command line - = select entries to mark by pattern (* = mark all) ENTER = run file, execute script or enter directory under cursor SHIFT 4 = read root directory SHIFT 6 = read directory under cursor to nonactive file requester SHIFT 0 = unmark all selected entries SHIFT . = insert file name with full path in command line SHIFT - = select entries to unmark by pattern (* = unmark all) ALT - = toggle num lock for normal numeric key pad Other keys: ----------- TAB = toggle active file requester HELP = show this help pages SHIFT HELP = show about page SHIFT ALT HELP = change configuration ALT = speed search, use to continue searching ESC = quit any function Configuration menu: ------------------- Left edge = horizontal position of left upper edge of VSh window Top Edge = vertical position of left upper edge of VSh window Width = width of VSh window Height = height of VSh window Number of CLI lines = number of CLI lines (min file requester lines = 14) Scroll speed = scroll speed (1 = slow, 2 = normal, 3 = fast) Keyboard type = keyboard type (1 = A1000, 2 = A500, A2000, A2500 or A3000), used for numeric key pad mapping Dump mode = displayed characters in view or quick view mode (1 = all characters, 2 = no control characters [0-31 and 128-159], 3 = only ASCII characters [32-126]) Path for editor = full path name for external editor Options for editor = additional options for editor, e.g. STICKY for TxEd+ Patterns: --------- VSh uses the pattern matching function of the ARP library. All valid AmigaDOS and Unix wild cards and combinations from both are possible. Attention: Patterns are case sensitive !!! AmigaDos: # ? ( | ) Unix : * ? ( | ) [ ] ~ Example: ~(*.info|*.INFO) = select all files without the extension '.info' AND '*.INFO' *.[cC] = select all files with the extension '.c' OR '.C' Requirements: ------------- - Shareware Console Handler `ConMan' v1.3+ from William S. Hawes - arp.library v39+ Author: ------- Torsten Jürgeleit Am Sandberg 4 W-5270 Gummersbach Germany Phone: ++49 2261 27400 Bug reports, flames, donations etc. are welcome ! I may be reached via eMail: mike@miba.obb.sub.org Since this is a neighbour, it may take some time to answer :)