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 classifications, see attributes(5).Those wishing to integrate with the GNOME desktop are recom-
mended to depend on interfaces marked as Committed. Theseinterfaces will not break after upgrade. The set of Commit-
ted interfaces is a subset of the GNOME Platform libraries (plus additional interfaces such as FreeDesktop interfacesand pkg-config).
Sun believes that the list of Committed interfaces is suit-
able 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 mayuse 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 commit-
ment level of any dependencies you may be using. Some such dependencies are optional and configure options can disablethem. 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 GNOMEbeing 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 accessto developer applications and API documentation. API docu-
mentation for GNOME interfaces can be found in related man-
pages and the API documentation installed to/usr/share/gtk-doc in HTML format.
SunOS 5.11 Last change: 16 May 2008 1
Headers, Tables, and Macros gnome-interfaces.5(5)
To do new development work with the latest GNOME code, con-
sider 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 todesktop-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 consideredVolatile, 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.SunOS 5.11 Last change: 16 May 2008 2
Headers, Tables, and Macros gnome-interfaces.5(5)
SunOS 5.11 Last change: 16 May 2008 3
Headers, Tables, and Macros gnome-interfaces.5(5)
_____________________________________________________________________
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- Volatile GNOME Platform
1.0/libspi/Accessibility.h
_____________________________________________________________________
/usr/lib/python2.4/site- Volatile GNOME Platform
packages/pyatspi/*_____________________________________________________________________
at-spi Committed GNOME Platform
SunOS 5.11 Last change: 16 May 2008 4
Headers, Tables, and Macros gnome-interfaces.5(5)
_____________________________________________________________________
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
SunOS 5.11 Last change: 16 May 2008 5
Headers, Tables, and Macros gnome-interfaces.5(5)
_____________________________________________________________________
| 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 attri-
butes:SunOS 5.11 Last change: 16 May 2008 6
Headers, Tables, and Macros gnome-interfaces.5(5)
____________________________________________________________
| 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-database(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), libgnome-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/SunOS 5.11 Last change: 16 May 2008 7
Headers, Tables, and Macros gnome-interfaces.5(5)
NOTES Written by Brian Cameron and Matt Keenan, Sun Microsystems Inc., 2003, 2007, 2008.SunOS 5.11 Last change: 16 May 2008 8