something like this? : Index: doc/reference/tmpl/gnome-about.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-about.sgml,v retrieving revision 1.7 diff -u -r1.7 gnome-about.sgml --- doc/reference/tmpl/gnome-about.sgml 13 Oct 2003 21:33:11 -0000 1.7 +++ doc/reference/tmpl/gnome-about.sgml 24 Feb 2005 16:04:53 -0000 @@ -2,7 +2,7 @@ GnomeAbout
<!-- ##### SECTION Short_Description ##### --> -Display author, documenter and translator credits for an application. +Deprecated widget for displaying author, documenter and translator credits for an application. <!-- ##### SECTION Long_Description ##### --> <para> @@ -11,8 +11,11 @@ <literal>About...</literal> option from the <literal>Help</literal> menu. With one simple function call, the application can then display all of the appropriate information. + +This widget is deprecated in favor of GtkAboutDialog in the gtk library. </para> + <!-- ##### SECTION See_Also ##### --> <para> Index: doc/reference/tmpl/gnome-color-picker.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-color-picker.sgml,v retrieving revision 1.6 diff -u -r1.6 gnome-color-picker.sgml --- doc/reference/tmpl/gnome-color-picker.sgml 13 Oct 2003 21:33:11 -0000 1.6 +++ doc/reference/tmpl/gnome-color-picker.sgml 24 Feb 2005 16:04:53 -0000 @@ -2,13 +2,16 @@ GnomeColorPicker <!-- ##### SECTION Short_Description ##### --> - +Deprecated widget in the form of a small button containing a swatch representing the current selected color. <!-- ##### SECTION Long_Description ##### --> <para> +Deprecated widget in the form of a small button containing a swatch representing the current selected color. +This widget is deprecated in favor of GtkColorButton in the gtk library. </para> + <!-- ##### SECTION See_Also ##### --> <para> Index: doc/reference/tmpl/gnome-dialog-util.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-dialog-util.sgml,v retrieving revision 1.1 diff -u -r1.1 gnome-dialog-util.sgml --- doc/reference/tmpl/gnome-dialog-util.sgml 8 Sep 2001 16:49:03 -0000 1.1 +++ doc/reference/tmpl/gnome-dialog-util.sgml 24 Feb 2005 16:04:53 -0000 @@ -2,11 +2,13 @@ gnome-dialog-util <!-- ##### SECTION Short_Description ##### --> - +Debrecated widget that shows a dialog. <!-- ##### SECTION Long_Description ##### --> <para> +Debrecated widget that shows a dialog. +This widget is deprecated in favor of GtkDialog in the gtk library. </para> <!-- ##### SECTION See_Also ##### --> Index: doc/reference/tmpl/gnome-entry.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-entry.sgml,v retrieving revision 1.6 diff -u -r1.6 gnome-entry.sgml --- doc/reference/tmpl/gnome-entry.sgml 13 Oct 2003 21:33:11 -0000 1.6 +++ doc/reference/tmpl/gnome-entry.sgml 24 Feb 2005 16:04:53 -0000 @@ -2,11 +2,13 @@ GnomeEntry <!-- ##### SECTION Short_Description ##### --> - +Debrecated widget that is an entrybox that keeps a history of what was filled in by the user. <!-- ##### SECTION Long_Description ##### --> <para> +Deprecated widget that is an entrybox that keeps a history of what was filled in by the user. +This widget is deprecated in favor of GtkEntry,GtkEntryCompletion in the gtk library and Gconf . </para> <!-- ##### SECTION See_Also ##### --> Index: doc/reference/tmpl/gnome-file-entry.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-file-entry.sgml,v retrieving revision 1.14 diff -u -r1.14 gnome-file-entry.sgml --- doc/reference/tmpl/gnome-file-entry.sgml 22 Mar 2004 01:41:23 -0000 1.14 +++ doc/reference/tmpl/gnome-file-entry.sgml 24 Feb 2005 16:04:53 -0000 @@ -2,11 +2,13 @@ GnomeFileEntry <!-- ##### SECTION Short_Description ##### --> - +Deprecated widget that shows an combobox and a button that makes it possible to select a file. <!-- ##### SECTION Long_Description ##### --> <para> +Deprecated widget that shows an entrybox and a button that makes it possible to select a file. +This widget is deprecated in favor of GtkFileChooserButton in the gtk library. </para> <!-- ##### SECTION See_Also ##### --> Index: doc/reference/tmpl/gnome-font-picker.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-font-picker.sgml,v retrieving revision 1.6 diff -u -r1.6 gnome-font-picker.sgml --- doc/reference/tmpl/gnome-font-picker.sgml 13 Oct 2003 21:33:11 -0000 1.6 +++ doc/reference/tmpl/gnome-font-picker.sgml 24 Feb 2005 16:04:54 -0000 @@ -2,13 +2,14 @@ GnomeFontPicker <!-- ##### SECTION Short_Description ##### --> - +Deprecated widget that shows an listbox with types of fonts and the size. <!-- ##### SECTION Long_Description ##### --> <para> +Deprecated widget that shows an listbox with types of fonts and the size. +This widget is deprecated in favor of GtkFontSelectionDialog in the gtk library. </para> - <!-- ##### SECTION See_Also ##### --> <para> Index: doc/reference/tmpl/gnome-icon-list.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-icon-list.sgml,v retrieving revision 1.11 diff -u -r1.11 gnome-icon-list.sgml --- doc/reference/tmpl/gnome-icon-list.sgml 13 Oct 2003 21:33:11 -0000 1.11 +++ doc/reference/tmpl/gnome-icon-list.sgml 24 Feb 2005 16:04:54 -0000 @@ -6,7 +6,7 @@ <!-- ##### SECTION Long_Description ##### --> <para> - +Deprecated widget in favor of GtkIconView in the gtk library. </para> <!-- ##### SECTION See_Also ##### --> Index: doc/reference/tmpl/gnome-icon-theme.sgml =================================================================== RCS file: /cvs/gnome/libgnomeui/doc/reference/tmpl/gnome-icon-theme.sgml,v retrieving revision 1.3 diff -u -r1.3 gnome-icon-theme.sgml --- doc/reference/tmpl/gnome-icon-theme.sgml 18 Dec 2003 15:26:08 -0000 1.3 +++ doc/reference/tmpl/gnome-icon-theme.sgml 24 Feb 2005 16:04:54 -0000 @@ -6,7 +6,7 @@ <!-- ##### SECTION Long_Description ##### --> <para> - +This widget is deprecated in favor of GtkIconTheme in the gtk library. </para> <!-- ##### SECTION See_Also ##### --> On Wed, 2005-02-23 at 21:23 +1030, Alex Murray wrote: >On Wed, 2005-02-23 at 11:37 +0100, Kristof Vansant wrote: >> I think one of the important things missing at the moment, is good >> documentation for developers how they can switch from gnome widgets to >> gtk widgets. A lot of gnome stuff is deprecated but still used in a >lot >> of projects. >> > >I agree -> perhaps in the Gnome API it could say (eg): >GnomeAboutDialog is deprecated and should not be used in newly written >code -> superseded by GtkAboutDialog >this way at least there is some guidance as to what to use instead.. > >> Guides that should be possible to write but I can't find: >> GnomeFileEntry -> ? >> GnomeAppBar -> GtkStatusbar + GtkProgressBar >> GnomeEntry -> GtkEntry + ? (to save the history) >> GnomeCanvas -> GtkCanvas (gtk 2.8) >> esd -> gstreamer > >Has gstreamer been confirmed as the plan for sound in Gnome in the >future?? > > >> gnome_config_* -> ? >> >> >> widgets and functions missing in gtk at the moment, so can't be >> replaced: >> GnomeDruid >> GnomeHREF >> GnomeDateEdit ? >> gnome_help_* >> gnome_url_* >> session support >> >> >> I hope someone would write those guide so we can start replacing code. >> Or set up a wiki and when the documentation is done include it into >the >> gtk api guide. >> >> _______________________________________________ >> gnome-devel-list mailing list >> [email protected] >> http://mail.gnome.org/mailman/listinfo/gnome-devel-list > >_______________________________________________ >gnome-devel-list mailing list >[email protected] >http://mail.gnome.org/mailman/listinfo/gnome-devel-list > _______________________________________________ gnome-devel-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/gnome-devel-list
