glfs/x/lib/gtk+3.xml
Krejzi 742b99e018 GTK+3 XML fixes, moved gtkmm.xml to gtkmm3.xml and some other xml fixes
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9923 af4574ff-66df-0310-9fd7-8a98e5e911e0
2012-04-16 17:06:53 +00:00

313 lines
9.7 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gtk3-download-http
"&gnome-download-http;/gtk+/3.4/gtk+-&gtk3-version;.tar.xz">
<!ENTITY gtk3-download-ftp
"&gnome-download-ftp;/gtk+/3.4/gtk+-&gtk3-version;.tar.xz">
<!ENTITY gtk3-md5sum "2cbf02394c2c42cc597405eadabcac3e">
<!ENTITY gtk3-size "13 MB">
<!ENTITY gtk3-buildsize "330 MB">
<!ENTITY gtk3-time "2.9 SBU">
]>
<sect1 id="gtk3" xreflabel="GTK+-&gtk3-version;">
<?dbhtml filename="gtk3.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>GTK+-&gtk3-version;</title>
<indexterm zone="gtk3">
<primary sortas="a-gtk3">gtk+-3</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to GTK+-3</title>
<para>
The <application>GTK+-3</application> package contains
<application>GTK+-3</application> libraries. These are used for creating
graphical user interfaces for applications.
</para>
&lfs71_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&gtk3-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&gtk3-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &gtk3-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &gtk3-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &gtk3-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &gtk3-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">GTK+-3 Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="atk"/>,
<xref linkend="gdk-pixbuf"/> and
<xref linkend="pango"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="gobject-introspection"/> (required if you want to build
GNOME. NB, you will need to install
<application>Gobject Introspection</application> before you install
<xref linkend="atk"/>, <xref linkend="gdk-pixbuf"/> and
<xref linkend="pango"/>.)
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="cups"/>,
<xref linkend="docbook-utils"/>,
<xref linkend="colord"/> and
<xref linkend="gtk-doc"/> (only needed if you want to rebuild the
documentation).
</para>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/gtk3"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GTK+-3</title>
<para>
Install <application>GTK+-3</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</userinput></screen>
<para>
To test the results:
</para>
<screen><userinput>rm tests/css/parser/selector.css &amp;&amp;
rm tests/a11y/pickers.ui &amp;&amp;
make check</userinput></screen>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<parameter>--disable-packagekit</parameter>: This parameter disables use
of PackageKit which isn't suitable for BLFS.
</para>
<para>
<command>rm tests/css/parser/selector.css</command> and
<command>rm tests/a11y/pickers.ui</command>: This prevents two tests
being run as they are known to fail.
</para>
</sect2>
<sect2 role="configuration">
<title>Configuring GTK+-3</title>
<sect3 id="gtk3-config">
<title>Config Files</title>
<para>
<filename>~/.config/gtk-3.0/settings.ini</filename> and
<filename>/etc/gtk-3.0/settings.ini</filename>
</para>
<indexterm zone="gtk3 gtk3-config">
<primary sortas="e-AA.home-settings.ini">~/.config/gtk-3.0/settings.ini</primary>
</indexterm>
<indexterm zone="gtk3 gtk3-config">
<primary sortas="e-etc-path-settings.ini">/etc/gtk-3.0/settings.ini</primary>
</indexterm>
</sect3>
<sect3><title>Configuration Information</title>
<para>
GTK+-3 themes change the way a gtk application looks. An icon theme can
be used to change the icons that appear on the application's toolbar. If
you have installed a GTK+-3 theme (eg
<xref linkend="gnome-themes-standard"/> or an icon theme (such as
<xref linkend="gnome-icon-theme"/>) you can set your prefences in
<filename>~/.config/gtk-3.0/settings.ini</filename>:
</para>
<screen><userinput>cat &gt; ~/.config/gtk-3.0/settings.ini &lt;&lt; "EOF"
[Settings]
gtk-theme-name = <replaceable>Adwaita</replaceable>
gtk-fallback-icon-theme = <replaceable>gnome</replaceable>
EOF</userinput></screen>
<para>
There are many more themes available at
<ulink url="http://gnome-look.org/"/> and other places.
</para>
<para>
Once you've settled on themes you like, you can (as the
<systemitem class="username">root</systemitem> user) make them the
default system wide:
</para>
<screen role="root"><userinput>cat &gt; /etc/gtk-3.0/settings.ini &lt;&lt; "EOF"[Settings]
gtk-theme-name = <replaceable>Clearwaita</replaceable>
gtk-fallback-icon-theme = <replaceable>elementary</replaceable>
EOF</userinput></screen>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
gtk3-demo, gtk-query-immodules-3.0 and gtk-update-icon-cache
</seg>
<seg>
libgailutil.so, libgdk-3.so and libgtk-3.so
</seg>
<seg>
/etc/gtk-3.0, /usr/include/{gail-3.0,gtk-3.0},
/usr/lib/gtk-3.0, /usr/share/gtk-3.0 and
/usr/share/gtk-doc/html/{gail-libgail-util3,gdk3,gtk3}
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gtk3-demo">
<term><command>gtk3-demo</command></term>
<listitem>
<para>
is a simple program that demonstrates some of the things that can be
done with <application>GTK+-3</application>
</para>
<indexterm zone="gtk3 gtk3-demo">
<primary sortas="b-gtk3-demo">gtk3-demo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gtk-query-immodules-3.0">
<term><command>gtk-query-immodules-3.0</command></term>
<listitem>
<para>
collects information about loadable input method modules for
<application>GTK+-3</application> and writes it to the default cache
file location, or to standard output.
</para>
<indexterm zone="gtk3 gtk-query-immodules-3.0">
<primary sortas="b-gtk-query-immodules-3.0">gtk-query-immodules-3.0</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gtk-update-icon-cache3">
<term><command>gtk-update-icon-cache</command></term>
<listitem>
<para>
is an icon theme caching utility that creates mmap()able cache files
for icon themes.
</para>
<indexterm zone="gtk3 gtk-update-icon-cache3">
<primary sortas="b-gtk-update-icon-cache3">gtk-update-icon-cache</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgailutil">
<term><filename class='libraryfile'>libgailutil.so</filename></term>
<listitem>
<para>
contains functions that implements the accessibility interfaces
defined by the GNOME Accessibility Toolkit
</para>
<indexterm zone="gtk3 libgailutil">
<primary sortas="c-libgailutil">libgailutil.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgdk-3">
<term><filename class='libraryfile'>libgdk-3.so</filename></term>
<listitem>
<para>
contains functions that act as a wrapper around the low-level
drawing and windowing functions provided by the underlying graphics
system.
</para>
<indexterm zone="gtk3 libgdk-3">
<primary sortas="c-libgdk-3">libgdk-3.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgtk-3">
<term><filename class='libraryfile'>libgtk-3.so</filename></term>
<listitem>
<para>
contains functions that provide an API to implement graphical user
interfaces.
</para>
<indexterm zone="gtk3 libgtk-3">
<primary sortas="c-libgtk-3">libgtk-3.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>