/* -*-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)