1 .TH xgetline 1 "15 November 1998" "Edgeware tools"
3 xgetline \- request a line of text in an X dialogue box
16 program reads a line of text from the user via a pretty GTK dialogue
17 box. The title bar contents, prompt string, and default text are all
18 configurable. If the user enters a string and clicks the
23 the string is echoed to standard output and
25 returns an exit status of zero. If the user cancels the dialogue box
26 (by closing it, or pressing
29 echoes nothing and returns an exit status of one.
33 program is intended to be used in window manager configuration files, to
34 allow users to fill in bits of text (e.g., hostnames or shell commands)
35 in generally useful places. For example, the author has the following
36 shell command attached to a hotkey:
41 cmd=`xgetline -t "Shell command in window" -p "Command:"` &&
42 xterm -T "$cmd" -e sh -c "$cmd"
48 Don't echo characters to the screen when they're typed. Useful when
49 requesting passwords and similar secrets.
51 .BI "\-t, \-\-title " title
52 Sets the title of the dialogue box to
55 .RB ` "Input request" '.
57 .BI "\-p, \-\-prompt " prompt
58 Sets the prompt string in the dialogue box to
60 The default is to have no prompt string.
62 .BI "\-d, \-\-default " default
63 Sets the default text in the entry field to
65 The default default is the empty string.
67 Mark Wooding (mdw@nsict.org).