Re: About dialog api

["Gustavo J. A. M. Carneiro" <gjc inescporto pt>]

A Qui, 2003-04-24 às 01:53, Matthias Clasen escreveu:
> 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! :)
  Not completely anyway.  It is not extensible.  Please look at:

	http://bugzilla.gnome.org/show_bug.cgi?id=80468

  I'm not implying this particular method of extensibility (at the
widget level) is required, but some sort of extensibility is to be
required sooner or later (I gave an example of an "artwork" section that
was missing.)

  Regards.

-- 
Gustavo João Alves Marques Carneiro
<gjc inescporto pt> <gustavo users sourceforge net>