From ed2737aa72e56eb27faad470fba69f4470a9f1ee Mon Sep 17 00:00:00 2001
From: mdw <mdw>
Date: Thu, 29 Apr 1999 20:48:13 +0000
Subject: [PATCH] Add documentation for `msg'.

---
 msg.c | 13 ++++++++++++-
 msg.h | 13 ++++++++++++-
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/msg.c b/msg.c
index ff317e9..08a0285 100644
--- a/msg.c
+++ b/msg.c
@@ -1,6 +1,6 @@
 /* -*-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
  *
@@ -29,6 +29,9 @@
 /*----- 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.
@@ -75,6 +78,14 @@ static int creply;
  *
  * 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)
diff --git a/msg.h b/msg.h
index f4f1214..9f7e825 100644
--- a/msg.h
+++ b/msg.h
@@ -1,6 +1,6 @@
 /* -*-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
  *
@@ -29,6 +29,9 @@
 /*----- 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.
  *
@@ -56,6 +59,14 @@
  *
  * 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*/, ...);
-- 
2.11.0