⟦f938a1575⟧

TextFile

	Vsh is a screen-oriented shell designed to replace the standard shell
in many of the simpler operations involved in program and text development.
In addition to the commands below, vsh is extensible via the 'O' command.
A user can define his own commands with either the 'O' command or in a file
.vshrc in his login directory, which will be loaded upon vsh startup. The upper
case letters, lower case u-z, and most printable special characters can be
redefined.  More can be redefined in multicolumn mode. See the vsh.intro
documentation for more information.

			VSH Command Summary

Command		Action

^D		Leave Vsh, must be entered twice, see parameter quitchar
1-9		Select page 1-9 (listing of files in current directory)
0		Select page 10
+, ^F, ^D	Select next page, + next column
-, ^U		Select previous page, - previous column
^L		Re-display same page
.		Select page with files beginning with character prompted for
		(Files listed with a following * are executable)

a-z		Select associated file
^ (HOME)	Change to Home directory
/		Change to root
\		Change to previous directory
?		Display this page
!		Execute shell
%		Chain to shell (does not return to Vsh)
$		Execute Bourne (Version 7) shell
line feed	Change to parent directory.

C		Create file or directory
D		Date
E		Show Errors from previous make
F		File selection by name
G		Grep
L		Long listing of files on current page
M		Make
N		Make forked off (2 bells on OK return, 3 bells on error)
O		Options
P		Ps (Print processes)
R		Remove files
S		Show output of Grep
T		Type out (display) text file
W		Who
X               eXecute any shell command
Y		Re-execute previous X shell command

Most of the above commands, especially A-Z, are user-alterable.
These commands are useful in select mode.
Command		Action
<TAB>		Forward column
^F		Forward column (Emacs style)
^B		Backward column
^P		uP column
^N		dowN column
^A		Back series
^E		Forward series
h,j,k,l		Forward, backward, up, and down (VI style)
'		Enter selected item

These commands are available when view files or output through VSH's pager,
(More ? prompt with the VSH display command, help or pexec), see also the
description of the parameter moresize.
1,<		First line
G,>		Last line
?,^R		Reverse search
/,^S		Forward search (wraps around)
e,v		Invoke $EDITOR
-,^P,k		Previous line
<CR>,^N,j	Next line
^U		Previous half page
^D		Next half page
^B,^		Previous full page
^L		Repaint screen
!		Fork a subshell
(anything else)	Next full page

	The forward and reverse searches search for a prompted string pattern
which supports only the ^ . $ regular expression extensions. Note that a forward
search can cause a file to be read til EOF and then either wraparound or
restoring the display after an unsuccessful search can fail if the size of the
more buffer is insufficient to hold the entire file. Reverse searches do not
wraparound beyond the beginning of the file (or as much as can be buffered).
	One can also set several parameters used by vsh using the O command,
such as the editor, the shell, and the make commands called.
	These commands are the recognized keywords which a character command
can be set to:
	
	chain		Chain (exec without fork) to a shell command
*	create		Create a new filename
	date		Display the date and time
*	display		Display the contents of a text file
*	exec		Execute a shell command (does not uses the shell)
	file		Enter a file, see below and parameter enterpath
	fmake		Execute make, do not wait for completion
*	grep		Search for a string pattern in a set of files
	home		Change to home directory
	longlist	Extend file listing to include size, modtime, etc.
	null		No operation, clear the command character
	options		Set options, commands and parameters
*	pexec		Execute like exec (above) but page output
	remove		Remove files
*	rexecute	Re-execute previous xecute command
	shell		Create a subshell
	showerror	Display the make error file
	showgrep	Display the grep log file
	wmake		Execute make, wait for completion
*	xecute		Execute one shell command, prompt if no command

	The commands above which are denoted by an asterisk '*', are interfaced
to the select mode of vsh, as described below. Certain commands such as 'file'
and 'display' prompt for a filename if none has been selected. Entering a lone
'!' causes the previous filename to be used.
	If the command string to either the exec or xecute commands begins
with a semicolon ';', the screen is immediately updated after the command
completes.
	A filename beginning with tilde '~', is interpreted as a login
directory belonging to the following username (e.g. ~username = /usr/username).
The filenames '~' and '~/' refer to the HOME directory.
	If the options command is invoked with a file argument, a
.vshrc-compatible copy of the current set of options and command definitions is
placed in the named file.

	A file is "entered" by either the selection process, or the VSH file
command. The VSH pager (see below) may be invoked as part of the entering
process. These actions occur to the selected file depending on the file type:

Filetype	Action
directory	Change to directory, make named directory the working directory
archive		ar tv, produce listing of contents of archive through pager
cpio		cpio -itv, produce listing of contents of archive
core dump	adb debugger
a.out format	nm, produce listing of name list through pager
packed file	pcat or ccat, decoding file through pager
device		Cannot be entered
anything else	A quick test is performed to guess whether file is ASCII text.
		If the file seems to be ASCII text, either the pager or the
		editor or some other program is invoked with the file, depending
		on whether the VSH parameter entertext is set to display,
		$EDITOR, or an arbitrary program.

	VSH parameters can be changed by altering one's .vshrc file and starting
up VSH, or by using the VSH options command, which affects the current instance
of VSH only. These are parameters used by vsh:

NAME		DEFAULT

EDITOR		vi
HOME
TERM		unknown
PATH		:/bin:/usr/bin
SHELL		/bin/sh
grep		/bin/grep
grepout		.grepout		Grep output file
make		/bin/make
makerror	.makerror		Make output file
quitchar	D			Quit command (octal 0100 is
					 subtracted, thus D is
					 control D and [ is <ESC>)
pagechar	{			Page command synonym for '+',
					 like 'quitchar', 0100 is
					 subtracted, '{' is ';', and
					 'M' would be <return>
rmhelp		/usr/new/lib/vsh/rmhelp	Remove help file
showhelp	/usr/new/lib/vsh/showhelp Show(grep,make) help file
vshmode		enter			Vsh operating mode
entertext	$EDITOR			Determines how to enter a text
					 file.
helpfile	$HOME/.vshelp		Help file always displayed
window		full screen		Lines for VSH
column		1			Number of filename columns
noargprompt				Prompt for missing arguments
VImotion				Use hjkl for page motions
MAIL		/usr/spool/mail/~	Check for new mail
moresize	10000			Memory buffer size for reversing
					the VSH pager used with
					(display, help, pexec)
enterpath	:			List of directories to search
					when entering a file via the
					keyboard VSH file command.

	The parameter vshmode, sets one of two operating modes. The first
(default) mode, enter, accepts single character commands as described above.
The second mode, select, is obtained by setting the parameter vshmode to
"select". In select mode, a character a-z is used to select a filename to
be used for the next command. A second character determines the command
to be executed. If the command character entered is again a-z refering to the
same filename, that filename is entered as in the enter mode. If another a-z
filename is selected, that filename becomes the selected filename and vsh
awaits for another command character. If the command character is an action
command, that action is performed, using the selected file where relevant
(e.g. G, T). Thus typing 'aa' in select mode is equivalent to typing 'a'
in enter mode. The selected file can also be entered by the ' command.
	The parameter entertext determines how vsh enters text. The default
value $EDITOR causes vsh to enter text by calling the text editor refered to
by the vsh EDITOR parameter. If the entertext value is "display", the vsh
internal pager, display, is used to enter text (displaying its contents).
Any other value for entertext causes vsh to invoke that string as a simple
shell command with the selected file as its argument. If the command is
prefixed with a semicolon ';', the screen is immediately updated after the
command completes.
	In select mode, one can define new commands which will use the
selected filename as an argument. Specifically the keywords "exec", "pexec",
and "xecute" (normally associated with the X and Y commands) both accept the
selected filename as an argument. Every occurance of a lone dollar sign ($)
separated by spaces is replaced by the selected filename. In addition, with
"exec" and "pexec", each argument beginning with "??" is printed without the
"??" as a prompt for an argument.
	The parameter noargprompt, if set, inhibits prompting for missing
$ arguments as described above.
	The parameter window sets the number of CRT lines available for the
VSH directory page. If window is less than the full screen, the remaining
CRT lines is used as a execute scroll window, where all executing commands
and text paging is viewed.
	The parameter column sets the number of filename columns to use
in the VSH directory page. Each column uses approximately twenty positions,
so a maximum of 4 columns is permitted with a standard 80 column CRT.
	Commands such as <TAB>, ^N, ^P are available to move a select
cursor around the multicolumn directory page.
	If the parameter VImotion is set, the commands h,j,k,l are acceptable
as page motion commands and not interpreted as select commands. If VImotion is
not set, then h,j,k,l are only applicable when the window is 11 or less and
otherwise are interpreted as their usual select file function.
	The parameter MAIL, if set, determines a mail filename to check for
new mail. If the filename ends in ~, it is replaced with the user's name.
	The parameter moresize, sets the size of the buffer used to store
output for the VSH pager for later reviewing (reversing). Only moresize
previous characters are saved.
	The parameter enterpath determines the list of directories to be
searched when entering a file via the keyboard VSH file command. The list
consist of a string of directories separated by ':', in the style of $PATH
for the Bourne shell. A simple '~' denotes the current $HOME, while ~user
is replaced with the named user's login directory. The current working
directory is always searched, though the order may be changed by the placement
of a simple ':'.
	The create command will not create over an existing file unless the
given filename is preceed by a !.
	Vsh attempts to ascertain if the terminal is a CRT and has a TERMCAP
entry. If vsh fails on these counts, vsh normally will exit. If vsh is given
a '-' argument, a non-CRT terminal will cause vsh to chain to the standard
shell.
DataMuseum.dk

ICL Comet 32

⟦f938a1575⟧ TextFile

Derivation

TextFile
