'\" te
.TH gnome-interfaces\&.5 5 "16 May 2008" "SunOS 5.11" "Headers, Tables, and Macros"
.SH "NAME"
gnome-interfaces \- GNOME interface classifications
.SH "DESCRIPTION"
.PP
This page describes the interface classifications for items shipped
with the GNOME desktop\&. For the definitions of the interface classifications,
see \fBattributes\fR(5)\&.
.PP
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)\&.
.PP
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\&.
.PP
Note that when you build software, any configure script may use the
\fBpkg-config\fR to identify what libraries are installed to
the system\&.  Solaris includes pc files for non-Committed interfaces in
\fB/usr/lib/pkgconfig\fR, 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\&.
.PP
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\&.
.PP
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\&.
.PP
Instructions on how to integrate with the GNOME panel menu, the MIME
database, and icon integration are discussed in the GNOME System
Administration Guide\&.
.PP
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\&.
.PP
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:
.PP
\fBhttp://www\&.opensolaris\&.org/\fR
.PP
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\&.
.PP
\fBhttp://www\&.opensolaris\&.org/os/project/jds/\fR
\fBhttp://dlc\&.sun\&.com/osol/jds/downloads/current/\fR
.PP
To contact the desktop team at Sun send an email to
desktop-discuss@opensolaris\&.org\&.
.PP
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 \fB/usr/share/gtk-doc\fR\&.  Interfaces in Committed libraries
that are not documented in the man page or referenced gtk-doc API documentation
should be considered Volatile\&.
.sp
.TS
tab() allbox;
lw(2.750000i)| lw(2.750000i).
INTERFACE NAMECLASSIFICATION
\fBgdk-pixbuf-csource\fRCommitted GNOME Platform
\fBgdk-pixbuf-query-loaders\fRCommitted GNOME Platform
\fBglib-genmarshal\fRCommitted GNOME Platform
\fBglib-gettextize\fRCommitted GNOME Platform
\fBglib-mkenums\fRCommitted GNOME Platform
\fBgobject-query\fRCommitted GNOME Platform
\fBgtk-builder-convert\fRCommitted GNOME Platform
\fBgtk-query-immodules-2\&.0\fRCommitted GNOME Platform
\fBgtk-update-icon-cache\fRCommitted GNOME Platform
\fBpkg-config\fRCommitted
\fBlibIDL-2\fRVolatile GNOME Platform
\fBlibORBit-2\fRVolatile GNOME Platform
\fBlibORBitCosNaming-2\fRVolatile GNOME Platform
\fBlibart_lgpl_2\fRVolatile GNOME Platform
\fBlibatk-1\&.0\fRCommitted GNOME Platform
\fBlibaudiofile\fRVolatile GNOME Platform
\fBlibbonobo-2\fRVolatile GNOME Platform
\fBlibbonobo-activation\fRVolatile GNOME Platform
\fBlibbonoboui-2\fRVolatile GNOME Platform
\fBlibcairo\fRUncommitted FreeDesktop
\fBlibcspi\fRCommitted GNOME Platform
T{
\fB/usr/include/at-spi-1\&.0/libspi/Accessibility\&.h\fR
T}Volatile GNOME Platform
T{
\fB/usr/lib/python2\&.4/site-packages/pyatspi/*\fR
T}Volatile GNOME Platform
\fBat-spi\fRCommitted GNOME Platform
\fBlibesd\fRVolatile GNOME Platform
\fBlibgailutil\fRVolatile GNOME Platform
\fBlibgconf-2\fRVolatile GNOME Platform
\fBlibgdk-x11-2\&.0\fRCommitted GNOME Platform
\fBlibgdk_pixbuf-2\&.0\fRCommitted GNOME Platform
\fBlibgio-2\&.0\fRVolatile GNOME Platform
\fBlibglade-2\&.0\fRVolatile GNOME Platform
\fBlibglib-2\&.0\fRCommitted GNOME Platform
\fBlibglibmm-2\&.4\fRUncommitted GNOME Platform
\fBlibgiomm-2\&.4\fRUncommitted GNOME Platform
\fBlibgmodule-2\&.0\fRCommitted GNOME Platform
\fBlibgthread-2\&.0\fRCommitted GNOME Platform
\fBlibgnome-2\fRVolatile GNOME Platform
\fBlibgnomecanvas-2\fRVolatile GNOME Platform
\fBlibgnome-desktop-2\fRVolatile GNOME Desktop
\fBlibgnomeprint-2\&.2\fRVolatile GNOME Desktop
\fBlibgnomeprintui-2\&.2\fRObsolete GNOME Desktop
\fBlibgnomeui-2\fRVolatile GNOME Platform
\fBlibgnomevfs-2\fRObsolete Volatile GNOME Platform
\fBlibgobject-2\&.0\fRCommitted GNOME Platform
\fBlibgstreamer-10\&.0\fRVolatile GNOME Desktop
\fBlibgstbase-10\&.0\fRVolatile GNOME Desktop
\fBlibgtk-x11-2\&.0\fRCommitted GNOME Platform
\fBlibogg\fRVolatile Xiph\&.org
\fBlibpanel-applet-2\fRVolatile GNOME Desktop
\fBlibpango-1\&.0\fRCommitted GNOME Platform
\fBlibpangoft2-1\&.0\fRCommitted GNOME Platform
\fBlibpangocairo-1\&.0\&.3\fRCommitted GNOME Platform
\fBibpangoxft-1\&.0\&.3\fRCommitted GNOME Platform
\fBlibpangox-1\&.0\fRCommitted GNOME Platform
\fBlibpopt\fRVolatile
\fBlibrsvg\fRVolatile GNOME Desktop
\fBlibvorbis\fRVolatile Xiph\&.org
\fBlibvte\fRVolatile GNOME Desktop
\fBgnome-vfs-mime-magic\fRObsolete Volatile GNOME Platform
\fBgnome-vfs\&.applications\fRObsolete Volatile GNOME Platform
\fBgnome-vfs\&.keys\fRObsolete Volatile GNOME Platform
\fBgnome-vfs\&.mime\fRObsolete Volatile GNOME Platform
\fBdefault\&.session\fRVolatile GNOME Desktop
\fB/usr/lib/pkgconfig\fRCommitted
\fB/usr/share/applications\fRCommitted FreeDesktop
\fB$HOME/\&.local/share/applications\fRCommitted FreeDesktop
\fB/usr/share/gdm/defaults\&.conf\fRVolatile
\fB/etc/X11/gdm/custom\&.conf\fRVolatile
\fB/usr/bin/update-mime-database\fRCommitted
\fB/usr/bin/update-desktop-database\fRCommitted
\fB/usr/bin/pango-querymodules\fRCommitted
\fB/usr/lib/libgtop\fRVolatile GNOME Platform
.TE
.sp
.SH "ATTRIBUTES"
.PP
See \fBattributes\fR(5)
for descriptions of the following attributes:
.sp
.TS
tab() allbox;
cw(2.750000i)| cw(2.750000i)
lw(2.750000i)| lw(2.750000i).
ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWgnome-*
.TE
.sp
.SH "SEE ALSO"
.PP
\fBgdk-pixbuf-csource\fR(1),
\fBgdk-pixbuf-query-loaders\fR(1),
\fBgdm\fR(1m),
\fBglib-genmarshal\fR(1),
\fBglib-gettextize\fR(1),
\fBglib-mkenums\fR(1),
\fBgobject-query\fR(1),
\fBgtk-builder-convert\fR(1),
\fBgtk-query-immodules-2\&.0\fR(1),
\fBgtk-update-icon-cache\fR(1),
\fBpango-querymodules\fR(1),
\fBpkg-config\fR(1),
\fBupdate-desktop-database\fR(1),
\fBupdate-mime-database\fR(1),
\fBlibIDL-2\fR(3),
\fBlibORBit-2\fR(3),
\fBlibORBitCosNaming-2\fR(3),
\fBlibart_lgpl_2\fR(3),
\fBlibatk-1\&.0\fR(3),
\fBlibaudiofile\fR(3),
\fBlibbonobo-2\fR(3),
\fBlibbonobo-activation\fR(3),
\fBlibbonoboui-2\fR(3),
\fBlibcairo\fR(3),
\fBlibcspi\fR(3),
\fBlibesd\fR(3),
\fBlibgailutil\fR(3),
\fBlibgconf-2\fR(3),
\fBlibgdk-x11-2\&.0\fR(3),
\fBlibgdk_pixbuf-2\&.0\fR(3),
\fBlibgio-2\&.0\fR(3),
\fBlibglade-2\&.0\fR(3),
\fBlibglib-2\&.0\fR(3),
\fBlibglibmm-2\&.4\fR(3),
\fBlibgiomm-2\&.4\fR(3),
\fBlibgnome-2\fR(3),
\fBlibgnome-desktop-2\fR(3),
\fBlibgnomecanvas-2\fR(3),
\fBlibgnomeprint-2-2\fR(3),
\fBlibgnomeprintui-2-2\fR(3),
\fBlibgnomeui-2\fR(3),
\fBlibgnomevfs-2\fR(3),
\fBlibgobject-2\&.0\fR(3),
\fBlibgstreamer-10\&.0\fR(3),
\fBlibgtk-x11-2\&.0\fR(3),
\fBlibogg\fR(3),
\fBlibpanel-applet-2\fR(3),
\fBlibpango-1\&.0\fR(3),
\fBlibpopt\fR(3),
\fBlibrsvg\fR(3),
\fBlibvorbis\fR(3),
\fBlibvte\fR(3),
\fBlibgtop\fR(3)
\fBgnome-vfs-mime-magic\fR(4),
\fBgnome-vfs\&.applications\fR(4),
\fBattributes\fR(5),
\fBenviron\fR(5)
.SH "ATTRIBUTES"
.PP
See \fBattributes\fR(5)
for descriptions of the above attributes:
.PP
Latest version of the \fIGNOME Desktop System Administration Guide\fR for
your platform\&.
.PP
The following web resources are useful for learning more about the GNOME
desktop and its interfaces:
.PP
\fBhttp://www\&.opensolaris\&.org/os/project/jds/\fR
.PP
\fBhttp://www\&.gnome\&.org/\fR
.PP
\fBhttp://developer\&.gnome\&.org/\fR
.PP
\fBhttp://live\&.gnome\&.org/\fR
.PP
\fBhttp://www\&.gtkmm\&.org/\fR
.PP
\fBhttp://www\&.freedesktop\&.org/\fR
.PP
\fBhttp://www\&.xiph\&.org/\fR
.SH "NOTES"
.PP
Written by Brian Cameron and Matt Keenan, Sun Microsystems Inc\&., 2003, 2007, 2008\&.
...\" created by instant / solbook-to-man, Thu 20 Mar 2014, 02:30