Subversion Repositories svn LFS-FR

Compare Revisions

Ignore whitespace Rev 541 → Rev 542

/trunk/blfs/x/xorg/xorg.xml
File deleted
/trunk/blfs/x/xorg/xorg.ent
File deleted
/trunk/blfs/x/x.ent
File deleted
/trunk/blfs/x/wm/enlightenment/enlightenment-config.xml
File deleted
/trunk/blfs/x/wm/enlightenment/enlightenment.ent
File deleted
/trunk/blfs/x/wm/enlightenment/enlightenment-intro.xml
File deleted
/trunk/blfs/x/wm/enlightenment/enlightenment-exp.xml
File deleted
/trunk/blfs/x/wm/enlightenment/enlightenment-inst.xml
File deleted
/trunk/blfs/x/wm/enlightenment/enlightenment-desc.xml
File deleted
/trunk/blfs/x/wm/sawfish/sawfish-config.xml
File deleted
/trunk/blfs/x/wm/sawfish/sawfish.ent
File deleted
/trunk/blfs/x/wm/sawfish/sawfish-intro.xml
File deleted
/trunk/blfs/x/wm/sawfish/sawfish-exp.xml
File deleted
/trunk/blfs/x/wm/sawfish/sawfish-inst.xml
File deleted
/trunk/blfs/x/wm/sawfish/sawfish-desc.xml
File deleted
/trunk/blfs/x/wm/metacity/metacity-config.xml
File deleted
/trunk/blfs/x/wm/metacity/metacity.ent
File deleted
/trunk/blfs/x/wm/metacity/metacity-intro.xml
File deleted
/trunk/blfs/x/wm/metacity/metacity-inst.xml
File deleted
/trunk/blfs/x/wm/metacity/metacity-desc.xml
File deleted
/trunk/blfs/x/wm/enlightenment.xml
File deleted
/trunk/blfs/x/wm/fluxbox/fluxbox.ent
File deleted
/trunk/blfs/x/wm/fluxbox/fluxbox-intro.xml
File deleted
/trunk/blfs/x/wm/fluxbox/fluxbox-exp.xml
File deleted
/trunk/blfs/x/wm/fluxbox/fluxbox-inst.xml
File deleted
/trunk/blfs/x/wm/fluxbox/fluxbox-desc.xml
File deleted
/trunk/blfs/x/wm/fluxbox/fluxbox-config.xml
File deleted
/trunk/blfs/x/wm/xfce/xfce-config.xml
File deleted
/trunk/blfs/x/wm/xfce/xfce.ent
File deleted
/trunk/blfs/x/wm/xfce/xfce-intro.xml
File deleted
/trunk/blfs/x/wm/xfce/xfce-inst.xml
File deleted
/trunk/blfs/x/wm/xfce/xfce-desc.xml
File deleted
/trunk/blfs/x/wm/wm.xml
1,48 → 1,57
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="x-wm">
<?dbhtml filename="wm.html"?>
<title>Gestionnaires de fenêtres</title>
<?dbhtml filename="wm.html" ?>
<title>Window Managers</title>
 
<sect1 id="Introduction">
<sect1 id="Introduction">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<title>Introduction</title>
 
<para>Des gestionnaires de fenêtres et des environnements de bureau sont les
interfaces principales de l'utilisateur dans le système
<application>X</application> Window. Un gestionnaire de fenêtre est un
programme qui contrôle l'apparence des fenêtres et apporte les moyens par
lesquels l'utilisateur peut interagir avec elles. Un environnement de bureau
apporte une interface plus complète au système d'exploitation et apporte un
ensemble d'utilitaires et d'applications intégrés.</para>
<para>Window Mangers and Desktop Environments are the primary user
interfaces into the <application>X</application> Window System. A window
manager is a program that controls the appearance of windows and provides the
means by which the user can interact with them. A Desktop Environment
provides a more complete interface to the operating system, and provides a
range of integrated utilities and applications.</para>
 
<para>Il existe un grand nombre de gestionnaires de fenêtres. Les plus connus
incluent <application>fvwm2</application>, <application>Window
<para>There are many Window Mangers available. Some of the more well
known ones include <application>fvwm2</application>, <application>Window
Maker</application>, <application>AfterStep</application>,
<application>Enlightenment</application>, <application>Sawfish</application>,
et <application>Blackbox</application>.</para>
<application>Enlightenment</application>,
<application>Sawfish</application>,
and <application>Blackbox</application>.</para>
 
<para>Les environnements de bureau disponibles pour Linux sont
<para>The Desktop Environments available for Linux are
<application><acronym>GNOME</acronym></application>,
<application><acronym>KDE</acronym></application> et
<application><acronym>KDE</acronym></application>, and
<application>XFce</application>.</para>
 
<para>Choisir un gestionnaire de fenêtres ou un environnement de bureau est
hautement subjectif. Le choix dépend de l'apparence ('look and feel') des
packages, des ressources (<acronym>RAM</acronym>, espace disque) requises, et
des utilitaires inclues. Un site web, apportant un très bon résumé de ce qui
est disponible, des copies d'écran et les fonctionnalités respectives, est
<ulink url="http://www.plig.org/xwinman/">Gestionnaires de Fenêtres sous
X</ulink>.</para>
<para>Choosing a Window Manager or Desktop Environment is highly subjective.
The choice depends on the look and feel of the packages, the resources
(<acronym>RAM</acronym>, disk space) required, and the utilities included.
One web site that provides a very good summary of what is available,
screenshots, and their respective features is
<ulink url="http://www.plig.org/xwinman/">Window Managers for X</ulink>.</para>
 
<para>Dans ce chapitre, les instructions d'installation de plusieurs
gestionnaires de bureau et d'un environnement de bureau léger sont présentées.
Plus loin dans ce livre, <application><acronym>KDE</acronym></application> et
<application><acronym>GNOME</acronym></application> auront leurs propres sections.</para>
 
<para>In this chapter, the installation instructions of several Window
Managers and one lightweight Desktop Environment are presented. Later in the
book, both <application><acronym>KDE</acronym></application> and
<application><acronym>GNOME</acronym></application> have their own
sections.</para>
</sect1>
 
&sawfish;
&fluxbox;
&metacity;
&xfce;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sawfish.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fluxbox.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="metacity.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfce.xml"/>
 
</chapter>
/trunk/blfs/x/wm/sawfish.xml
1,13 → 1,158
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY sawfish-download-http "http://prdownloads.sourceforge.net/sawmill/sawfish-&sawfish-version;.tar.gz">
<!ENTITY sawfish-download-ftp " ">
<!ENTITY sawfish-md5sum "9e5ce5e76c60acecdb1889c1f173295a">
<!ENTITY sawfish-size "1.5 MB">
<!ENTITY sawfish-buildsize "17.5 MB">
<!ENTITY sawfish-time "0.26 SBU">
]>
 
<sect1 id="sawfish" xreflabel="sawfish-&sawfish-version;">
<?dbhtml filename="sawfish.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="sawfish.html" ?>
<title>sawfish-&sawfish-version;</title>
<indexterm zone="sawfish"><primary
sortas="a-Sawfish">Sawfish</primary></indexterm>
 
&sawfish-intro;
&sawfish-inst;
&sawfish-exp;
&sawfish-config;
&sawfish-desc;
<sect2>
<title>Introduction to <application>sawfish</application></title>
 
<para>The <application>sawfish</application> package contains a window manager.
This is useful for organizing and displaying windows where all window
decorations are configurable and all user-interface policy is controlled
through the extension language.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&sawfish-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&sawfish-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &sawfish-md5sum;</para></listitem>
<listitem><para>Download size: &sawfish-size;</para></listitem>
<listitem><para>Estimated disk space required:
&sawfish-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&sawfish-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>sawfish</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="librep"/>,
<xref linkend="rep-gtk"/>,
<xref linkend="esound"/> and
<xref linkend="gtk2"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>sawfish</application></title>
 
<para>Install <application>sawfish</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --libexec=/usr/sbin --infodir=/usr/share/info \
--disable-themer &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--with-audiofile</option>: This command directs
<application>sawfish</application> to use
<filename class="libraryfile">libaudiofile</filename>
for sound manipulation.</para>
 
<para><option>--with-esd</option>: This command directs <application>
sawfish</application> to use the Enlightened Sound Daemon.</para>
 
<para><option>--disable-themer</option>: This
option prevents building the <application>sawfish</application> themer.
This program was not migrated to <application>GTK-2</application>.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>sawfish</application></title>
 
<sect3 id="sawfish-config"><title>Configuration Information</title>
<indexterm zone="sawfish sawfish-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
<para>Be sure to backup your current <filename>.xinitrc</filename>
before proceeding.</para>
 
<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
exec sawfish
<command>EOF</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>sawfish, sawfish-client and sawfish-ui</seg>
<seg>None</seg>
<seg>/usr/share/sawfish, /usr/sbin/sawfish and /usr/lib/rep/*/</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="sawfish-prog">
<term><filename>sawfish</filename></term>
<listitem><para>is the extensible window manager using a
<application>Lisp</application>-based scripting language.</para>
<indexterm zone="sawfish sawfish-prog">
<primary sortas="b-sawfish">sawfish</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="sawfish-client">
<term><filename>sawfish-client</filename></term>
<listitem><para>allows you to connect to a window manager process and
evaluate arbitrary <application>Lisp</application> forms.</para>
<indexterm zone="sawfish sawfish-client">
<primary sortas="b-sawfish-client">sawfish-client</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="sawfish-ui">
<term><filename>sawfish-ui</filename></term>
<listitem><para>is the <application>sawfish</application> configurator.</para>
<indexterm zone="sawfish sawfish-ui">
<primary sortas="b-sawfish-ui">sawfish-ui</primary></indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/wm/xfce.xml
1,12 → 1,390
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xfce-download-http "http://www.us.xfce.org/archive/xfce-&xfce-version;/fat_tarballs/xfce-&xfce-version;-src-bz2.tar.bz2">
<!ENTITY xfce-download-ftp " ">
<!ENTITY xfce-md5sum "8b213c0db2ac25b85a094e5959f5b2c1">
<!ENTITY xfce-size "15 MB">
<!ENTITY xfce-buildsize "215 MB">
<!ENTITY xfce-time "3.24 SBU">
]>
 
<sect1 id="xfce" xreflabel="XFce-&xfce-version;">
<?dbhtml filename="xfce.html"?>
<sect1info>
<othername>$LastChangedBy: igor $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="xfce.html" ?>
<title>XFce-&xfce-version;</title>
 
&xfce-intro;
&xfce-inst;
&xfce-config;
&xfce-desc;
<indexterm zone="xfce">
<primary sortas="a-xfce">XFce</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>XFce</application></title>
 
<para>The <application>XFce</application> package contains a lightweight
desktop environment.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&xfce-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&xfce-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &xfce-md5sum;</para></listitem>
<listitem><para>Download size: &xfce-size;</para></listitem>
<listitem><para>Estimated disk space required: &xfce-buildsize;</para></listitem>
<listitem><para>Estimated build time: &xfce-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application>XFce</application> dependencies</title>
 
<sect4>
<title>Required</title>
 
<para><xref linkend="gtk2"/> and
<xref linkend="libxml2"/>
</para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="libgtkhtml"/>,
<xref linkend="startup-notification"/>,
<xref linkend="a2ps"/> and
<xref linkend="psutils"/>
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>XFce</application></title>
 
<para><application>XFce</application> now distributes as a
<acronym>TAR</acronym> ball of base packages and module packages.
For each package, run the following:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
<para>The following packages will install the bare minimum:</para>
 
<itemizedlist spacing='compact'>
<listitem><para>libxfce4util-&xfce-version;</para></listitem>
<listitem><para>dbh-1.0.20</para></listitem>
<listitem><para>libxfcegui4-&xfce-version;</para></listitem>
<listitem><para>libxfce4mcs-&xfce-version;</para></listitem>
<listitem><para>xfce-mcs-manager-&xfce-version;</para></listitem>
<listitem><para>xfwm4-&xfce-version;</para></listitem>
<listitem><para>xfce4-panel-&xfce-version;</para></listitem>
<listitem><para>xfdesktop-&xfce-version;</para></listitem>
<listitem><para>xfce-utils-&xfce-version;</para></listitem>
</itemizedlist>
 
<para>In addition, you may choose to install:</para>
<itemizedlist spacing='compact'>
<listitem><para>gtk-xfce-engine-2.2.5</para></listitem>
<listitem><para>xfcalendar-&xfce-version;</para></listitem>
<listitem><para>xfce-mcs-plugins-&xfce-version;</para></listitem>
<listitem><para>xfce4-appfinder-&xfce-version;</para></listitem>
<listitem><para>xfce4-icon-theme-&xfce-version;</para></listitem>
<listitem><para>xfce4-iconbox-&xfce-version;</para></listitem>
<listitem><para>xfce4-mixer-&xfce-version;</para></listitem>
<listitem><para>xfce4-session-&xfce-version;</para></listitem>
<listitem><para>xfce4-systray-&xfce-version;</para></listitem>
<listitem><para>xfce4-toys-&xfce-version;</para></listitem>
<listitem><para>xfce4-trigger-launcher-&xfce-version;</para></listitem>
<listitem><para>xffm-&xfce-version;</para></listitem>
<listitem><para>xfprint-&xfce-version;</para></listitem>
<listitem><para>xfwm4-themes-&xfce-version;</para></listitem>
</itemizedlist>
 
</sect2>
 
<sect2 id='xfce-config'>
<title>Configuring <application>XFce</application></title>
 
<sect3>
<title>Config files</title>
<para><filename>~/.xinitrc</filename></para>
</sect3>
 
<sect3>
<title>Configuration Information</title>
 
<para>Be sure to backup your current <filename>.xinitrc</filename> before
proceeding.</para>
 
<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
xfce-mcs-manager
xfwm4 --daemon
xftaskbar4 &amp;
xfdesktop &amp;
exec xfce4-panel
<command>EOF</command></userinput></screen>
 
<indexterm zone="xfce xfce-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
</sect3>
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>fgr, scramble, startxfce4, xfbook, xfbook4, xfcalendar,
xfce-mcs-manager, xfce-setting-show, xfce4-about,
xfce4-appfinder, xfce4-iconbox, xfce4-kiosk-query,
xfce4-menueditor, xfce4-mixer, xfce4-panel, xfce4-session,
xfce4-session-logout, xfce4-tips, xfdesktop, xfdiff4, xffm,
xffrequent, xffrequent4, xffstab, xffstab4, xfglob4, xfhelp4,
xflock4, xfmime-edit, xfmountdev4, xfrecent, xfrecent4,
xfprint-manager, xfprint4, xfrun4, xfsamba4, xftaskbar4,
xfterm4, xftrash4, xftree4, xfwm4</seg>
<seg id='xfcelibs'>libdbh, libxfce4mcs, libxfce4util, libxfcegui4,
libxffm, libxfsm, libxfprint</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
 
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libdbh">libdbh.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfce4mcs">libxfce4mcs.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfce4util">libxfce4util.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfcegui4">libxfcegui4.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxffm">libxffm.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfsm">libxfsm.so</primary>
</indexterm>
<indexterm zone="xfce xfcelibs">
<primary sortas="c-libxfprint">libxfprint.so</primary>
</indexterm>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="fgr">
<term><command>fgr</command></term>
<listitem>
<para>is a file content search engine for <command>xffm</command>.</para>
<indexterm zone="xfce fgr">
<primary sortas="b-fgr">fgr</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce-mce-manager">
<term><command>xfce-mce-manager</command></term>
<listitem>
<para>is the settings manager for <application>XFce</application>.</para>
<indexterm zone="xfce xfce-mce-manager">
<primary sortas="b-xfce-mce-manager">xfce-mce-manager</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-about">
<term><command>xfce4-about</command></term>
<listitem>
<para>displays the about box.</para>
<indexterm zone="xfce xfce4-about">
<primary sortas="b-xfce4-about">xfce4-about</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-session">
<term><command>xfce4-session</command></term>
<listitem>
<para>starts up the <application>XFce</application> Desktop
Environment.</para>
<indexterm zone="xfce xfce4-session">
<primary sortas="b-xfce4-session">xfce4-session</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-session-logout">
<term><command>xfce4-session-logout</command></term>
<listitem>
<para>logs out from <application>XFce</application>.</para>
<indexterm zone="xfce xfce4-session-logout">
<primary sortas="b-xfce4-session-logout">xfce4-session-logout</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce-setting-show">
<term><command>xfce-setting-show</command></term>
<listitem>
<para>displays the settings for <application>XFce</application>.</para>
<indexterm zone="xfce xfce-setting-show">
<primary sortas="b-xfce-setting-show">xfce-setting-show</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfce4-panel">
<term><command>xfce4-panel</command></term>
<listitem>
<para>is the panel manager for <application>XFce</application>. It contains
the launcher, clock, mail check, desktop switcher and separator programs.</para>
<indexterm zone="xfce xfce4-panel">
<primary sortas="b-xfce4-panel">xfce4-panel</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfdesktop">
<term><command>xfdesktop</command></term>
<listitem>
<para> is the desktop manager for <application>XFce</application>.</para>
<indexterm zone="xfce xfdesktop">
<primary sortas="b-xfdesktop">xfdesktop</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfhelp4">
<term><command>xfhelp4</command></term>
<listitem>
<para>is script that launches a <acronym>HTML</acronym> browser to
display online documentation.</para>
<indexterm zone="xfce xfhelp4">
<primary sortas="b-xfhelp4">xfhelp4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xflock4">
<term><command>xflock4</command></term>
<listitem>
<para>is a script used to lock the current screen during drag and drop actions.</para>
<indexterm zone="xfce xflock4">
<primary sortas="b-xflock4">xflock4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfmountdev4">
<term><command>xfmountdev4</command></term>
<listitem>
<para>mounts a device on the specified mount point and launches <command>xftree4</command>,
then unmounts the device when <command>xftree4</command> finishes.</para>
<indexterm zone="xfce xfmountdev4">
<primary sortas="b-xfmountdev4">xfmountdev4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfrun4">
<term><command>xfrun4</command></term>
<listitem>
<para>is the program launcher for <application>XFce</application>.</para>
<indexterm zone="xfce xfrun4">
<primary sortas="b-xfrun4">xfrun4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfsamba4">
<term><command>xfsamba4</command></term>
<listitem>
<para> is the <application>Samba</application> front end for <application>XFce</application>.</para>
<indexterm zone="xfce xfsamba4">
<primary sortas="b-xfsamba4">xfsamba4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xftaskbar4">
<term><command>xftaskbar4</command></term>
<listitem>
<para>is the taskbar manager for <application>XFce</application>.</para>
<indexterm zone="xfce xftaskbar4">
<primary sortas="b-xftaskbar4">xftaskbar4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfterm4">
<term><command>xfterm4</command></term>
<listitem>
<para>is a small terminal wrapper to be used as a drag and drop action
for the <application>XFce</application> front panel.</para>
<indexterm zone="xfce xfterm4">
<primary sortas="b-xfterm4">xfterm4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xftrash4">
<term><command>xftrash4</command></term>
<listitem>
<para>is a small script to be used as a drag and drop action for the
<application>XFce</application> front panel.</para>
<indexterm zone="xfce xftrash4">
<primary sortas="b-xftrash4">xftrash4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xftree4">
<term><command>xftree4</command></term>
<listitem>
<para>is the file manager for <application>XFce</application>.</para>
<indexterm zone="xfce xftree4">
<primary sortas="b-xftree4">xftree4</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xfwm4">
<term><command>xfwm4</command></term>
<listitem>
<para>is an <application>X11</application> window manager for <application>XFce</application>.</para>
<indexterm zone="xfce xfwm4">
<primary sortas="b-xfwm4">xfwm4</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
</sect1>
 
/trunk/blfs/x/wm/fluxbox.xml
1,13 → 1,186
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY fluxbox-download-http "http://prdownloads.sourceforge.net/fluxbox/fluxbox-&fluxbox-version;.tar.bz2">
<!ENTITY fluxbox-download-ftp " ">
<!ENTITY fluxbox-md5sum "398f4e10d88b47507ea309968340961c">
<!ENTITY fluxbox-size "637 KB">
<!ENTITY fluxbox-buildsize "36.7 MB">
<!ENTITY fluxbox-time "1.28 SBU">
]>
 
<sect1 id="fluxbox" xreflabel="Fluxbox-&fluxbox-version;">
<?dbhtml filename="fluxbox.html"?>
<sect1info>
<othername>$LastChangedBy: larry $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="fluxbox.html" ?>
<title>Fluxbox-&fluxbox-version;</title>
<indexterm zone="fluxbox"><primary
sortas="a-Fluxbox">Fluxbox</primary></indexterm>
 
&fluxbox-intro;
&fluxbox-inst;
&fluxbox-exp;
&fluxbox-config;
&fluxbox-desc;
<sect2>
<title>Introduction to <application>Fluxbox</application></title>
 
<para>The <application>Fluxbox</application> package contains a window manager.
</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&fluxbox-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&fluxbox-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &fluxbox-md5sum;</para></listitem>
<listitem><para>Download size: &fluxbox-size;</para></listitem>
<listitem><para>Estimated disk space required:
&fluxbox-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&fluxbox-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Fluxbox</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para></sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Fluxbox</application></title>
 
<para>Install <application>Fluxbox</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
 
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configuring <application>Fluxbox</application></title>
 
<sect3 id="fluxbox-config"><title>Config files</title>
<para><filename>~/.fluxbox/init</filename>,
<filename>~/.fluxbox/keys</filename>,
<filename>~/.fluxbox/menu</filename></para>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.fluxbox-init">~/.fluxbox/init</primary></indexterm>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.fluxbox-keys">~/.fluxbox/keys</primary></indexterm>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.fluxbox-menu">~/.fluxbox/menu</primary></indexterm>
</sect3>
 
<sect3><title>Configuration Information</title>
 
<para>Be sure to backup your current <filename>.xinitrc</filename> before
proceeding.</para>
<indexterm zone="fluxbox fluxbox-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
startfluxbox
<command>EOF</command></userinput></screen>
 
<para>Now create the <application>Fluxbox</application> configuration
files:</para>
 
<screen><userinput><command>mkdir ~/.fluxbox &amp;&amp;
cp /usr/share/fluxbox/init ~/.fluxbox/init &amp;&amp;
cp /usr/share/fluxbox/keys ~/.fluxbox/keys &amp;&amp;
cp /usr/share/fluxbox/menu ~/.fluxbox/menu </command></userinput></screen>
 
<para>Menu Items are added by editing <filename>~/.fluxbox/menu</filename>. The
syntax is explained on the fluxbox man page.</para>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>fluxbox, fbsetbg, bsetroot, fluxbox-generate_menu, startfluxbox, and
fbrun</seg>
<seg>None</seg>
<seg>/usr/share/fluxbox and ~/.fluxbox</seg></seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="fluxbox-prog">
<term><command>fluxbox</command></term>
<listitem><para>is a window manager for <application>X11</application> based
on <application>Blackbox</application> 0.61.0.</para>
<indexterm zone="fluxbox fluxbox-prog">
<primary sortas="b-fluxbox">fluxbox</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="fbsetbg">
<term><command>fbsetbg</command></term>
<listitem><para>is a utility that sets the background image.
It needs <command>display</command>, <command>Esetroot</command>,
<command>wmsetbg</command>, <command>xv</command>,
<command>qiv</command> or <command>xsri</command> to be used.</para>
<indexterm zone="fluxbox fbsetbg">
<primary sortas="b-fbsetbg">fbsetbg</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="bsetroot">
<term><command>bsetroot</command></term>
<listitem><para>is a <application>Blackbox</application>
utility to change root window appearance.</para>
<indexterm zone="fluxbox bsetroot">
<primary sortas="b-bsetroot">bsetroot</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="fluxbox-generate">
<term><command>fluxbox-generate_menu</command></term>
<listitem><para> is a menu maker utility.</para>
<indexterm zone="fluxbox fluxbox-generate">
<primary sortas="b-fluxbox-generate">fluxbox-generate_menu</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="startfluxbox">
<term><command>startfluxbox</command></term>
<listitem><para> is a session startup script that
allows for command executions prior to <command>fluxbox</command>
starting.</para>
<indexterm zone="fluxbox startfluxbox">
<primary sortas="b-startfluxbox">startfluxbox</primary></indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="fbrun">
<term><command>fbrun</command></term>
<listitem><para> displays a run dialog window.</para>
<indexterm zone="fluxbox fbrun">
<primary sortas="b-fbrun">fbrun</primary></indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/wm/metacity.xml
1,12 → 1,180
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY metacity-download-http "http://ftp.gnome.org/pub/GNOME/sources/metacity/2.8/metacity-&metacity-version;.tar.bz2">
<!ENTITY metacity-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/metacity/2.8/metacity-&metacity-version;.tar.bz2">
<!ENTITY metacity-md5sum "c49e4b5575503975516159780855e317">
<!ENTITY metacity-size "2.1 MB">
<!ENTITY metacity-buildsize "46.9 MB">
<!ENTITY metacity-time "0.41 SBU">
]>
 
<sect1 id="metacity" xreflabel="Metacity-&metacity-version;">
<?dbhtml filename="metacity.html"?>
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="metacity.html" ?>
<title>Metacity-&metacity-version;</title>
 
&metacity-intro;
&metacity-inst;
&metacity-config;
&metacity-desc;
<indexterm zone="metacity">
<primary sortas="a-metacity">Metacity</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>Metacity</application></title>
 
<para>The <application>Metacity</application> package contains a window
manager. This is useful for organizing and displaying windows.</para>
 
<sect3>
<title>Package information</title>
 
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&metacity-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&metacity-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &metacity-md5sum;</para></listitem>
<listitem><para>Download size: &metacity-size;</para></listitem>
<listitem><para>Estimated disk space required: &metacity-buildsize;</para></listitem>
<listitem><para>Estimated build time: &metacity-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application>Metacity</application> dependencies</title>
 
<sect4>
<title>Required</title>
 
<para><xref linkend="intltool"/>,
<xref linkend="GConf"/>, and
<xref linkend="gtk2"/>
</para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="startup-notification"/>,
<ulink url="http://freedesktop.org/Software/xlibs">Xrender</ulink>*, and
<ulink url="http://freedesktop.org/Software/xlibs">libXcomposite</ulink>**
</para>
 
<para>* <filename class='libraryfile'>libXrender</filename> is included in a
<acronym>BLFS</acronym> <application>X</application> Window System
installation, but the pkgconfig <filename>.pc</filename> file
<application>Metacity</application> looks for is not installed. Satisfy the
requirement by installing an <filename>xrender.pc</filename> file into
<filename class='directory'>/usr/X11R6/lib/pkgconfig</filename> which can be
installed as:</para>
 
<screen><userinput><command>cat &gt; /usr/X11R6/lib/pkgconfig/xrender.pc &lt;&lt; "EOF"</command>
prefix=/usr/X11R6
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
 
Name: Xrender
Description: X Render Library
Version: 0.8.3
Cflags: -I${includedir} -I/usr/X11R6/include
Libs: -L${libdir} -lXrender -L/usr/X11R6/lib -lX11
<command>EOF</command></userinput></screen>
 
<para>** <application>libXcomposite</application> can optionally be used, but
here's what the <application>Metacity</application> package maintainer
has to say about it in the configure script if the package is found:
<quote>Not building compositing manager by default now, must enable explicitly
to get it. And it doesn't work, so don't bother unless you want to hack on
it...</quote></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Metacity</application></title>
 
<para>Install <application>Metacity</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/sbin --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--with-gconf-schema-file-dir=/etc/gnome/gconf/schemas</option>:
Use this option if you have the
<application><acronym>GNOME</acronym>-2</application>
<application>GConf</application> package installed.</para>
 
</sect2>
 
<sect2 id='metacity-config'>
<title>Configuring <application>Metacity</application></title>
 
<sect3>
<title>Configuration Information</title>
 
<para>To automatically start the <application>Metacity</application> window
manager when you issue the <command>startx</command> command, append to (or
create) <filename>.xinitrc</filename> using the command below. Ensure you
backup your current <filename>~/.xinitrc</filename> before proceeding.</para>
 
<indexterm zone="metacity metacity-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
<screen><userinput><command>cat &gt;&gt; ~/.xinitrc &lt;&lt; "EOF"</command>
xterm &amp;
exec metacity
<command>EOF</command></userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>metacity</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="metacity-prog">
<term><command>metacity</command></term>
<listitem>
<para>is a window manager used mainly by
<application><acronym>GNOME</acronym></application>.
</para>
<indexterm zone="metacity metacity-prog">
<primary sortas="b-metacity">metacity</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
</sect1>
 
/trunk/blfs/x/installing/xfree86/xfree86-config.xml
File deleted
/trunk/blfs/x/installing/xfree86/xfree86.ent
File deleted
/trunk/blfs/x/installing/xfree86/xfree86-intro.xml
File deleted
/trunk/blfs/x/installing/xfree86/xfree86-exp.xml
File deleted
/trunk/blfs/x/installing/xfree86/xfree86-inst.xml
File deleted
/trunk/blfs/x/installing/xfree86/xfree86-desc.xml
File deleted
/trunk/blfs/x/installing/xfree86-setup.xml
File deleted
/trunk/blfs/x/installing/dri.xml
File deleted
/trunk/blfs/x/installing/truetype.xml
File deleted
/trunk/blfs/x/installing/installing.xml
1,12 → 1,18
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="x-installing">
<?dbhtml filename="installing.html"?>
<title>Installer X</title>
<?dbhtml filename="installing.html" ?>
<title>X Window System Environment</title>
 
<para>Ce chapitre contient un environnement graphique pour l'utilisateur.</para>
<para>This chapter contains a graphical user environment.</para>
 
&xorg;
&xfree86;
&x-setup;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xorg.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="xfree86.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x-setup.xml"/>
 
</chapter>
/trunk/blfs/x/installing/x-setup.xml
0,0 → 1,347
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<sect1 id="x-setup">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="xfree86-setup.html"?>
<title>X Window System Components</title>
 
<sect2 id='dri'>
<title>Checking Direct Rendering Infrastructure (<acronym>DRI</acronym>)
Installation</title>
 
<indexterm zone="x-setup dri">
<primary sortas="g-DRI">DRI</primary>
</indexterm>
 
<para><acronym>DRI</acronym> is a framework for allowing software to access
graphics hardware in a safe and efficient manner. It is installed in
<application>X</application> by default if you have a supported video card.
To check if <acronym>DRI</acronym> is installed properly, check the log file
<filename>/var/log/XFree86.0.log</filename> or
<filename>/var/log/Xorg.0.log</filename> for statements like:</para>
 
<screen>(II) R128(0): Direct rendering enabled</screen>
 
<para>From an <command>xterm</command>, run <command>glxinfo</command> and
look for the phrase:</para>
 
<screen><computeroutput>direct rendering: Yes</computeroutput></screen>
 
<para>You can also run the test program <command>glxgears</command>.
This program brings up a window with three gears turning. The
<command>xterm</command> will display how many frames were drawn every
five seconds, so this is a reasonable benchmark. The window is scalable, and
the frames drawn per second is highly dependent on the size of
the window.</para>
 
<indexterm zone="x-setup dri">
<primary sortas="b-glxgears">glxgears</primary>
</indexterm>
 
<indexterm zone="x-setup dri">
<primary sortas="b-glxinfo">glxinfo</primary>
</indexterm>
 
<para>For troubleshooting problems, check the <acronym>DRI</acronym> Users
Guide at
<ulink url="http://dri.sourceforge.net/doc/DRIuserguide.html"/>.</para>
 
</sect2>
 
<!-- ================================================== -->
 
<sect2 id='fonts'>
<title>Adding <application>TrueType</application> fonts to
<application>X</application></title>
 
<para><application>TrueType</application> font support is built into
<application>X</application>. The following items need to
be completed to make the fonts available. Each item is described in
detail after the list.</para>
 
<indexterm zone="x-setup fonts">
<primary sortas="g-truetype">TrueType</primary>
</indexterm>
 
<itemizedlist>
<listitem><para>Establish a directory for the fonts and move any
<application>TrueType</application> fonts you want into that directory.
Ensure that any fonts you install are world readable. Incorrect
permissions on fonts have been known to cause problems with some
<application>X</application> applications.</para></listitem>
 
<listitem><para>Download the fonts.</para></listitem>
 
<listitem><para>Create the <filename>fonts.scale</filename> and
<filename>fonts.dir</filename> files in the
<application>TrueType</application> font
directory.</para></listitem>
 
<listitem><para>Ensure the <application>TrueType</application> module is
loaded in the <filename>XF86Config</filename> or
<filename>xorg.conf</filename>.</para></listitem>
 
<listitem><para>Ensure the <parameter>FontPath</parameter> in
<filename>XF86Config</filename> or <filename>xorg.conf</filename> contains the
<application>TrueType</application> font directory.</para></listitem>
 
<listitem><para>Update the font cache files</para></listitem>
</itemizedlist>
 
<indexterm zone="x-setup fonts">
<primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
</indexterm>
 
<indexterm zone="x-setup fonts">
<primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
</indexterm>
 
<sect3><title>Establish a <application>TrueType</application> font
directory</title>
 
<para>The build of <application>X</application> as given above automatically
creates a <application>TrueType</application> font directory:
<filename class="directory">/usr/X11R6/lib/X11/fonts/TTF</filename>. This
directory already has some <application>TrueType</application> fonts and is
set up correctly. If this directory is satisfactory, copy any other
<application>TrueType</application> fonts you want into that directory. If
not, create a new directory, preferably in the
<filename class="directory">/usr/X11R6/lib/X11/fonts/</filename> directory and
put your <application>TrueType</application> fonts there.</para>
</sect3>
 
<sect3><title>Download the fonts</title>
 
<para>There are two known high quality free font resources:
<ulink url="ftp://ftp.gnu.org/savannah/files/freefont/"/> and
<ulink url="http://corefonts.sourceforge.net/"/>. Copy the fonts (files with
the <filename>.ttf</filename> suffix) to the directory you've just
created.</para>
</sect3>
 
<sect3 id="fonts-scale-dir"><title>Create <filename>fonts.scale</filename> and
<filename>fonts.dir</filename></title>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="g-fonts.scale">fonts.scale</primary>
</indexterm>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="g-fonts.dir">fonts.dir</primary>
</indexterm>
 
<para>Now change to the directory where you have your
<application>TrueType</application> fonts and run:
<screen><userinput><command>mkfontscale &amp;&amp;
mkfontdir</command></userinput></screen></para>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="b-mkfontscale">mkfontscale</primary>
</indexterm>
<indexterm zone="x-setup fonts-scale-dir">
<primary sortas="b-mkfontdir">mkfontdir</primary>
</indexterm>
</sect3>
 
<sect3><title>Ensure <application>TrueType</application> is loaded in
<filename>XF86Config</filename> or <filename>xorg.conf</filename></title>
<para>The "Module" section should look like:
<screen>Section "Module"
...
Load "freetype"
...
EndSection</screen></para>
</sect3>
 
<sect3><title>Ensure the <parameter>FontPath</parameter> in
<filename>XF86Config</filename> or <filename>xorg.conf</filename> points to the
<application>TrueType</application> font directory</title>
<para>The "Files" section should look like:
<screen>Section "Files"
...
FontPath "/usr/X11R6/lib/X11/fonts/<replaceable>[TrueTypeDir]</replaceable>/"
...
EndSection</screen></para>
</sect3>
 
<sect3><title>Update the font cache files</title>
 
<para>Ensure you have the following directory entries in
<filename>/etc/fonts/local.conf</filename>, inside the fontconfig
tags:</para>
 
<indexterm zone="x-setup fonts">
<primary sortas="e-etc-fonts-local.conf">/etc/fonts/local.conf</primary>
</indexterm>
 
<screen><userinput><command>sed -i -e '/^&lt;\/fontconfig&gt;/i\
&lt;dir&gt;/usr/X11R6/lib/X11/fonts/TTF&lt;/dir&gt;\
&lt;dir&gt;/usr/X11R6/lib/X11/fonts/Type1&lt;/dir&gt;' /etc/fonts/local.conf</command></userinput></screen>
 
<para>The <command>fc-cache</command> program will automatically search
the above directories and all subdirectories for needed fonts.</para>
<para>Finally, to update all the font cache files, run</para>
 
<screen><userinput><command>fc-cache</command></userinput></screen>
 
<indexterm zone="x-setup fonts">
<primary sortas="b-fc-cache">fc-cache</primary>
</indexterm>
 
<para><application>X</application> will now be able to use
<application>TrueType</application> fonts when it is restarted.
You can check to see if the new fonts are available with the
<command>xlsfonts</command> or <command>xfontsel</command>
program.</para>
 
<note><para>You should rerun <command>mkfontscale</command> and
<command>mkfontdir</command> any time you add or delete
<application>TrueType</application> fonts.
You should also rerun <command>fc-cache</command> each time
you add or remove any fonts.</para></note>
 
</sect3>
</sect2>
 
<!-- ================================================== -->
<sect2>
<title>Setting up keyboards</title>
<para>In this version of <application>X</application>, non-Latin
keyboard layouts do not include Latin configurations as was previous
practice. To set up a keyboard for Latin and non-Latin input,
change the XkbLayout keyboard driver option in the InputDevice section
of the <filename>XF86Config</filename> or <filename>xorg.conf</filename> file.
For example:</para>
 
<screen> Section "InputDevice"
Identifier "Keyboard0"
Driver "Keyboard"
Option "XkbModel" "pc105"
Option "XkbLayout" "en_US,ru"
Option "XkbOptions" "grp:switch,grp:alt_shift_toggle,grp_led:scroll"
EndSection</screen>
 
<para>In this example, you can use the Alt-Shift combination to switch
between keyboard layouts and use the Scroll Lock <acronym>LED</acronym> to
indicate when the second layout is active.</para>
</sect2>
 
<!-- ================================================== -->
<sect2>
<title>Setting up fonts</title>
 
<para>Users using character sets other than <acronym>ISO</acronym>-8859-1 have
to make a few adjustments to their font settings in order to make sure that
fonts with the correct encoding are used for "fixed", "variable", "10x20" and
similar aliases:</para>
<para>For Cyrillic alphabet, it is sufficient to put the following line
into the top of the "Files" section in <filename>XF86Config</filename>
or <filename>xorg.conf</filename> because this directory already contains
the needed bitmap fonts and their aliases:</para>
 
<screen>FontPath "/usr/X11R6/lib/X11/fonts/cyrillic/"</screen>
 
<para>For ISO-8859-<replaceable>[X]</replaceable> based locales, use the
following command instead:</para>
 
<screen><userinput><command>sed -i 's,iso8859-1\( \|$\),iso8859-<replaceable>[X]</replaceable>\1,g' \
/usr/X11R6/lib/X11/fonts/{75dpi,100dpi,misc}/fonts.alias</command></userinput></screen>
 
</sect2>
 
<!-- ================================================== -->
<sect2 id='xdm'>
<title>Setting up XDM</title>
<para><command>xdm</command> provides a graphical logon capability and is
normally set up in <filename>/etc/inittab</filename>. Most of the information
you need to customize <command>xdm</command> is found in its man page. To
execute <command>xdm</command> during bootup, change the initdefault level to 5
and add the following lines to <filename>/etc/inittab</filename>:</para>
 
<indexterm zone="x-setup xdm">
<primary sortas="b-xdm">xdm</primary>
</indexterm>
 
<para><screen><userinput># Run xdm as a separate service
x:5:respawn:/usr/X11R6/bin/xdm -nodaemon</userinput></screen></para>
 
<para>If Linux-PAM is installed on your system, you should
create a PAM entry for xdm by duplicating the login entry
using the following command:</para>
 
<para><screen><userinput>cp /etc/pam.d/login /etc/pam.d/xdm</userinput></screen></para>
<indexterm zone="x-setup xdm">
<primary sortas="e-etc-pam.d/xdm">/etc/pam.d/xdm</primary>
</indexterm>
 
</sect2>
 
<!-- ================================================== -->
<sect2 id='x-resources'>
<title>Using <application>X</application> Resources</title>
<para>There are many options that can be set in
<application>X</application> and <application>X</application> clients via
resources. Typically resources are set in the
<filename>~/.Xresources</filename> file.</para>
 
<para>The layout of the <filename>~/.Xresources</filename> file consists
of a list of specifications in the form of</para>
 
<indexterm zone="x-setup x-resources">
<primary sortas="e-AA.xresources">~/.Xresources</primary>
</indexterm>
 
<screen>object.subobject[.subobject...].attribute: value</screen>
 
<para>Components of a resource specification are linked together
by either <emphasis>tight</emphasis>, represented by a dot (.),
or <emphasis>loose</emphasis>, represented by an asterisk (*), bindings.
A tight binding indicates that the components on either side of the dot must
be directly next to each other as defined in a specific implementation. An
asterisk is a wildcard character that means that any number of levels in
a defined hierarchy can be between the components.
For example, X offers two special cursors: redglass and whiteglass. To
use one of these resources, you need to add the following line:</para>
 
<screen>Xcursor.theme: whiteglass</screen>
 
<para>However, you can specify the background for all clients with:</para>
 
<screen>*background: blue</screen>
 
<para>More specific resource variables will override less specific names.</para>
 
<para>Resource definitions can be found in the man pages for each
respective client.</para>
 
<para>In order to load your resources, the <command>xrdb</command> program
must be called with the appropriate parameters. Typically, the first time
resources are loaded, you use:</para>
 
<screen><userinput><command>xrdb -load &lt;filename&gt;</command></userinput></screen>
 
<para>To add resources to <application>X</application>'s database in memory,
use:</para>
 
<screen><userinput><command>xrdb -merge &lt;filename&gt;</command></userinput></screen>
 
<para>The <command>xrdb</command> instruction is usually placed in
<filename>~/.xinitrc</filename> or <filename>~/.xsession</filename>.
To get more information, see the xrdb man page.</para>
 
<indexterm zone="x-setup x-resources">
<primary sortas="b-xrdb">xrdb</primary>
</indexterm>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/installing/xfree86.xml
1,11 → 1,748
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xfree86-download-http "http://gnu.kookel.org/ftp/XFree86/4.4.0/source/">
<!ENTITY xfree86-download-ftp "ftp://ftp.xfree86.org/pub/XFree86/4.4.0/source/">
<!ENTITY xfree86-md5sum "ftp://ftp.xfree86.org/pub/XFree86/4.4.0/source/SUMS.md5sum">
<!ENTITY xfree86-size "52 MB">
<!ENTITY xfree86-buildsize "775 MB">
<!ENTITY xfree86-time "11.6 SBU">
]>
 
<sect1 id="xfree86" xreflabel="XFree86-&xfree86-version;">
<?dbhtml filename="xfree86.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="xfree86.html" ?>
<title>XFree86-&xfree86-version;</title>
 
&xfree86-intro;
&xfree86-inst;
&xfree86-exp;
&xfree86-config;
&xfree86-desc;
<indexterm zone="xfree86">
<primary sortas="a-xfree86">XFree86</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>XFree86</application></title>
 
<para><application>XFree86</application> is a freely redistributable
open-source implementation of the <application>X</application> Window System.
<application>XFree86</application> provides a client/server interface between
display hardware (the mouse, keyboard, and video displays) and the desktop
environment, while also providing both the windowing infrastructure and a
standardized application interface (<acronym>API</acronym>).</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&xfree86-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&xfree86-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sums: <ulink url="&xfree86-md5sum;"/></para></listitem>
<listitem><para>Download size: &xfree86-size;</para></listitem>
<listitem><para>Estimated disk space required: &xfree86-buildsize;</para></listitem>
<listitem><para>Estimated build time: &xfree86-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title>Additional downloads</title>
 
<itemizedlist spacing='compact'>
<listitem>
<para>Security patch: <ulink
url="http://www.x.org/pub/X11R6.8.0/patches/xorg-CAN-2004-0687-0688.patch"/></para>
</listitem>
</itemizedlist></sect3>
 
<sect3>
<title><application>XFree86</application> dependencies</title>
 
<sect4>
<title>Required</title>
<para><xref linkend="libpng"/></para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="Linux_PAM"/>; the
following packages are included in the <application>XFree86</application>
package, however they are updated more often than the
<application>XFree86</application> package and are highly recommended:
<xref linkend="expat"/>, <xref linkend="freetype2"/>,
<xref linkend="fontconfig"/>.
</para>
 
<note><para>If you choose not to install <application>expat</application>,
<application>FreeType2</application>, and <application>Fontconfig</application>,
the <filename>host.def</filename> file below will have to be modified to
instruct <application>XFree86</application> to build them.</para>
</note>
</sect4>
 
</sect3>
 
<sect3>
<title>Download Instructions</title>
 
<para>There are several files that need to be fetched from the download location:</para>
 
<itemizedlist spacing='compact'>
<listitem><para><filename>XFree86-4.4.0-src-1.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-2.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-3.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-4.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-5.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-6.tgz</filename></para></listitem>
<listitem><para><filename>XFree86-4.4.0-src-7.tgz</filename></para></listitem>
</itemizedlist>
 
<para>The first three packages are the <application>XFree86</application>
programs, the fourth and fifth are fonts, the sixth is normal documentation,
and the seventh is hardcopy documentation. There are also two packages
<filename>doctools-1.3.1.tgz</filename>, which contain programs to regenerate
hardcopy documentation, and <filename>utils-1.1.0.tgz</filename>, which contain
<application><acronym>GNU</acronym> <acronym>TAR</acronym></application>
and <application>zlib</application> which are already installed on an
<acronym>LFS</acronym> system.
</para>
 
<para>To check your downloads for integrity, download the
<filename>SUMS.md5sum</filename> file. Then:
</para>
 
<screen><userinput><command>md5sum -c SUMS.md5sum</command></userinput></screen>
 
<para>The only errors you should see are for <filename>README</filename>,
<filename>doctools-1.3.1.tgz</filename>, <filename>utils-1.1.0.tgz</filename>
and <filename>XFree86-xtest-4.0.x.tar.bz2</filename> files if you did not
download them.
</para>
 
<!--
<para>The fixes subdirectory also has a <filename>SUMS.md5sum</filename>. Note that
this is the same filename as the sums for the main sources, so you need to rename the
file if you download it. Otherwise, you can just look at it and use it to
check against the patch files:</para>
<screen><userinput><command>md5sum 4.3.0-4.3.0.1.diff.gz</command></userinput>
<userinput><command>md5sum fontfile.diff</command></userinput></screen>
 
<para>After unpacking the <filename>X430src-?.tgz</filename> files and uncompressing the
diff file, change to the <filename class="directory">xc</filename> directory and run:</para>
 
<screen><userinput><command>patch -Np1 -i ../4.3.0-4.3.0.1.diff</command></userinput>
<userinput><command>pushd lib/font/fontfile/</command></userinput>
<userinput><command>patch -N -i ../../../../fontfile.diff</command></userinput>
<userinput><command>popd</command></userinput></screen>
-->
 
</sect3>
</sect2>
 
<sect2>
<title>Installation of <application>XFree86</application></title>
 
<sect3 id='xfree86-kernel'>
<title>Kernel Compilation Settings</title>
 
<para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
Registers) support into the kernel. The kernel can map Cyrix and AMD
<acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
this option is useful for those processors also. This option is found in the
"Processor type and features" menu. It can increase performance of image write
operations 2.5 times or more on <acronym>PCI</acronym> or
<acronym>AGP</acronym> video cards.
</para>
 
<indexterm zone="xfree86 xfree86-kernel">
<primary sortas="d-xfree86">XFree86</primary>
</indexterm>
 
<para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support
and select the chipset support on your motherboard. If you do not know the
chipset, you may select all the chip types at the expense of extra kernel size.
You can usually determine your motherboard's chipset by running the command
<command>lspci</command>, a program from the <xref linkend="pciutils"/> package.
</para>
 
<para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
Rendering Manager unless you have a Direct Rendering Infrastructure
(<acronym>DRI</acronym>) supported video card. A complete list of
<acronym>DRI</acronym> supported video cards can be found at
<ulink url="http://dri.sourceforge.net" /> in the Status section. Currently,
supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
Matrox (G200, G400, G450).
</para>
 
<para>Additionally NVidia provides their own closed source binary drivers,
which do not make use of <acronym>DRI</acronym>. If you intend to use these
drivers, do not enable <acronym>DRI</acronym>.
</para>
 
<para>If you made any changes to the kernel configuration, recompile and
install the new kernel.
</para>
 
<note><para>If you build <application>XFree86</application> in a
<command>chroot</command> environment, make sure the kernel version of the base
system and the target system are the same.
</para></note>
 
</sect3>
 
<sect3>
<title>Creating <filename>host.def</filename></title>
 
<para>Although <application>XFree86</application> will compile without a
<filename>host.def</filename> file, the following file is recommended for
customizing the installation. Start from the
<filename class="directory">xc</filename> directory.
</para>
 
<note><para>The <filename>host.def</filename> file is a
<application>C</application> file, not the usual configuration file. If you
make any changes, be sure the comment characters (<userinput>/*</userinput>
and <userinput>*/</userinput>) are balanced. Most of the entries in the file
below are commented out with the default settings shown.
</para></note>
 
<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
/* Begin XFree86 host.def file */
 
/* System Related Information. If you read and configure only one
* section then it should be this one. The Intel architecture defaults
* are set for a i686 and higher. Axp is for the Alpha architecture
* and Ppc is for the Power PC. Note that there have been reports that
* the Ppc optimization line causes segmentation faults during build.
* If that happens, try building without the DefaultGcc2PpcOpt line. */
 
/* #define DefaultGcc2i386Opt -O2 -fomit-frame-pointer -march=i686 */
/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
 
/* The following definitions are normally set properly by XFree86's
* scripts. You can uncomment them if you want to make sure. *********/
/* #define HasMTRRSupport YES */ /* Enabled in kernel; */
/* see kernel docs */
/* #define HasMMXSupport NO */ /* Any i586 or above */
/* #define HasKatmaiSupport NO */ /* PIII SSE instructions */
/* #define Has3DNowSupport NO */ /* AMD instructions */
 
 
/* This setting reduces compile time a little by omitting rarely used
* input devices. You can find the complete list in
* config/cf/xfree86.cf *********************************************/
#define XInputDrivers mouse void
 
/* VIDEO DRIVERS ****************************************************/
 
/* If you are sure you only want the drivers for one or a few video
* cards, you can delete the drivers you do not want. ***************/
 
 
#define XF86CardDrivers mga glint nv tga s3 s3virge sis rendition \
neomagic i740 tdfx savage \
cirrus vmware tseng trident chips apm \
GlideDriver fbdev i128 nsc \
ati i810 AgpGartDrivers DevelDrivers ark \
cyrix siliconmotion \
vesa vga \
dummy XF86OSCardDrivers XF86ExtraCardDrivers
 
 
/* USER AND SYSTEM DEFAULT PATHS *************************************/
 
/* These settings set the PATH variables used by xdm. See README for */
/* detailed description and modify the following as per your need. ***/
 
/* #define DefaultSystemPath \
/usr/bin:/bin:/usr/sbin:/sbin:/usr/X11R6/bin */
/* #define DefaultUserPath /usr/bin:/bin:/usr/X11R6/bin */
 
/* FONT SERVER AND LIBRARY SETTINGS **********************************/
 
/* These settings are the defaults **********************************/
 
/* #define BuildFontServer YES */ /*For Ghostscript Print Server*/
/* #define SharedLibFont YES */
/* #define CompressAllFonts YES */
/* #define GzipFontCompression YES */
 
/* These settings ensure we use our libraries ************************/
#define HasFreetype2 YES
#define HasFontconfig YES
#define HasExpat YES
#define HasLibpng YES
#define HasZlib YES
 
/* The font path can be redefined in the XF86Config file *************/
 
/*
#define DefaultFontPath $(FONTDIR)/misc/,$(FONTDIR)/75dpi/,\
$(FONTDIR)/100dpi/,$(FONTDIR)/Type1,$(FONTDIR)/local,\
$(FONTDIR)/TrueType,$(FONTDIR)/CID,$(FONTDIR)/Speedo
*/
 
 
/* INTERNATIONAL FONTS. Change to YES if you need any of them. These
* are the defaults. **************************************************/
 
/* #define BuildCyrillicFonts NO */
/* #define BuildArabicFonts NO */
/* #define BuildISO8859_6Fonts NO */
/* #define BuildGreekFonts NO */
/* #define BuildISO8859_7Fonts NO */
/* #define BuildHebrewFonts NO */
/* #define BuildISO8859_8Fonts NO */
/* #define BuildKOI8_RFonts NO */
/* #define BuildJapaneseFonts NO */
/* #define BuildJISX0201Fonts NO */
/* #define BuildKoreanFonts NO */
/* #define BuildChineseFonts NO */
 
/* DOCUMENTATION SETTINGS ********************************************/
 
/* These setting are the defaults. ***********************************/
 
/* #define BuildLinuxDocHtml NO */ /* X Docs in Html format */
/* #define BuildLinuxDocPS NO */ /* PostScript format */
/* #define BuildAllSpecsDocs NO */ /* Various docs */
/* #define BuildHtmlManPages NO */
 
/* GENERAL SETTINGS: You generally want to leave these alone when
* building X on an LFS system ***************************************/
 
#define GccWarningOptions -pipe /* Speed up compiles */
#define TermcapLibrary -lncurses
#define XprtServer YES /* Needed by realplayer */
#define XnestServer YES
#define XAppLoadDir EtcX11Directory/app-defaults
#define VarLibDir /var/lib
#define XFree86Devel NO
#define FSUseSyslog YES
#define ThreadedX YES
#define HasPam NO
#define SystemManDirectory /usr/share/man /*Instead of /usr/man*/
#define HasLibCrypt YES
#define InstallXinitConfig YES
#define InstallXdmConfig YES
#define ForceNormalLib YES
#define BuildSpecsDocs NO
 
/* End XFree86 host.def file */
<command>EOF</command></userinput></screen>
 
<para>Edit the file for your hardware and desires.</para>
 
</sect3>
 
<sect3>
<title>Build Commands</title>
 
<para>Some vulnerabilities were reported in <filename
class="libraryfile">libXpm</filename>. A remote user may be able to
execute arbitrary code on applications that use <filename
class="libraryfile">libXpm</filename>. The <application>Xorg</application>
team released a patch for their version 6.8.0 but it works for
<application>XFree86</application> as well. Apply the patch:
</para>
 
<screen><userinput><command>patch -Np1 -i ../xorg-CAN-2004-0687-0688.patch</command></userinput></screen>
 
<para>Install <application>XFree86</application> by running the following commands:</para>
 
<screen><userinput><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
`grep -lr linux/config.h *` &amp;&amp;
( make WORLDOPTS="" World 2&gt;&amp;1 | \
tee xfree-compile.log &amp;&amp; exit $PIPESTATUS )</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install &amp;&amp;
make install.man &amp;&amp;
ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
ln -sf ../X11R6/lib/X11 /usr/lib/X11 &amp;&amp;
ln -sf ../X11R6/include/X11 /usr/include/X11</command></userinput></screen>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>: The
<application>Linux-Libc-Headers</application> package installed in
<acronym>LFS</acronym> installs a
<filename>/usr/include/linux/config.h</filename> file which is not compatible
with userspace applications. The recommended fix for applications including
this file is to remove it (see <ulink
url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
<command>grep -lr</command> to replace all occurences. If you desire, just
remove (comment) the line in the appropriate video driver file if you
customized <filename>host.def</filename>.
</para>
 
<para><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log
&amp;&amp; exit $PIPESTATUS )</command>:
This command runs multiple <filename>Makefile</filename>s to completely rebuild
the system. <envar>WORLDOPTS</envar>="" disables the default setting to
continue after encountering an error. <parameter>2&gt;&amp;1</parameter>
redirects error messages to the same location as standard output. The
<command>tee</command> command allows viewing of the output while logging the
results to a file. The parentheses around the command runs the entire comand in
a subshell and finally the <command>exit $PIPESTATUS</command> ensures the
result of the <command>make</command> is returned as the result and not the
result of the <command>tee</command> command.</para>
 
<note><para>When rebuilding <application>XFree86</application>, a separate
command that may be used if only minor changes are made to the sources is
<command>make Everything</command>. This does not automatically remove
generated files and only rebuilds those files or programs that are out
of date.</para></note>
 
<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
ln -sf ../X11R6/lib/X11 /usr/lib/X11
ln -sf ../X11R6/include/X11 /usr/include/X11</command></screen>
These commands are present to enable other (broken) packages to build
against <application>XFree86</application>, even though the Filesystem
Hierarchy Standard says: "In general, software must not be installed or
managed via the above symbolic links. They are intended for utilization by
users only."</para>
 
</sect2>
 
<sect2 id='xfree86-config'>
<title>Configuring <application>XFree86</application></title>
 
<para>Edit <filename>/etc/ld.so.conf</filename> and add
<filename class="directory">/usr/X11R6/lib</filename>.
Run: </para>
<screen><userinput><command>ldconfig</command></userinput></screen>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
</indexterm>
 
<para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
environment variables, respectively. Instructions for doing this are
described in the section "<xref linkend='postlfs-config-profile'/>."</para>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
</indexterm>
 
<para>Create the <filename>XF86Config</filename> file with:
<screen><userinput><command>cd ~
XFree86 -configure</command></userinput></screen>
The screen will go black and you may hear some clicking of the monitor. This
command will create a file, <filename>XF86Config.new</filename> in your home
directory.</para>
 
<para>Edit <filename>XF86Config.new</filename> to suit your system. The
details of the file are located in the man page
<command>man XF86Config</command>. Some things you may want to do are:</para>
 
<itemizedlist>
 
<listitem><para>Section "Files". Change the order of the font paths searched.
You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally
comes up closer to 100 dots per inch. You may want to remove some font
directories completely.</para></listitem>
 
<listitem><para>Section "Module". If you are going to install NVidia
drivers, remove the "dri" line.</para></listitem>
<listitem><para>Sections "InputDevice". Specify the
<parameter>Device</parameter> parameter to "/dev/input/mice" and
<parameter>Protocol</parameter> to "auto" to set up your mouse. You may
also want to change the keyboard autorepeat rate by adding
<parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
 
<listitem><para>Section "Monitor". Specify the
<parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values
if the system does not automatically detect the monitor and its values.</para>
</listitem>
 
<listitem><para>Section "Device". You may want to set some of the options
available for your selected video driver. A description of the driver
parameters is in the man page for your driver.</para></listitem>
 
<listitem><para>Section "Screen". Add a DefaultDepth statement such
as: <parameter>DefaultDepth 16</parameter>. In the SubSection for your
default depth, add a modes line such as:
<parameter> Modes "1280x1024" "1024x768"</parameter>. The first mode listed
will normally be the starting resolution.</para></listitem>
 
</itemizedlist>
 
<para>Test the system with:
<screen><userinput><command>XFree86 -xf86config ~/XF86Config.new</command></userinput></screen>
You will only get a gray background with an X-shaped mouse cursor, but it
confirms the system is working. Exit with Control-Alt-Backspace. If the
system does not work, examine <filename>/var/log/XFree86.0.log</filename> to
see what went wrong.</para>
 
<para>Move the configuration file to its final location:</para>
<screen><userinput><command>mv ~/XF86Config.new /etc/X11/XF86Config</command></userinput></screen>
 
<para>Create <filename>.xinitrc</filename>:
<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
# Begin .xinitrc file
xterm -g 80x40+0+0 &amp;
xclock -g 100x100-0+0 &amp;
twm
<command>EOF</command></userinput></screen>
This provides an initial screen with an xterm and a clock that is managed by a
simple window manager, Tab Window Manager. For details of
<command>twm</command>, see the man page.</para>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
 
 
<note>
 
<para>When needed, <application>XFree86</application> creates the directory
<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
not owned by root, <application>XFree86</application> delays startup by a few
seconds and also appends a warning to the logfile. This also affects startup of
other applications. To improve performance, it is advisable to manually create
the directory before <application>XFree86</application> uses it. Add the file
creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"</command>
/tmp/.ICE-unix dir 1777 root root
<command>EOF</command></userinput></screen>
</note>
 
<indexterm zone="xfree86 xfree86-config">
<primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
</indexterm>
 
<para>Start <application>X</application> with:
<screen><userinput><command>startx</command></userinput></screen>
to get a basic functional <application>X</application> Window System.</para>
 
<para>At this point, you should check out <xref linkend='x-setup'/>.</para>
 
</sect2>
 
<sect2 id="xfree86-contents" xreflabel="XFree86 Contents and Descriptions">
<title>Contents</title>
 
<para>The <application>XFree86</application> package contains the
<application>X</application> Window System for Linux (and other operating
systems). It includes the <application>X</application> server, fonts,
<command>xterm</command>, a simple window manager (<command>twm</command>),
various utilities, video output drivers, and various input drivers including
the mouse and keyboard.</para>
 
<para><application>XFree86</application> also contains libraries and header
files for development of the <application>X</application> Window System
programs.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<note><para>The following lists are not comprehensive. The
full list of programs is in <filename class="directory">/usr/X11R6/bin</filename>. For
additional information about these programs, see the respective man
page.</para></note>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>XFree86, xf86config, xf86cfg, startx, xinit, twm, xterm, xwininfo,
x11perf, xlsfonts, xvidtune, xload, xcalc, xclock, oclock, xmodmap</seg>
<seg>libGL.so, libGLU.so, libSM.so, libXi.so, libXrender.so, libXt.so, libXfont.so</seg>
<seg>/usr/X11R6/, /etc/X11/</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="XFree86">
<term><command>XFree86</command></term>
<listitem>
<para>is the X11R6 implementation of the <application>X</application> Window System server.</para>
<indexterm zone="xfree86 XFree86">
<primary sortas="b-XFree86">XFree86</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xf86config">
<term><command>xf86config</command></term>
<listitem>
<para>is an interactive program for generating an <filename>XF86Config</filename> file for use with
<application>XFree86</application> <application>X</application> servers.</para>
<indexterm zone="xfree86 xf86config">
<primary sortas="b-xf86config">xf86config</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xf86cfg">
<term><command>xf86cfg</command></term>
<listitem>
<para> is a tool to configure <application>XFree86</application> that can be used to either write the
initial configuration file or make customizations to the current configuration.</para>
<indexterm zone="xfree86 xf86cfg">
<primary sortas="b-xf86cfg">xf86cfg</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="startx">
<term><command>startx</command></term>
<listitem>
<para>is a script to initialize the <application>X</application> session. It
runs <command>xinit</command>.</para>
<indexterm zone="xfree86 startx">
<primary sortas="b-startx">startx</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xinit">
<term><command>xinit</command></term>
<listitem>
<para>is used to start the <application>X</application> Window System server.</para>
<indexterm zone="xfree86 xinit">
<primary sortas="b-xinit">xinit</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="twm">
<term><command>twm</command></term>
<listitem>
<para> (Tab Window Manager) is a window manager included with the
<application>X</application> Window System.</para>
<indexterm zone="xfree86 twm">
<primary sortas="b-twm">twm</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xterm">
<term><command>xterm</command></term>
<listitem>
<para>is a terminal emulator for <application>X</application>.</para>
<indexterm zone="xfree86 xterm">
<primary sortas="b-xterm">xterm</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xwininfo">
<term><command>xwininfo</command></term>
<listitem>
<para> is a window information utility for <application>X</application>.</para>
<indexterm zone="xfree86 xwininfo">
<primary sortas="b-xwininfo">xwininfo</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="x11perf">
<term><command>x11perf</command></term>
<listitem>
<para>is an <application>X</application>11 server performance test program.</para>
<indexterm zone="xfree86 x11perf">
<primary sortas="b-x11perf">x11perf</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xlsfonts">
<term><command>xlsfonts</command></term>
<listitem>
<para>is a program to list fonts available to the <application>X</application> server.</para>
<indexterm zone="xfree86 xlsfonts">
<primary sortas="b-xlsfonts">xlsfonts</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xvidtune">
<term><command>xvidtune</command></term>
<listitem>
<para>is a video mode tuner for <application>XFree86</application>.</para>
<indexterm zone="xfree86 xvidtune">
<primary sortas="b-xvidtune">xvidtune</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xload">
<term><command>xload</command></term>
<listitem>
<para> is a system load average display for <application>X</application>.</para>
<indexterm zone="xfree86 xload">
<primary sortas="b-xload">xload</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xcalc">
<term><command>xcalc</command></term>
<listitem>
<para>is a scientific calculator for <application>X</application>.</para>
<indexterm zone="xfree86 xcalc">
<primary sortas="b-xcalc">xcalc</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xclock">
<term><command>xclock</command></term>
<listitem>
<para>is a clock programs for <application>X</application>.</para>
<indexterm zone="xfree86 xclock">
<primary sortas="b-xclock">xclock</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="oclock">
<term><command>oclock</command></term>
<listitem>
<para>is a clock programs for <application>X</application>.</para>
<indexterm zone="xfree86 oclock">
<primary sortas="b-oclock">oclock</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="xmodmap">
<term><command>xmodmap</command></term>
<listitem>
<para>is a utility for modifying keymaps and pointer button mappings in
<application>X</application>.</para>
<indexterm zone="xfree86 xmodmap">
<primary sortas="b-xmodmap">xmodmap</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
</sect1>
/trunk/blfs/x/installing/xorg.xml
0,0 → 1,486
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY xorg-download-http " ">
<!ENTITY xorg-download-ftp "ftp://ftp.opengroup.org/pub/x.org/pub/X11R&xorg-version;/src-single/X11R&xorg-version;-src.tar.bz2">
<!ENTITY xorg-md5sum "8131cd7ea1e4566e6e05c438a93fcfe1">
<!ENTITY xorg-size "43 MB">
<!ENTITY xorg-buildsize "655 MB">
<!ENTITY xorg-time "17.8 SBU">
]>
 
<sect1 id="xorg" xreflabel="X.org-&xorg-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="xorg.html"?>
<title>Xorg-&xorg-version;</title>
 
<indexterm zone="xorg">
<primary sortas="a-xorg">Xorg</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>Xorg</application></title>
 
<note><para>There are two packages in <acronym>BLFS</acronym> that implement
the <application>X</application> Window System: <application>Xorg</application>
and <application>XFree86</application>. These packages are quite similar. In
fact, the base system of <application>Xorg</application> is
<application>XFree86</application>-4.4.0RC2. The primary difference as of this
writing is the license provisions of the packages. For someone building a
package for their own use, these issues are not significant. Most large
commercial distributions have decided to use the
<application>Xorg</application> package, but several still use
<application>XFree86</application>.</para>
 
<para>A second reason for the forking of <application>X</application> packages
is the stated goals of the developers. Some developers were unhappy with the
administration and progress of <application>XFree86</application>. X.org's
future plans include significant improvements to the internals of the system
and more frequent releases.</para>
 
<para><application>XFree86</application> continues to be a solid, conservative
application with excellent driver support.</para>
 
<para>Both <application>Xorg</application> and
<application>XFree86</application> can be installed in the same way, but this
section will provide a slightly different and more current variation for
installation.</para>
</note>
 
<para><application>Xorg</application> is a freely redistributable open-source
implementation of the <application>X</application> Window System. This
application provides a client/server interface between display hardware (the
mouse, keyboard, and video displays) and the desktop environment, while also
providing both the windowing infrastructure and a standardized application
interface (<acronym>API</acronym>).</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&xorg-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&xorg-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &xorg-md5sum;</para></listitem>
<listitem><para>Download size: &xorg-size;</para></listitem>
<listitem><para>Estimated disk space required: &xorg-buildsize;</para></listitem>
<listitem><para>Estimated build time: &xorg-time;</para></listitem>
</itemizedlist>
</sect3>
<sect3>
<title><application>Xorg</application> Dependencies</title>
<sect4>
<title>Required</title>
<para><xref linkend="libpng"/> and
<xref linkend="fontconfig"/></para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="Linux_PAM"/></para>
</sect4>
 
</sect3>
<sect3><title>Download Instructions</title>
<para>As an alternative to downloading the entire source tree in a single
file, there are several files that need to be fetched from the download
location (directory /pub/x.org/pub/X11R&xorg-version;/src/):</para>
 
<itemizedlist spacing='compact'>
<listitem><para><filename>X11R&xorg-version;-src1.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src2.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src3.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src4.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src5.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src6.tar.gz</filename></para></listitem>
<listitem><para><filename>X11R&xorg-version;-src7.tar.gz</filename></para></listitem>
</itemizedlist>
 
<para>The first package contains the <application>Xorg</application> libraries
and support programs, the second contains standard <application>X</application>
programs, the third contains the <application>X</application> server, the
fourth and fifth are fonts, the sixth is normal documentation, and the seventh
is hardcopy documentation.</para>
<para>To check your file for integrity, download the
<filename>md5sums</filename> file. Then:</para>
<screen><userinput><command>md5sum -c md5sums</command></userinput></screen>
<para>The package (or all seven packages) should give an OK status.</para>
</sect3>
</sect2>
 
<sect2>
<title>Installation of <application>Xorg</application></title>
 
<sect3 id='xorg-kernel'>
<title>Kernel Compilation Settings</title>
 
<indexterm zone="xorg xorg-kernel">
<primary sortas="d-Xorg">Xorg</primary></indexterm>
 
<para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
Registers) support into the kernel. The kernel can map Cyrix and AMD
<acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
this option is useful for those processors also. This option is found in the
"Processor type and features" menu. It can increase performance of
image write operations 2.5 times or more on <acronym>PCI</acronym> or
<acronym>AGP</acronym> video cards.
</para>
<para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support
and select the chipset support on your motherboard. If you do not know the
chipset, you may select all the chip types at the expense of extra kernel size.
You can usually determine your motherboard's chipset by running the command
<command>lspci</command>, a program from the <xref linkend="pciutils"/>
package.
</para>
<para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
Rendering Manager unless you have a Direct Rendering Infrastructure
(<acronym>DRI</acronym>) supported video card. A complete list of
<acronym>DRI</acronym> supported video cards can be found at
<ulink url="http://dri.sourceforge.net" /> in the "Status" section.
Currently, supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
Matrox (G200, G400, G450).
</para>
<para>Additionally NVidia provides their own closed source binary drivers,
which do not make use of <acronym>DRI</acronym>. If you intend to use these
drivers, do not enable <acronym>DRI</acronym>.
</para>
<para>If you made any changes to the kernel configuration, recompile and
install the new kernel.
</para>
<note><para>If you build <application>Xorg</application> in a
<command>chroot</command> environment, make sure the kernel version of the base
system and the target system are the same.</para>
</note>
</sect3>
 
<sect3>
<title>Suppressing Xprint-related modification to <filename class="directory">/etc</filename></title>
 
<para><application>Xorg</application> insists on putting
its boot and profile scripts into the <filename
class="directory">/etc</filename> directory even if specifically told
not to compile anything Xprint server or client related (see
<filename>host.def</filename> below). The following command will
suppress any such modifications:
</para>
 
<screen><userinput><command>sed -i '/^SUBDIRS =/s/ etc$//' programs/Xserver/Xprint/Imakefile</command></userinput></screen>
 
</sect3>
 
<sect3>
<title>Setting Up a Shadow Directory</title>
 
<para>When building <application>Xorg</application>, you should create a shadow
directory of symbolic links for the compiled code. To do that, first make
<command>lndir</command>. Starting from the
<filename class='directory'>xc</filename> directory:
</para>
 
<screen><userinput><command>pushd config/util &amp;&amp;
make -f Makefile.ini lndir</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>cp lndir /usr/bin/</command></userinput></screen>
 
<para>And back as a regular user:</para>
<screen><userinput><command>popd</command></userinput></screen>
 
<para>Now create the shadow tree:</para>
 
<screen><userinput><command>mkdir ../xcbuild &amp;&amp;
cd ../xcbuild &amp;&amp;
lndir ../xc</command></userinput></screen>
</sect3>
 
<sect3>
<title>Creating <filename>host.def</filename></title>
 
<para>The next step is to create the <filename>config/cf/host.def</filename>
file. The documentation for <application>Xorg</application> indicates that the
application will build without a <filename>host.def</filename> file, but
the included libraries for <application>Fontconfig</application> and
<application>FreeType2</application> do not build properly on a base
<acronym>LFS</acronym> system. Therefore, you must specify that these
libraries, as well as others, should be imported from the system.
</para>
 
<note><para><filename>config/cf/host.def</filename> is a C file, not a shell
script. Ensure the comments delimited by <userinput>/*</userinput> ...
<userinput>*/</userinput> are balanced when modifying the file.</para>
</note>
 
<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
/* Begin Xorg host.def file */
/* System Related Information. If you read and configure only one
* section then it should be this one. The Intel architecture defaults
* are set for a i686 and higher. Axp is for the Alpha architecture
* and Ppc is for the Power PC. AMD64 is for the Opteron processor.
* Note that there have been reports that the Ppc optimization line
* causes segmentation faults during build. If that happens, try
* building without the DefaultGcc2PpcOpt line. ***********/
/* #define DefaultGcc2i386Opt -O2 -fno-strength-reduce \
-fno-strict-aliasing -march=i686 */
/* #define DefaultGccAMD64Opt -O2 -fno-strength-reduce \
-fno-strict-aliasing */
/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
 
#define HasFreetype2 YES
#define HasFontconfig YES
#define HasExpat YES
#define HasLibpng YES
#define HasZlib YES
 
/*
* Which drivers to build. When building a static server, each of
* these will be included in it. When building the loadable server
* each of these modules will be built.
*
#define XF86CardDrivers mga glint nv tga s3virge sis rendition \
neomagic i740 tdfx savage \
cirrus vmware tseng trident chips apm \
GlideDriver fbdev i128 \
ati AgpGartDrivers DevelDrivers ark \
cyrix siliconmotion vesa vga \
XF86OSCardDrivers XF86ExtraCardDrivers
*/
 
/*
* Select the XInput devices you want by uncommenting this.
*
#define XInputDrivers mouse keyboard acecad calcomp citron \
digitaledge dmc dynapro elographics \
microtouch mutouch penmount spaceorb \
summa wacom void magictouch aiptek
*/
 
/* Most installs will only need this */
 
#define XInputDrivers mouse keyboard
 
/* Disable building Xprint server and clients until we get them figured
* out but build Xprint libraries to allow precompiled binaries such as
* Acrobat Reader to run.
*/
 
#define XprtServer NO
#define BuildXprintClients NO
 
/* End Xorg host.def file */
<command>EOF</command></userinput></screen>
 
<para>There are several other options that you may want to consider. A well
documented example file is <filename>config/cf/xorgsite.def</filename>.
</para>
 
</sect3>
 
<sect3>
<title>Build Commands</title>
 
<para>Install <application>Xorg</application> by running the following commands:</para>
<screen><userinput><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
`grep -lr linux/config.h *` &amp;&amp;
( make World 2&gt;&amp;1 | tee xorg-compile.log &amp;&amp; exit $PIPESTATUS )</command></userinput></screen>
 
<para>Again as the root user:</para>
<screen><userinput role='root'><command>make install &amp;&amp;
make install.man &amp;&amp;
ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
ln -sf ../X11R6/lib/X11 /usr/lib/X11 &amp;&amp;
ln -sf ../X11R6/include/X11 /usr/include/X11</command></userinput></screen>
</sect3>
</sect2>
 
<sect2>
<title>Command explanations</title>
<para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>:
The <application>Linux-Libc-Headers</application> package installed in
<acronym>LFS</acronym> installs a
<filename>/usr/include/linux/config.h</filename> file which is not compatible
with userspace applications. The recommended fix for applications including
this file is to remove it (see <ulink
url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
<command>grep -lr</command> to replace all occurences. If you desire, just
remove (comment) the line in the appropriate video driver file if you
customized <filename>host.def</filename>.
</para>
 
<para><command>( make World 2&gt;&amp;1 | tee xorg-compile.log
&amp;&amp; exit $PIPESTATUS )</command>:
This command runs multiple <filename>Makefile</filename>s to completely rebuild
the system. <parameter>2&gt;&amp;1</parameter> redirects error messages
to the same location as standard output. The <command>tee</command> command
allows viewing of the output while logging the results to a file. The
parentheses around the command runs the entire comand in a subshell and finally
the <command>exit $PIPESTATUS</command> ensures the result of the
<command>make</command> is returned as the result and not the result of the
<command>tee</command> command.
</para>
<note><para>When rebuilding <application>Xorg</application>, a separate command
that may be used if only minor changes are made to the sources is
<command>make Everything</command>. This does not automatically remove generated
files and only rebuilds those files or programs that are out of date.</para>
</note>
<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
ln -sf ../X11R6/lib/X11 /usr/lib/X11
ln -sf ../X11R6/include/X11 /usr/include/X11</command></screen>
These commands are present to enable other (broken) packages to build against
<application>Xorg</application>, even though the Filesystem Hierarchy Standard
says: "In general, software must not be installed or managed via the above
symbolic links. They are intended for utilization by users only."</para>
</sect2>
 
<sect2 id='xorg-config'>
<title>Configuring Xorg</title>
 
<para>Edit <filename>/etc/ld.so.conf</filename> and add
<filename class="directory">/usr/X11R6/lib</filename>. Run:
</para>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
</indexterm>
<screen><userinput><command>ldconfig</command></userinput></screen>
<para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
environment variables, respectively. Instructions for doing this are
described in the section "<xref linkend='postlfs-config-profile'/>."</para>
<para>Create the <filename>xorg.conf</filename> file with:
<screen><userinput><command>cd ~
Xorg -configure</command></userinput></screen>
The screen will go black and you may hear some clicking of the monitor. This
command will create a file, <filename>xorg.conf.new</filename> in your home
directory.</para>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
</indexterm>
<para>Edit <filename>xorg.conf.new</filename> to suit your system. The details
of the file are located in the xorg.conf man page. Some
things you may want to do are:</para>
<itemizedlist>
 
<listitem><para>Section "Files". Change the order of the font paths searched.
You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally
comes up closer to 100 dots per inch. You may want to remove some font
directories completely.</para></listitem>
 
<listitem><para>Section "Module". If you are going to install NVidia
drivers, remove the "dri" line.</para></listitem>
<listitem><para>Sections "InputDevice". Specify the
<parameter>Device</parameter> parameter to "/dev/input/mice" and
<parameter>Protocol</parameter> to "auto" to set up your mouse. You may
also want to change the keyboard autorepeat rate by adding
<parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
<listitem><para>Section "Monitor". Specify the
<parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values
if the system does not automatically detect the monitor and its values.</para>
</listitem>
<listitem><para>Section "Device". You may want to set some of the options
available for your selected video driver. A description of the driver
parameters is in the man page for your driver.</para></listitem>
<listitem><para>Section "Screen". Add a DefaultDepth statement such as:
<parameter>DefaultDepth 16</parameter>. In the SubSection for your default
depth, add a modes line such as:
<parameter> Modes "1280x1024" "1024x768"</parameter>. The first mode listed
will normally be the starting resolution.</para></listitem>
</itemizedlist>
 
<para>Test the system with:
<screen><userinput><command>X -config ~/xorg.conf.new</command></userinput></screen>
You will only get a gray background with an X-shaped mouse cursor, but it
confirms the system is working. Exit with Control-Alt-Backspace. If the
system does not work, take a look at <filename>/var/log/Xorg.0.log</filename>
to see what went wrong.</para>
<para>Move the configuration file to its final location:</para>
<screen><userinput><command>mv ~/xorg.conf.new /etc/X11/xorg.conf</command></userinput></screen>
<para>Create <filename>.xinitrc</filename>:
<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
# Begin .xinitrc file
xterm -g 80x40+0+0 &amp;
xclock -g 100x100-0+0 &amp;
twm
<command>EOF</command></userinput></screen>
This provides an initial screen with an xterm and a clock that is managed by a
simple window manager, Tab Window Manager. For details of
<command>twm</command>, see the man page.</para>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
</indexterm>
<note>
<para>When needed, <application>Xorg</application> creates the directory
<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
not owned by root, <application>Xorg</application> delays startup by a few
seconds and also appends a warning to the logfile. This also affects startup of
other applications. To improve performance, it is advisable to manually create
the directory before <application>Xorg</application> uses it. Add the file
creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
<screen><userinput role='root'><command>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"</command>
/tmp/.ICE-unix dir 1777 root root
<command>EOF</command></userinput></screen>
</note>
 
<indexterm zone="xorg xorg-config">
<primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
</indexterm>
 
<para>Start <application>X</application> with:
<screen><userinput><command>startx</command></userinput></screen>
to get a basic functional <application>X</application> Window System.</para>
 
<para>At this point, you should check out <xref linkend='x-setup'/>.</para>
 
<para>For a list of the package contents and a description of the commands,
see the sections in the <xref linkend='xfree86-contents'/>.</para>
 
</sect2>
 
</sect1>
/trunk/blfs/x/lib/icon/hicolor-icon-theme.ent
File deleted
/trunk/blfs/x/lib/icon/hicolor-icon-theme-intro.xml
File deleted
/trunk/blfs/x/lib/icon/hicolor-icon-theme-inst.xml
File deleted
/trunk/blfs/x/lib/icon/hicolor-icon-theme-desc.xml
File deleted
/trunk/blfs/x/lib/atk/atk.ent
File deleted
/trunk/blfs/x/lib/atk/atk-intro.xml
File deleted
/trunk/blfs/x/lib/atk/atk-exp.xml
File deleted
/trunk/blfs/x/lib/atk/atk-inst.xml
File deleted
/trunk/blfs/x/lib/atk/atk-desc.xml
File deleted
/trunk/blfs/x/lib/mime/shared-mime-info.ent
File deleted
/trunk/blfs/x/lib/mime/shared-mime-info-intro.xml
File deleted
/trunk/blfs/x/lib/mime/shared-mime-info-inst.xml
File deleted
/trunk/blfs/x/lib/mime/shared-mime-info-desc.xml
File deleted
/trunk/blfs/x/lib/gtk/gtk+-intro.xml
File deleted
/trunk/blfs/x/lib/gtk/gtk+-exp.xml
File deleted
/trunk/blfs/x/lib/gtk/gtk.ent
File deleted
/trunk/blfs/x/lib/gtk/gtk+-inst.xml
File deleted
/trunk/blfs/x/lib/gtk/gtk+-desc.xml
File deleted
/trunk/blfs/x/lib/fnlib.xml
File deleted
/trunk/blfs/x/lib/lesstif/lesstif.ent
File deleted
/trunk/blfs/x/lib/lesstif/lesstif-intro.xml
File deleted
/trunk/blfs/x/lib/lesstif/lesstif-exp.xml
File deleted
/trunk/blfs/x/lib/lesstif/lesstif-inst.xml
File deleted
/trunk/blfs/x/lib/lesstif/lesstif-desc.xml
File deleted
/trunk/blfs/x/lib/lesstif/lesstif-config.xml
File deleted
/trunk/blfs/x/lib/notification/startup-notification-intro.xml
File deleted
/trunk/blfs/x/lib/notification/startup-notification-inst.xml
File deleted
/trunk/blfs/x/lib/notification/startup-notification-desc.xml
File deleted
/trunk/blfs/x/lib/notification/startup-notification.ent
File deleted
/trunk/blfs/x/lib/qt.ent
File deleted
/trunk/blfs/x/lib/pango/pango.ent
File deleted
/trunk/blfs/x/lib/pango/pango-intro.xml
File deleted
/trunk/blfs/x/lib/pango/pango-exp.xml
File deleted
/trunk/blfs/x/lib/pango/pango-inst.xml
File deleted
/trunk/blfs/x/lib/pango/pango-desc.xml
File deleted
/trunk/blfs/x/lib/libxklavier/libxklavier-inst.xml
File deleted
/trunk/blfs/x/lib/libxklavier/libxklavier-desc.xml
File deleted
/trunk/blfs/x/lib/libxklavier/libxklavier.ent
File deleted
/trunk/blfs/x/lib/libxklavier/libxklavier-intro.xml
File deleted
/trunk/blfs/x/lib/gtk2/gtk+2-intro.xml
File deleted
/trunk/blfs/x/lib/gtk2/gtk+2-exp.xml
File deleted
/trunk/blfs/x/lib/gtk2/gtk2.ent
File deleted
/trunk/blfs/x/lib/gtk2/gtk+2-inst.xml
File deleted
/trunk/blfs/x/lib/gtk2/gtk+2-desc.xml
File deleted
/trunk/blfs/x/lib/fnlib/fnlib.ent
File deleted
/trunk/blfs/x/lib/fnlib/fnlib-intro.xml
File deleted
/trunk/blfs/x/lib/fnlib/fnlib-exp.xml
File deleted
/trunk/blfs/x/lib/fnlib/fnlib-inst.xml
File deleted
/trunk/blfs/x/lib/fnlib/fnlib-desc.xml
File deleted
/trunk/blfs/x/lib/fnlib/fnlib-config.xml
File deleted
/trunk/blfs/x/lib/gtk+.xml
1,12 → 1,137
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY GTK-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
<!ENTITY GTK-download-ftp "ftp://ftp.gtk.org/pub/gtk/v1.2/gtk+-&GTK-version;.tar.gz">
<!ENTITY GTK-md5sum "4d5cb2fc7fb7830e4af9747a36bfce20">
<!ENTITY GTK-size "2.7 MB">
<!ENTITY GTK-buildsize "54 MB">
<!ENTITY GTK-time "1.96 SBU">
]>
<sect1 id="GTK" xreflabel="GTK+-&GTK-version;">
<?dbhtml filename="gtk.html"?>
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="gtk.html" ?>
<title>GTK+-&GTK-version;</title>
 
&GTK-intro;
&GTK-inst;
&GTK-exp;
&GTK-desc;
<indexterm zone="GTK">
<primary sortas="a-GTK">GTK</primary>
</indexterm>
 
 
<sect2>
<title>Introduction to
<application><acronym>GTK</acronym>+</application></title>
 
<para>The <application>GTK+</application> package contains
<application>GTK+</application> Libraries. This is useful for
creating graphical user interfaces for applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&GTK-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&GTK-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &GTK-md5sum;</para></listitem>
<listitem><para>Download size: &GTK-size;</para></listitem>
<listitem><para>Estimated disk space required: &GTK-buildsize;</para></listitem>
<listitem><para>Estimated build time: &GTK-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application><acronym>GTK</acronym>+</application> dependencies</title>
 
<sect4>
<title>Required</title>
 
<para><xref linkend="GLib"/>,
<xref linkend="libtiff"/>,
<xref linkend="libjpeg"/>, and
X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of
<application><acronym>GTK</acronym>+</application></title>
 
<para>Install <application><acronym>GTK</acronym>+</application> by running
the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--sysconfdir=/etc</option>: This installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--with-xinput=xfree</parameter>: This configuration
flag is necessary to utilize alternative input devices.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libgtk-1.2, libgdk-1.2</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
 
<varlistentry id="libgtk">
<term><filename class='libraryfile'>libgtk.{so,a}</filename></term>
<listitem>
<para>(GIMP Tool Kit) is a library for creating graphical user interfaces similar to
the Motif "look and feel".</para>
<indexterm zone="GTK libgtk">
<primary sortas="c-libgtk">libgtk.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="libgdk">
<term><filename class='libraryfile'>libgdk.{so,a}</filename></term>
<listitem>
<para>is designed as a wrapper library that lies on top of Xlib. It
performs many common and desired operations for a programmer instead of
the programmer having to explicitly ask for such functionality from
Xlib directly.</para>
<indexterm zone="GTK libgdk">
<primary sortas="c-libgdk">libgdk.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
</sect1>
 
/trunk/blfs/x/lib/gtk+2.xml
1,12 → 1,187
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="GTK2" xreflabel="GTK+-&GTK2-version;">
<?dbhtml filename="gtk2.html"?>
<title>GTK+-&GTK2-version;</title>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
&GTK2-intro;
&GTK2-inst;
&GTK2-exp;
&GTK2-desc;
<!ENTITY gtk2-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v2.6/gtk+-&gtk2-version;.tar.bz2">
<!ENTITY gtk2-download-ftp "ftp://ftp.gtk.org/pub/gtk/v2.6/gtk+-&gtk2-version;.tar.bz2">
<!ENTITY gtk2-md5sum "4749fce7b082b784a71a076aa586dc25">
<!ENTITY gtk2-size "11.2 MB">
<!ENTITY gtk2-buildsize "202 MB">
<!ENTITY gtk2-time "2.87 SBU">
]>
 
<sect1 id="gtk2" xreflabel="GTK+-&gtk2-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="gtk2.html" ?>
<title>GTK+-&gtk2-version;</title>
 
<indexterm zone="gtk2">
<primary sortas="a-gtk2">gtk2</primary>
</indexterm>
 
<sect2>
<title>Introduction to
<application><acronym>GTK</acronym>+</application></title>
 
<para>The <application><acronym>GTK</acronym>+</application> package contains
<application><acronym>GTK</acronym>+</application> Libraries. These are useful
for creating graphical user interfaces for applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&gtk2-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&gtk2-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &gtk2-md5sum;</para></listitem>
<listitem><para>Download size: &gtk2-size;</para></listitem>
<listitem><para>Estimated disk space required: &gtk2-buildsize;</para></listitem>
<listitem><para>Estimated build time: &gtk2-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3>
<title><application><acronym>GTK</acronym>+</application> dependencies</title>
<sect4>
<title>Required</title>
<para>
X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>),
<xref linkend="pango"/>, and
<xref linkend="atk"/>
</para>
</sect4>
 
<sect4>
<title>Optional</title>
<para>
<xref linkend="libtiff"/>,
<xref linkend="libjpeg"/>,
<xref linkend="gtk-doc"/>, and
<xref linkend="docbook-utils"/>
</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application><acronym>GTK</acronym>+</application></title>
 
<para>Install <application><acronym>GTK</acronym>+</application> by running
the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
--without-libtiff --without-libjpeg &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
 
<para><parameter>--without-libtiff</parameter>: Omit this switch if you have
<application>libtiff</application> installed.</para>
 
<para><parameter>--without-libjpeg</parameter>: Omit this switch if you have
<application>libjpeg</application> installed.</para>
 
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the <acronym>API</acronym> documentation during the
<command>make</command> command.</para>
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gdk-pixbuf-csource, gdk-pixbuf-query-loaders, gtk-demo,
gtk-query-immodules-2.0, gtk-update-icon-cache</seg>
<seg>libgdk_pixbuf-2.0.so, libgdk-x11-2.0.so, libgtk-x11-2.0.so,
libgdk_pixbuf_xlib-2.0.so and numerous engine, module and
loader plugins</seg>
<seg>/etc/gtk-2.0, /usr/include/gtk-2.0, /usr/lib/gtk-2.0,
/usr/share/gtk-2.0, /usr/share/gtk-doc/html/[gdk,gdk-pixbuf,gtk],
/usr/share/themes/Default/gtk* and
/usr/share/themes/Emacs/gtk-2.0-key</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="gdk-pixbuf-csource">
<term><command>gdk-pixbuf-csource</command></term>
<listitem>
<para>generates C code containing images, useful for compiling images
directly into programs.</para>
<indexterm zone="gtk2 gdk-pixbuf-csource">
<primary sortas="b-gdk-pixbuf-csource">gdk-pixbuf-csource</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gdk-pixbuf-query-loaders">
<term><command>gdk-pixbuf-query-loaders</command></term>
<listitem>
<para>collects information about loadable modules for gdk-pixbuf and
writes it to standard output.</para>
<indexterm zone="gtk2 gdk-pixbuf-query-loaders">
<primary sortas="b-gdk-pixbuf-query-loaders">gdk-pixbuf-query-loaders</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gtk-query-immodules-2.0">
<term><command>gtk-query-immodules-2.0</command></term>
<listitem>
<para> collects information about loadable input method modules for
<application><acronym>GTK</acronym>+</application> and writes it to
standard output.</para>
<indexterm zone="gtk2 gtk-query-immodules-2.0">
<primary sortas="b-gtk-query-immodules-2.0">gtk-query-immodules-2.0</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="gtk-update-icon-cache">
<term><command>gtk-update-icon-cache</command></term>
<listitem>
<para>creates mmap()able cache files for icon themes.</para>
<indexterm zone="gtk2 gtk-update-icon-cache">
<primary sortas="b-gtk-update-icon-cache">gtk-update-icon-cache</primary>
</indexterm>
</listitem>
</varlistentry>
 
<varlistentry id="GTK2libs">
<term>GTK+ Libraries</term>
<listitem>
<para>provide an API to implement graphical user interfaces.</para>
<indexterm zone="gtk2 GTK2libs">
<primary sortas="c-GTK2libs">GTK+ Libraries</primary>
</indexterm>
</listitem>
</varlistentry>
 
</variablelist>
</sect2>
 
</sect1>
 
/trunk/blfs/x/lib/qt.xml
1,5 → 1,22
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY qt-download-http "http://sunsite.rediris.es/mirror/Qt/source/qt-x11-free-&qt-version;.tar.bz2">
<!ENTITY qt-download-ftp "ftp://ftp.trolltech.com/qt/source/qt-x11-free-&qt-version;.tar.bz2">
<!ENTITY qt-md5sum "3e0a0c8429b0a974b39b5f535ddff01c">
<!ENTITY qt-size "14.4 MB">
<!ENTITY qt-buildsize "250 MB">
<!ENTITY qt-time "19.3 SBU (full), 13.4 SBU (sub-tools)">
]>
 
<sect1 id="qt" xreflabel="Qt-&qt-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="qt.html" ?>
<title>Qt-&qt-version;</title>
 
10,15 → 27,16
<application>C++</application> <acronym>GUI</acronym> library. This is useful
for creating graphical applications or executing graphical applications that
are dynamically linked to the <application>Qt</application> library. One of the
major users of <application>Qt</application> is <application>KDE</application>.</para>
major users of <application>Qt</application> is <application>KDE</application>.
</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&qt-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&qt-download-ftp;"/></para></listitem>
<listitem><para>MD5 Sum: &qt-md5sum;</para></listitem>
<listitem><para>Download MD5 Sum: &qt-md5sum;</para></listitem>
<listitem><para>Download size: &qt-size;</para></listitem>
<listitem><para>Estimated Disk space required: &qt-buildsize;</para></listitem>
<listitem><para>Estimated disk space required: &qt-buildsize;</para></listitem>
<listitem><para>Estimated build time: &qt-time;</para></listitem></itemizedlist>
</sect3>
 
26,14 → 44,16
<sect4><title>Required</title>
<para><xref linkend="x-installing"/></para>
</sect4>
 
<sect4><title>Recommended</title>
<para><xref linkend="libjpeg"/> and <xref linkend="libmng"/>.</para>
<para><xref linkend="libjpeg"/> and <xref linkend="libmng"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="nas"/>, <xref linkend="cups"/>, <xref linkend="mysql"/>,
<xref linkend="postgresql"/>, <ulink url="http://firebird.sourceforge.net/">Firebird</ulink>,
and <ulink url="http://www.unixodbc.org/">unixODBC</ulink>.</para>
<xref linkend="postgresql"/>, <ulink url="http://sqlite.org/">SQLite</ulink>,
<ulink url="http://firebird.sourceforge.net/">Firebird</ulink>
and <ulink url="http://www.unixodbc.org/">unixODBC</ulink></para>
</sect4>
</sect3>
</sect2>
41,36 → 61,41
<sect2>
<title>Installation of <application>Qt</application></title>
 
<para>There are several ways to install a complicated package such as <application>Qt</application>.
The files are not completely position independent. Installation procedures execute the
program <filename>pkg-config</filename> to determine the location of package executables, libraries,
headers, and other files. For <application>Qt</application>, <filename>pkg-config</filename> will
look for the file <filename>lib/pkgconfig/qt-mt.pc</filename> which must be modified if relocating the
package. This file is set up correctly by the build process.</para>
<para>There are several ways to install a complicated package such as
<application>Qt</application>. The files are not completely position
independent. Installation procedures execute the program
<command>pkg-config</command> to determine the location of package executables,
libraries, headers, and other files. For <application>Qt</application>,
<command>pkg-config</command> will look for the file
<filename>lib/pkgconfig/qt-mt.pc</filename> which must be modified if
relocating the package. This file is set up correctly by the build process.
</para>
 
<para>The default installation places the files in <filename class='directory'>/usr/local/qt/</filename>.
Many commercial distributions place the files in the system's
<filename class='directory'>/usr</filename> hierarchy. The package can also be installed
in an arbitrary directory.</para>
<para>The default installation places the files in
<filename class='directory'>/usr/local/qt/</filename>. Many commercial
distributions place the files in the system's
<filename class='directory'>/usr</filename> hierarchy. The package can also be
installed in an arbitrary directory.</para>
 
<para>This section will demonstrate two different methods.</para>
 
<note><para>The build time for <application>Qt</application> is quite long. If
you want to save some time and don't want the tutorials and examples, change
the first make line to:</para>
 
<note><para>The build time for <application>Qt</application> is quite long. If you want to
save some time and don't want the tutorials and examples, change the first make line to:</para>
 
<para><userinput><command>make sub-tools</command></userinput></para>
</note>
 
<sect3>
<title>Method 1 - Installing in the <filename class='directory'>/usr</filename> hierarchy</title>
<title>Method 1 - Installing in the
<filename class='directory'>/usr</filename> hierarchy</title>
<para>The advantage of this method is that no updates to the <filename>/etc/ld.so.conf</filename>
or <filename>/etc/man.conf</filename> files are required. The package files
are distributed within several subdirectories of the <filename class='directory'>/usr</filename>
hierarchy. This is the method that most commercial distributions use.</para>
<para>The advantage of this method is that no updates to the
<filename>/etc/ld.so.conf</filename> or <filename>/etc/man.conf</filename>
files are required. The package files are distributed within several
subdirectories of the <filename class='directory'>/usr</filename> hierarchy.
This is the method that most commercial distributions use.</para>
 
<screen><userinput><command>sed -i "s:cp -f:install:" mkspecs/linux-g++/qmake.conf &amp;&amp;
bash
export PATH=$PWD/bin:$PATH &amp;&amp;
78,12 → 103,15
./configure -prefix /usr -docdir /usr/share/doc/qt \
-headerdir /usr/include/qt -plugindir /usr/lib/qt/plugins \
-datadir /usr/share/qt -translationdir /usr/share/qt/translations \
-sysconfdir /etc/qt -qt-gif -system-zlib \
-no-exceptions -thread -plugin-imgfmt-png -system-libpng &amp;&amp;
-sysconfdir /etc/qt -qt-gif -system-zlib -system-libmng \
-no-exceptions -thread -plugin-imgfmt-png \
-system-libjpeg -system-libpng &amp;&amp;
find -type f -name Makefile | xargs sed -i "s@-Wl,-rpath,/usr/lib@@g" &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
ln -sf libqt-mt.so /usr/lib/libqt.so &amp;&amp;
rm /usr/bin/qmake &amp;&amp;
install -m755 -oroot -groot qmake/qmake /usr/bin &amp;&amp;
cp -r doc/man /usr/share &amp;&amp;
cp -r examples /usr/share/doc/qt &amp;&amp;
exit</command></userinput></screen>
93,68 → 121,41
<sect3>
<title>Method 2 - Installing in <filename class='directory'>/opt</filename></title>
 
<para>This is the method recommended by the <application>Qt</application> developers. It
has the advantage of keeping all the package files consolidated in a dedicated directory
hierarchy. By using this method, an update can be made without overwriting a previous
installation and users can easily revert to a previous version by changing one symbolic
link.</para>
<para>This is the method recommended by the <application>Qt</application>
developers. It has the advantage of keeping all the package files consolidated
in a dedicated directory hierarchy. By using this method, an update can be made
without overwriting a previous installation and users can easily revert to a
previous version by changing one symbolic link.</para>
 
<para>The <application>Qt</application> developers use a default location of
<filename class='directory'>/usr/local/qt/</filename>, however this procedure puts the files
in <filename class='directory'>/opt/qt-&qt-version;/</filename> and then creates a
symbolic link to <filename>/opt/qt/</filename>.</para>
<filename class='directory'>/usr/local/qt/</filename>, however this procedure
puts the files in <filename class='directory'>/opt/qt-&qt-version;/</filename>
and then creates a symbolic link to <filename>/opt/qt/</filename>.</para>
 
 
<screen><userinput><command>bash
export QTDIR=$PWD &amp;&amp;
export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH &amp;&amp;
export PATH=$PWD/bin:$PATH &amp;&amp;
./configure -prefix /opt/qt-&qt-version; -qt-gif -system-libpng \
&nbsp;&nbsp;&nbsp;-system-libmng -system-zlib -system-libjpeg -no-exceptions \
&nbsp;&nbsp;&nbsp;-thread -plugin-imgfmt-png &amp;&amp;
-system-libmng -system-zlib -system-libjpeg -no-exceptions \
-thread -plugin-imgfmt-png &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
ln -sfn qt-&qt-version; /opt/qt &amp;&amp;
ln -s libqt-mt.so /opt/qt/lib/libqt.so &amp;&amp;
rm /opt/qt-&qt-version;/bin/qmake &amp;&amp;
install -m755 -oroot -groot qmake/qmake /opt/qt-&qt-version;/bin &amp;&amp;
cp -r doc/man /opt/qt/doc &amp;&amp;
cp -r examples /opt/qt/doc
exit</command></userinput></screen>
 
<sect4>
<title>Configuration</title>
<note><para>If you pass the
<option>-plugin-sql-<replaceable>[driver]</replaceable></option> switch to the
<command>configure</command> command, you must also pass
<option>-I<replaceable>[/path/to/sql/headers]</replaceable></option> so
<command>make</command> can find the appropriate header files.</para></note>
</sect3>
 
<para>For Method 2 only, update the <filename>/etc/ld.so.conf</filename> and
<filename>/etc/man.conf</filename> files.</para>
 
 
<screen><userinput><command>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
# Begin qt addition to /etc/ld.so.conf
 
/opt/qt/lib
 
# End qt addition
EOF
ldconfig
 
cat &gt;&gt; /etc/man.conf &lt;&lt; "EOF"
# Begin qt addition to man.conf
 
MANPATH /opt/qt/doc/man
 
# End qt addition to man.conf
EOF</command></userinput></screen>
 
<para>Also, the <envar>QTDIR</envar> environment variable needs to be set when
building packages that depend on Qt. Add the following to the
<filename>.bash_profile</filename> initialization script for each user that
builds packages using the <application>Qt</application> libraries.
Alternatively, the variable can be set in the system wide
<filename>/etc/profile</filename> file.</para>
 
<screen><userinput>export QTDIR=/opt/qt</userinput></screen>
 
</sect4>
</sect3>
</sect2>
 
<sect2>
167,25 → 168,30
<para><command>bash</command>: This command enters a sub-shell to isolate
environment changes.</para>
 
<para><command>export QTDIR=$PWD</command>: This command
defines where the root of the Qt directory is located.</para>
<para><command>export QTDIR=$PWD</command>: This command defines where the root
of the <application>Qt</application> directory is located.</para>
 
<para><command>export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH</command>: This command
allows the not yet installed qt libraries to be used by the not yet installed qt programs.</para>
<para><command>export LD_LIBRARY_PATH=$PWD/lib:$LD_LIBRARY_PATH</command>: This
command allows the not yet installed <application>Qt</application> libraries to
be used by the not yet installed <application>Qt</application> programs.</para>
 
<para><command>export PATH=$PWD/bin:$PATH</command>: This command
allows the build process to find supporting executables.</para>
 
<para><parameter>-qt-gif</parameter>: This switch adds support for gif
files to the libraries.</para>
<para><parameter>-qt-gif</parameter>: This switch adds support for
<filename>gif</filename> files to the libraries.</para>
 
<para><parameter>-system-zlib -system-libpng</parameter>: This switch
forces the build instructions to use the shared libraries that are on your system
instead of creating a custom set of support libraries for these
forces the build instructions to use the shared libraries that are on your
system instead of creating a custom set of support libraries for these
functions.</para>
 
<para><parameter>-plugin-imgfmt-png</parameter>: This switch enables
<application>libpng</application> to be linked to at runtime.</para>
 
<para><parameter>-no-exceptions</parameter>: This switch disables
the exceptions coding generated by the <application>C++</application> compiler.</para>
the exceptions coding generated by the <application>C++</application> compiler.
</para>
 
<para><parameter>-thread</parameter>: This switch adds
support for multi-threading.</para>
192,28 → 198,79
 
<para><command>find -type f -name Makefile | xargs sed -i
"s@-Wl,-rpath,/usr/lib@@g"</command>: This command removes hardcoded run-time
paths. Otherwise, <command>uic</command> always tries to run with Qt libraries
in <filename>/usr/lib</filename>.</para>
paths. Otherwise, <command>uic</command> always tries to run with
<application>Qt</application> libraries in <filename>/usr/lib</filename>.</para>
 
<para><command>ln -s libqt-mt.so /usr/lib/libqt.so</command>: This
command allows configure scripts
to find a working <application>Qt</application> installation.</para>
<para><command>ln -s libqt-mt.so /usr/lib/libqt.so</command>: This command
allows <command>configure</command> scripts to find a working
<application>Qt</application> installation.</para>
 
<para><command>rm .../qmake; install -m755 -oroot -groot qmake/qmake .../bin</command>:
The <command>qmake</command> program is installed incorrectly by
<command>make install</command>. These two commands install the program
correctly.</para>
 
<para><command>cp -r doc/man /usr/share (or /opt/qt/doc)</command>: This command
installs the man pages which are missed by <command>make install</command>.</para>
installs the man pages which are missed by <command>make install</command>.
</para>
 
<para><command>cp -r examples /usr/share/doc/qt (or /opt/qt/doc)</command>: This command
installs the examples which are missed by <command>make install</command>.</para>
<para><command>cp -r examples /usr/share/doc/qt (or /opt/qt/doc)</command>:
This command installs the examples which are missed by
<command>make install</command>.</para>
 
<para><command>exit</command>: This command returns to the parent shell
and eliminates environment variables set earlier.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Qt</application></title>
 
<sect3><title>Configuration Information</title>
<para>If you installed <application>Qt</application> using Method 2, you need
to update some configuration files so that <application>Qt</application> is
correctly found by other packages and system processes.</para>
 
<para>Update the <filename>/etc/ld.so.conf</filename> and
<filename>/etc/man.conf</filename> files:</para>
 
<screen><userinput><command>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
# Begin qt addition to /etc/ld.so.conf
 
/opt/qt/lib
 
# End qt addition
EOF
ldconfig
 
cat &gt;&gt; /etc/man.conf &lt;&lt; "EOF"
# Begin qt addition to man.conf
 
MANPATH /opt/qt/doc/man
 
# End qt addition to man.conf
EOF</command></userinput></screen>
 
<para>Update the <envar>PKG_CONFIG_PATH</envar> environment variable in your
<filename>~/.bash_profile</filename> or <filename>/etc/profile</filename> with
the following:</para>
 
<screen><userinput>PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/qt/lib/pkgconfig</userinput></screen>
 
<para>The <envar>QTDIR</envar> environment variable needs to be set when
building packages that depend on <application>Qt</application>. Add the
following to the <filename>.bash_profile</filename> initialization script for
each user that builds packages using the <application>Qt</application>
libraries. Alternatively, the variable can be set in the system wide
<filename>/etc/profile</filename> file.</para>
 
<screen><userinput>export QTDIR=/opt/qt</userinput></screen>
 
<para>If you want the <application>Qt</application> executables in your shell
search path, update the <envar>PATH</envar> environment variable in your
<filename>~/.bash_profile</filename> or <filename>/etc/profile</filename> to
include <filename class='directory'>/opt/qt/bin</filename>.</para>
 
<para>As with most libraries, there is no explicit configuration to do. After
updating <filename>/etc/ld.so.conf</filename> as explained above, run
<command>/sbin/ldconfig</command> so that <command>ldd</command> can find the
222,12 → 279,14
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>Qt</application>/<application>X11</application>
library contains <acronym>API</acronym>s necessary to use
programs based on the Qt <acronym>GUI</acronym> toolkit.</para>
programs based on the <application>Qt</application> <acronym>GUI</acronym>
toolkit.</para>
 
<para>The <application>Qt</application> package contains
<command>assistant</command>,
/trunk/blfs/x/lib/shared-mime-info.xml
1,11 → 1,108
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="shared-mime-info" xreflabel="shared-mime-info-&shared-mime-info-version;">
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY shared-mime-info-download-http "http://freedesktop.org/software/shared-mime-info/shared-mime-info-&shared-mime-info-version;.tar.gz">
<!ENTITY shared-mime-info-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/shared-mime-info-&shared-mime-info-version;.tar.gz">
<!ENTITY shared-mime-info-md5sum "51793b041edc68717c3f87e26a4bc087">
<!ENTITY shared-mime-info-size "422 KB">
<!ENTITY shared-mime-info-buildsize "4.4 MB">
<!ENTITY shared-mime-info-time "0.03 SBU">
]>
 
<sect1 id="shared-mime-info"
xreflabel="shared-mime-info-&shared-mime-info-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="shared-mime-info.html" ?>
<title>shared-mime-info-&shared-mime-info-version;</title>
 
&shared-mime-info-intro;
&shared-mime-info-inst;
&shared-mime-info-desc;
<sect2>
<title>Introduction to <application>shared-mime-info</application></title>
 
<para>The <application>shared-mime-info</application> package contains a
<acronym>MIME</acronym> database. This allows central updates of
<acronym>MIME</acronym> information for all supporting applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&shared-mime-info-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&shared-mime-info-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&shared-mime-info-md5sum;</para></listitem>
<listitem><para>Download size:
&shared-mime-info-size;</para></listitem>
<listitem><para>Estimated disk space required:
&shared-mime-info-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&shared-mime-info-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>shared-mime-info</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="glib2"/>,
<xref linkend="libxml2"/> and
<xref linkend="perl-modules"/>: XML-Parser</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>shared-mime-info</application></title>
 
<para>Install <application>shared-mime-info</application> by running the
following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Configuring <application>shared-mime-info</application></title>
 
<sect3><title>Configuration information</title>
 
<para>Some applications
(including <application><acronym>GNOME</acronym></application>-2) require
a properly set enviroment variable to locate the <acronym>MIME</acronym>
database. Satisfy this requirement by setting the following variable in your
local shell profile, or the system-wide profile:</para>
 
<screen><userinput>XDG_DATA_DIRS=/usr/share
export XDG_DATA_DIRS</userinput></screen>
</sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>shared-mime-info</application> package contains
<command>update-mime-database</command> and
<filename>/usr/share/mime/*</filename>.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>update-mime-database</title>
<para><command>update-mime-database</command> assists in adding
<acronym>MIME</acronym> data to the database.</para></sect3>
 
<sect3><title>MIME Database</title>
<para><filename>/usr/share/mime/*</filename> contains the centralized
<acronym>MIME</acronym> database.</para></sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/lib/pango.xml
1,12 → 1,132
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="Pango" xreflabel="Pango-&Pango-version;">
<?dbhtml filename="pango.html" dir="x"?>
<title>Pango-&Pango-version;</title>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
&Pango-intro;
&Pango-inst;
&Pango-exp;
&Pango-desc;
<!ENTITY pango-download-http "http://ftp.gnome.org/pub/GNOME/sources/pango/1.8/pango-&pango-version;.tar.bz2">
<!ENTITY pango-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/pango/1.8/pango-&pango-version;.tar.bz2">
<!ENTITY pango-md5sum "88aa6bf1876766db6864f3b93577887c">
<!ENTITY pango-size "996 KB">
<!ENTITY pango-buildsize "22 MB">
<!ENTITY pango-time "0.56 SBU (includes rebuilding the documentation)">
]>
 
<sect1 id="pango" xreflabel="Pango-&pango-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="pango.html" ?>
<title>Pango-&pango-version;</title>
 
<sect2>
<title>Introduction to <application>Pango</application></title>
 
<para>The <application>Pango</application> package contains the
<filename class="libraryfile">libpango</filename> libraries. These are useful
for the layout and rendering of text.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&pango-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&pango-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &pango-md5sum;</para></listitem>
<listitem><para>Download size: &pango-size;</para></listitem>
<listitem><para>Estimated disk space required:
&pango-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&pango-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>Pango</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="glib2"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><ulink url="http://freedesktop.org/~fontconfig/release/">Xft</ulink>
(included in <xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="fontconfig"/> and <xref linkend="gtk-doc"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>Pango</application></title>
 
<para>In order for <application>Pango</application> to find
<application>Xft</application>, the <envar>PKG_CONFIG_PATH</envar> must
include <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>.
This is a good time to add it if you haven't already. You can utilize the
example for <filename>X.sh</filename> to create a script for modifying this
variable located in the section <xref linkend="postlfs-config-profile"/>.
</para>
 
<para>Install <application>Pango</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
configuration files into <filename class="directory">/etc</filename>
instead of <filename class="directory">/usr/etc</filename>.</para>
 
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the <acronym>API</acronym> documentation during the
<command>make</command> command.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>Pango</application></title>
 
<sect3><title>Config files</title>
<para><filename>/etc/pango/pangorc</filename>,
<filename>~/.pangorc</filename> and the file specified in the
environment variable <envar>PANGO_RC_FILE</envar></para>
</sect3>
 
<sect3><title>Configuration Information</title>
<para>The <application>Pango</application> module path is specified by the key
<userinput><parameter>Pango/ModulesPath</parameter></userinput> in the
<application>Pango</application> config database, which is read from the
config files listed above.</para></sect3>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>Pango</application> package contains
<command>pango-querymodules</command>,
<filename class="libraryfile">libpango</filename> libraries and
<application>Pango</application> loadable modules.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>pango-querymodules</title>
<para><command>pango-querymodules</command> is a module registration utility
that collects information about <application>Pango</application> loadable
modules</para></sect3>
 
<sect3><title>Pango libraries</title>
<para><application>Pango</application> libraries contain low level layout
rendering routines, a high level driver for laying out entire blocks of text,
and routines to assist in editing internationalized text.</para></sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/lib/hicolor-icon-theme.xml
1,11 → 1,95
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="hicolor-icon-theme" xreflabel="hicolor-icon-theme-&hicolor-icon-theme-version;">
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY hicolor-icon-theme-download-http "http://freedesktop.org/software/icon-theme/releases/hicolor-icon-theme-&hicolor-icon-theme-version;.tar.gz">
<!ENTITY hicolor-icon-theme-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/hicolor-icon-theme-&hicolor-icon-theme-version;.tar.gz">
<!ENTITY hicolor-icon-theme-md5sum "947c7f6eb68fd95c7b86e87f853ceaa0">
<!ENTITY hicolor-icon-theme-size "32 KB">
<!ENTITY hicolor-icon-theme-buildsize "1.1 MB">
<!ENTITY hicolor-icon-theme-time "0.01 SBU">
]>
 
<sect1 id="hicolor-icon-theme"
xreflabel="hicolor-icon-theme-&hicolor-icon-theme-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
 
<?dbhtml filename="hicolor-icon-theme.html" ?>
<title>hicolor-icon-theme-&hicolor-icon-theme-version;</title>
 
&hicolor-icon-theme-intro;
&hicolor-icon-theme-inst;
&hicolor-icon-theme-desc;
<indexterm zone="hicolor-icon-theme">
<primary sortas="a-hicolor-icon-theme">hicolor-icon-theme</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>hicolor-icon-theme</application></title>
 
<para>The <application>hicolor-icon-theme</application> package contains
a default fallback theme for implementations of the icon theme
specification.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&hicolor-icon-theme-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&hicolor-icon-theme-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &hicolor-icon-theme-md5sum;</para></listitem>
<listitem><para>Download size: &hicolor-icon-theme-size;</para></listitem>
<listitem><para>Estimated disk space required: &hicolor-icon-theme-buildsize;</para></listitem>
<listitem><para>Estimated build time: &hicolor-icon-theme-time;</para></listitem>
</itemizedlist>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>hicolor-icon-theme</application></title>
 
<para>Install <application>hicolor-icon-theme</application> by running the
following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>None</seg>
<seg>/usr/share/icons/hicolor/</seg>
</seglistitem>
</segmentedlist>
 
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="hicolor-icon-themes">
<term>/usr/share/icons/hicolor/*</term>
<listitem>
<para> contains icon definitions used as defaults.</para>
</listitem>
</varlistentry>
 
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/lib/startup-notification.xml
1,11 → 1,89
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="startup-notification" xreflabel="startup-notification-&startup-notification-version;">
<?dbhtml filename="startup-notification.html" dir="x"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY startup-notification-download-http "http://www.freedesktop.org/software/startup-notification/releases/startup-notification-&startup-notification-version;.tar.gz">
<!ENTITY startup-notification-download-ftp "ftp://ftp.linux.org.uk/pub/linux/GNOME/sources/startup-notification/&startup-notification-version;/startup-notification-&startup-notification-version;.tar.bz2">
<!ENTITY startup-notification-md5sum "9bba52ffe8c096cfeeaf7a1dcd9b943d">
<!ENTITY startup-notification-size "335 KB">
<!ENTITY startup-notification-buildsize "3.3 MB">
<!ENTITY startup-notification-time "0.09 SBU">
]>
 
<sect1 id="startup-notification"
xreflabel="startup-notification-&startup-notification-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="startup-notification.html" ?>
<title>startup-notification-&startup-notification-version;</title>
 
&startup-notification-intro;
&startup-notification-inst;
&startup-notification-desc;
<sect2>
<title>Introduction to <application>startup-notification</application></title>
 
<para>The <application>startup-notification</application> package
contains <filename class="libraryfile">startup-notification</filename>
libraries. These are useful for building a consistent manner to notify
the user through the cursor that the application is loading.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&startup-notification-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&startup-notification-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&startup-notification-md5sum;</para></listitem>
<listitem><para>Download size:
&startup-notification-size;</para></listitem>
<listitem><para>Estimated disk space required:
&startup-notification-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&startup-notification-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>startup-notification</application>
dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>startup-notification</application></title>
 
<para>Install <application>startup-notification</application> by running the
following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>startup-notification</application> package contains
<filename class="libraryfile">libstartup-notification</filename>
libraries.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>startup-notification libraries</title>
<para><filename class="libraryfile">startup-notification</filename> libraries
provide the functions to assist applications in communicating with the cursor
system to provide feedback to the user that the application is
loading.</para></sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/lib/lib.xml
1,27 → 1,33
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
 
<chapter id="x-lib">
<?dbhtml filename="lib.html" dir="x"?>
<title>Bibliothèques X</title>
<?dbhtml filename="lib.html" ?>
<title>X Libraries</title>
 
<para>Ce chapitre ne contient pas des bibliothèques requises pour lancer
<application>X</application>. Il contient des bibliothèques améliorant
<application>X</application>. Dans certains cas, l'amélioration est aussi
simple que le support des polices. Dans d'autres, il est aussi complexe que
les bibliothèques faisant l'interface entre <application>X</application>
et les applications qui utilisent <application>X</application> dont le but
est de standardiser l'allure et le comportement ainsi que les communications
inter-processus entre différentes applications. Elles assistent aussi les
développeurs en leur fournissant des éléments communs.</para>
<para>This chapter does not contain libraries that are required to run
<application>X</application>. It does contain libraries that enhance
<application>X</application>. In some cases the enhancement is as simple as
font support. In others it is as complex as libraries that sit between
<application>X</application> and applications that run on
<application>X</application> whose purpose is to standardize the look and feel
and inter-process communications for different applications. They also assist
programmers by supplying common elements.</para>
 
&qt;
&GTK;
&Pango;
&ATK;
&GTK2;
&lesstif;
&startup-notification;
&shared-mime-info;
&hicolor-icon-theme;
&libxklavier;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="qt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pango.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="atk.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gtk+2.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lesstif.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="startup-notification.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="shared-mime-info.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hicolor-icon-theme.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxklavier.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="freeglut.xml"/>
 
</chapter>
/trunk/blfs/x/lib/lesstif.xml
1,13 → 1,172
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY lesstif-download-http "http://prdownloads.sourceforge.net/lesstif/lesstif-&lesstif-version;.tar.bz2">
<!ENTITY lesstif-download-ftp " ">
<!ENTITY lesstif-md5sum "20f38a06c863e0c51ca0c862ef039601">
<!ENTITY lesstif-size "2.4 MB">
<!ENTITY lesstif-buildsize "109.9 MB (includes building test suite)">
<!ENTITY lesstif-time "2.94 SBU (includes building test suite)">
]>
 
<sect1 id="lesstif" xreflabel="LessTif-&lesstif-version;">
<?dbhtml filename="lesstif.html"?>
<title>LessTif-&lesstif-version;</title>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="lesstif.html" ?>
<title><application>LessTif</application>-&lesstif-version;</title>
 
&lesstif-intro;
&lesstif-inst;
&lesstif-exp;
&lesstif-config;
&lesstif-desc;
<sect2>
<title>Introduction to <application>LessTif</application></title>
 
<para>The <application>LessTif</application> package contains an Open
Source version of <application>OSF/Motif(R)</application>.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&lesstif-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&lesstif-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &lesstif-md5sum;</para></listitem>
<listitem><para>Download size: &lesstif-size;</para></listitem>
<listitem><para>Estimated disk space required:
&lesstif-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&lesstif-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>LessTif</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="lynx"/> or <xref linkend="Links"/> and
<ulink url="http://dmalloc.com">Dmalloc</ulink></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>LessTif</application></title>
 
<para>Install <application>LessTif</application> by running the following
commands:</para>
 
<screen><userinput><command>find -name Makefile.in | \
xargs sed -i 's@$(prefix)/LessTif@$(prefix)/share/LessTif@g' &amp;&amp;
./configure --prefix=/usr \
--enable-build-21 \
--disable-debug \
--enable-production \
--disable-build-tests \
--with-xdnd &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><command>sed -i 's@$(prefix)/LessTif@$(prefix)/share/LessTif@g'</command>:
This moves the location of the non-FHS compliant
<filename class="directory">/usr/LessTif</filename> directory to
<filename class="directory">/usr/share/LessTif</filename>.</para>
 
<para><parameter>--enable-build-21</parameter>: Build the
<application>Motif</application> 2.1 compatible version of the
<application>LessTif</application> libraries.</para>
 
<para><parameter>--disable-debug</parameter>: Do not generate debugging
information.</para>
 
<para><parameter>--enable-production</parameter>: Build the release version
of the <application>LessTif</application> libraries.</para>
 
<para><parameter>--disable-build-tests</parameter>: Do not build the
<filename class="directory">test/</filename> tree (see Testing
<application>LessTif</application>).</para>
 
<para><parameter>--with-xdnd</parameter>: Enable <acronym>XDND</acronym>
<acronym>GNOME</acronym> compatibility support.</para>
 
</sect2>
 
<sect2>
<title>Configuring <application>LessTif</application></title>
 
<sect3><title>Configuration Information</title>
 
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
 
</sect3>
 
</sect2>
 
<sect2>
<title>Testing <application>LessTif</application></title>
 
<para>It is advisable to test the installation of
<application>LessTif</application> with the test suite located in
<filename class="directory">lesstif-&lesstif-version;/test</filename>. It is
not required to install any of the resulting binaries to validate the
installation. The following commands executed from the source
directory will suffice:</para>
 
<screen><userinput><command>cd test &amp;&amp;
./configure &amp;&amp;
make</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>LessTif</application> package contains
<command>mxmkmf</command>, <command>mwm</command>,
<command>xmbind</command>, <command>uil</command> and
<application>LessTif</application> libraries.</para>
 
</sect2>
 
<sect2><title>Description</title>
 
<sect3><title>mxmkmf</title>
<para><command>mxmkmf</command> is the <application>LessTif</application>
version of <command>xmkmf</command> which creates a
<filename>Makefile</filename> from an <filename>Imakefile</filename></para>
</sect3>
 
<sect3><title>mwm</title>
<para><command>mwm</command> is a window manager that adheres largely to the
<application>Motif</application> <command>mwm</command> specification.</para>
</sect3>
 
<sect3><title>xmbind</title>
<para><command>xmbind</command> configures the virtual key bindings of
<application>LessTif</application> applications</para>
</sect3>
 
<sect3><title>uil</title>
<para><command>uil</command> is a user interface language compiler which
translates a plain text description of the user interface of a
<application>Motif</application> application into a machine-readable form.
</para>
</sect3>
 
<sect3><title>lesstif libraries</title>
<para><application>LessTif</application> libraries are an
<application><acronym>OSF</acronym>/Motif(R)</application> source code
compatible library for the <application>X</application> Window System.</para>
</sect3>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/lib/libxklavier.xml
1,11 → 1,78
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY libxklavier-download-http "http://prdownloads.sourceforge.net/gswitchit/libxklavier-&libxklavier-version;.tar.gz">
<!ENTITY libxklavier-download-ftp " ">
<!ENTITY libxklavier-md5sum "1a4c6b95bc74bccaf5a7e394f928a54f">
<!ENTITY libxklavier-size "425 KB">
<!ENTITY libxklavier-buildsize "6.0 MB">
<!ENTITY libxklavier-time "0.11 SBU">
]>
 
<sect1 id="libxklavier" xreflabel="libxklavier-&libxklavier-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="libxklavier.html" ?>
<title>libxklavier-&libxklavier-version;</title>
 
&libxklavier-intro;
&libxklavier-inst;
&libxklavier-desc;
<sect2>
<title>Introduction to <application>libxklavier</application></title>
 
<para>The <application>libxklavier</application> package contains a
utility library for <application>X</application> keyboard.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&libxklavier-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&libxklavier-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &libxklavier-md5sum;</para></listitem>
<listitem><para>Download size: &libxklavier-size;</para></listitem>
<listitem><para>Estimated disk space required:
&libxklavier-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&libxklavier-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3><title><application>libxklavier</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="pkgconfig"/> and
<xref linkend="libxml2"/></para>
</sect4>
 
<sect4><title>Optional</title>
<para><xref linkend="doxygen"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>libxklavier</application></title>
 
<para>Install <application>libxklavier</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<para>The <application>libxklavier</application> package contains
<filename>libxklavier</filename> libraries.</para>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/lib/freeglut.xml
0,0 → 1,102
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
<!ENTITY freeglut-download-http "http://prdownloads.sourceforge.net/freeglut/freeglut-&freeglut-version;.tar.gz">
<!ENTITY freeglut-download-ftp "ftp://ftp.freestandards.org/pub/lsb/app-battery/packages/freeglut-&freeglut-version;.tar.gz">
<!ENTITY freeglut-md5sum "9439b8745f443131c2dad00bc93dc0ef">
<!ENTITY freeglut-size "379 KB">
<!ENTITY freeglut-buildsize "6.0 MB">
<!ENTITY freeglut-time "0.13 SBU">
]>
 
<sect1 id="freeglut" xreflabel="freeglut-&freeglut-version;">
<sect1info>
<othername>$LastChangedBy: igor $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="freeglut.html"?>
<title>freeglut-&freeglut-version;</title>
 
<indexterm zone="freeglut">
<primary sortas="a-freeglut">freeglut</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application>freeglut</application></title>
 
<para><application>freeglut</application> is intended to be a 100% compatible,
completely opensourced clone of the <acronym>GLUT</acronym> library.
<acronym>GLUT</acronym> is a window system independent toolkit for
writing OpenGL programs, implementing a simple windowing API, which
makes learning about and exploring OpenGL programming very easy.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing="compact">
<listitem><para>Download (HTTP): <ulink url="&freeglut-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&freeglut-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &freeglut-md5sum;</para></listitem>
<listitem><para>Download size: &freeglut-size;</para></listitem>
<listitem><para>Estimated disk space required: &freeglut-buildsize;</para></listitem>
<listitem><para>Estimated build time: &freeglut-time;</para></listitem>
</itemizedlist>
</sect3>
 
<sect3><title><application>freeglut</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application>freeglut</application></title>
 
<para>Install <application>freeglut</application> by running the following
commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libglut.{so,a}</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="libglut">
<term><filename class='libraryfile'>libglut.{so,a}</filename></term>
<listitem>
<para>contains functions that implement the OpenGL Utility Toolkit.</para>
<indexterm zone="freeglut libglut">
<primary sortas="c-libglut">libglut.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
</sect1>
/trunk/blfs/x/lib/atk.xml
1,12 → 1,118
<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="ATK" xreflabel="ATK-&ATK-version;">
<?dbhtml filename="atk.html"?>
<title>ATK-&ATK-version;</title>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
 
&ATK-intro;
&ATK-inst;
&ATK-exp;
&ATK-desc;
<!ENTITY atk-download-http "http://ftp.gnome.org/pub/GNOME/sources/atk/1.9/atk-&atk-version;.tar.bz2">
<!ENTITY atk-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/atk/1.9/atk-&atk-version;.tar.bz2">
<!ENTITY atk-md5sum "7f41bd9c6dcd83c8df391dc1805be653">
<!ENTITY atk-size "506 KB">
<!ENTITY atk-buildsize "7.9 MB">
<!ENTITY atk-time "0.11 SBU">
]>
 
<sect1 id="atk" xreflabel="ATK-&atk-version;">
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2005-06-15 06:05:15 $</date>
</sect1info>
<?dbhtml filename="atk.html" ?>
<title>ATK-&atk-version;</title>
 
<indexterm zone="atk">
<primary sortas="a-atk">atk</primary>
</indexterm>
 
<sect2>
<title>Introduction to <application><acronym>ATK</acronym></application></title>
 
<para>The <application><acronym>ATK</acronym></application> package contains the
<application><acronym>ATK</acronym></application> libraries. They are useful for
allowing accessibility solutions to be available for all
<application><acronym>GTK</acronym>2</application>
applications.</para>
 
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&atk-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&atk-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &atk-md5sum;</para></listitem>
<listitem><para>Download size: &atk-size;</para></listitem>
<listitem><para>Estimated disk space required: &atk-buildsize;</para></listitem>
<listitem><para>Estimated build time: &atk-time;</para></listitem></itemizedlist>
</sect3>
 
<sect3>
<title><application><acronym>ATK</acronym></application> dependencies</title>
 
<sect4>
<title>Required</title>
<para><xref linkend="glib2"/></para>
</sect4>
 
<sect4>
<title>Optional</title>
<para><xref linkend="gtk-doc"/></para>
</sect4>
</sect3>
 
</sect2>
 
<sect2>
<title>Installation of <application><acronym>ATK</acronym></application></title>
 
<para>Install <application><acronym>ATK</acronym></application> by running the following commands:</para>
 
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
 
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
 
</sect2>
 
<sect2>
<title>Command explanations</title>
 
<para><option>--enable-gtk-doc</option>: This switch will rebuild
the <acronym>API</acronym> documentation during the
<command>make</command> command.</para>
 
</sect2>
 
<sect2>
<title>Contents</title>
 
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libatk-1.0.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
 
<varlistentry id="libatk">
<term><filename class='libraryfile'>atklib-1.0.so</filename></term>
<listitem>
<para>contains functions that are used by assistive technologies in order to
interact with the desktop and applications.</para>
<indexterm zone="atk libatk">
<primary sortas="c-libatk">libatk-1.0.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
 
</sect2>
 
</sect1>
 
/trunk/blfs/x/x.xml
1,10 → 1,16
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
 
<part id="x" xreflabel="X and Window Managers">
<?dbhtml filename="x.html" dir="x"?>
<title>X + Gestionnaires de Fenêtres</title>
<title>X + Window Managers</title>
 
&x-installing;
&x-lib;
&x-wm;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="installing/installing.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lib/lib.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wm/wm.xml"/>
 
</part>