1 .TH xgetline 1 "15 November 1998" "Edgeware tools"
3 xgetline \- request a line of text in an X dialogue box
20 program reads a line of text from the user via a pretty GTK dialogue
21 box. The title bar contents, prompt string, and default text are all
22 configurable. If the user enters a string and clicks the
27 the string is echoed to standard output and
29 returns an exit status of zero. If the user cancels the dialogue box
30 (by closing it, or pressing
33 echoes nothing and returns an exit status of one.
37 program is intended to be used in window manager configuration files, to
38 allow users to fill in bits of text (e.g., hostnames or shell commands)
39 in generally useful places. For example, the author has the following
40 shell command attached to a hotkey:
45 cmd=`xgetline -t "Shell command in window" -p "Command:"` &&
46 xterm -T "$cmd" -e sh -c "$cmd"
52 Don't echo characters to the screen when they're typed. Useful when
53 requesting passwords and similar secrets.
55 .BI "\-t, \-\-title " title
56 Sets the title of the dialogue box to
59 .RB ` "Input request" '.
61 .BI "\-p, \-\-prompt " prompt
62 Sets the prompt string in the dialogue box to
64 The default is to have no prompt string.
66 .BI "\-d, \-\-default " default
67 Sets the default text in the entry field to
69 The default default is the first item in the empty string. The special
72 sets the default to be the first item in the history list, if one is
75 .BI "\-l, \-\-list " file
76 Reads a list of alternatives from
78 and displays them in a drop-down list box. The user can rapidly select
79 an item from the drop-down list using the mouse or cursor keys. The
80 file is not modified (but see the
84 .B "\-n, \-\-no-choice"
85 One of the items from the selection list must be chosen; the user may
86 not type an entry in directly.
88 .BI "\-H, \-\-history " file
89 Reads a file and displays the contents in a drop-down list, as for
91 above. Once the user has entered a string, a new list written to
93 containing the newly entered string as the first item; other lines
94 matching the newly entered string are not written.
96 .BI "\-m, \-\-histmax " max
97 When writing an updated history file, do not write more than
99 lines. The default is 20; a value of 0 disables a length limit on the
102 Mark Wooding (mdw@nsict.org).