[0m


ALERT(1)	    UNIX Programmer's Manual		 ALERT(1)



[1mNAME
     [0malert - display a warning message in a window

[1mSYNOPSIS
     alert [0m[ [1m-z [0m] [ [1m-standard X Toolkit options ... [0m] "[1mTITLE[0m"
     [1mtext to be displayed

DESCRIPTION
     [0m_A_l_e_r_t is a utility to issue a warning message to the user.
     It displays a warning symbol, some justified text and a but-
     ton in a window.  The button should be clicked with the
     mouse to acknowledge the alert and close the window.

     If the connection to the X server cannot be established, the
     title and text is printed on _a_l_e_r_t's standard output and the
     user is requested to press _R_E_T_U_R_N to acknowledge the mes-
     sage.

     _A_l_e_r_t can take the following option:

     [1m-z      [0mNo Zoom.  The window will attempt to by pass the
	     window manager and appear immediately, rather than
	     going through the window manager's placement and
	     sizing scheme.

     _A_l_e_r_t additionally recognizes the following standard X
     Toolkit command line arguments:

     [1m-bg [0m_c_o_l_o_u_r or [1m-background [0m_c_o_l_o_u_r
	     This option specifies the colour to use for the
	     background of the window and widgets.  The default
	     is `white.'

     [1m-bd [0m_c_o_l_o_u_r or [1m-bordercolor [0m_c_o_l_o_u_r
	     This option specifies the colour to use for the
	     border of the main window.  The default is `black.'

     [1m-bw [0m_n_u_m_b_e_r or [1m-borderwidth [0m_n_u_m_b_e_r
	     This option specifies the width in pixels of the
	     border surrounding the main window.

     [1m-fg [0m_c_o_l_o_u_r or [1m-foreground [0m_c_o_l_o_u_r
	     This option specifies the colour to use for all text
	     and symbols.  The default is `black'.

     [1m-fn [0m_f_o_n_t
	     This option specifies the font to be used for
	     displaying the text warning message.  The default is
	     `serif10'.

     [1m-name [0m_n_a_m_e
	     This option specifies the application name under



Printed 31/1/92          3 October 1988                         1






ALERT(1)	    UNIX Programmer's Manual		 ALERT(1)



	     which resources are to be obtained, rather than the
	     default executable file name, `alert'.

     [1m-geometry [0m_g_e_o_m_e_t_r_y
	     This option specifies the preferred size and posi-
	     tion of the alert window; see _X(_1);

     [1m-display [0m_d_i_s_p_l_a_y
	     This option specifies the X server to contact; see
	     _X(_1).

     [1m-xrm [0m_r_e_s_o_u_r_c_e_s_t_r_i_n_g
	     This option specifies a resource string to be used.
	     This is especially useful for setting resources that
	     do not have separate command line options.

[1mX DEFAULTS
     [0m_A_l_e_r_t is implemented using the Athena widgets.  Each widget
     can individually or in groups have various visual and opera-
     tional aspects changed via a `.Xdefaults' file on the client
     machine or the `RESOURCE_MANAGER' property on the server.
     All widgets have a common set of resources (background,
     backgroundPixmap, etc.) and resources unique to each type of
     widget; a `command button' widget, for example, also has a
     cursor resource.  For a full list see the document _X _T_o_o_l_k_i_t
     _W_i_d_g_e_t_s - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e.

     The path names and types of all widgets used by _a_l_e_r_t are as
     follows:

     _X_X_X[1m.alert/yorn
	     [0mThe widget that is a child of root.  All the other
	     widgets used by the alert box are children or grand
	     children of this widget.

     _X_X_X[1m.alert/yorn.contents
	     [0mA form widget that manages the layout of the alert
	     box.  Normally completely covers the alert/yorn
	     widget.

     _X_X_X[1m.alert/yorn.contents.symbol
	     [0mA widget to display the alert symbol.

     _X_X_X[1m.alert/yorn.contents.ok/yes button
	     [0mA command button widget to obtain an acknowledgement
	     from the user, normally displaying an `equals' sym-
	     bol.

     _X_X_X[1m.alert/yorn.contents.message
	     [0mA widget to display and format the text message.





Printed 31/1/92          3 October 1988                         2






ALERT(1)	    UNIX Programmer's Manual		 ALERT(1)



     The `_X_X_X' may be replaced by either _a_l_e_r_t's classname,
     `Xopentop', or its application name, `alert'.

     Additionally, the following items are also fetched from the
     resource database:

     [1malertsym
	     [0mThe pathname of a bitmap file to use as an alterna-
	     tive to the `exclamation-mark-in-a-triangle' symbol
	     displayed in the `symbol' widget.

     [1moksym   [0mThe pathname of a bitmap file to use as an alterna-
	     tive to the `equals' symbol displayed in the `ok/yes
	     button' widget.

     [1mbackgroundPixmap.foreground
	     [0mOne of two colours (the other is the widget's back-
	     ground colour) required when converting a bitmap
	     file into a pixmap for use as the widget's back-
	     ground pixmap.

[1mRETURN CODES
	  [0m0 - Termination via the acknowledge box.

	  2 - Termination due to some internal error.

[1mENVIRONMENT
[0mserver.
     DISPLAY - the default host name and display number of the X

     XENVIRONMENT -
	      the name of the Xdefaults file to use, normally
	     $HOME/.Xdefaults.

[1mEXAMPLES
	  [0malert "Low disk space" Warning: There are less than 200
	  free disk blocks

     Will open an alert box with the title _L_o_w _d_i_s_k _s_p_a_c_e and
     containing the text _W_a_r_n_i_n_g: _T_h_e_r_e _a_r_e _l_e_s_s _t_h_a_n _2_0_0

[1mFILES
     [0m$HOME/.Xdefaults /usr/lib/X11/app-defaults/Xopentop

[1mSEE ALSO
     [0mgs(1), yorn(1)

[1mBUGS
     [0mIf the font is too large or the message too long, the text
     will be clipped.





Printed 31/1/92          3 October 1988                         3






ALERT(1)	    UNIX Programmer's Manual		 ALERT(1)



     The title may not be displayed if the window manager does
     not provide title bars around windows or the [1m-z [0moption is
     used.

[1mAUTHOR
     [0mGary Henderson & Mark E. Howells, Torch Computers Ltd.

















































Printed 31/1/92          3 October 1988                         4



[0m