/* -*-c-*-
*
- * $Id: msg.c,v 1.3 1999/03/25 23:36:10 mdw Exp $
+ * $Id: msg.c,v 1.4 1999/04/29 20:48:13 mdw Exp $
*
* Display a message and get an answer
*
/*----- Revision history --------------------------------------------------*
*
* $Log: msg.c,v $
+ * Revision 1.4 1999/04/29 20:48:13 mdw
+ * Add documentation for `msg'.
+ *
* Revision 1.3 1999/03/25 23:36:10 mdw
* Compile to nothing in absence of GTK, for the benefit of parent packages
* which contain non-GTK-dependent parts.
*
* Use: Displays a message to the user in a nice dialogue box and
* returns the index of the button selected.
+ *
+ * The @msg@ argument is a @printf@-style format string, which
+ * contains the message to actually be shown. The @buttons@
+ * argument is a comma-separated list of buttons to be drawn,
+ * from right to left. A button name can be preceded with `:'
+ * to indicate that it's the default, or `~' if it's the
+ * `cancel' button. The return value is the zero-based index
+ * of the button selected.
*/
static int close(GtkWidget *w, gpointer p)
/* -*-c-*-
*
- * $Id: msg.h,v 1.1 1998/12/11 09:44:21 mdw Exp $
+ * $Id: msg.h,v 1.2 1999/04/29 20:48:13 mdw Exp $
*
* Display a message and get an answer
*
/*----- Revision history --------------------------------------------------*
*
* $Log: msg.h,v $
+ * Revision 1.2 1999/04/29 20:48:13 mdw
+ * Add documentation for `msg'.
+ *
* Revision 1.1 1998/12/11 09:44:21 mdw
* Initial version.
*
*
* Use: Displays a message to the user in a nice dialogue box and
* returns the index of the button selected.
+ *
+ * The @msg@ argument is a @printf@-style format string, which
+ * contains the message to actually be shown. The @buttons@
+ * argument is a comma-separated list of buttons to be drawn,
+ * from right to left. A button name can be preceded with `:'
+ * to indicate that it's the default, or `~' if it's the
+ * `cancel' button. The return value is the zero-based index
+ * of the button selected.
*/
extern int msg(const char */*buttons*/, const char */*msg*/, ...);