[xtoys] / xmsg.1

.\" -*-nroff-*-
.TH xmsg 1 "20 December 2001" "Edgeware tools"
.SH NAME
xmsg \- pops up a message box
.SH SYNOPSIS
.ll +5i
.B xmsg
.RB [ \-\-display
.IR display ]
.RB [ \-f ]
.RB [ \-t
.IR title ]
.RB [ \-c | \-d
.IR button ]
.if n \{\
.br
\h'1i'
..
\}
.I message
.RI [ button ...]
.ll -5i
.SH DESCRIPTION
The
.B xmsg
program pops up a pretty GTK message box, containing the listed buttons
(shown right to left along the bottom).  The button strings are listed,
one per argument, after the message.  If no buttons are requested, an
.B OK
button is provided anyway.
.PP
A button may be selected as being the default (i.e., may be chosen by
pressing
.IR enter ),
using the
.B \-d
option: the argument must either match a button name, or be an index
(zero-based) of the requested button.  If you don't select a default,
the first (rightmost) button becomes the default anyway.
.PP
Similarly, a button may be selected as being the `cancel' action (i.e.,
may be chosen by closing the window or pressing
.IR escape ),
using
the
.B \-c
option.  Again, the argument must either match a button name or be an
index of a button.  If you don't select a cancel button, the last
(leftmost) button because the cancel button.
.PP
If there is more than one button, the name of the selected button is
printed on standard output when the program exits.
.SS Options
.TP 5
.BI "\-\-display " display
Attempt to connect to
.I display
rather than the display named in the usual environment variable.
.TP 5
.B "\-f, \-\-focus "
Sets a magical property to ensure that the window acquires the focus
under a customized
.BR fvwm (3)
version I don't use any more.
.TP 5
.BI "\-t, \-\-title " title
Sets the title for the window.  If you don't specify a title, the window
is labelled
.RB ` xmsg '.
.TP 5
.BI "\-c, \-\-cancel " button
Selects the given
.I button
as being the cancel button.
.TP 5
.BI "\-d, \-\-default " button
Selects the given
.I button
as being the default button.
.SH AUTHOR
Mark Wooding (mdw@nsict.org).
.SH BUGS
None currently known.
Commit	Line	Data
2b6e1eca	1	.\" --nroff--
	2	.TH xmsg 1 "20 December 2001" "Edgeware tools"
	3	.SH NAME
	4	xmsg \- pops up a message box
	5	.SH SYNOPSIS
	6	.ll +5i
	7	.B xmsg
	8	.RB [ \-\-display
	9	.IR display ]
	10	.RB [ \-f ]
	11	.RB [ \-t
	12	.IR title ]
	13	.RB [ \-c \| \-d
	14	.IR button ]
	15	.if n \{\
	16	.br
	17	\h'1i'
	18	..
	19	\}
	20	.I message
	21	.RI [ button ...]
	22	.ll -5i
	23	.SH DESCRIPTION
	24	The
	25	.B xmsg
	26	program pops up a pretty GTK message box, containing the listed buttons
	27	(shown right to left along the bottom). The button strings are listed,
	28	one per argument, after the message. If no buttons are requested, an
	29	.B OK
	30	button is provided anyway.
	31	.PP
	32	A button may be selected as being the default (i.e., may be chosen by
	33	pressing
	34	.IR enter ),
	35	using the
	36	.B \-d
	37	option: the argument must either match a button name, or be an index
	38	(zero-based) of the requested button. If you don't select a default,
	39	the first (rightmost) button becomes the default anyway.
	40	.PP
	41	Similarly, a button may be selected as being the `cancel' action (i.e.,
	42	may be chosen by closing the window or pressing
	43	.IR escape ),
	44	using
	45	the
	46	.B \-c
	47	option. Again, the argument must either match a button name or be an
	48	index of a button. If you don't select a cancel button, the last
	49	(leftmost) button because the cancel button.
	50	.PP
	51	If there is more than one button, the name of the selected button is
	52	printed on standard output when the program exits.
	53	.SS Options
	54	.TP 5
	55	.BI "\-\-display " display
	56	Attempt to connect to
	57	.I display
	58	rather than the display named in the usual environment variable.
	59	.TP 5
	60	.B "\-f, \-\-focus "
	61	Sets a magical property to ensure that the window acquires the focus
	62	under a customized
	63	.BR fvwm (3)
	64	version I don't use any more.
65	.TP 5
66	.BI "\-t, \-\-title " title
67	Sets the title for the window. If you don't specify a title, the window
68	is labelled
69	.RB ` xmsg '.
70	.TP 5
71	.BI "\-c, \-\-cancel " button
72	Selects the given
73	.I button
74	as being the cancel button.
75	.TP 5
76	.BI "\-d, \-\-default " button
77	Selects the given
78	.I button
79	as being the default button.
80	.SH AUTHOR
81	Mark Wooding (mdw@nsict.org).
82	.SH BUGS
83	None currently known.