author | Rich Burridge <rich.burridge@oracle.com> |
Wed, 07 Jan 2015 21:26:16 -0800 | |
changeset 3598 | 5fdeba1e317c |
parent 681 | 7c568e880861 |
child 5810 | 76203f2cf39d |
permissions | -rw-r--r-- |
681
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
1 |
'\" te |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
2 |
.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
3 |
.TH enhance 1 "18 May 2004" "SunOS 5.11" "User Commands" |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
4 |
.SH NAME |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
5 |
enhance \- enhanced command-line editing facilities |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
6 |
.SH SYNOPSIS |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
7 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
8 |
.nf |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
9 |
\fBenhance\fR \fIcommand\fR [\fIargument\fR]... |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
10 |
.fi |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
11 |
|
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
12 |
.SH DESCRIPTION |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
13 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
14 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
15 |
The \fBenhance\fR program provides enhanced command-line editing facilities to users of third party applications, to which one doesn't have any source code. It does this by placing a pseudo-terminal between the application and the real terminal. It uses the \fBtecla\fR command-line editing library to read input from the real terminal, then forwards each just completed input line to the application via the pseudo-terminal. All output from the application is forwarded back unchanged to the real terminal. |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
16 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
17 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
18 |
Whenever the application stops generating output for more than a tenth of a second, the enhance program treats the latest incomplete output line as the prompt, and re-displays any incompleted input line that the user has typed after it. The small delay, which is imperceptible to the user, isn't necessary for correct operation of the program. It is just an optimization, designed to stop the input line from being re-displayed so often that it slows down output. |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
19 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
20 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
21 |
The user-level command-line editing facilities provided by the Tecla library are documented in the \fBtecla\fR(5) man page |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
22 |
.SS "DEFICIENCIES" |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
23 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
24 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
25 |
The one major problem that hasn't been solved yet, is how to deal with applications that change whether typed input is echo'd by their controlling terminal. For example, programs that ask for a password, such as \fBftp\fR and \fBtelnet\fR, temporarily tell their controlling terminal not to echo what the user types. Since this request goes to the application side of the pseudo terminal, the enhance program has no way of knowing that this has happened, and continues to echo typed input to its controlling terminal, while the user types their password. |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
26 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
27 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
28 |
Furthermore, before executing the host application, the enhance program initially sets the pseudo terminal to \fBnoecho\fR mode, so that everything that it sends to the program doesn't get redundantly echoed. If a program that switches to \fBnoecho\fR mode explicitly restores echoing afterwards, rather than restoring the terminal modes that were previously in force, then subsequently, every time that you enter a new input line, a duplicate copy will be displayed on the next line. |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
29 |
.SH FILES |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
30 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
31 |
.ne 2 |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
32 |
.mk |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
33 |
.na |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
34 |
\fB\fB/usr/lib/libtecla.so\fR\fR |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
35 |
.ad |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
36 |
.RS 24n |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
37 |
.rt |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
38 |
\fBtecla\fR library |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
39 |
.RE |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
40 |
|
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
41 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
42 |
.ne 2 |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
43 |
.mk |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
44 |
.na |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
45 |
\fB\fB~/.teclarc\fR\fR |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
46 |
.ad |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
47 |
.RS 24n |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
48 |
.rt |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
49 |
\fBtecla\fR personal customization file. |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
50 |
.RE |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
51 |
|
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
52 |
.SH ATTRIBUTES |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
53 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
54 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
55 |
See \fBattributes\fR(5) for descriptions of the following attributes: |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
56 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
57 |
|
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
58 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
59 |
.TS |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
60 |
tab() box; |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
61 |
cw(2.75i) |cw(2.75i) |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
62 |
lw(2.75i) |lw(2.75i) |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
63 |
. |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
64 |
ATTRIBUTE TYPEATTRIBUTE VALUE |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
65 |
_ |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
66 |
Availabilitylibrary/libtecla |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
67 |
_ |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
68 |
Interface StabilityCommitted |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
69 |
.TE |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
70 |
|
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
71 |
.SH SEE ALSO |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
72 |
.sp |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
73 |
.LP |
7c568e880861
7143177 move libtecla from ON to Userland (Userland portion)
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
74 |
\fBlibtecla\fR(3LIB), \fBattributes\fR(5), \fBtecla\fR(5) |