1 files changed, 64 insertions, 0 deletions
diff --git a/debian/rlfe.1 b/debian/rlfe.1
new file mode 100644
index 0000000..26a20a1
--- /dev/null
+++ b/debian/rlfe.1
@@ -0,0 +1,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.