Re: what we need to make apps use gtk instead of libgnome/ui

[Kristof Vansant <de_lupus pandora be>]

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
>> gnome-devel-list gnome org
>> http://mail.gnome.org/mailman/listinfo/gnome-devel-list
>
>_______________________________________________
>gnome-devel-list mailing list
>gnome-devel-list gnome org
>http://mail.gnome.org/mailman/listinfo/gnome-devel-list
>