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. These
interfaces 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 interfaces
and 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 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 commit-
ment 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 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 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 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 CLASIFICATION
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
libartlgpl2 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
libgdkpixbuf-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
ATRIBUTES
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)
ATRIBUTE TYPE ATRIBUTE 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), libartlgpl2(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),
libgdkpixbuf-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)
ATRIBUTES
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
|
