On Thu, 2005-02-24 at 17:11 +0100, Kristof Vansant wrote: > something like this? : Don't forget to prefix type names with #, for cross-linking purposes. For example, #GtkAboutDialog. Regards. > > 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 > > > > _______________________________________________ > gnome-devel-list mailing list > gnome-devel-list gnome org > http://mail.gnome.org/mailman/listinfo/gnome-devel-list -- Gustavo J. A. M. Carneiro <gjc inescporto pt> <gustavo users sourceforge net> The universe is always one step beyond logic.
Attachment:
smime.p7s
Description: S/MIME cryptographic signature