win(1) General Commands Manual win(1)
NAME
win - Terminal emulator
SYNOPSIS
win [-v] [-t name] [command [argument ...]] address
OPTIONS
-v If the -v option is present, win prints its version number and date and exits.
-tname If the -t option is present, win uses +name as the final part of the tag name of its window.
DESCRIPTION
win must be able to connect to a running wily(1). win attaches to a window. If the -t option is present, the final part of the tag name
is name. If command is present, the final part of the tag name is +command. Otherwise, the final part of the tag name is +win. The first
part of the tag name is the current working directory.
win runs a program in a child process. The child process is the leader of a process group and is connected to win by a pseudo-terminal.
If command is specified, the child process runs
$SHELL -c 'command argument ...'
otherwise it runs
$SHELL -i
If SHELL is not found in the environment, /bin/sh is used.
TERM=win is placed in the environment of the running program.
Output from the running command appears in the window. The point after the last output from the running command is known as the output
point. Further output from the running command appears just before the output point. The output point is initially at the end of the win-
dow.
Normal wily editing commands work in the window. When a newline, interrupt character, or end-of-file character is created after the output
point, the text between the output point and the last newline, interrupt character, or end-of-file character in the window (inclusive) is
passed to the running program as input.
The interrupt character is control-C and the end-of-file character is control-D. The pseudo-terminal initially is configured so that these
are recognized with their normal meanings.
The B2 commands beginning with the |, <, or > characters or an upper case letter are executed normally by wily. Other B2 are first termi-
nated with a newline, if they are not already, and are then appended to the buffer (and thereafter passed to the running program).
RETURNS
win returns zero if it is able to successfully create the child process, otherwise it returns non-zero.
EXAMPLES
Run a terminal emulator within wily
win
Run FTP within wily
win ftp
Run rlogin within wily
win -t host.domain rlogin -8 host.domain
SEE ALSO
wily(1) Tag(1) Man(1)
BUGS
win doesn't follow changes to the terminal attributes. In particular, there is no way to stop echoing or to change its concept of the
interrupt and eof characters.
rlogin seems to need -8 and, annoyingly, sets echo and onlcr. The latter can be fixed in your .rcrc:
if ( ~ $TERM win ) {
stty -echo -onlcr
}
win doesn't follow changes to the terminal attributes. In particular, there is no way to stop echoing or to change its concept of the
interrupt and eof characters.
WEdestroy messages aren't yet passed by wily. Thus, Del and Delcol can delete the window yet leave win running.
There is a race condition; the user can press newline and then delete text before win has a chance to read it.
AUTHOR
win was originally written by Gary Capell (gary@cs.su.oz.au). Alan Watson (alan@oldp.nmsu.edu) rewrote it and added support for arguments,
pseudo-terminals instead of pipes, and execution of certain B2 commands by wily. The pseudo-terminal support in 9term, written by Matty
Farrow (matty@cs.su.oz.au), was a great help.
1R1.1L1 of 1D1 win(1)