gnome-interfaces.5(5) Headers, Tables, and Macros gnome-interfaces.5(5)
NAME
gnome-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/pkgconfig, 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
Administration Guide.
You must install the GNOME development packages for access to developer applications and API documentation. API documentation for GNOME
interfaces 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
OpenSolaris 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-discuss@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 Com-
mitted 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 ALSO
gdk-pixbuf-csource(1), gdk-pixbuf-query-loaders(1), gdm(1m), glib-genmarshal(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), libORBitCosNaming-2(3), libart_lgpl_2(3), libatk-1.0(3), libaudiofile(3),
libbonobo-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), libgnomeprintui-2-2(3), libgnomeui-2(3), libgnomevfs-2(3), libgobject-2.0(3),
libgstreamer-10.0(3), libgtk-x11-2.0(3), libogg(3), libpanel-applet-2(3), libpango-1.0(3), libpopt(3), librsvg(3), libvorbis(3), libvte(3),
libgtop(3) gnome-vfs-mime-magic(4), gnome-vfs.applications(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)