xgetline \- request a line of text in an X dialogue box
.SH SYNOPSIS
.B xgetline
+.RB [ -in ]
.RB [ \-t
.IR title ]
.RB [ \-p
.IR prompt ]
.RB [ \-d
.IR default ]
+.RB [ \-l | \-H
+.IR file ]
+.RB [ \- m
+.IR max ]
.SH DESCRIPTION
The
.B xgetline
.fi
.SS OPTIONS
.TP 5
+.B \-i, \-\-invisible
+Don't echo characters to the screen when they're typed. Useful when
+requesting passwords and similar secrets.
+.TP 5
.BI "\-t, \-\-title " title
Sets the title of the dialogue box to
.IR title .
.BI "\-d, \-\-default " default
Sets the default text in the entry field to
.IR default .
-The default default is the empty string.
+The default default is the first item in the empty string. The special
+default string
+.RB ` @ '
+sets the default to be the first item in the history list, if one is
+supplied.
+.TP 5
+.BI "\-l, \-\-list " file
+Reads a list of alternatives from
+.I file
+and displays them in a drop-down list box. The user can rapidly select
+an item from the drop-down list using the mouse or cursor keys. The
+file is not modified (but see the
+.B \-\-history
+option below).
+.TP 5
+.B "\-n, \-\-no-choice"
+One of the items from the selection list must be chosen; the user may
+not type an entry in directly.
+.TP 5
+.BI "\-H, \-\-history " file
+Reads a file and displays the contents in a drop-down list, as for
+.B \-\-list
+above. Once the user has entered a string, a new list written to
+.I file
+containing the newly entered string as the first item; other lines
+matching the newly entered string are not written.
+.TP 5
+.BI "\-m, \-\-histmax " max
+When writing an updated history file, do not write more than
+.I max
+lines. The default is 20; a value of 0 disables a length limit on the
+history file.
.SH AUTHOR
Mark Wooding (mdw@nsict.org).
.SH BUGS