libgnome and libgnomeui Must Die!

Why? See ProjectRidley

libgnome

• DONE (already deprecated and replaced)

  • gnome-config: replaced by GConf and GKeyFile

  • gnome-i18n: replaced by glib-i18n

  • gnome-score: replaced by GamesScores in gnome-games (partially: 515429)

  • gnome-util

    • file-related stuff mostly moved to glib

  • GnomeProgram

    • popt stuff replaced by GOption (see 307312)

    • For session management, EggSMClient should be used

  • gnome-open (command-line utility)

    • Replaced by gvfs-open

  • gnome-url

    • Replaced with gtk_show_uri()

  • gnome-help

    • Use gtk_show_uri. see 514396 and GnomeGoals/RemoveGnomeOpenGnomeHelp

  • gnome-sound

    • Use libcanberra and sound theme
• TODO

  • gnome-exec

    • GSpawn covers all of (the useful parts of) this

    • gnome_execute_terminal* can be implemented using xdg-terminal (which will use "the active desktop's terminal program" rather than "the gnome-configured terminal program")

    • gnome_prepend_terminal_to_vector() is availible as gnome_desktop_prepend_terminal_to_vector for desktop applications (note: libgnomedesktop is not API stable)

  • gnome-gconf

    • utility methods (does anyone use these)?

    • the GConf GnomeModuleInfo

  • gnome-init

    • Gnome and Bonobo GnomeModuleInfos

    • Use gtk_init() or gtk_init_with_args() for command line option processing.

    • .gnome2/ dir stuff. Apps should probably migrate to g_get_config_dir() ($XDG_CONFIG_HOME). See http://live.gnome.org/GnomeGoals/XDGConfigFolders

  • gnome-macros

    • GNOME_CLASS_BOILERPLATE, GNOME_REGISTER_TYPE replaced by G_DEFINE_TYPE etc

    • GNOME_CALL_PARENT, GNOME_CALL_PARENT_WITH_DEFAULT does not yet have an equiv.

      • The CALL_PARENT macros are proxies to libbonobo macros, eel also has some similar macros.

        • bug 327840 -- ChristianNeumair 2006-01-20 12:30:31

  • GnomeProgram

    • GnomeModuleInfo stuff

    • name/directory-registration stuff

    • easier GOptionContext integration than the current plain gtk interfaces

  • gnome-triggers

    • this is currently used to trigger sound effects -- JamesHenstridge 2005-04-11 13:02:31

  • gnome-util

    • some stuff already in glib
    • lots of stuff of marginal value

    • gnome_program_locate_file wrappers

    • the parts that aren't already in glib: bug 327837 -- 2006-01-20 12:30:31

  • monikers/

    • According to the ChangeLog this was used by GnomePreferences which was killed in 2001. -- ChristianNeumair 2006-01-19 22:57:12

  • schemas/

    • Contains all the basic desktop-related schemas.
    • Maybe it should be moved to gnome-desktop? This would involve migrating some the gettext translations.

  • gnome-data/

    • sound stuff, gnome-program option manpage

libgnomeui

• DONE (already deprecated and replaced)

  • GnomeAbout: replaced by GtkAboutDialog

  • GnomeAppHelper: mostly replaced by GtkUIManager

  • gnome-app-util: replaced by various things

  • GnomeColorPicker: replaced by GtkColorButton etc

  • GnomeDialog: replaced by GtkDialog

  • gnome-dialog-util: replaced by GtkDialog and GtkMessageDialog

  • GnomeDruid: replaced by GtkAssistant (115348)

    • See http://library.gnome.org/devel/gtk/stable/gtk-migrating-GtkAssistant.html

  • GnomeFileEntry: replaced by GtkFileChooserButton

  • GnomeFontPicker: replaced by GtkFontSelectorButton

  • GnomeIconList, GnomeIconItem: replaced by GtkIconView

  • GnomeIconTheme: replaced by GtkIconTheme, etc

  • GnomeMDI, etc: deprecated, not replaced, we're ok with that

  • GnomeMessageBox: replaced by GtkMessageDialog

  • GnomePixmap: replaced by GtkImage

  • gnome-popup-menu: presumably replaced by GtkUIManager?

  • GnomePropertyBox: I don't think this has a replacement, but I don't think it needs one

  • gnome-scores: replaced by GamesScoresDialog in gnome-games

  • GnomeWindow: replaced by GtkWindow methods

  • gnome-window-icon: replaced by GtkWindow methods (?)

  • GnomeHRef: replaced by GtkLinkButton

  • gnome_segv program replaced by the libgnomebreakpad.so GTK_MODULE included in bug-buddy.

• TODO

  • GnomeAppBar

  • GnomeApp

  • GnomeAppHelper

    • default menus (eg, GNOMEUIINFO_MENU_EDIT_TREE)

    • integration with GnomeApp and GnomeAppBar

    • gnome_accelerators_sync (save modified accels)

      • Easily replaced with gtk_accel_map_load (needed if you stop using GnomeProgram) and gtk_accel_map_save

  • gnome-authentication-manager

    • Only needed for gnome-vfs, which is deprecated. For GIO, use GtkMountOperation for authentication dialogs.

  • GnomeClient / gnome-ice

    • To be replaced by EggSMClient. (?)

  • GnomeDateEdit

    • To be replaced by EggDateTime?

      • That was my original intention when I wrote EggDateEdit. It was also to provide more comprehensive functionality and a less braindead API. Of course the current code is quite old and incomplete. But if there is serious interest in this widget, I offer to continue development. -- -- SebastianRittau 2006-01-17 17:43:24

    • This is only used by the bindings and glade. -- -- AndreKlapper 2009-05-03 20:21:00

  • gnome-dialog-util

    • gnome_request_string_dialog*, gnome_request_password_dialog* (deprecated, but not replaced?)

  • GnomeEntry

    • deprecated, but is the history-saving functionality replaced by anything?

  • gnome-help

  • GnomeIconEntry

  • gnome-icon-lookup

    • Deprecated, with GIO you get the icon directly in the file attributes

  • GnomeIconSelection

    • To be replaced by EggIconChooser?

  • GnomePasswordDialog

    • Often GtkMountOperation is enough for apps using GVfs.

  • GnomePixmapEntry

    • deprecated, but no simple replacement

  • gnome-stock-icons

    • some have been migrated to gtk, but some haven't been

      • will we need that many sophisticated stock icons? Shouldn't we just have those for potential stock items inside GTK+, while icon-only items (GNOME_STOCK_BOOK_OPEN) are loaded from the icon theme using the freedesktop icon naming spec? -- ChristianNeumair 2006-01-19 22:57:12

  • GnomeThemeParser

    • This looks like a weak GKeyFile equivalent with some extra helpers and data structs. I couldn't find any client - shouldn't we just deprecate it? -- ChristianNeumair 2006-01-19 22:57:12

  • gnome-thumbnail

    • To be replaced by EggPixbufThumbnail?

    • For desktop applications there exists a copy of this in gnome-desktop called GnomeDesktopThumbnail (Note: libgnomedesktop is not API stable)

  • gnome-uidefs

    • This is mainly a collection of GNOME_PAD size constants which are sometimes used for dialog spacing and some hardcoded accelerators like #define GNOME_KEY_NAME_UNDO 'z' and #define GNOME_KEY_MOD_UNDO (GDK_CONTROL_MASK). This kind of compile-time options is almost totally useless because almost no application uses them. We should probably deprecate them and come up with a new dynamic system for binding predefined accels to stock items.

  • gnome-ui-init

    • more GnomeModuleInfos: GnomeClient, GnomeGConfUI

    • crash dialog setup
    • default window icon

      • This seems to invoke gnome_window_icon_set_from_file_list. Shouldn't apps use gtk_window_set_icon_from_file, gtk_window_set_default_icon_name API? -- ChristianNeumair 2006-01-19 22:57:12

  • gnome-url (gnome_url_show_on_screen)

    • replaces with gtk_show_uri()

  • gnome-vfs-util

    • This is deprecated in favour of Tgdk_pixbuf_new_from_stream(), although maybe we want a version of this that just takes a uri argument.
  • glade, gnome-vfs integration

    • libglade use should be replaced with GtkBuilder

    • gnome-vfs use should be replaced with GIO use

Further deprecations

For further deprecations of other modules, see the section Upcoming Deprecations.

Missing bits

• gnome-utils/gsearchtool requires gtk Session Management support and Gtk-combo-box-entry missing history feature to get fixed first.

• Anjuta: See http://www.mail-archive.com/desktop-devel-list@gnome.org/msg15471.html (unanswered)

  • ChPe: About "GnomeFileEntry in gtk for selecting a file that does not yet exist": That seems to be a case for GtkFilerChooserButton in GTK_FILE_CHOOSER_ACTION_SAVE mode, which is unsupported explicitly due to 157384.

• Deskbar-applet issues blocking removal of libgnomeui dependency

• seahorse-plugins depends on libpanel-applet for its encryption applet