xmessage [ -buttons label1[:value1],label2[:value2], ... ] [ options ] -file filename xmessage [ -buttons label1[:value1],label2[:value2], ... ] [ options ] message ...
The xmessage program displays a window containing a message from the command line, a file, or standard input. Along the lower edge of the message is row of buttons; clicking the left mouse button on any of these buttons will cause xmessage to exit. Which button was pressed is returned in the exit status and, optionally, by writing the label of the button to standard output.
The program is typically used by shell scripts to display information to the user or to ask the user to make a choice.
Unless a size is specified, xmessage sizes itself to fit the message, up to a maximum size. If the message is too big for the window, xmessage will display scroll bars.
These are the command line options that xmessage understands, in addition to the standard ones listed in X(7).
Knowing the name and position in the hierarchy of each widget is useful when specifying resources for them. In the following chart, the class and name of each widget is given.
Xmessage (xmessage) Form form Text message Command (label1) Command (label2) . . .
The program has a few top-level application resources that allow customizations that are specific to xmessage.
If it detects an error, xmessage returns 1, so this value should not be used with a button.
X(7), echo(1), cat(1)
Chris Peterson, MIT Project Athena Stephen Gildea, X Consortium