Re: About dialog api

[Matthias Clasen <maclas gmx de>]

The interest in this seems to have worn off, so let me summarize my
current understanding of the outcome:

Functions:

GtkWidget *gtk_about_dialog_new      (void);

void       gtk_about_dialog_show     (GtkWindow    *parent,
				      const gchar *first_property_name,
				      ...);
If there isn't already an about dialog attached to parent, this function
will create a new one from the provided properties. Otherwise it will
just show the one attached to parent.

Properties:

char *name 
char *version
char *copyright
char *comments
GdkPixbuf *logo
char **authors
char **documenters
char *translator_credits

Example:

  const gchar *authors[] = {
    "Peter Mattis",
    "Spencer Kimball",
    "Josh MacDonald",
    "and many more...",
    NULL
  };

  const gchar *documenters[] = {
    "Owen Taylor <otaylor redhat com>\n  reference manual",
    "Tony Gale <tony gale>\n  FAQ",
    "and many more...",
    NULL
  };

  gtk_about_dialog_show (GTK_WINDOW (callback_data),
			 "version", "2.2.1",
			 "copyright", "(C) 1997-2003 The GTK+ Team",
			 "comments", "Program to demonstrate GTK+", 
			 "authors", authors,
			 "documenters", documenters,
			 "translator_credits", "Nobody",
			 NULL);

Is this api agreeable ?

Matthias