summary refs log tree commit diff
path: root/Doc/Zsh/mod_zpty.yo
blob: 6e07d36f0a14853c85e5847f1f2b0baf0720b59c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
COMMENT(!MOD!zsh/zpty
A builtin for starting a command in a pseudo-terminal.
!MOD!)
The tt(zsh/zpty) module offers one builtin:

startitem()
findex(zpty)
xitem(tt(zpty) [ tt(-e) ] [ tt(-b) ] var(name) var(command) [ var(args ...) ])
xitem(tt(zpty) tt(-d) [ var(names) ... ])
xitem(tt(zpty) tt(-w) [ tt(-n) ] var(name) var(strings ...))
xitem(tt(zpty) tt(-r) var(name) [ var(param) [ var(pattern) ] ])
item(tt(zpty) [ tt(-L) ])(
In the first form, the var(command) is started with the var(args) as
arguments. After this, the var(name) can be used in further calls to
tt(zpty) to refer to this command. With the tt(-e) option given, the
pseudo-terminal will be set up so that input characters are echoed and 
with the tt(-b) option given, input and output from and to the
pseudo-terminal will be blocking.

The second form with the tt(-d) option is used to delete commands
started before by giving their var(names). If no var(names) are given, 
all commands are deleted. Deleting a command makes the HUP signal be
sent to the process started for it.

The tt(-w) option can be used to sent the command var(name) the given
var(strings) as input (separated by spaces). If the tt(-n) option is
not given, a newline will be sent after the last var(string).

The tt(-r) option can be used to read the output of the command
var(name). Without a var(param) argument, the string read will be
printed to standard output. With a var(param) argument, the string
read will be put in the parameter named var(param). If the
var(pattern) is also given, output will be read until the whole string 
read matches the var(pattern).

The last form without any arguments is used to list the commands
currently defined. If the tt(-L) option is given, this is done in the
form of calls to the tt(zpty) builtin.
)
enditem()