X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/mgLib/blobdiff_plain/1c48db0c647c38c9dcb8b8e48d48b3ebee761786..19c0192cb4ce59aea6af17238745c26e22d05489:/msg.h diff --git a/msg.h b/msg.h index f4f1214..31ba0de 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.3 1999/05/05 18:52:45 mdw Exp $ * * Display a message and get an answer * @@ -12,23 +12,29 @@ * This file is part of the mgLib GTK utilities library. * * mgLib is free software; you can redistribute it and/or modify - * it under the terms of the GNU General Public License as published by - * the Free Software Foundation; either version 2 of the License, or - * (at your option) any later version. + * it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of the + * License, or (at your option) any later version. * * mgLib is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU General Public License for more details. + * GNU Library General Public License for more details. * - * You should have received a copy of the GNU General Public License - * along with mgLib; if not, write to the Free Software Foundation, - * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + * You should have received a copy of the GNU Library General Public + * License along with mgLib; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ /*----- Revision history --------------------------------------------------* * * $Log: msg.h,v $ + * Revision 1.3 1999/05/05 18:52:45 mdw + * Change licensing conditions to LGPL. + * + * 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 +62,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*/, ...);