gnome-interfaces.5(5) Headers, Tables, and Macros gnome-interfaces.5(5)NAMEgnome-interfaces - GNOME interface classifications
DESCRIPTION
This page describes the interface classifications for items shipped
with the GNOME desktop. For the definitions of the interface classifi‐
cations, see attributes(5).
Those wishing to integrate with the GNOME desktop are recommended to
depend on interfaces marked as Committed. These interfaces will not
break after upgrade. The set of Committed interfaces is a subset of
the GNOME Platform libraries (plus additional interfaces such as
FreeDesktop interfaces and pkg-config).
Sun believes that the list of Committed interfaces is suitable for
writing a great GTK+ based application. Examples of programs that
depend only on these interfaces include: GIMP, Firefox, Thunderbird,
RealPlayer, and Adobe Reader.
Note that when you build software, any configure script may use the
pkg-config to identify what libraries are installed to the system.
Solaris includes pc files for non-Committed interfaces in /usr/lib/pkg‐
config, so be aware of the commitment level of any dependencies you may
be using. Some such dependencies are optional and configure options
can disable them. It is recommended that non-Committed interfaces are
not enabled if you require stability.
GNOME Platform libraries have an API/ABI stability guarantee from the
external GNOME community. While it is unlikely that non-Committed
interfaces in the GNOME Platform would break after upgrade, Sun makes
no guarantee that these interfaces have any stability. Refer to the
GNOME community for a list of Platform libraries for the version of
GNOME being used. Use non-Committed interfaces at your own risk.
GNOME Desktop interfaces have no stability guarantee and are intended
only for use for programs provided by the GNOME community. Xiph.org
interfaces also have no stability guarantee.
Instructions on how to integrate with the GNOME panel menu, the MIME
database, and icon integration are discussed in the GNOME System Admin‐
istration Guide.
You must install the GNOME development packages for access to developer
applications and API documentation. API documentation for GNOME inter‐
faces can be found in related manpages and the API documentation
installed to /usr/share/gtk-doc in HTML format.
To do new development work with the latest GNOME code, consider using
the latest version of OpenSolaris which you can download from the Open‐
Solaris website:
http://www.opensolaris.org/
Refer to the Java Desktop System project at OpenSolaris.org for
instructions on how to build GNOME based applications on Solaris. It
is recommended that you use the JDS Common Build Environment (CBE) that
you can find at the project website, the first link below. The second
link provides access to the latest GNOME development packages which can
be used with recent OpenSolaris builds to replace the desktop with an
unstable but most modern version, if desired.
http://www.opensolaris.org/os/project/jds/
http://dlc.sun.com/osol/jds/downloads/current/
To contact the desktop team at Sun send an email to desktop-dis‐
cuss@opensolaris.org.
The interfaces listed below ship with API documentation. Refer to the
specific manpage for details. GNOME interfaces which are not listed in
the table below should be considered Volatile, even if the interfaces
have gtk-docs installed in /usr/share/gtk-doc. Interfaces in Committed
libraries that are not documented in the man page or referenced gtk-doc
API documentation should be considered Volatile.
┌─────────────────────────────────┬──────────────────────────────────┐
│INTERFACE NAME │ CLASSIFICATION │
├─────────────────────────────────┼──────────────────────────────────┤
│gdk-pixbuf-csource │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gdk-pixbuf-query-loaders │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│glib-genmarshal │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│glib-gettextize │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│glib-mkenums │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gobject-query │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gtk-builder-convert │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gtk-query-immodules-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gtk-update-icon-cache │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│pkg-config │ Committed │
├─────────────────────────────────┼──────────────────────────────────┤
│libIDL-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libORBit-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libORBitCosNaming-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libart_lgpl_2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libatk-1.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libaudiofile │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libbonobo-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libbonobo-activation │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libbonoboui-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libcairo │ Uncommitted FreeDesktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libcspi │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/include/at-spi-1.0/lib‐ │ Volatile GNOME Platform │
│spi/Accessibility.h │ │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/lib/python2.4/site-pack‐ │ Volatile GNOME Platform │
│ages/pyatspi/* │ │
├─────────────────────────────────┼──────────────────────────────────┤
│at-spi │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libesd │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgailutil │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgconf-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgdk-x11-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgdk_pixbuf-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgio-2.0 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libglade-2.0 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libglib-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libglibmm-2.4 │ Uncommitted GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgiomm-2.4 │ Uncommitted GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgmodule-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgthread-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgnome-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgnomecanvas-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgnome-desktop-2 │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libgnomeprint-2.2 │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libgnomeprintui-2.2 │ Obsolete GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libgnomeui-2 │ Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgnomevfs-2 │ Obsolete Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgobject-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libgstreamer-10.0 │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libgstbase-10.0 │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libgtk-x11-2.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libogg │ Volatile Xiph.org │
├─────────────────────────────────┼──────────────────────────────────┤
│libpanel-applet-2 │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libpango-1.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libpangoft2-1.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libpangocairo-1.0.3 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│ibpangoxft-1.0.3 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libpangox-1.0 │ Committed GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│libpopt │ Volatile │
├─────────────────────────────────┼──────────────────────────────────┤
│librsvg │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│libvorbis │ Volatile Xiph.org │
├─────────────────────────────────┼──────────────────────────────────┤
│libvte │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│gnome-vfs-mime-magic │ Obsolete Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gnome-vfs.applications │ Obsolete Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gnome-vfs.keys │ Obsolete Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│gnome-vfs.mime │ Obsolete Volatile GNOME Platform │
├─────────────────────────────────┼──────────────────────────────────┤
│default.session │ Volatile GNOME Desktop │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/lib/pkgconfig │ Committed │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/share/applications │ Committed FreeDesktop │
├─────────────────────────────────┼──────────────────────────────────┤
│$HOME/.local/share/applications │ Committed FreeDesktop │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/share/gdm/defaults.conf │ Volatile │
├─────────────────────────────────┼──────────────────────────────────┤
│/etc/X11/gdm/custom.conf │ Volatile │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/bin/update-mime-database │ Committed │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/bin/update-desktop-database │ Committed │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/bin/pango-querymodules │ Committed │
├─────────────────────────────────┼──────────────────────────────────┤
│/usr/lib/libgtop │ Volatile GNOME Platform │
└─────────────────────────────────┴──────────────────────────────────┘
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWgnome-* │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOgdk-pixbuf-csource(1), gdk-pixbuf-query-loaders(1), gdm(1m), glib-gen‐
marshal(1), glib-gettextize(1), glib-mkenums(1), gobject-query(1), gtk-
builder-convert(1), gtk-query-immodules-2.0(1), gtk-update-icon-
cache(1), pango-querymodules(1), pkg-config(1), update-desktop-data‐
base(1), update-mime-database(1), libIDL-2(3), libORBit-2(3), libORBit‐
CosNaming-2(3), libart_lgpl_2(3), libatk-1.0(3), libaudiofile(3), lib‐
bonobo-2(3), libbonobo-activation(3), libbonoboui-2(3), libcairo(3),
libcspi(3), libesd(3), libgailutil(3), libgconf-2(3), libgdk-
x11-2.0(3), libgdk_pixbuf-2.0(3), libgio-2.0(3), libglade-2.0(3),
libglib-2.0(3), libglibmm-2.4(3), libgiomm-2.4(3), libgnome-2(3), libg‐
nome-desktop-2(3), libgnomecanvas-2(3), libgnomeprint-2-2(3), libg‐
nomeprintui-2-2(3), libgnomeui-2(3), libgnomevfs-2(3), libgob‐
ject-2.0(3), libgstreamer-10.0(3), libgtk-x11-2.0(3), libogg(3), lib‐
panel-applet-2(3), libpango-1.0(3), libpopt(3), librsvg(3), libvor‐
bis(3), libvte(3), libgtop(3)gnome-vfs-mime-magic(4), gnome-vfs.appli‐
cations(4), attributes(5), environ(5)ATTRIBUTES
See attributes(5) for descriptions of the above attributes:
Latest version of the GNOME Desktop System Administration Guide for
your platform.
The following web resources are useful for learning more about the
GNOME desktop and its interfaces:
http://www.opensolaris.org/os/project/jds/
http://www.gnome.org/
http://developer.gnome.org/
http://live.gnome.org/
http://www.gtkmm.org/
http://www.freedesktop.org/
http://www.xiph.org/
NOTES
Written by Brian Cameron and Matt Keenan, Sun Microsystems Inc., 2003,
2007, 2008.
SunOS 5.11 16 May 2008 gnome-interfaces.5(5)