Re: About dialog api

[Pavel Machek <pavel ucw cz>]

Hi!

> 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 ?

No, it misses the most important point:
license. People do not care who copyright
belongs to, but they *do* care about
what they may or may not do with
software.
				Pavel
-- 
				Pavel
Written on sharp zaurus, because my Velo1 broke. If you have Velo you don't need...