/!\ As of GTK+ 3.0 this project is considered complete. /!\

libgnome and libgnomeui Must Die!

Why? See ProjectRidley

libgnome

  • DONE (already deprecated and replaced)
    • gnome-config: replaced by GSettings 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, provided by GVFS

    • gnome-url

      • Replaced with gtk_show_uri().

    • gnome-help

    • 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

    • gnome-init

      • Gnome and Bonobo GnomeModuleInfos

      • Use gtk_init() or gtk_init_with_args() for command line option processing.
      • .gnome2/ dir stuff. Apps should 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 equivalent

        • The CALL_PARENT macros are proxies to libbonobo macros, eel also has some similar macros.
    • 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/

    • 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 GtkApplication, GtkApplicationWindow, and GtkBuilder

    • 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)

    • 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: replaced by GtkBuilder

    • 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 and GtkApplicationWindow

    • 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

    • 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, use GSettings to store arrays of strings.
    • GnomeIconEntry

    • gnome-icon-lookup

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

      • To be replaced by EggIconChooser?

    • GnomePasswordDialog

    • 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

        • Stock icons have been deprecated in GTK+; use icon theme names
    • 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

Attic/LibgnomeMustDie (last edited 2015-10-05 10:30:29 by EmmanueleBassi)