summaryrefslogtreecommitdiffstats
path: root/debian/rlfe.1
blob: 26a20a15d79beafb7145cb2c96e227b2e1595e59 (plain)
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
.TH RLFE 1
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
rlfe \- "cook" input lines for other programs using readline
.SH SYNOPSIS
.PP
\fBrlfe\fP [\fI-l filename\fP] [\fI-a\fP] [\fI-n appname\fP] [\fI-hv\fP] [\fIcommand\fP [\fIarguments ...\fP]]
.PP
.SH "DESCRIPTION"
.PP
.B rlfe
lets you use history and line-editing in any text oriented tool. This
is especially useful with third-party proprietary tools that cannot be
distributed linked against readline. It is not perfect but it works
pretty well.
.SH OPTIONS
.TP
-a
append to the logfile (default is to overwrite).
.TP
-l filename
log into file.
.TP
-n appname
set the readline application name.
.TP
-h
print usage string.
.TP
-v
print version information.
.SH "SEE ALSO"
readline(3)
.SH AUTHOR
Per Bothner
.SH PROBLEMS/TODO
When running mc -c under the Linux console, mc does not recognize
mouse clicks, which mc does when not running under fep.
.PP
Pasting selected text containing tabs is like hitting the tab character,
which invokes readline completion.  We don't want this.  I don't know
if this is fixable without integrating fep into a terminal emulator.
.PP
Echo suppression is a kludge, but can only be avoided with better kernel
support: We need a tty mode to disable "real" echoing, while still
letting the inferior think its tty driver to doing echoing.
Stevens's book claims SCR$ and BSD4.3+ have TIOCREMOTE.
.PP
The latest readline may have some hooks we can use to avoid having
to back up the prompt.
.PP
Desirable readline feature:  When in cooked no-echo mode (e.g. password),
echo characters are they are types with '*', but remove them when done.
.PP
A synchronous output while we're editing an input line should be
inserted in the output view.PPbefore* the input line, so that the
lines being edited (with the prompt) float at the end of the input.
.PP
A "page mode" option to emulate more/less behavior:  At each page of
output, pause for a user command.  This required parsing the output
to keep track of line lengths.  It also requires remembering the
output, if we want an option to scroll back, which suggests that
this should be integrated with a terminal emulator like xterm.