Added X11, added sdl2. Required deps done

This commit is contained in:
Zeckmathederg 2024-05-16 16:19:20 -06:00
parent e5fbe6eceb
commit 914ad330e4
49 changed files with 7618 additions and 108 deletions

View File

@ -805,6 +805,7 @@
<!ENTITY mesa-major-minor "24.0">
<!ENTITY mesa-version "&mesa-major-minor;.7">
<!ENTITY xbitmaps-version "1.1.3">
<!ENTITY luit-version "20240102">
<!ENTITY xcursor-themes-version "1.0.7">
<!ENTITY xkeyboard-config-version "2.41">
<!ENTITY xwayland-version "23.2.4">
@ -1052,6 +1053,7 @@
<!ENTITY pidgin-version "2.14.13">
<!ENTITY rox-filer-version "2.11">
<!ENTITY rxvt-unicode-version "9.31">
<!ENTITY steam-version "1.0.0.79">
<!ENTITY thunderbird-version "115.9.0">
<!ENTITY tigervnc-version "1.13.1">
<!ENTITY transmission-version "4.0.5">

View File

@ -0,0 +1,148 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../../general.ent">
%general-entities;
<!ENTITY pixman-download-http "https://www.cairographics.org/releases/pixman-&pixman-version;.tar.gz">
<!ENTITY pixman-download-ftp " ">
<!ENTITY pixman-md5sum "21b18058dea39ad48f32d3199b8ffe40">
<!ENTITY pixman-size "776 KB">
<!ENTITY pixman-buildsize "27 MB (With tests)">
<!ENTITY pixman-time "0.2 SBU (Using parallelism=4; with tests)">
]>
<sect1 id="pixman" xreflabel="Pixman-&pixman-version;">
<?dbhtml filename="pixman.html"?>
<title>Pixman-&pixman-version;</title>
<indexterm zone="pixman">
<primary sortas="a-Pixman">Pixman</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Pixman</title>
<para>
The <application>Pixman</application> package contains a library that
provides low-level pixel manipulation features such as image
compositing and trapezoid rasterization.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&pixman-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&pixman-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &pixman-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &pixman-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &pixman-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &pixman-time;
</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Pixman</title>
<para>
Install <application>Pixman</application> by running the following
commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
ninja</userinput></screen>
<para>
To test the results, issue: <command>ninja test</command>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../../xincludes/meson-buildtype-release.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>
None
</seg>
<seg>
libpixman-1.so
</seg>
<seg>
/usr/include/pixman-1
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libpixman">
<term><filename class="libraryfile">libpixman-1.so</filename></term>
<listitem>
<para>
contains functions that provide low-level pixel manipulation
features
</para>
<indexterm zone="pixman libpixman">
<primary sortas="c-libpixman">libpixman-1.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

519
shareddeps/dps/wl/icu.xml Normal file
View File

@ -0,0 +1,519 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY icu-download-http
"https://github.com/unicode-org/icu/releases/download/release-&icu-major;-&icu-minor;/icu4c-&icu-major;_&icu-minor;-src.tgz">
<!ENTITY icu-download-ftp " ">
<!ENTITY icu-md5sum "a83c1499e508f73ddbc60002f84ea42a">
<!ENTITY icu-size "25 MB">
<!ENTITY icu-buildsize "341 MB (add 45 MB for tests)">
<!ENTITY icu-time "0.7 SBU (Using parallelism=4; add 2.0 SBU for tests)">
]>
<sect1 id="icu" xreflabel="ICU-&icu-version;">
<?dbhtml filename="icu.html"?>
<title>icu-&icu-version;</title>
<indexterm zone="icu">
<primary sortas="a-icu">icu</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to ICU</title>
<para>
The <application>International Components for Unicode</application> (ICU)
package is a mature, widely used set of C/C++ libraries providing Unicode
and Globalization support for software applications.
<application>ICU</application> is widely portable and gives applications
the same results on all platforms.
</para>
<warning>
<para>
Upgrading this package to a new major version (for example, from
72.1 to &icu-version;) will require rebuilding of many other
packages. If some packages that use the libraries built by
icu4c-&icu-major; are rebuilt, they will use the new libraries while
current packages will use the previous libraries. If the Linux
application loader
(<filename class='libraryfile'>/usr/lib/ld-linux-x86-64.so.2</filename>)
determines that both the old and new libraries are needed, and a
symbol (name of data or function) exists in both versions of the
library, all references to the symbol will be resolved to the
version appearing earlier in the breadth-first sequence of the
dependency graph. This may result in the application failing if
the definition of the data or the behavior of the function referred
by the symbol differs in two versions. To avoid the issue, users
will need to rebuild every package linked to an ICU library as soon
as possible once ICU is updated to a new major version.
</para>
<para>
To determine what external libraries are needed (directly or indirectly)
by an application or a library, run:
</para>
<screen><userinput>ldd &lt;application or library&gt; </userinput></screen>
<para>
or to see only the directly needed libraries:
</para>
<screen><userinput>readelf -d &lt;application or library&gt; | grep NEEDED</userinput></screen>
</warning>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&icu-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&icu-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &icu-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &icu-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &icu-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &icu-time;
</para>
</listitem>
</itemizedlist>
<!--
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Required patch:
<ulink url="&patch-root;/icu4c-&icu-version;-fix_enumeration-1.patch"/>
</para>
</listitem>
</itemizedlist>
-->
<bridgehead renderas="sect3">ICU Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="llvm"/> (with Clang)
</para>
</sect2>
<sect2 role="installation">
<title>Installation of ICU</title>
<note>
<para>
This package expands to the directory
<filename class='directory'>icu</filename>.
</para>
</note>
<note>
<para>
If <command>clang++</command> is available, it will be used in the
mistaken belief that <command>g++</command> might not support C++11,
even though <command>configure</command> has tested for that. If
using <command>g++</command> there will be an unnecessary warning at
the end of <command>configure</command>. Building with
<command>g++</command> also takes longer than the estimated SBU shown.
</para>
</note>
<!--
<para>
First, fix a regression in version 58.1:
</para>
<screen><userinput>patch -p1 -i ../icu4c-&icu-version;-fix_enumeration-1.patch</userinput></screen>
-->
<para>
Install <application>ICU</application> by running the following commands:
</para>
<!-- Review comments at:
https://chromium.googlesource.com/chromium/src/+/e58fa0ba66272c5f28828b15d06c7e42a9882b3b
To see if the following prebuild command is appropriate for BLFS:
sed '/fdef U_CHARSET_I/i#define U_CHARSET_IS_UTF8 1' -i common/unicode/platform.h
-->
<screen><userinput>cd source &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>
To test the results, issue: <command>make check</command>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
derb, escapesrc, genbrk, genccode, gencfu, gencmn, gencnval,
gendict, gennorm2,
genrb, gensprep, icu-config, icuexportdata, icuinfo, icupkg,
makeconv, pkgdata, and uconv
</seg>
<seg>
libicudata.so, libicui18n.so, libicuio.so,
libicutest.so, libicutu.so, and libicuuc.so
</seg>
<seg>
/usr/include/unicode,
/usr/lib/icu, and
/usr/share/icu
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="derb">
<term><command>derb</command></term>
<listitem>
<para>
disassembles a resource bundle
</para>
<indexterm zone="icu derb">
<primary sortas="b-derb">derb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="escapesrc">
<term><command>escapesrc</command></term>
<listitem>
<para>
converts <quote>\u</quote> escaped characters into unicode
characters
</para>
<indexterm zone="icu escapesrc">
<primary sortas="b-escapesrc">escapesrc</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genbrk">
<term><command>genbrk</command></term>
<listitem>
<para>
compiles ICU break iteration rules source files into binary data
files
</para>
<indexterm zone="icu genbrk">
<primary sortas="b-genbrk">genbrk</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genccode">
<term><command>genccode</command></term>
<listitem>
<para>
generates C or platform specific assembly code from an ICU data
file
</para>
<indexterm zone="icu genccode">
<primary sortas="b-genccode">genccode</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gencfu">
<term><command>gencfu</command></term>
<listitem>
<para>
reads in Unicode confusable character definitions and writes out the
binary data
</para>
<indexterm zone="icu gencfu">
<primary sortas="b-gencfu">gencfu</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gencmn">
<term><command>gencmn</command></term>
<listitem>
<para>
generates an ICU memory-mappable data file
</para>
<indexterm zone="icu gencmn">
<primary sortas="b-gencmn">gencmn</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gencnval">
<term><command>gencnval</command></term>
<listitem>
<para>
compiles the converter's aliases file
</para>
<indexterm zone="icu gencnval">
<primary sortas="b-gencnval">gencnval</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gendict">
<term><command>gendict</command></term>
<listitem>
<para>
compiles word lists into ICU string trie dictionaries
</para>
<indexterm zone="icu gendict">
<primary sortas="b-gendict">gendict</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gennorm2">
<term><command>gennorm2</command></term>
<listitem>
<para>
builds binary data files with Unicode normalization data
</para>
<indexterm zone="icu gennorm2">
<primary sortas="b-gennorm2">gennorm2</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="genrb">
<term><command>genrb</command></term>
<listitem>
<para>
compiles a resource bundle
</para>
<indexterm zone="icu genrb">
<primary sortas="b-genrb">genrb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gensprep">
<term><command>gensprep</command></term>
<listitem>
<para>
compiles StringPrep data from filtered RFC 3454 files
</para>
<indexterm zone="icu gensprep">
<primary sortas="b-gensprep">gensprep</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="icu-config">
<term><command>icu-config</command></term>
<listitem>
<para>
outputs ICU build options
</para>
<indexterm zone="icu icu-config">
<primary sortas="b-icu-config">icu-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="icuinfo">
<term><command>icuinfo</command></term>
<listitem>
<para>
outputs configuration information about the current ICU
</para>
<indexterm zone="icu icuinfo">
<primary sortas="b-icuinfo">icuinfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="icupkg">
<term><command>icupkg</command></term>
<listitem>
<para>
extracts or modifies an ICU .dat archive
</para>
<indexterm zone="icu icupkg">
<primary sortas="b-icupkg">icupkg</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="makeconv">
<term><command>makeconv</command></term>
<listitem>
<para>
compiles a converter table
</para>
<indexterm zone="icu makeconv">
<primary sortas="b-makeconv">makeconv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pkgdata">
<term><command>pkgdata</command></term>
<listitem>
<para>
packages data for use by ICU
</para>
<indexterm zone="icu pkgdata">
<primary sortas="b-pkgdata">pkgdata</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="uconv">
<term><command>uconv</command></term>
<listitem>
<para>
converts data from one encoding to another
</para>
<indexterm zone="icu uconv">
<primary sortas="b-uconv">uconv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicudata">
<term><filename class="libraryfile">libicudata.so</filename></term>
<listitem>
<para>
is the data library
</para>
<indexterm zone="icu libicudata">
<primary sortas="c-libicudata">libicudata.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicui18n">
<term><filename class="libraryfile">libicui18n.so</filename></term>
<listitem>
<para>
is the internationalization (i18n) library
</para>
<indexterm zone="icu libicui18n">
<primary sortas="c-libicui18n">libicui18n.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicuio">
<term><filename class="libraryfile">libicuio.so</filename></term>
<listitem>
<para>
is the ICU I/O (unicode stdio) library
</para>
<indexterm zone="icu libicuio">
<primary sortas="c-libicuio">libicuio.so</primary>
</indexterm>
</listitem>
</varlistentry>
<!-- <varlistentry id="libicule">
<term><filename class="libraryfile">libicule.so</filename></term>
<listitem>
<para>
is the layout engine.
</para>
<indexterm zone="icu libicule">
<primary sortas="c-libicule">libicule.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libiculx">
<term><filename class="libraryfile">libiculx.so</filename></term>
<listitem>
<para>
is the layout extensions engine.
</para>
<indexterm zone="icu libiculx">
<primary sortas="c-libiculx">libiculx.so</primary>
</indexterm>
</listitem>
</varlistentry>-->
<varlistentry id="libicutest">
<term><filename class="libraryfile">libicutest.so</filename></term>
<listitem>
<para>
is the test library
</para>
<indexterm zone="icu libicutest">
<primary sortas="c-libicutest">libicutest.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicutu">
<term><filename class="libraryfile">libicutu.so</filename></term>
<listitem>
<para>
is the tool utility library
</para>
<indexterm zone="icu libicutu">
<primary sortas="c-libicutu">libicutu.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libicuuc">
<term><filename class="libraryfile">libicuuc.so</filename></term>
<listitem>
<para>
is the common library
</para>
<indexterm zone="icu libicuuc">
<primary sortas="c-libicuuc">libicuuc.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,247 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!-- Also update the download, md5, size entities in libxml2py2.xml -->
<!ENTITY libxml2-download-http "https://download.gnome.org/sources/libxml2/2.12/libxml2-&libxml2-version;.tar.xz">
<!-- <!ENTITY libxml2-download-http "http://xmlsoft.org/sources/libxml2-&libxml2-version;.tar.xz">-->
<!ENTITY libxml2-download-ftp " ">
<!ENTITY libxml2-md5sum "37fab9ace78d8a085af81dc9a19f36d9">
<!ENTITY libxml2-size "2.5 MB">
<!ENTITY libxml2-buildsize "103 MB (with tests)">
<!ENTITY libxml2-time "0.4 SBU (Using parallelism=4; with tests)">
<!ENTITY testsuite-version "20130923">
]>
<sect1 id="libxml2" xreflabel="libxml2-&libxml2-version;">
<?dbhtml filename="libxml2.html"?>
<title>libxml2-&libxml2-version;</title>
<indexterm zone="libxml2">
<primary sortas="a-libxml2">libxml2</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to libxml2</title>
<para>
The <application>libxml2</application> package contains libraries
and utilities used for parsing XML files.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&libxml2-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&libxml2-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &libxml2-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &libxml2-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &libxml2-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &libxml2-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">libxml2 Dependencies</bridgehead>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="icu"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of libxml2</title>
<para>
Install <application>libxml2</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--disable-static \
--with-history \
--with-icu \
PYTHON=/usr/bin/python3 \
--docdir=/usr/share/doc/libxml2-&libxml2-version; &amp;&amp;
make</userinput></screen>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>
Finally, prevent some packages from unnecessarily linking to ICU using
the following commands as the &root; user:
</para>
<screen role="root"><userinput>rm -vf /usr/lib/libxml2.la &amp;&amp;
sed '/libs=/s/xml2.*/xml2"/' -i /usr/bin/xml2-config</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../xincludes/static-libraries.xml"/>
<para>
<parameter>--with-history</parameter>: This switch enables
<application>Readline</application> support when running
<command>xmlcatalog</command> or <command>xmllint</command> in shell mode.
</para>
<para>
<parameter>--with-icu</parameter>: This switch enables support for
<application>ICU</application>, which provides additional Unicode support.
This is needed for some packages outside of GLFS, such as for QtWebEngine.
</para>
<para>
<parameter>PYTHON=/usr/bin/python3</parameter>: Allows building
the libxml2 module with Python3 instead of Python2.
</para>
<!--
<para>
<option>- -with-icu</option>: Add this switch if you have built
<xref linkend="icu"/>, for better unicode support.
</para>
<note>
<para>
If the <option>- -with-icu</option> switch is used, the BLFS editors
recommend removing unneeded references to the ICU libraries. This
will prevent many packages that use libxml2 from unnecessarily linking
to the ICU libraries. This, in turn, will prevent the need for
rebuilding many packages when upgrading ICU to a new major version.
After installing libxml2, as the &root; user, issue:
</para>
<screen role="nodump"><userinput>rm -vf /usr/lib/libxml2.la &amp;&amp;
sed '/libs=/s/xml2.*/xml2"/' -i /usr/bin/xml2-config</userinput></screen>
</note>
-->
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
xml2-config,
xmlcatalog, and
xmllint
</seg>
<seg>
libxml2.so
</seg>
<seg>
/usr/include/libxml2,
/usr/lib/cmake/libxml2,
/usr/share/doc/libxml2-&libxml2-version;, and
/usr/share/gtk-doc/html/libxml2
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="xml2-config">
<term><command>xml2-config</command></term>
<listitem>
<para>
determines the compile and linker flags that should be used to
compile and link programs that use
<filename class="libraryfile">libxml2</filename>
</para>
<indexterm zone="libxml2 xml2-config">
<primary sortas="b-xml2-config">xml2-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xmlcatalog">
<term><command>xmlcatalog</command></term>
<listitem>
<para>
is used to monitor and manipulate XML and SGML catalogs
</para>
<indexterm zone="libxml2 xmlcatalog">
<primary sortas="b-xmlcatalog">xmlcatalog</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xmllint">
<term><command>xmllint</command></term>
<listitem>
<para>
parses XML files and outputs reports (based upon options) to detect
errors in XML coding
</para>
<indexterm zone="libxml2 xmllint">
<primary sortas="b-xmllint">xmllint</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libxml2-lib">
<term><filename class="libraryfile">libxml2.so</filename></term>
<listitem>
<para>
provides functions for programs to parse files that use the XML
format
</para>
<indexterm zone="libxml2 libxml2-lib">
<primary sortas="c-libxml2">libxml2.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY wayland-protocols-download-http "https://gitlab.freedesktop.org/wayland/wayland-protocols/-/releases/&wayland-protocols-version;/downloads/wayland-protocols-&wayland-protocols-version;.tar.xz">

View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY wayland-download-http "https://gitlab.freedesktop.org/wayland/wayland/-/releases/&wayland-version;/downloads/wayland-&wayland-version;.tar.xz">
@ -74,16 +74,6 @@
<xref linkend="libxml2"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="doxygen"/>,
<xref linkend="graphviz"/> and
<xref linkend="xmlto"/> (to build the API documentation) and
<xref linkend="DocBook"/>,
<xref linkend="docbook-xsl"/> and
<xref linkend="libxslt"/> (to build the manual pages)
</para>
</sect2>
<sect2 role="installation">
@ -125,8 +115,7 @@ ninja</userinput></screen>
<para>
<parameter>-Ddocumentation=false</parameter>: This switch is used to
disable building of the API documentation. Remove it if you have
installed optional dependencies.
disable building of the API documentation.
</para>
</sect2>

View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xwayland-download-http "&xorg-download-http;/xserver/xwayland-&xwayland-version;.tar.xz">
@ -81,24 +81,10 @@
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="libepoxy"/>,
<xref linkend="libtirpc"/>, and
<xref linkend="libepoxy"/> and
<xref linkend="mesa"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="git"/> (to download packages needed for the tests),
<xref linkend="libei"/>,
<xref linkend="libgcrypt"/>,
<xref linkend="nettle"/>,
<xref linkend="xmlto"/>,
<xref linkend="xorg7-legacy"/>
(only bdftopcf, for building fonts required for the tests),
<ulink url="https://gitlab.freedesktop.org/xorg/test/rendercheck">rendercheck</ulink> (for tests), and
<ulink url="https://wayland.pages.freedesktop.org/weston/">weston</ulink> (for tests)
</para>
</sect2>
<sect2 role="installation">
@ -120,61 +106,6 @@ meson setup --prefix=$XORG_PREFIX \
.. &amp;&amp;
ninja</userinput></screen>
<para>
Building the test framework needs some work. First,
<ulink url="https://wayland.pages.freedesktop.org/weston/">weston</ulink>
brings in several dependencies, but the number can be reduced by
disabling unneeded features. The <command>meson</command> command
for a stripped down build of <application>weston</application> is shown
in <ulink
url="https://gitlab.freedesktop.org/xorg/xserver/-/blob/xwayland-22.1/.gitlab-ci/debian-install.sh">
Upstream continuous integration build</ulink>.
<!-- keep 22.1 above: they used to build it in gitlab-ci because debian
had an obsolete version of weston, but now they take weston from
debian so the command to build it has been removed. -->
</para>
<!--
<para>
Furthermore, an X server needs to be running during the build of
<application>xts</application>. If not running the tests in a
graphical environment, you'll need to enable <command>Xvfb</command>
by removing the <parameter>-Dxvfb=false</parameter> above. The
instructions below expect this has been done.
</para>
-->
<para>
Running the tests involves downloading two other frameworks, in addition
to the mentioned optional dependencies:
</para>
<screen remap="test"><userinput>mkdir tools &amp;&amp;
pushd tools &amp;&amp;
git clone https://gitlab.freedesktop.org/mesa/piglit.git --depth 1 &amp;&amp;
cat &gt; piglit/piglit.conf &lt;&lt; EOF &amp;&amp;
<literal>[xts]
path=$(pwd)/xts
EOF</literal>
git clone https://gitlab.freedesktop.org/xorg/test/xts --depth 1 &amp;&amp;
export DISPLAY=:22 &amp;&amp;
../hw/vfb/Xvfb $DISPLAY &amp;
VFB_PID=$! &amp;&amp;
cd xts &amp;&amp;
CFLAGS=-fcommon ./autogen.sh &amp;&amp;
make &amp;&amp;
kill $VFB_PID &amp;&amp;
unset DISPLAY VFB_PID &amp;&amp;
popd</userinput></screen>
<para>
Then the tests can be run with:
</para>
<screen remap="test"><userinput>XTEST_DIR=$(pwd)/tools/xts PIGLIT_DIR=$(pwd)/tools/piglit ninja test</userinput></screen>
<!-- The xfontset tests fail on my system -renodr -->
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
@ -208,7 +139,7 @@ EOF</userinput></screen>
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/meson-buildtype-release.xml"/>
href="../../../xincludes/meson-buildtype-release.xml"/>
<!--
<para>
<parameter>-Dxvfb=false</parameter>: Prevents building the

View File

@ -0,0 +1,161 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY libepoxy-download-http "&gnome-download-http;/libepoxy/&libepoxy-minor;/libepoxy-&libepoxy-version;.tar.xz">
<!ENTITY libepoxy-download-ftp " ">
<!ENTITY libepoxy-md5sum "10c635557904aed5239a4885a7c4efb7">
<!ENTITY libepoxy-size "220 KB">
<!ENTITY libepoxy-buildsize "13 MB (with tests)">
<!ENTITY libepoxy-time "0.1 SBU (with tests)">
]>
<sect1 id="libepoxy" xreflabel="libepoxy-&libepoxy-version;">
<?dbhtml filename="libepoxy.html"?>
<title>libepoxy-&libepoxy-version;</title>
<indexterm zone="libepoxy">
<primary sortas="a-libepoxy">libepoxy</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to libepoxy</title>
<para>
<application>libepoxy</application> is a library for handling OpenGL
function pointer management.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&libepoxy-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&libepoxy-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &libepoxy-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &libepoxy-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &libepoxy-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &libepoxy-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">libepoxy Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="mesa"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of libepoxy</title>
<para>
Install <application>libepoxy</application> by running the following
commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup --prefix=/usr --buildtype=release .. &amp;&amp;
ninja</userinput></screen>
<para>
To test the results, issue: <command>ninja test</command>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../xincludes/meson-buildtype-release.xml"/>
<para>
<option>-Ddocs=true</option>: If you have Doxygen
installed, add this option to generate additional documentation.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
None
</seg>
<seg>
libepoxy.so
</seg>
<seg>
/usr/include/epoxy
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libepoxy-lib">
<term><filename class="libraryfile">libepoxy.so</filename></term>
<listitem>
<para>
contains API functions for handling OpenGL function
pointer management
</para>
<indexterm zone="libepoxy libepoxy-lib">
<primary sortas="c-libepoxy">libepoxy.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- Automatically generated by kernel-config.py
DO NOT EDIT! -->
<screen><emphasis role='blue'>D</emphasis>evice Drivers ---&gt;
<emphasis role='blue'>I</emphasis>nput device support ---&gt;
-*- <emphasis role='blue'>G</emphasis>eneric input layer (needed for keyboard, mouse, ...) [INPUT]
&lt;*/M&gt; <emphasis role='blue'>E</emphasis>vent interface [INPUT_EVDEV]</screen>

View File

@ -0,0 +1,10 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- Automatically generated by kernel-config.py
DO NOT EDIT! -->
<screen><emphasis role='blue'>D</emphasis>evice Drivers ---&gt;
<emphasis role='blue'>I</emphasis>nput device support ---&gt;
-*- <emphasis role='blue'>G</emphasis>eneric input layer (needed for keyboard, mouse, ...) [INPUT]
[*] M<emphasis role='blue'>i</emphasis>scellaneous devices ---&gt; [INPUT_MISC]
&lt;*/M&gt; <emphasis role='blue'>U</emphasis>ser level driver support [INPUT_UINPUT]</screen>

View File

@ -0,0 +1,209 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY libevdev-version "1.13.1">
<!ENTITY libevdev-download-http "https://www.freedesktop.org/software/libevdev/libevdev-&libevdev-version;.tar.xz">
<!ENTITY libevdev-download-ftp " ">
<!ENTITY libevdev-md5sum "58fe71aa6fd5e80d0928e9b691761311">
<!ENTITY libevdev-size "448 KB">
<!ENTITY libevdev-buildsize "6.0 MB (with tests)">
<!ENTITY libevdev-time "0.1 SBU (with tests)">
]>
<!-- Begin Xorg libevdev Driver -->
<sect2 id="libevdev" xreflabel="libevdev-&libevdev-version;">
<sect2info>
<date>$Date$</date>
</sect2info>
<title>libevdev &libevdev-version;</title>
<indexterm zone="libevdev">
<primary sortas="a-libevdev">libevdev</primary>
</indexterm>
<sect3 role="package">
<title>Introduction to libevdev</title>
<para>
The <application>libevdev</application> package contains common
functions for Xorg input drivers.
</para>
&lfs121_checked;
<bridgehead renderas="sect4">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&libevdev-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&libevdev-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &libevdev-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &libevdev-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &libevdev-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &libevdev-time;
</para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="kernel" id="libevdev-kernel">
<title>Kernel Configuration</title>
<para>
Enable the following options in the kernel configuration and recompile
the kernel if necessary:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="libevdev-kernel.xml"/>
<indexterm zone="libevdev libevdev-kernel">
<primary sortas="d-libevdev">libevdev</primary>
</indexterm>
</sect3>
<sect3 role="installation">
<title>Installation of libevdev</title>
<para>
Install <application>libevdev</application> by running the following
commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup .. \
--prefix=$XORG_PREFIX \
--buildtype=release \
-Ddocumentation=disabled &amp;&amp;
ninja</userinput></screen>
<para>
The regression tests can be run as the <systemitem
class="username">root</systemitem> user with <command>ninja
test</command>, in a graphical session. You need to have enabled
the CONFIG_INPUT_UINPUT setting in the kernel for full test coverage.
If it is enabled as a module, the module is named
<command>uinput</command> and needs to be loaded before running the
tests. Note that on some systems, the
tests may cause a hard lockup and require a reboot. On laptops, the
system will go into Sleep and need to be woken up to finish the test
suites.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
</sect3>
<sect3 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Xorg Programs</segtitle>
<segtitle>Installed Xorg Library</segtitle>
<segtitle>Installed Xorg Directory</segtitle>
<seglistitem>
<seg>
libevdev-tweak-device, mouse-dpi-tool, and touchpad-edge-detector
</seg>
<seg>
libevdev.so
</seg>
<seg>
$XORG_PREFIX/include/libevdev-1.0
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect4">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libevdev-tweak-device">
<term><command>libevdev-tweak-device</command></term>
<listitem>
<para>
is a tool to change some kernel device properties
</para>
<indexterm zone="libevdev libevdev-tweak-device">
<primary sortas="b-libevdev-tweak-device">libevdev-tweak-device</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mouse-dpi-tool">
<term><command>mouse-dpi-tool</command></term>
<listitem>
<para>
is a tool to estimate the resolution of a mouse
</para>
<indexterm zone="libevdev mouse-dpi-tool">
<primary sortas="b-mouse-dpi-tool">mouse-dpi-tool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="touchpad-edge-detector">
<term><command>touchpad-edge-detector</command></term>
<listitem>
<para>
touchpad-edge-detector is a tool that reads the touchpad events
from the kernel and calculates the minimum and maximum for the x
and y coordinates, respectively
</para>
<indexterm zone="libevdev touchpad-edge-detector">
<primary sortas="b-touchpad-edge-detector">touchpad-edge-detector</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libevdev-lib">
<term><filename class="libraryfile">libevdev.so</filename></term>
<listitem>
<para>
is a library of Xorg driver input functions
</para>
<indexterm zone="libevdev libevdev-lib">
<primary sortas="c-libevdev-lib">ebvdev.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

View File

@ -0,0 +1,219 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY libinput-version "1.25.0">
<!-- <!ENTITY libinput-download-http "https://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz">-->
<!ENTITY libinput-download-http "https://gitlab.freedesktop.org/libinput/libinput/-/archive/&libinput-version;/libinput-&libinput-version;.tar.gz"
>
<!ENTITY libinput-download-ftp " ">
<!ENTITY libinput-md5sum "fc582c553e40be99bea49adf6d4aa669">
<!ENTITY libinput-size "996 KB">
<!ENTITY libinput-buildsize "11 MB (add 23 MB for documentation and 9.6 MB for tests)">
<!ENTITY libinput-time "0.1 SBU (add 0.1 SBU for documentation and 4.9 SBU for tests)">
]>
<sect2 id="libinput" xreflabel="libinput-&libinput-version;">
<?dbhtml filename="libinput.html"?>
<sect2info>
<date>$Date$</date>
</sect2info>
<title>libinput-&libinput-version;</title>
<indexterm zone="libinput">
<primary sortas="a-libinput">libinput</primary>
</indexterm>
<sect3 role="package">
<title>Introduction to Libinput</title>
<para>
<application>libinput</application> is a library that handles
input devices for display servers and other applications that
need to directly deal with input devices.
</para>
&lfs121_checked;
<bridgehead renderas="sect4">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&libinput-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&libinput-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &libinput-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &libinput-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &libinput-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &libinput-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect4">libinput Dependencies</bridgehead>
<bridgehead renderas="sect5">Required</bridgehead>
<para role="required">
<xref linkend="libevdev"/> and
<xref linkend="mtdev"/>
</para>
</sect3>
<sect3 role="installation">
<title>Installation of Libinput</title>
<para>
Install <application>libinput</application> by running the following
commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup --prefix=$XORG_PREFIX \
--buildtype=release \
-Ddebug-gui=false \
-Dtests=false \
-Dlibwacom=false \
-Dudev-dir=/usr/lib/udev \
.. &amp;&amp;
ninja</userinput></screen>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
<para>
If you have passed <option>-Ddocumentation=true</option> to
<command>meson</command>, you can install the generated documentation
by running the following commands as the <systemitem
class="username">root</systemitem> user:
</para>
<!-- seems the api doc is not generated because the directory is not a git
repository... -->
<screen role="root"
remap="doc"><userinput>install -v -dm755 /usr/share/doc/libinput-&libinput-version;/html &amp;&amp;
cp -rv Documentation/* /usr/share/doc/libinput-&libinput-version;/html</userinput></screen>
</sect3>
<sect3 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../xincludes/meson-buildtype-release.xml"/>
<para>
<parameter>-Ddebug-gui=false</parameter>: This switch
disables creation of a visual debug helper for libinput. Remove
if you want it, and you have GTK3 installed.
</para>
<para>
<parameter>-Dlibwacom=false</parameter>: Remove this option if you
have libwacom installed, or if you are installing
GNOME.
</para>
<para>
<parameter>-Dudev-dir=/usr/lib/udev</parameter>: In case that the
value of <envar>XORG_PREFIX</envar> is not set to
<filename class='directory'>/usr</filename>, this option prevents
the package from installing Udev rules and helpers into
<filename class='directory'>$XORG_PREFIX/lib/udev</filename> which
is not searched by Udev daemon. This option is not needed for
systems with <envar>XORG_PREFIX</envar> set to
<filename class='directory'>/usr</filename>, but does no harm.
</para>
</sect3>
<sect3 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
libinput
<!-- libinput-debug-events, libinput-list-devices, libinput-measure*,
libinput-record, libinput-replay Library Executables -->
</seg>
<seg>
libinput.so
</seg>
<seg>
/etc/libinput,
$XORG_PREFIX/libexec/libinput,
$XORG_PREFIX/share/libinput, and (optionally)
$XORG_PREFIX/share/doc/libinput-&libinput-version;
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libinput-prog">
<term><command>libinput</command></term>
<listitem>
<para>
is a set of tools to interface with the
<application>libinput</application> library
</para>
<indexterm zone="libinput libinput-prog">
<primary sortas="b-libinput-prog">libinput</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libinput-lib">
<term><filename class="libraryfile">libinput.so</filename></term>
<listitem>
<para>
contains API functions for handling input devices
</para>
<indexterm zone="libinput libinput-lib">
<primary sortas="c-libinput-lib">libinput.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

120
shareddeps/dps/x/luit.xml Normal file
View File

@ -0,0 +1,120 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY luit-download-http "https://invisible-mirror.net/archives/luit/luit-&luit-version;.tgz">
<!ENTITY luit-download-ftp " ">
<!ENTITY luit-md5sum "b69a0819905ad8dc4bf82d25f24037a4">
<!ENTITY luit-size "208 KB">
<!ENTITY luit-buildsize "1.8 MB">
<!ENTITY luit-time "less than 0.1 SBU">
]>
<sect1 id="luit" xreflabel="luit-&luit-version;">
<?dbhtml filename="luit.html"?>
<title>luit-&luit-version;</title>
<indexterm zone="luit">
<primary sortas="a-luit">luit</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to luit</title>
<para>
The <application>luit</application> package is a filter
that can be run between an arbitrary application and a UTF-8
terminal emulator. It will convert application output from the
locales encoding into UTF8, and convert terminal input from
UTF8 into the locales encoding.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&luit-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&luit-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &luit-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &luit-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &luit-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &luit-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">luit Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-app"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of luit</title>
<para>
Install <application>luit</application> by running the
following commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>luit</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>

157
shareddeps/dps/x/mtdev.xml Normal file
View File

@ -0,0 +1,157 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY mtdev-download-http "https://bitmath.org/code/mtdev/mtdev-&mtdev-version;.tar.bz2">
<!ENTITY mtdev-download-ftp " ">
<!ENTITY mtdev-md5sum "483ed7fdf7c1e7b7375c05a62848cce7">
<!ENTITY mtdev-size "296 KB">
<!ENTITY mtdev-buildsize "2.5 MB">
<!ENTITY mtdev-time "less than 0.1 SBU">
]>
<sect1 id="mtdev" xreflabel="mtdev-&mtdev-version;">
<?dbhtml filename="mtdev.html"?>
<title>mtdev-&mtdev-version;</title>
<indexterm zone="mtdev">
<primary sortas="a-mtdev">mtdev</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to mtdev</title>
<para>
The <application>mtdev</application> package contains Multitouch
Protocol Translation Library which is used to transform all
variants of kernel MT (Multitouch) events to the slotted type B
protocol.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&mtdev-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&mtdev-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &mtdev-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &mtdev-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &mtdev-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &mtdev-time;
</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 role="installation">
<title>Installation of mtdev</title>
<para>
Install <application>mtdev</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr --disable-static &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../xincludes/static-libraries.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
mtdev-test
</seg>
<seg>
libmtdev.so
</seg>
<seg>
None
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="mtdev-test">
<term><command>mtdev-test</command></term>
<listitem>
<para>
is a tool to test <filename class="libraryfile">libmtdev</filename>
</para>
<indexterm zone="mtdev mtdev-test">
<primary sortas="b-mtdev-test">mtdev-test</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libmtdev">
<term><filename class="libraryfile">libmtdev.so</filename></term>
<listitem>
<para>
contains Multitouch Protocol Translation API functions
</para>
<indexterm zone="mtdev libmtdev">
<primary sortas="c-libmtdev">libmtdev.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

154
shareddeps/dps/x/twm.xml Normal file
View File

@ -0,0 +1,154 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY twm-download-http "&xorg-download-http;/app/twm-&twm-version;.tar.xz">
<!ENTITY twm-download-ftp " ">
<!ENTITY twm-md5sum "805ee08b5a87e1103dfe2eb925b613b4">
<!ENTITY twm-size "260 KB">
<!ENTITY twm-buildsize "3.8 MB">
<!ENTITY twm-time "less than 0.1 SBU">
]>
<sect1 id="twm" xreflabel="twm-&twm-version;">
<?dbhtml filename="twm.html"?>
<title>twm-&twm-version;</title>
<indexterm zone="twm">
<primary sortas="a-twm">twm</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to twm</title>
<para>
The <application>twm</application> package contains a very minimal
window manager.
</para>
&not-katamari;
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&twm-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&twm-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &twm-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &twm-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &twm-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &twm-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">twm Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg-server"/>
</para>
<!--
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="xorg7-legacy"/>
</para>
-->
</sect2>
<sect2 role="installation">
<title>Installation of twm</title>
<para>
Install <application>twm</application> by running the
following commands:
</para>
<screen><userinput>sed -i -e '/^rcdir =/s,^\(rcdir = \).*,\1/etc/X11/app-defaults,' src/Makefile.in &amp;&amp;
./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>sed -i -e '/^rcdir =/s...</command>: This command ensures
the <application>twm</application> configuration file gets installed in
the proper location.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>twm</seg>
<seg>None</seg>
<seg>/etc/X11/app-defaults</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="twm-bin">
<term><command>twm</command></term>
<listitem>
<para>
is the Tab Window Manager for the X Window System
</para>
<indexterm zone="twm twm">
<primary sortas="b-twm">twm</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

816
shareddeps/dps/x/x7app.xml Normal file
View File

@ -0,0 +1,816 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY x7apps-download-http "&xorg-download-http;/app/">
<!ENTITY x7apps-download-ftp " ">
<!ENTITY x7apps-size "4.9 MB">
<!-- Ken : reminder to self - this is size of DESTDIR install, plus the
downloaded tarballs, plus the *largest* compiled source directory,
currently xkbcomp -->
<!ENTITY x7apps-buildsize "48 MB">
<!ENTITY x7apps-time "1.5 SBU (ignoring the time to download)">
<!ENTITY iceauth-version "1.0.10">
<!ENTITY iceauth-md5sum "30f898d71a7d8e817302970f1976198c">
<!ENTITY mkfontscale-version "1.2.3">
<!ENTITY mkfontscale-md5sum "7dcf5f702781bdd4aaff02e963a56270">
<!ENTITY sessreg-version "1.1.3">
<!ENTITY sessreg-md5sum "05423bb42a006a6eb2c36ba10393de23">
<!ENTITY setxkbmap-version "1.3.4">
<!ENTITY setxkbmap-md5sum "1d61c9f4a3d1486eff575bf233e5776c">
<!ENTITY smproxy-version "1.0.7">
<!ENTITY smproxy-md5sum "9f7a4305f0e79d5a46c3c7d02df9437d">
<!ENTITY x11perf-version "1.6.1">
<!ENTITY x11perf-md5sum "e96b56756990c56c24d2d02c2964456b">
<!ENTITY xauth-version "1.1.3">
<!ENTITY xauth-md5sum "595c941d9aff6f6d6e038c4e42dcff58">
<!ENTITY xbacklight-version "1.2.3">
<!ENTITY xbacklight-md5sum "5b6405973db69c0443be2fba8e1a8ab7">
<!ENTITY xcmsdb-version "1.0.6">
<!ENTITY xcmsdb-md5sum "82a90e2feaeab5c5e7610420930cc0f4">
<!ENTITY xcursorgen-version "1.0.8">
<!ENTITY xcursorgen-md5sum "89e81a1c31e4a1fbd0e431425cd733d7">
<!ENTITY xdpyinfo-version "1.3.4">
<!ENTITY xdpyinfo-md5sum "933e6d65f96c890f8e96a9f21094f0de">
<!ENTITY xdriinfo-version "1.0.7">
<!ENTITY xdriinfo-md5sum "34aff1f93fa54d6a64cbe4fee079e077">
<!ENTITY xev-version "1.2.6">
<!ENTITY xev-md5sum "f29d1544f8dd126a1b85e2f7f728672d">
<!ENTITY xgamma-version "1.0.7">
<!ENTITY xgamma-md5sum "41afaa5a68cdd0de7e7ece4805a37f11">
<!ENTITY xhost-version "1.0.9">
<!ENTITY xhost-md5sum "48ac13856838d34f2e7fca8cdc1f1699">
<!ENTITY xinput-version "1.6.4">
<!ENTITY xinput-md5sum "8e4d14823b7cbefe1581c398c6ab0035">
<!ENTITY xkbcomp-version "1.4.7">
<!ENTITY xkbcomp-md5sum "83d711948de9ccac550d2f4af50e94c3">
<!ENTITY xkbevd-version "1.1.5">
<!ENTITY xkbevd-md5sum "05ce1abd8533a400572784b1186a44d0">
<!ENTITY xkbutils-version "1.0.6">
<!ENTITY xkbutils-md5sum "07483ddfe1d83c197df792650583ff20">
<!ENTITY xkill-version "1.0.6">
<!ENTITY xkill-md5sum "f62b99839249ce9a7a8bb71a5bab6f9d">
<!ENTITY xlsatoms-version "1.1.4">
<!ENTITY xlsatoms-md5sum "da5b7a39702841281e1d86b7349a03ba">
<!ENTITY xlsclients-version "1.1.5">
<!ENTITY xlsclients-md5sum "ab4b3c47e848ba8c3e47c021230ab23a">
<!ENTITY xmessage-version "1.0.7">
<!ENTITY xmessage-md5sum "ba2dd3db3361e374fefe2b1c797c46eb">
<!ENTITY xmodmap-version "1.0.11">
<!ENTITY xmodmap-md5sum "0d66e07595ea083871048c4b805d8b13">
<!ENTITY xpr-version "1.2.0">
<!ENTITY xpr-md5sum "ab6c9d17eb1940afcfb80a72319270ae">
<!ENTITY xprop-version "1.2.7">
<!ENTITY xprop-md5sum "d050642a667b518cb3429273a59fa36d">
<!ENTITY xrandr-version "1.5.2">
<!ENTITY xrandr-md5sum "f822a8d5f233e609d27cc22d42a177cb">
<!ENTITY xrdb-version "1.2.2">
<!ENTITY xrdb-md5sum "c8629d5a0bc878d10ac49e1b290bf453">
<!ENTITY xrefresh-version "1.1.0">
<!ENTITY xrefresh-md5sum "55003733ef417db8fafce588ca74d584">
<!ENTITY xset-version "1.2.5">
<!ENTITY xset-md5sum "18ff5cdff59015722431d568a5c0bad2">
<!ENTITY xsetroot-version "1.1.3">
<!ENTITY xsetroot-md5sum "fa9a24fe5b1725c52a4566a62dd0a50d">
<!ENTITY xvinfo-version "1.1.5">
<!ENTITY xvinfo-md5sum "d698862e9cad153c5fefca6eee964685">
<!ENTITY xwd-version "1.0.9">
<!ENTITY xwd-md5sum "b0081fb92ae56510958024242ed1bc23">
<!ENTITY xwininfo-version "1.1.6">
<!ENTITY xwininfo-md5sum "c91201bc1eb5e7b38933be8d0f7f16a8">
<!ENTITY xwud-version "1.0.6">
<!ENTITY xwud-md5sum "5ff5dc120e8e927dc3c331c7fee33fc3">
]>
<sect1 id="xorg7-app" xreflabel="Xorg Applications">
<?dbhtml filename="x7app.html"?>
<title>Xorg Applications</title>
<indexterm zone="xorg7-app">
<primary sortas="a-xorg7-app">Xorg-&xorg-version; Applications</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Xorg Applications</title>
<para>
The <application>Xorg</application> applications provide the
expected applications available in previous X Window implementations.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&x7apps-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&x7apps-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download size: &x7apps-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &x7apps-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &x7apps-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Xorg Applications Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="libpng"/>,
<xref linkend="mesa"/>,
<xref linkend="xbitmaps"/>, and
<xref linkend="xcb-util"/>
</para>
</sect2>
<sect2>
<title>Downloading Xorg Applications</title>
<para>
First, create a list of files to be downloaded. This file will also
be used to verify the integrity of the downloads when complete:
</para>
<screen><userinput>cat &gt; app-&xorg-version;.md5 &lt;&lt; "EOF"
<literal>&iceauth-md5sum; iceauth-&iceauth-version;.tar.xz
&mkfontscale-md5sum; mkfontscale-&mkfontscale-version;.tar.xz
&sessreg-md5sum; sessreg-&sessreg-version;.tar.xz
&setxkbmap-md5sum; setxkbmap-&setxkbmap-version;.tar.xz
&smproxy-md5sum; smproxy-&smproxy-version;.tar.xz
&x11perf-md5sum; x11perf-&x11perf-version;.tar.bz2
&xauth-md5sum; xauth-&xauth-version;.tar.xz
#&xbacklight-md5sum; xbacklight-&xbacklight-version;.tar.bz2
&xcmsdb-md5sum; xcmsdb-&xcmsdb-version;.tar.xz
&xcursorgen-md5sum; xcursorgen-&xcursorgen-version;.tar.xz
&xdpyinfo-md5sum; xdpyinfo-&xdpyinfo-version;.tar.xz
&xdriinfo-md5sum; xdriinfo-&xdriinfo-version;.tar.xz
&xev-md5sum; xev-&xev-version;.tar.xz
&xgamma-md5sum; xgamma-&xgamma-version;.tar.xz
&xhost-md5sum; xhost-&xhost-version;.tar.xz
&xinput-md5sum; xinput-&xinput-version;.tar.xz
&xkbcomp-md5sum; xkbcomp-&xkbcomp-version;.tar.xz
&xkbevd-md5sum; xkbevd-&xkbevd-version;.tar.xz
&xkbutils-md5sum; xkbutils-&xkbutils-version;.tar.xz
&xkill-md5sum; xkill-&xkill-version;.tar.xz
&xlsatoms-md5sum; xlsatoms-&xlsatoms-version;.tar.xz
&xlsclients-md5sum; xlsclients-&xlsclients-version;.tar.xz
&xmessage-md5sum; xmessage-&xmessage-version;.tar.xz
&xmodmap-md5sum; xmodmap-&xmodmap-version;.tar.xz
&xpr-md5sum; xpr-&xpr-version;.tar.xz
&xprop-md5sum; xprop-&xprop-version;.tar.xz
&xrandr-md5sum; xrandr-&xrandr-version;.tar.xz
&xrdb-md5sum; xrdb-&xrdb-version;.tar.xz
&xrefresh-md5sum; xrefresh-&xrefresh-version;.tar.xz
&xset-md5sum; xset-&xset-version;.tar.xz
&xsetroot-md5sum; xsetroot-&xsetroot-version;.tar.xz
&xvinfo-md5sum; xvinfo-&xvinfo-version;.tar.xz
&xwd-md5sum; xwd-&xwd-version;.tar.xz
&xwininfo-md5sum; xwininfo-&xwininfo-version;.tar.xz
&xwud-md5sum; xwud-&xwud-version;.tar.xz</literal>
EOF</userinput></screen>
<!-- Removed because it is also installed with mkfontscale
&mkfontdir-md5sum; mkfontdir-&mkfontdir-version;.tar.bz2
-->
<para>
To download the needed files using <xref linkend='wget'/>,
use the following commands:
</para>
<screen><userinput>mkdir app &amp;&amp;
cd app &amp;&amp;
grep -v '^#' ../app-&xorg-version;.md5 | awk '{print $2}' | wget -i- -c \
-B &xorg-download-http;/app/ &amp;&amp;
md5sum -c ../app-&xorg-version;.md5</userinput></screen>
</sect2>
<sect2 role="installation">
<title>Installation of Xorg Applications</title>
&as_root;
<para>
First, start a subshell that will exit on error:
</para>
<screen><userinput>bash -e</userinput></screen>
<para>
Install all of the packages by running the following commands:
</para>
<screen><userinput>for package in $(grep -v '^#' ../app-&xorg-version;.md5 | awk '{print $2}')
do
packagedir=${package%.tar.?z*}
tar -xf $package
pushd $packagedir
./configure $XORG_CONFIG
make
as_root make install
popd
rm -rf $packagedir
done</userinput></screen>
<para>
Finally, exit the shell that was started earlier:
</para>
<screen><userinput>exit</userinput></screen>
<para>
Unless you installed the optional dependencies, remove an undocumented
script which is reported to be broken (<command>xkeystone</command>
provided by the <application>xrandr</application> package).
</para>
<screen><userinput>as_root rm -f $XORG_PREFIX/bin/xkeystone</userinput></screen>
</sect2>
<!--
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>sed -e 's/\$(CPP) \$(DEFS)/$(CPP) -P $(DEFS)/' -i
man/Makefile.in</command>: with <application>gcc-5</application> the
behavior of <command>cpp</command> was changed to emit line numbers.
That results in unterminated <application>sed</application> commands in
<filename>filenames.sed</filename>. Adding <literal>-P</literal> restores
the old behavior.
</para>
</sect2>
-->
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>iceauth, mkfontdir, mkfontscale, sessreg,
setxkbmap, smproxy, x11perf, x11perfcomp, xauth, xbacklight,
xcmsdb, xcursorgen, xdpr, xdpyinfo, xdriinfo, xev, xgamma, xhost,
xinput, xkbbell, xkbcomp, xkbevd, xkbvleds, xkbwatch, xkill,
xlsatoms, xlsclients, xmessage, xmodmap, xpr, xprop, xrandr, xrdb,
xrefresh, xset, xsetroot, xvinfo, xwd, xwininfo, and xwud</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="iceauth-x7">
<term><command>iceauth</command></term>
<listitem>
<para>
is the ICE authority file utility
</para>
<indexterm zone="xorg7-app iceauth-x7">
<primary sortas="b-iceauth">iceauth</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mkfontdir-x7">
<term><command>mkfontdir</command></term>
<listitem>
<para>
creates an index of X font files in a directory
</para>
<indexterm zone="xorg7-app mkfontdir-x7">
<primary sortas="b-mkfontdir">mkfontdir</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mkfontscale-x7">
<term><command>mkfontscale</command></term>
<listitem>
<para>
creates an index of scalable font files for X
</para>
<indexterm zone="xorg7-app mkfontscale-x7">
<primary sortas="b-mkfontscale">mkfontscale</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="sessreg-x7">
<term><command>sessreg</command></term>
<listitem>
<para>
manages utmp/wtmp entries for non-init clients
</para>
<indexterm zone="xorg7-app sessreg-x7">
<primary sortas="b-sessreg">sessreg</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="setxkbmap-x7">
<term><command>setxkbmap</command></term>
<listitem>
<para>
sets the keyboard using the X Keyboard Extension
</para>
<indexterm zone="xorg7-app setxkbmap-x7">
<primary sortas="b-setxkbmap">setxkbmap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="smproxy-x7">
<term><command>smproxy</command></term>
<listitem>
<para>
is the Session Manager Proxy
</para>
<indexterm zone="xorg7-app smproxy-x7">
<primary sortas="b-smproxy">smproxy</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="x11perf-x7">
<term><command>x11perf</command></term>
<listitem>
<para>
is an X11 server performance test program
</para>
<indexterm zone="xorg7-app x11perf-x7">
<primary sortas="b-x11perf">x11perf</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="x11perfcomp-x7">
<term><command>x11perfcomp</command></term>
<listitem>
<para>
is an X11 server performance comparison program
</para>
<indexterm zone="xorg7-app x11perfcomp-x7">
<primary sortas="b-x11perfcomp">x11perfcomp</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xauth-x7">
<term><command>xauth</command></term>
<listitem>
<para>
is the X authority file utility
</para>
<indexterm zone="xorg7-app xauth-x7">
<primary sortas="b-xauth">xauth</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xbacklight-x7">
<term><command>xbacklight</command></term>
<listitem>
<para>
adjusts backlight brightness using RandR extension
</para>
<indexterm zone="xorg7-app xbacklight-x7">
<primary sortas="b-xbacklight">xbacklight</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xcmsdb-x7">
<term><command>xcmsdb</command></term>
<listitem>
<para>
is the Device Color Characterization utility for the X
Color Management System
</para>
<indexterm zone="xorg7-app xcmsdb-x7">
<primary sortas="b-xcmsdb">xcmsdb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xcursorgen-x7">
<term><command>xcursorgen</command></term>
<listitem>
<para>
creates an X cursor file from a collection of PNG images
</para>
<indexterm zone="xorg7-app xcursorgen-x7">
<primary sortas="b-xcursorgen">xcursorgen</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xdpr-x7">
<term><command>xdpr</command></term>
<listitem>
<para>
dumps an X window directly to a printer
</para>
<indexterm zone="xorg7-app xdpr-x7">
<primary sortas="b-xdpr">xdpr</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xdpyinfo-x7">
<term><command>xdpyinfo</command></term>
<listitem>
<para>
is a display information utility for X
</para>
<indexterm zone="xorg7-app xdpyinfo-x7">
<primary sortas="b-xdpyinfo">xdpyinfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xdriinfo-x7">
<term><command>xdriinfo</command></term>
<listitem>
<para>
queries configuration information of DRI drivers
</para>
<indexterm zone="xorg7-app xdriinfo-x7">
<primary sortas="b-xdriinfo">xdriinfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xev-x7">
<term><command>xev</command></term>
<listitem>
<para>
prints contents of X events
</para>
<indexterm zone="xorg7-app xev-x7">
<primary sortas="b-xev">xev</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xgamma-x7">
<term><command>xgamma</command></term>
<listitem>
<para>
alters a monitor's gamma correction through the X server
</para>
<indexterm zone="xorg7-app xgamma-x7">
<primary sortas="b-xgamma">xgamma</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xhost-x7">
<term><command>xhost</command></term>
<listitem>
<para>
is a server access control program for X
</para>
<indexterm zone="xorg7-app xhost-x7">
<primary sortas="b-xhost">xhost</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xinput-x7">
<term><command>xinput</command></term>
<listitem>
<para>
is a utility to configure and test X input devices
</para>
<indexterm zone="xorg7-app xinput-x7">
<primary sortas="b-xinput">xinput</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xkbbell-x7">
<term><command>xkbbell</command></term>
<listitem>
<para>
is an XKB utility program that raises a bell event
</para>
<indexterm zone="xorg7-app xkbbell-x7">
<primary sortas="b-xkbbell">xkbbell</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xkbcomp-x7">
<term><command>xkbcomp</command></term>
<listitem>
<para>
compiles an XKB keyboard description
</para>
<indexterm zone="xorg7-app xkbcomp-x7">
<primary sortas="b-xkbcomp">xkbcomp</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xkbevd-x7">
<term><command>xkbevd</command></term>
<listitem>
<para>
is the XKB event daemon
</para>
<indexterm zone="xorg7-app xkbevd-x7">
<primary sortas="b-xkbevd">xkbevd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xkbvleds-x7">
<term><command>xkbvleds</command></term>
<listitem>
<para>
shows the XKB status of keyboard LEDs
</para>
<indexterm zone="xorg7-app xkbvleds-x7">
<primary sortas="b-xkbvleds">xkbvleds</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xkbwatch-x7">
<term><command>xkbwatch</command></term>
<listitem>
<para>
monitors modifier keys and LEDs
</para>
<indexterm zone="xorg7-app xkbwatch-x7">
<primary sortas="b-xkbwatch">xkbwatch</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xkill-x7">
<term><command>xkill</command></term>
<listitem>
<para>
kills a client by its X resource
</para>
<indexterm zone="xorg7-app xkill-x7">
<primary sortas="b-xkill">xkill</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xlsatoms-x7">
<term><command>xlsatoms</command></term>
<listitem>
<para>
lists interned atoms defined on the server
</para>
<indexterm zone="xorg7-app xlsatoms-x7">
<primary sortas="b-xlsatoms">xlsatoms</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xlsclients-x7">
<term><command>xlsclients</command></term>
<listitem>
<para>
lists client applications running on a display
</para>
<indexterm zone="xorg7-app xlsclients-x7">
<primary sortas="b-xlsclients">xlsclients</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xmessage-x7">
<term><command>xmessage</command></term>
<listitem>
<para>
displays a message or query in a window
</para>
<indexterm zone="xorg7-app xmessage-x7">
<primary sortas="b-xmessage">xmessage</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xmodmap-x7">
<term><command>xmodmap</command></term>
<listitem>
<para>
is a utility for modifying keymaps and pointer button
mappings in X
</para>
<indexterm zone="xorg7-app xmodmap-x7">
<primary sortas="b-xmodmap">xmodmap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xpr-x7">
<term><command>xpr</command></term>
<listitem>
<para>
prints an X window dump
</para>
<indexterm zone="xorg7-app xpr-x7">
<primary sortas="b-xpr">xpr</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xprop-x7">
<term><command>xprop</command></term>
<listitem>
<para>
is a property displayer for X
</para>
<indexterm zone="xorg7-app xprop-x7">
<primary sortas="b-xprop">xprop</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xrandr-x7">
<term><command>xrandr</command></term>
<listitem>
<para>
is a primitive command line interface to RandR extension
</para>
<indexterm zone="xorg7-app xrandr-x7">
<primary sortas="b-xrandr">xrandr</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xrdb-x7">
<term><command>xrdb</command></term>
<listitem>
<para>
is the X server resource database utility
</para>
<indexterm zone="xorg7-app xrdb-x7">
<primary sortas="b-xrdb">xrdb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xrefresh-x7">
<term><command>xrefresh</command></term>
<listitem>
<para>
refreshes all or part of an X screen
</para>
<indexterm zone="xorg7-app xrefresh-x7">
<primary sortas="b-xrefresh">xrefresh</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xset-x7">
<term><command>xset</command></term>
<listitem>
<para>
is the user preference utility for X
</para>
<indexterm zone="xorg7-app xset-x7">
<primary sortas="b-xset">xset</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xsetroot-x7">
<term><command>xsetroot</command></term>
<listitem>
<para>
is the root window parameter setting utility for X
</para>
<indexterm zone="xorg7-app xsetroot-x7">
<primary sortas="b-xsetroot">xsetroot</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xvinfo-x7">
<term><command>xvinfo</command></term>
<listitem>
<para>
prints out X-Video extension adaptor information
</para>
<indexterm zone="xorg7-app xvinfo-x7">
<primary sortas="b-xvinfo">xvinfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xwd-x7">
<term><command>xwd</command></term>
<listitem>
<para>
dumps an image of an X window
</para>
<indexterm zone="xorg7-app xwd-x7">
<primary sortas="b-xwd">xwd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xwininfo-x7">
<term><command>xwininfo</command></term>
<listitem>
<para>
is a window information utility for X
</para>
<indexterm zone="xorg7-app xwininfo-x7">
<primary sortas="b-xwininfo">xwininfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xwud-x7">
<term><command>xwud</command></term>
<listitem>
<para>
is an image displayer for X
</para>
<indexterm zone="xorg7-app xwud-x7">
<primary sortas="b-xwud">xwud</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,168 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xorg-evdev-driver-version "2.10.6">
<!ENTITY xorg-evdev-driver-download-http "&xorg-download-http;/driver/xf86-input-evdev-&xorg-evdev-driver-version;.tar.bz2">
<!ENTITY xorg-evdev-driver-download-ftp " ">
<!ENTITY xorg-evdev-driver-md5sum "e8bd1edc6751f92e425cae7eba3c61eb">
<!ENTITY xorg-evdev-driver-size "400 KB">
<!ENTITY xorg-evdev-driver-buildsize "3.9 MB">
<!ENTITY xorg-evdev-driver-time "less than 0.1 SBU">
]>
<!-- Begin Xorg Evdev Driver -->
<sect2 id="xorg-evdev-driver" xreflabel="Xorg Evdev Driver-&xorg-evdev-driver-version;">
<sect2info>
<date>$Date$</date>
</sect2info>
<title>Xorg Evdev Driver-&xorg-evdev-driver-version;</title>
<indexterm zone="xorg-evdev-driver">
<primary sortas="a-xorg-evdev-driver">xorg-evdev-driver</primary>
</indexterm>
<sect3 role="package">
<title>Introduction to Xorg Evdev Driver</title>
<para>
The <application>Xorg Evdev Driver</application> package contains a Generic
Linux input driver for the Xorg X server. It handles keyboard, mouse, touchpads
and wacom devices, though for touchpad and wacom advanced handling,
additional drivers are required.
</para>
&lfs121_checked;
<bridgehead renderas="sect4">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xorg-evdev-driver-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xorg-evdev-driver-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xorg-evdev-driver-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xorg-evdev-driver-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xorg-evdev-driver-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xorg-evdev-driver-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect4">Xorg Evdev Driver Dependencies</bridgehead>
<bridgehead renderas="sect5">Required</bridgehead>
<para role="required">
<xref linkend="libevdev"/>,
<xref linkend="mtdev"/>, and
<xref linkend="xorg-server"/>
</para>
<!--
<bridgehead renderas="sect5">Recommended</bridgehead>
<para role="recommended">
<xref linkend="mtdev"/>
</para>-->
</sect3>
<!-- No need to give kernel configuration here, since already done for
libevdev. If for any reason you want to uncomment, this configuration
is not complete.
<sect3 role="kernel" id="xorg-evdev-driver-kernel">
<title>Kernel Configuration</title>
<para>
Enable the following options in the kernel configuration and recompile the
kernel if necessary:
</para>
<screen><literal>Device Drivers - - -&gt;
Input device support - - -&gt;
<*> Generic input layer (needed ...) [CONFIG_INPUT]
<*> Event interface [CONFIG_INPUT_EVDEV]</literal></screen>
<indexterm zone="xorg-evdev-driver xorg-evdev-driver-kernel">
<primary sortas="d-xorg-evdev-driver">xorg-evdev-driver</primary>
</indexterm>
</sect3>
-->
<sect3 role="installation">
<title>Installation of Xorg Evdev Driver</title>
<para>
Install <application>Xorg Evdev Driver</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect3>
<sect3 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Xorg Driver</segtitle>
<seglistitem>
<seg>
evdev_drv.so
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect4">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="evdev_drv">
<term><filename class="libraryfile">evdev_drv.so</filename></term>
<listitem>
<para>
is an Xorg input driver for Linux generic event devices
</para>
<indexterm zone="xorg-evdev-driver evdev_drv">
<primary sortas="c-evdev_drv">evdev_drv.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

View File

@ -0,0 +1,143 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xorg-libinput-driver-version "1.4.0">
<!ENTITY xorg-libinput-driver-download-http "&xorg-download-http;/driver/xf86-input-libinput-&xorg-libinput-driver-version;.tar.xz">
<!ENTITY xorg-libinput-driver-download-ftp " ">
<!ENTITY xorg-libinput-driver-md5sum "b52a1fc7456cf6595a9a1004287551a3">
<!ENTITY xorg-libinput-driver-size "320 KB">
<!ENTITY xorg-libinput-driver-buildsize "3.9 MB (with tests)">
<!ENTITY xorg-libinput-driver-time "less than 0.1 SBU (with tests)">
]>
<!-- Begin Xorg input-libinput Driver -->
<sect2 id="xorg-libinput-driver" xreflabel="xorg-libinput-&xorg-libinput-driver-version;">
<sect2info>
<date>$Date$</date>
</sect2info>
<title>Xorg Libinput Driver-&xorg-libinput-driver-version;</title>
<indexterm zone="xorg-libinput-driver">
<primary sortas="a-xorg-libinput-driver">xorg-libinput-driver</primary>
</indexterm>
<sect3 role="package">
<title>Introduction to Xorg Libinput Driver</title>
<para>
The <application>X.Org Libinput Driver</application> is a thin wrapper
around libinput and allows for libinput to be used for input devices in
X. This driver can be used as drop-in replacement for evdev and
synaptics.
</para>
&lfs121_checked;
<bridgehead renderas="sect4">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xorg-libinput-driver-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xorg-libinput-driver-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xorg-libinput-driver-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xorg-libinput-driver-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xorg-libinput-driver-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xorg-libinput-driver-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect4">Xorg Libinput Driver Dependencies</bridgehead>
<bridgehead renderas="sect5">Required</bridgehead>
<para role="required">
<xref linkend="libinput"/> and
<xref linkend="xorg-server"/>
</para>
</sect3>
<sect3 role="installation">
<title>Installation of Xorg Libinput Driver</title>
<para>
Install <application>Xorg Libinput Driver</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
To test the results, issue <command>make check</command>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect3>
<sect3 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Xorg Driver</segtitle>
<seglistitem>
<seg>
libinput_drv.so
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect4">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libinput_drv">
<term><filename class="libraryfile">libinput_drv.so</filename></term>
<listitem>
<para>
is an Xorg input driver for mouse, keyboard, touchpad,
touchscreen, and tablet devices
</para>
<indexterm zone="xorg-libinput-driver libinput_drv">
<primary sortas="c-libinput_drv">libinput_drv.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

View File

@ -0,0 +1,174 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xorg-synaptics-driver-version "1.9.2">
<!ENTITY xorg-synaptics-driver-download-http "&xorg-download-http;/driver/xf86-input-synaptics-&xorg-synaptics-driver-version;.tar.xz">
<!ENTITY xorg-synaptics-driver-download-ftp " ">
<!ENTITY xorg-synaptics-driver-md5sum "3b95e7baf4428b114e9910f999e96601">
<!ENTITY xorg-synaptics-driver-size "424 KB">
<!ENTITY xorg-synaptics-driver-buildsize "5.2 MB">
<!ENTITY xorg-synaptics-driver-time "less than 0.1 SBU">
]>
<!-- Begin Xorg Synaptics Driver -->
<sect2 id="xorg-synaptics-driver" xreflabel="Xorg Synaptics Driver-&xorg-synaptics-driver-version;">
<sect2info>
<date>$Date$</date>
</sect2info>
<title>Xorg Synaptics Driver-&xorg-synaptics-driver-version;</title>
<indexterm zone="xorg-synaptics-driver">
<primary sortas="a-xorg-synaptics-driver">xorg-synaptics-driver</primary>
</indexterm>
<sect3 role="package">
<title>Introduction to Xorg Synaptics Driver</title>
<para>
The <application>Xorg Synaptics Driver</application> package contains
the X.Org Input Driver, support programs and SDK for Synaptics
touchpads. Even though the evdev driver can handle touchpads very well,
this driver is required if you want to use advanced features like multi
tapping, scrolling with touchpad, turning the touchpad off while
typing, etc.
</para>
&lfs121_checked;
<bridgehead renderas="sect4">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xorg-synaptics-driver-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xorg-synaptics-driver-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xorg-synaptics-driver-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xorg-synaptics-driver-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xorg-synaptics-driver-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xorg-synaptics-driver-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect4">Xorg Synaptics Driver Dependencies</bridgehead>
<bridgehead renderas="sect5">Required</bridgehead>
<para role="required">
<xref linkend="libevdev"/> and
<xref linkend="xorg-server"/>
</para>
</sect3>
<sect3 role="installation">
<title>Installation of Xorg Synaptics Driver</title>
<para>
Install <application>Xorg Synaptics Driver</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect3>
<sect3 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Xorg Driver</segtitle>
<seglistitem>
<seg>
synclient and syndaemon
</seg>
<seg>
synaptics_drv.so
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect4">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="synclient">
<term><command>synclient</command></term>
<listitem>
<para>
is a command line utility used to query and modify Synaptics
driver options
</para>
<indexterm zone="xorg-synaptics-driver synclient">
<primary sortas="b-synclient">synclient</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="syndaemon">
<term><command>syndaemon</command></term>
<listitem>
<para>
is a program that monitors keyboard activity and disables the
touchpad when the keyboard is being used
</para>
<indexterm zone="xorg-synaptics-driver syndaemon">
<primary sortas="b-syndaemon">syndaemon</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="synaptics_drv">
<term><filename class="libraryfile">synaptics_drv.so</filename></term>
<listitem>
<para>
is an Xorg input driver for touchpads
</para>
<indexterm zone="xorg-synaptics-driver synaptics_drv">
<primary sortas="c-synaptics_drv">synaptics_drv.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

View File

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- Automatically generated by kernel-config.py
DO NOT EDIT! -->
<screen><emphasis role='blue'>D</emphasis>evice Drivers ---&gt;
[*] H<emphasis role='blue'>I</emphasis>D bus support ---&gt; [HID_SUPPORT]
{*/M} H<emphasis role='blue'>I</emphasis>D bus core support [HID]
<emphasis role='blue'>S</emphasis>pecial HID drivers ---&gt;
&lt;*/M&gt; <emphasis role='blue'>W</emphasis>acom Intuos/Graphire tablet support (USB) [HID_WACOM]
<emphasis role='blue'>U</emphasis>SB HID support ---&gt;
&lt;*/M&gt; <emphasis role='blue'>U</emphasis>SB HID transport layer [USB_HID]
[*] <emphasis role='blue'>U</emphasis>SB support ---&gt; [USB_SUPPORT]
&lt;*/M&gt; <emphasis role='blue'>S</emphasis>upport for Host-side USB [USB]</screen>

View File

@ -0,0 +1,177 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xorg-wacom-driver-version "1.2.2">
<!ENTITY xorg-wacom-driver-download-http "https://github.com/linuxwacom/xf86-input-wacom/releases/download/xf86-input-wacom-&xorg-wacom-driver-version;/xf86-input-wacom-&xorg-wacom-driver-version;.tar.bz2">
<!ENTITY xorg-wacom-driver-download-ftp " ">
<!ENTITY xorg-wacom-driver-md5sum "bd72f813b094b79b450e50a95476977b">
<!ENTITY xorg-wacom-driver-size "636 KB">
<!ENTITY xorg-wacom-driver-buildsize "8.1 MB (with tests)">
<!ENTITY xorg-wacom-driver-time "0.1 SBU (with tests)">
]>
<!-- Begin Xorg Wacom Driver -->
<sect2 id="xorg-wacom-driver" xreflabel="Xorg Wacom Driver-&xorg-wacom-driver-version;">
<sect2info>
<date>$Date$</date>
</sect2info>
<title>Xorg Wacom Driver-&xorg-wacom-driver-version;</title>
<indexterm zone="xorg-wacom-driver">
<primary sortas="a-xorg-wacom-driver">xorg-wacom-driver</primary>
</indexterm>
<sect3 role="package">
<title>Introduction to Xorg Wacom Driver</title>
<para>
The <application>Xorg Wacom Driver</application> package contains the
X.Org X11 driver and SDK for Wacom and Wacom-like tablets. It is not
required to use a Wacom tablet, the
<application>xf86-input-evdev</application> driver can handle these
devices without problems.
</para>
&lfs121_checked;
<bridgehead renderas="sect4">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xorg-wacom-driver-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xorg-wacom-driver-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xorg-wacom-driver-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xorg-wacom-driver-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xorg-wacom-driver-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xorg-wacom-driver-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect4">Xorg Wacom Drivers Dependencies</bridgehead>
<bridgehead renderas="sect5">Required</bridgehead>
<para role="required">
<xref linkend="xorg-server"/>
</para>
</sect3>
<sect3 role="kernel" id="xorg-wacom-driver-kernel">
<title>Kernel Configuration</title>
<para>
To use a Wacom tablet with USB interface, enable the following
options in your kernel configuration and recompile. Note that
other configuration options could be required for tablet with a
serial or bluetooth interface:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="x7driver-wacom-kernel.xml"/>
<indexterm zone="xorg-wacom-driver xorg-wacom-driver-kernel">
<primary sortas="d-xorg-wacom-driver">xorg-wacom-driver</primary>
</indexterm>
</sect3>
<sect3 role="installation">
<title>Installation of Xorg Wacom Driver</title>
<para>
Install <application>Xorg Wacom Driver</application> by running the following
commands:
</para>
<screen revision="sysv"><userinput>./configure $XORG_CONFIG --with-systemd-unit-dir=no &amp;&amp;
make</userinput></screen>
<para>
To test the results, issue: <command>make check</command>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect3>
<sect3 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Xorg Driver</segtitle>
<seglistitem>
<seg>
isdv4-serial-debugger, isdv4-serial-inputattach, and xsetwacom
</seg>
<seg>
wacom_drv.so
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect4">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="xsetwacom">
<term><command>xsetwacom</command></term>
<listitem>
<para>
is a commandline utility used to query
and modify wacom driver settings
</para>
<indexterm zone="xorg-wacom-driver xsetwacom">
<primary sortas="b-xsetwacom">xsetwacom</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wacom_drv">
<term><filename class="libraryfile">wacom_drv.so</filename></term>
<listitem>
<para>
is an Xorg input driver for Wacom devices
</para>
<indexterm zone="xorg-wacom-driver wacom_drv">
<primary sortas="c-wacom_drv">wacom_drv.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>

View File

@ -0,0 +1,99 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
]>
<sect1 id="xorg7-input-driver" xreflabel="Xorg Input Drivers">
<?dbhtml filename="x7driver.html"?>
<title>Xorg Input Drivers</title>
<indexterm zone="xorg7-input-driver">
<primary sortas="a-xorg7-input-driver">xorg7-input-driver</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Xorg Input Drivers</title>
<para>
The <application>Xorg Input Drivers</application> page contains the
instructions for building Xorg input drivers that are necessary in
order for Xorg Server to respond user inputs.
</para>
<sect3 id="xorg-input-drivers">
<title>Xorg Input Drivers</title>
<itemizedlist spacing="compact">
<listitem>
<para>
<xref linkend="libevdev"/>
</para>
</listitem>
<listitem>
<para>
<xref linkend="xorg-evdev-driver"/>
</para>
</listitem>
<listitem>
<para>
<xref linkend="libinput"/>
</para>
</listitem>
<listitem>
<para>
<xref linkend="xorg-libinput-driver"/>
</para>
</listitem>
<listitem>
<para>
<xref linkend="xorg-synaptics-driver"/>
</para>
</listitem>
<!-- With Kernel 5.1, VMMouse is now entirely unusable/obsolete.
VMWare has a replacement in the kernel that works for both Qemu and
VMWare, that allows the VMMouse instruction set to run through
EVDEV events.
I archived it on 2019-05-19 as a result. - renodr
<listitem>
<para>
<xref linkend="xorg-vmmouse-driver"/>
</para>
</listitem>
-->
<listitem>
<para>
<xref linkend="xorg-wacom-driver"/>
</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="libevdev.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="x7driver-evdev.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="libinput.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="x7driver-libinput.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="x7driver-synaptics.xml"/>
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="x7driver-vmmouse.xml"/> -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="x7driver-wacom.xml"/>
</sect1>

236
shareddeps/dps/x/x7font.xml Normal file
View File

@ -0,0 +1,236 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY x7fonts-download-http "&xorg-download-http;/font/">
<!ENTITY x7fonts-download-ftp " ">
<!ENTITY x7fonts-size "3.0 MB">
<!ENTITY x7fonts-buildsize "8.8 MB">
<!ENTITY x7fonts-time "0.1 SBU">
<!ENTITY encodings-version "1.1.0">
<!ENTITY encodings-md5sum "a56b1a7f2c14173f71f010225fa131f1">
<!ENTITY font-adobe-utopia-type1-version "1.0.5">
<!ENTITY font-adobe-utopia-type1-md5sum "546d17feab30d4e3abcf332b454f58ed">
<!ENTITY font-alias-version "1.0.5">
<!ENTITY font-alias-md5sum "79f4c023e27d1db1dfd90d041ce89835">
<!ENTITY font-bh-ttf-version "1.0.4">
<!ENTITY font-bh-ttf-md5sum "063bfa1456c8a68208bf96a33f472bb1">
<!ENTITY font-bh-type1-version "1.0.4">
<!ENTITY font-bh-type1-md5sum "51a17c981275439b85e15430a3d711ee">
<!ENTITY font-ibm-type1-version "1.0.4">
<!ENTITY font-ibm-type1-md5sum "00f64a84b6c9886040241e081347a853">
<!ENTITY font-misc-ethiopic-version "1.0.5">
<!ENTITY font-misc-ethiopic-md5sum "fe972eaf13176fa9aa7e74a12ecc801a">
<!ENTITY font-util-version "1.4.1">
<!ENTITY font-util-md5sum "a6541d12ceba004c0c1e3df900324642">
<!ENTITY font-xfree86-type1-version "1.0.5">
<!ENTITY font-xfree86-type1-md5sum "3b47fed2c032af3a32aad9acc1d25150">
]>
<sect1 id="xorg7-font" xreflabel="Xorg Fonts">
<?dbhtml filename="x7font.html"?>
<title>Xorg Fonts</title>
<indexterm zone="xorg7-font">
<primary sortas="a-xorg7-font">Xorg Fonts</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Xorg Fonts</title>
<para>
The <application>Xorg</application> font packages provide some scalable
fonts and supporting packages for <application>Xorg</application>
applications. Many people will want to install other TTF or OTF fonts in
addition to, or instead of, these. Some are listed at <ulink
url="&blfs-svn;/x/TTF-and-OTF-fonts">TTF-and-OTF-fonts</ulink>.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&x7fonts-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&x7fonts-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download size: &x7fonts-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &x7fonts-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &x7fonts-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Xorg Fonts Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xcursor-themes"/>
</para>
</sect2>
<sect2>
<title>Downloading Xorg Fonts</title>
<para>
First, create a list of files to be downloaded. This file will also
be used to verify the integrity of the downloads when complete:
</para>
<screen><userinput>cat &gt; font-&xorg-version;.md5 &lt;&lt; "EOF"
<literal>&font-util-md5sum; font-util-&font-util-version;.tar.xz
&encodings-md5sum; encodings-&encodings-version;.tar.xz
&font-alias-md5sum; font-alias-&font-alias-version;.tar.xz
&font-adobe-utopia-type1-md5sum; font-adobe-utopia-type1-&font-adobe-utopia-type1-version;.tar.xz
&font-bh-ttf-md5sum; font-bh-ttf-&font-bh-ttf-version;.tar.xz
&font-bh-type1-md5sum; font-bh-type1-&font-bh-type1-version;.tar.xz
&font-ibm-type1-md5sum; font-ibm-type1-&font-ibm-type1-version;.tar.xz
&font-misc-ethiopic-md5sum; font-misc-ethiopic-&font-misc-ethiopic-version;.tar.xz
&font-xfree86-type1-md5sum; font-xfree86-type1-&font-xfree86-type1-version;.tar.xz</literal>
EOF</userinput></screen>
<para>
To download the needed files using <xref linkend='wget'/>,
use the following commands:
</para>
<screen><userinput>mkdir font &amp;&amp;
cd font &amp;&amp;
grep -v '^#' ../font-&xorg-version;.md5 | awk '{print $2}' | wget -i- -c \
-B &xorg-download-http;/font/ &amp;&amp;
md5sum -c ../font-&xorg-version;.md5</userinput></screen>
</sect2>
<sect2 role="installation">
<title>Installation of Xorg Fonts</title>
&as_root;
<para>
First, start a subshell that will exit on error:
</para>
<screen><userinput>bash -e</userinput></screen>
<para>
Install all of the packages by running the following commands:
</para>
<screen><userinput>for package in $(grep -v '^#' ../font-&xorg-version;.md5 | awk '{print $2}')
do
packagedir=${package%.tar.?z*}
tar -xf $package
pushd $packagedir
./configure $XORG_CONFIG
make
as_root make install
popd
as_root rm -rf $packagedir
done</userinput></screen>
<para>
Finally, exit the shell that was started earlier:
</para>
<screen><userinput>exit</userinput></screen>
<para>
When all of the fonts have been installed, the system must be
configured so that <application>Fontconfig</application> can find the
TrueType fonts. Since the fonts are outside of the default search path of
several packages <emphasis role="bold">if <envar>XORG_PREFIX</envar> is
not <filename class="directory">/usr</filename></emphasis>, make symlinks
to the <application>Xorg</application> TrueType font directories in
<filename class="directory">/usr/share/fonts</filename> by
running the following commands as the
<systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>install -v -d -m755 /usr/share/fonts &amp;&amp;
ln -svfn $XORG_PREFIX/share/fonts/X11/OTF /usr/share/fonts/X11-OTF &amp;&amp;
ln -svfn $XORG_PREFIX/share/fonts/X11/TTF /usr/share/fonts/X11-TTF</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>bdftruncate and ucs2any</seg>
<seg>None</seg>
<seg><envar>$XORG_PREFIX</envar>/share/fonts</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bdftruncate-x7">
<term><command>bdftruncate</command></term>
<listitem>
<para>
generates a truncated BDF font from an ISO 10646-1 encoded BDF font
</para>
<indexterm zone="xorg7-font bdftruncate-x7">
<primary sortas="b-bdftruncate">bdftruncate</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ucs2any-x7">
<term><command>ucs2any</command></term>
<listitem>
<para>
generates BDF fonts in any encoding from an ISO 10646-1 encoded
BDF font
</para>
<indexterm zone="xorg7-font ucs2any-x7">
<primary sortas="b-ucs2any">ucs2any</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,232 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY x7legacy-download-http "&xorg-download-http;/">
<!ENTITY x7legacy-download-ftp " ">
<!ENTITY x7legacy-size "4.2 MB">
<!ENTITY x7legacy-buildsize "30 MB"> <!-- daewoo is largest build dir -->
<!ENTITY x7legacy-time "0.3 SBU">
<!ENTITY bdftopcf-version "1.1.1">
<!ENTITY bdftopcf-md5sum "e09b61567ab4a4d534119bba24eddfb1">
<!ENTITY font-adobe-100dpi-version "1.0.4">
<!ENTITY font-adobe-100dpi-md5sum "20239f6f99ac586f10360b0759f73361">
<!ENTITY font-adobe-75dpi-version "1.0.4">
<!ENTITY font-adobe-75dpi-md5sum "2dc044f693ee8e0836f718c2699628b9">
<!ENTITY font-jis-misc-version "1.0.4">
<!ENTITY font-jis-misc-md5sum "2c939d5bd4609d8e284be9bef4b8b330">
<!ENTITY font-daewoo-misc-version "1.0.4">
<!ENTITY font-daewoo-misc-md5sum "6300bc99a1e45fbbe6075b3de728c27f">
<!ENTITY font-isas-misc-version "1.0.4">
<!ENTITY font-isas-misc-md5sum "fe2c44307639062d07c6e9f75f4d6a13">
<!ENTITY font-misc-misc-version "1.1.3">
<!ENTITY font-misc-misc-md5sum "145128c4b5f7820c974c8c5b9f6ffe94">
]>
<sect1 id="xorg7-legacy" xreflabel="Xorg Legacy Fonts">
<?dbhtml filename="x7legacy.html"?>
<title>Xorg Legacy</title>
<indexterm zone="xorg7-legacy">
<primary sortas="a-xorg7-legacy">Xorg Legacy</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Xorg Legacy</title>
<para>
<application>Xorg</application>&apos;s ancestor (X11R1, in 1987) at
first only provided bitmap fonts, with a tool
(<command>bdftopcf</command>) to assist in their installation. With the
introduction of <application>xorg-server-1.19.0</application> and
<application>libXfont2</application> many people will not need them.
There are still a few old packages which might require, or benefit from,
these deprecated fonts and so the following packages are shown here.
</para>
<note>
<para>
The font-adobe-100dpi package installs 100 dots per inch versions of
Courier, Helvetica, New Century Schoolbook and Times fonts.
</para>
<para>
The remaining font packages here provide 75dpi versions of those fonts,
and various miscellaneous fonts - mostly for legacy encodings. Those are
primarily to silence warnings when testing Xorg. In previous versions
of BLFS a lot more legacy fonts were installed.
</para>
<para revision="sysv">
Please consult the BLFS-7.10 book at <ulink
url="https://www.linuxfromscratch.org/blfs/view/7.10/x/x7font.html"/>
if you wish to install any of those other fonts.
</para>
<para revision="systemd">
Please consult the BLFS-7.10 systemd book at <ulink url=
"https://www.linuxfromscratch.org/blfs/view/7.10-systemd/x/x7font.html"/>
if you wish to install any of those other fonts.
</para>
</note>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&x7legacy-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&x7legacy-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download size: &x7legacy-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &x7legacy-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &x7legacy-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Xorg Legacy Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-font"/>
</para>
</sect2>
<sect2>
<title>Downloading Xorg Legacy</title>
<para>
First, create a list of files to be downloaded. This file will also
be used to verify the integrity of the downloads when complete:
</para>
<screen><userinput>cat &gt; legacy.dat &lt;&lt; "EOF"
<literal>&bdftopcf-md5sum; util/ bdftopcf-&bdftopcf-version;.tar.xz
&font-adobe-100dpi-md5sum; font/ font-adobe-100dpi-&font-adobe-100dpi-version;.tar.xz
&font-adobe-75dpi-md5sum; font/ font-adobe-75dpi-&font-adobe-75dpi-version;.tar.xz
&font-jis-misc-md5sum; font/ font-jis-misc-&font-jis-misc-version;.tar.xz
&font-daewoo-misc-md5sum; font/ font-daewoo-misc-&font-daewoo-misc-version;.tar.xz
&font-isas-misc-md5sum; font/ font-isas-misc-&font-isas-misc-version;.tar.xz
&font-misc-misc-md5sum; font/ font-misc-misc-&font-misc-misc-version;.tar.xz</literal>
EOF</userinput></screen>
<para>
To download the needed files using <xref linkend='wget'/>,
use the following commands:
</para>
<screen><userinput>mkdir legacy &amp;&amp;
cd legacy &amp;&amp;
grep -v '^#' ../legacy.dat | awk '{print $2$3}' | wget -i- -c \
-B &xorg-download-http;/ &amp;&amp;
grep -v '^#' ../legacy.dat | awk '{print $1 " " $3}' > ../legacy.md5 &amp;&amp;
md5sum -c ../legacy.md5</userinput></screen>
</sect2>
<sect2 role="installation">
<title>Installation of Xorg Legacy</title>
&as_root;
<para>
First, start a subshell that will exit on error:
</para>
<screen><userinput>bash -e</userinput></screen>
<para>
Install all of the packages by running the following commands:
</para>
<screen><userinput>for package in $(grep -v '^#' ../legacy.md5 | awk '{print $2}')
do
packagedir=${package%.tar.?z*}
tar -xf $package
pushd $packagedir
./configure $XORG_CONFIG
make
as_root make install
popd
rm -rf $packagedir
as_root /sbin/ldconfig
done</userinput></screen>
<para>
Finally, exit the shell that was started earlier:
</para>
<screen><userinput>exit</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>bdftopcf</seg>
<seg>None</seg>
<seg><envar>$XORG_PREFIX</envar>/share/fonts/100dpi,
<envar>$XORG_PREFIX</envar>/share/fonts/75dpi,
<envar>$XORG_PREFIX</envar>/share/fonts/misc</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bdftopcf-x7">
<term><command>bdftopcf</command></term>
<listitem>
<para>
converts an X font from Bitmap Distribution Format to Portable
Compiled Format
</para>
<indexterm zone="xorg7-legacy bdftopcf-x7">
<primary sortas="b-bdftopcf">bdftopcf</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,117 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xbitmaps-download-http "&xorg-download-http;/data/xbitmaps-&xbitmaps-version;.tar.xz">
<!ENTITY xbitmaps-download-ftp " ">
<!ENTITY xbitmaps-md5sum "2b03f89d78fb91671370e77d7ad46907">
<!ENTITY xbitmaps-size "108 KB">
<!ENTITY xbitmaps-buildsize "1.6 MB">
<!ENTITY xbitmaps-time "less than 0.1 SBU">
]>
<sect1 id="xbitmaps" xreflabel="xbitmaps-&xbitmaps-version;">
<?dbhtml filename="xbitmaps.html"?>
<title>xbitmaps-&xbitmaps-version;</title>
<indexterm zone="xbitmaps">
<primary sortas="a-xbitmaps">xbitmaps</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xbitmaps</title>
<para>
The <application>xbitmaps</application> package contains bitmap
images used by multiple applications built in Xorg chapter.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xbitmaps-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xbitmaps-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xbitmaps-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xbitmaps-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xbitmaps-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xbitmaps-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xbitmaps Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="util-macros"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xbitmaps</title>
<para>
Install <application>xbitmaps</application> by running the
following commands:
</para>
<screen><userinput>./configure $XORG_CONFIG</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>None</seg>
<seg>None</seg>
<seg><envar>$XORG_PREFIX</envar>/include/X11/bitmaps</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>

View File

@ -0,0 +1,139 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xcb-util-cursor-download-http "https://xcb.freedesktop.org/dist/xcb-util-cursor-&xcb-util-cursor-version;.tar.xz">
<!ENTITY xcb-util-cursor-download-ftp " ">
<!ENTITY xcb-util-cursor-md5sum "0d244518ad54b886413fe782235d6210">
<!ENTITY xcb-util-cursor-size "260 KB">
<!ENTITY xcb-util-cursor-buildsize "2.5 MB">
<!ENTITY xcb-util-cursor-time "less than 0.1 SBU">
]>
<sect1 id="xcb-util-cursor" xreflabel="xcb-util-cursor-&xcb-util-cursor-version;">
<?dbhtml filename="xcb-util-cursor.html"?>
<title>xcb-util-cursor-&xcb-util-cursor-version;</title>
<indexterm zone="xcb-util-cursor">
<primary sortas="a-xcb-util-cursor">xcb-util-cursor</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xcb-util-cursor</title>
<para>
The <application>xcb-util-cursor</application> package provides a module
that implements the XCB cursor library. It is the
<application>XCB</application> replacement for libXcursor.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xcb-util-cursor-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xcb-util-cursor-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xcb-util-cursor-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xcb-util-cursor-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xcb-util-cursor-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xcb-util-cursor-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xcb-util-cursor Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xcb-util-image"/> and
<xref linkend="xcb-util-renderutil"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xcb-util-cursor</title>
<para>
Install <application>xcb-util-cursor</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libxcb-cursor.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libxcb-cursor">
<term><filename class="libraryfile">libxcb-cursor.so</filename></term>
<listitem>
<para>
Is a port of Xlib's libXcursor functions
</para>
<indexterm zone="xcb-util-cursor libxcb-cursor">
<primary sortas="c-libxcb-cursor">libxcb-cursor.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,138 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xcb-util-image-download-http "https://xcb.freedesktop.org/dist/xcb-util-image-&xcb-util-image-version;.tar.xz">
<!ENTITY xcb-util-image-download-ftp " ">
<!ENTITY xcb-util-image-md5sum "a67bfac2eff696170259ef1f5ce1b611">
<!ENTITY xcb-util-image-size "284 KB">
<!ENTITY xcb-util-image-buildsize "2.9 MB">
<!ENTITY xcb-util-image-time "less than 0.1 SBU">
]>
<sect1 id="xcb-util-image" xreflabel="xcb-util-image-&xcb-util-image-version;">
<?dbhtml filename="xcb-util-image.html"?>
<title>xcb-util-image-&xcb-util-image-version;</title>
<indexterm zone="xcb-util-image">
<primary sortas="a-xcb-util-image">xcb-util-image</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xcb-util-image</title>
<para>
The <application>xcb-util-image</application> package provides additional
extensions to the <application>XCB</application> library.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xcb-util-image-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xcb-util-image-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xcb-util-image-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xcb-util-image-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xcb-util-image-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xcb-util-image-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xcb-util-image Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xcb-util"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xcb-util-image</title>
<para>
Install <application>xcb-util-image</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
To test the results, issue:
<command>LD_LIBRARY_PATH=$XORG_PREFIX/lib make check</command>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libxcb-image.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libxcb-image">
<term><filename class="libraryfile">libxcb-image.so</filename></term>
<listitem>
<para>
Is a port of Xlib's XImage and XShmImage functions
</para>
<indexterm zone="xcb-util-image libxcb-image">
<primary sortas="c-libxcb-image">libxcb-image.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,147 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xcb-util-keysyms-download-http
"https://xcb.freedesktop.org/dist/xcb-util-keysyms-&xcb-util-keysyms-version;.tar.xz">
<!ENTITY xcb-util-keysyms-download-ftp " ">
<!ENTITY xcb-util-keysyms-md5sum "fbdc05f86f72f287ed71b162f1a9725a">
<!ENTITY xcb-util-keysyms-size "256 KB">
<!ENTITY xcb-util-keysyms-buildsize "2.3 MB">
<!ENTITY xcb-util-keysyms-time "less than 0.1 SBU">
]>
<sect1 id="xcb-util-keysyms" xreflabel="xcb-util-keysyms-&xcb-util-keysyms-version;">
<?dbhtml filename="xcb-util-keysyms.html"?>
<title>xcb-util-keysyms-&xcb-util-keysyms-version;</title>
<indexterm zone="xcb-util-keysyms">
<primary sortas="a-xcb-util-keysyms">xcb-util-keysyms</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xcb-util-keysyms</title>
<para>
The <application>xcb-util-keysyms</application> package contains a library
for handling standard X key constants and conversion to/from keycodes.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xcb-util-keysyms-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xcb-util-keysyms-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xcb-util-keysyms-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xcb-util-keysyms-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xcb-util-keysyms-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xcb-util-keysyms-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xcb-util-keysyms Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="libxcb"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xcb-util-keysyms</title>
<para>
Install <application>xcb-util-keysyms</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
<!--To test the results, issue:
<command>LD_LIBRARY_PATH=$XORG_PREFIX/lib make check</command>.-->
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
None
</seg>
<seg>
libxcb-keysyms.so
</seg>
<seg>
None
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libxcb-keysyms">
<term><filename class="libraryfile">libxcb-keysyms.so</filename></term>
<listitem>
<para>
provides the standard X key constants and API functions for
conversion to/from keycodes
</para>
<indexterm zone="xcb-util-keysyms libxcb-keysyms">
<primary sortas="c-libxcb-keysyms">libxcb-keysyms.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,137 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xcb-util-renderutil-download-http "https://xcb.freedesktop.org/dist/xcb-util-renderutil-&xcb-util-renderutil-version;.tar.xz">
<!ENTITY xcb-util-renderutil-download-ftp " ">
<!ENTITY xcb-util-renderutil-md5sum "193b890e2a89a53c31e2ece3afcbd55f">
<!ENTITY xcb-util-renderutil-size "256 KB">
<!ENTITY xcb-util-renderutil-buildsize "2.4 MB">
<!ENTITY xcb-util-renderutil-time "less than 0.1 SBU">
]>
<sect1 id="xcb-util-renderutil" xreflabel="xcb-util-renderutil-&xcb-util-renderutil-version;">
<?dbhtml filename="xcb-util-renderutil.html"?>
<title>xcb-util-renderutil-&xcb-util-renderutil-version;</title>
<indexterm zone="xcb-util-renderutil">
<primary sortas="a-xcb-util-renderutil">xcb-util-renderutil</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xcb-util-renderutil</title>
<para>
The <application>xcb-util-renderutil</application> package provides additional
extensions to the <application>XCB</application> library.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xcb-util-renderutil-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xcb-util-renderutil-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xcb-util-renderutil-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xcb-util-renderutil-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xcb-util-renderutil-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xcb-util-renderutil-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xcb-util-renderutil Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="libxcb"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xcb-util-renderutil</title>
<para>
Install <application>xcb-util-renderutil</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libxcb-render-util.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libxcb-render-util">
<term><filename class="libraryfile">libxcb-render-util.so</filename></term>
<listitem>
<para>
Provides convenience functions for the Render extension
</para>
<indexterm zone="xcb-util-renderutil libxcb-render-util">
<primary sortas="c-libxcb-render-util">libxcb-render-util.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,158 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xcb-util-wm-download-http
"https://xcb.freedesktop.org/dist/xcb-util-wm-&xcb-util-wm-version;.tar.xz">
<!ENTITY xcb-util-wm-download-ftp " ">
<!ENTITY xcb-util-wm-md5sum "581b3a092e3c0c1b4de6416d90b969c3">
<!ENTITY xcb-util-wm-size "280 KB">
<!ENTITY xcb-util-wm-buildsize "3.2 MB">
<!ENTITY xcb-util-wm-time "less than 0.1 SBU">
]>
<sect1 id="xcb-util-wm" xreflabel="xcb-util-wm-&xcb-util-wm-version;">
<?dbhtml filename="xcb-util-wm.html"?>
<title>xcb-util-wm-&xcb-util-wm-version;</title>
<indexterm zone="xcb-util-wm">
<primary sortas="a-xcb-util-wm">xcb-util-wm</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xcb-util-wm</title>
<para>
The <application>xcb-util-wm</application> package contains libraries
which provide client and window-manager helpers for EWMH and ICCCM.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xcb-util-wm-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xcb-util-wm-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xcb-util-wm-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xcb-util-wm-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xcb-util-wm-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xcb-util-wm-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xcb-util-wm Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="libxcb"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xcb-util-wm</title>
<para>
Install <application>xcb-util-wm</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
<!--To test the results, issue:
<command>LD_LIBRARY_PATH=$XORG_PREFIX/lib make check</command>.-->
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
None
</seg>
<seg>
libxcb-ewmh.so and libxcb-icccm.so
</seg>
<seg>
None
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libxcb-ewmh">
<term><filename class="libraryfile">libxcb-ewmh.so</filename></term>
<listitem>
<para>
provides the client and window-manager helpers for EWMH
</para>
<indexterm zone="xcb-util-wm libxcb-ewmh">
<primary sortas="c-libxcb-ewmh">libxcb-ewmh.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libxcb-icccm">
<term><filename class="libraryfile">libxcb-icccm.so</filename></term>
<listitem>
<para>
provides the client and window-manager helpers for ICCCM
</para>
<indexterm zone="xcb-util-wm libxcb-icccm">
<primary sortas="c-libxcb-icccm">libxcb-icccm.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,139 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xcb-util-download-http "https://xcb.freedesktop.org/dist/xcb-util-&xcb-util-version;.tar.xz">
<!ENTITY xcb-util-download-ftp " ">
<!ENTITY xcb-util-md5sum "34d749eab0fd0ffd519ac64798d79847">
<!ENTITY xcb-util-size "261 KB">
<!ENTITY xcb-util-buildsize "2.6 MB">
<!ENTITY xcb-util-time "less than 0.1 SBU">
]>
<sect1 id="xcb-util" xreflabel="xcb-util-&xcb-util-version;">
<?dbhtml filename="xcb-util.html"?>
<title>xcb-util-&xcb-util-version;</title>
<indexterm zone="xcb-util">
<primary sortas="a-xcb-util">xcb-util</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xcb-util</title>
<para>
The <application>xcb-util</application> package provides additional
extensions to the <application>XCB</application> library, many that were
previously found in <application>Xlib</application>, but are not part of
core X protocol.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xcb-util-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xcb-util-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xcb-util-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xcb-util-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xcb-util-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xcb-util-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xcb-util Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="libxcb"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xcb-util</title>
<para>
Install <application>xcb-util</application> by running the following
commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libxcb-util.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libxcb-util">
<term><filename class="libraryfile">libxcb-util.so</filename></term>
<listitem>
<para>
Provides utility functions for other XCB utilities
</para>
<indexterm zone="xcb-util libxcb-util">
<primary sortas="c-libxcb-util">libxcb-util.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

140
shareddeps/dps/x/xclock.xml Normal file
View File

@ -0,0 +1,140 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY xclock-download-http "&xorg-download-http;/app/xclock-&xclock-version;.tar.xz">
<!ENTITY xclock-download-ftp " ">
<!ENTITY xclock-md5sum "1273e3f4c85f1801be11a5247c382d07">
<!ENTITY xclock-size "156 KB">
<!ENTITY xclock-buildsize "1.5 MB">
<!ENTITY xclock-time "less than 0.1 SBU">
]>
<sect1 id="xclock" xreflabel="xclock-&xclock-version;">
<?dbhtml filename="xclock.html"?>
<title>xclock-&xclock-version;</title>
<indexterm zone="xclock">
<primary sortas="a-xclock">xclock</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xclock</title>
<para>
The <application>xclock</application> package contains a simple
clock application which is used in the default xinit configuration.
</para>
&not-katamari;
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xclock-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xclock-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xclock-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xclock-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xclock-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xclock-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xclock Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-lib"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xclock</title>
<para>
Install <application>xclock</application> by running the
following commands:
</para>
<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>xclock</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="xclock-bin">
<term><command>xclock</command></term>
<listitem>
<para>
is an analog/digital clock for X
</para>
<indexterm zone="xclock xclock">
<primary sortas="b-xclock">xclock</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,130 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xcursor-themes-download-http "&xorg-download-http;/data/xcursor-themes-&xcursor-themes-version;.tar.xz">
<!ENTITY xcursor-themes-download-ftp " ">
<!ENTITY xcursor-themes-md5sum "070993be1f010b09447ea24bab2c9846">
<!ENTITY xcursor-themes-size "1.4 MB">
<!ENTITY xcursor-themes-buildsize "15 MB">
<!ENTITY xcursor-themes-time "less than 0.1 SBU">
]>
<sect1 id="xcursor-themes" xreflabel="xcursor-themes-&xcursor-themes-version;">
<?dbhtml filename="xcursor-themes.html"?>
<title>xcursor-themes-&xcursor-themes-version;</title>
<indexterm zone="xcursor-themes">
<primary sortas="a-xcursor-themes">xcursor-themes</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xcursor-themes</title>
<para>
The <application>xcursor-themes</application> package contains the
redglass and whiteglass animated cursor themes.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xcursor-themes-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xcursor-themes-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xcursor-themes-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xcursor-themes-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xcursor-themes-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xcursor-themes-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xcursor-themes Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-app"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xcursor-themes</title>
<note>
<para>
We explicitly install the cursor themes in /usr instead
of <envar>$XORG_PREFIX</envar> so non-Xorg desktop environments can
find them.
</para>
</note>
<para>
Install <application>xcursor-themes</application> by running the
following commands:
</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<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/handhelds,
/usr/share/icons/redglass, and
/usr/share/icons/whiteglass
</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>

194
shareddeps/dps/x/xinit.xml Normal file
View File

@ -0,0 +1,194 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY xinit-download-http "&xorg-download-http;/app/xinit-&xinit-version;.tar.xz">
<!ENTITY xinit-download-ftp " ">
<!ENTITY xinit-md5sum "0e9a1b9a82b84ab229c709c0f939c113">
<!ENTITY xinit-size "153 KB">
<!ENTITY xinit-buildsize "1.5 MB">
<!ENTITY xinit-time "less than 0.1 SBU">
]>
<sect1 id="xinit" xreflabel="xinit-&xinit-version;">
<?dbhtml filename="xinit.html"?>
<title>xinit-&xinit-version;</title>
<indexterm zone="xinit">
<primary sortas="a-xinit">xinit</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xinit</title>
<para>
The <application>xinit</application> package contains a usable script
to start the xserver.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xinit-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xinit-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xinit-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xinit-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xinit-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xinit-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xinit Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-lib"/>
</para>
<bridgehead renderas="sect4">Recommended (runtime only)</bridgehead>
<para role="recommended">
<xref role="runtime" linkend="twm"/>,
<xref role="runtime" linkend="xclock"/>, and
<xref role="runtime" linkend="xterm2"/> (used in the default <filename>
xinitrc</filename> file)
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xinit</title>
<para>
Install <application>xinit</application> by running the
following commands:
</para>
<screen><userinput>./configure $XORG_CONFIG --with-xinitdir=/etc/X11/app-defaults &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install &amp;&amp;
ldconfig</userinput></screen>
<note revision='sysv'>
<para>
If starting Xorg from the command line, the default instructions
above start Xorg on the current virtual terminal. It may be
convenient to see Xorg and associated application messages on the
current virtual terminal, normally tty1, and start the graphical
environment on the first available unused virtual terminal, normally
tty7. To do this, set the suid bit on the Xorg application as the
<systemitem class="username">root</systemitem> user:
</para>
<screen role="nodump"><userinput>chmod u+s $XORG_PREFIX/bin/Xorg</userinput></screen>
<para>
At this point you can start Xorg on virtual terminal 7 with
<command>startx &lt;client arguments&gt; -- vt7</command>. Now
you can toggle between tty1 and tty7 with the Ctrl-Alt-F1 and
Ctrl-Alt-F7 key combinations.
</para>
<para>
To automatically start Xorg on the first available virtual terminal,
modify the <command>startx</command> script as the <systemitem
class="username">root</systemitem> user with:
</para>
<screen role="nodump"><userinput>sed -i '/$serverargs $vtarg/ s/serverargs/: #&amp;/' $XORG_PREFIX/bin/startx</userinput></screen>
<para>
After this change, the virtual terminal does not need to be
specified on the <command>startx</command> command line.
</para>
</note>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>xinit and startx</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="startx">
<term><command>startx</command></term>
<listitem>
<para>
initializes an X session
</para>
<indexterm zone="xinit startx">
<primary sortas="b-startx">startx</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xinit-bin">
<term><command>xinit</command></term>
<listitem>
<para>
is the X Window System initializer
</para>
<indexterm zone="xinit xinit">
<primary sortas="b-xinit">xinit</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -0,0 +1,139 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xkeyboard-config-download-http
"&xorg-download-http;/data/xkeyboard-config/xkeyboard-config-&xkeyboard-config-version;.tar.xz">
<!ENTITY xkeyboard-config-download-ftp " ">
<!ENTITY xkeyboard-config-md5sum "2f0b843b5283b82cae0402cbc4f374b4">
<!ENTITY xkeyboard-config-size "880 KB">
<!ENTITY xkeyboard-config-buildsize "20 MB">
<!ENTITY xkeyboard-config-time "0.1 SBU (with tests)">
]>
<sect1 id="xkeyboard-config" xreflabel="xkeyboard-config-&xkeyboard-config-version;">
<?dbhtml filename="xkeyboard-config.html"?>
<title>XKeyboardConfig-&xkeyboard-config-version;</title>
<indexterm zone="xkeyboard-config">
<primary sortas="a-XKeyboardConfig">XKeyboardConfig</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to XKeyboardConfig</title>
<para>
The <application>XKeyboardConfig</application> package contains
the keyboard configuration database for the X Window System.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xkeyboard-config-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xkeyboard-config-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xkeyboard-config-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xkeyboard-config-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xkeyboard-config-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xkeyboard-config-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">XKeyboardConfig Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="xorg7-lib"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of XKeyboardConfig</title>
<para>
Install <application>XKeyboardConfig</application> by running the
following commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup --prefix=$XORG_PREFIX --buildtype=release .. &amp;&amp;
ninja</userinput></screen>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../xincludes/meson-buildtype-release.xml"/>
<!-- the default for the xorg symlinks is false. So the change to
the symlink command is not needed. Note that those symlinks have
been deprecated since 2005...
<para>
<command>sed ... rules/meson.build</command>: Make sure
a symlink is created even if it already exists.
</para>
<para>
<parameter>- -with-xkb-rules-symlink=xorg</parameter>: By default, the
XKB rules installed are named "base". This creates symlinks named
"xorg" to those rules, which is the default name used by Xorg.
</para>
-->
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>None</seg>
<seg>None</seg>
<seg>
<envar>$XORG_PREFIX</envar>/share/X11/xkb
</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>

View File

@ -0,0 +1,524 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<sect1 id="xorg-config">
<?dbhtml filename="xorg-config.html"?>
<title>Xorg-&xorg-version; Testing and Configuration</title>
<indexterm zone="xorg-config">
<primary sortas="g-configuring-xorg">Configuring Xorg</primary>
</indexterm>
<sect2 id='X11-testing' xreflabel="Testing Xorg">
<title>Testing Xorg</title>
<note>
<para>
Before starting Xorg for the first time, is useful to
rebuild the library cache by running <userinput>ldconfig</userinput>
as the <systemitem class="username">root</systemitem> user.
</para>
</note>
<note>
<para>
Before starting Xorg for the first time, is often needed to
reboot the system to ensure all appropriate daemons are started
and appropriate security issues are properly set.
As an alternative, logging out and logging back in may work, but as
of this writing has not been tested.
</para>
</note>
<warning>
<para>
If Xorg hangs for some reason (for example, lacking a proper
input driver), the system may stop responding to any user input.
As a precaution, you can enable a magic <keycap>SysRq</keycap> key
before testing Xorg. As the
<systemitem class="username">root</systemitem> user, issue:
</para>
<screen><userinput>echo 4 > /proc/sys/kernel/sysrq</userinput></screen>
<para>
Then if Xorg hangs, it's possible to use
<keycombo>
<keycap>Alt</keycap>
<keycap>SysRq</keycap>
<keycap>R</keycap>
</keycombo>
to reset the keyboard mode. Now it should be able to use
<keycombo>
<keycap>Ctrl</keycap>
<keycap>Alt</keycap>
<keycap>Fx</keycap>
</keycombo>
(replace x with a VT number) to switch to another VT.
If it works, login and kill Xorg using command line in the new VT.
</para>
</warning>
<para>
To test the <application>Xorg</application> installation, issue
<command>startx</command>. This command brings up a rudimentary window
manager called <emphasis>twm</emphasis> with three xterm windows and one
xclock window. The xterm window in the upper left is a login terminal and
running <emphasis>exit</emphasis> from this terminal will exit the
<application>X Window</application> session. The third xterm window may
be obscured on your system by the other two xterms.
</para>
<note>
<para>
When testing <application>Xorg</application> with the
<application>twm</application> window manager, there will be several
warnings in the Xorg log file, <!--<filename revision="sysv">
/var/log/Xorg.0.log</filename><filename revision="systemd">-->
$HOME/.local/share/xorg/Xorg.0.log<!--</filename>-->, about missing font
files. In addition, there will be several warnings on the text mode
terminal (usually tty1) about missing fonts. These warnings do not
affect functionality, but can be removed if desired by installing
the <xref linkend="xorg7-legacy"/>.
</para>
</note>
<note>
<para>
On systems with NVIDIA GPUs which are using the Nouveau kernel driver,
you may encounter occasional GPU crashes and hangs. If this problem
occurs, downgrade to the latest version of the Linux 6.1 kernel.
<!--https://gitlab.freedesktop.org/drm/nouveau/-/issues/257-->
</para>
</note>
<para>
Generally, there is no specific configuration required for
<application>Xorg</application>, but customization is possible. For
details, see <xref linkend='xconfig'/> below.
</para>
</sect2>
<sect2 role="configuration" id="checking-dri" xreflabel="Checking the DRI
installation">
<title>Checking the Direct Rendering Infrastructure (DRI)
Installation</title>
<para>
DRI 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 (using
<application>Mesa</application>) if you have a supported video card.
</para>
<para>
To check if DRI drivers are installed properly, check the log file
<filename>$HOME/.local/share/xorg/Xorg.0.log</filename> (or
<filename>/var/log/Xorg.0.log</filename> if you have
built <xref linkend="xorg-server"/> with the suid bit) for
statements such as:
</para>
<screen><literal>(II) modeset(0): [DRI2] Setup complete
(II) modeset(0): [DRI2] DRI driver: crocus
(II) modeset(0): [DRI2] VDPAU driver: va_gl</literal></screen>
<note>
<para>
DRI configuration may differ if you are using alternate drivers, such
as traditional DDX drivers, or the proprietary drivers from
<ulink url="https://www.nvidia.com/page/home.html">NVIDIA</ulink> or
<ulink url="https://www.amd.com/">AMD</ulink>.
</para>
</note>
<!-- With elogind, this is not needed anymore
<para>
Although all users can use software acceleration, any hardware
acceleration (DRI2) is only available to <systemitem
class="username">root</systemitem> and members of the <systemitem
class="groupname">video</systemitem> group, but
<phrase revision="sysv"><emphasis>ConsoleKit2</emphasis></phrase>
<phrase revision="systemd"><emphasis>systemd-logind</emphasis></phrase>
takes care of adding any logged in user to the user ACL's of
<filename>/dev/dri/card*</filename>, the special file(s) allowing access
to hardware acceleration.<phrase revision="systemd"> So, no further
configuration is needed.</phrase>
</para>
<para revision="sysv">
If your driver is supported and <emphasis>ConsoleKit2</emphasis> is not
installed, add any users that might use X to the <systemitem
class="groupname">video</systemitem> group:
</para>
<screen role="root" revision="sysv"><userinput>usermod -a -G video <replaceable>&lt;username&gt;</replaceable></userinput></screen>
-->
<para>
Another way to determine if DRI is working properly is to use one of the
two optionally installed OpenGL demo programs in <xref
linkend="mesa"/>. From an X terminal, run <command>glxinfo -B</command>
and look for the phrase:
</para>
<screen><computeroutput>name of display: :0
display: :0 screen: 0
direct rendering: Yes</computeroutput></screen>
<para>
If direct rendering is enabled, you can add verbosity by running
<command>LIBGL_DEBUG=verbose glxinfo</command>. This will show the
drivers, device nodes and files used by the DRI system.
</para>
<para>
To confirm that DRI2 hardware acceleration is working, you can (still in
the X terminal) run the command <command>glxinfo | grep -E "(OpenGL
vendor|OpenGL renderer|OpenGL version)"</command>.
If that reports something <emphasis>other than</emphasis>
<literal>Software Rasterizer</literal> then you have working
acceleration for the user who ran the command.
</para>
<para>
If your hardware does not have any DRI2 driver available, it will use a
Software Rasterizer for Direct Rendering. In such cases, you can use a
new, LLVM-accelerated, Software Rasterizer called LLVMPipe. In order to
build LLVMPipe just make sure that <xref linkend="llvm"/> is present at
Mesa build time. Note that all decoding is done on the CPU instead of
the GPU, so the display will run slower than with hardware acceleration.
To check if you are using LLVMpipe, review the output of the glxinfo
command above. An example of the output using the Software Rasterizer
is shown below:
</para>
<screen><computeroutput>OpenGL vendor string: VMware, Inc.
OpenGL renderer string: Gallium 0.4 on llvmpipe (LLVM 3.5, 256 bits)
OpenGL version string: 3.0 Mesa 10.4.5</computeroutput></screen>
<para>
You can also force LLVMPipe by exporting the
<envar>LIBGL_ALWAYS_SOFTWARE=1</envar> environment variable when
starting Xorg.
</para>
<para>
Again, if you have built the Mesa OpenGL demos, you can also run the test
program <command>glxgears</command>. This program brings up a window with
three gears turning. The X terminal will display how many frames were
drawn every five seconds, so this will give a rough benchmark. The window
is scalable, and the frames drawn per second is highly dependent on the
size of the window. On some hardware, <command>glxgears</command> will
run synchronized with the vertical refresh signal and the frame rate will
be approximately the same as the monitor refresh rate.
</para>
</sect2>
<sect2 role="configuration" id="xorg-debug" xreflabel="Debugging Xorg">
<title>Debugging Xorg</title>
<para>
When starting xorg, there are a couple of ways to check what any
issues you may have. If the system comes up, you can see what driver
is being used by running <command>xdriinfo</command>. If there are
issues or you just want to check, look at <filename>Xorg.0.log</filename>.
</para>
<para>
The location of <filename>Xorg.0.log</filename> depends on how Xorg is
installed. If the instructions in the book are followed closely and
Xorg is started from the command line, it will be located in the
<filename class="directory">$HOME/.local/share/xorg/</filename> directory.
If Xorg is started by a display manager (e.g. <xref linkend='lightdm'/>,
<xref linkend='sddm'/>, or <xref linkend='gdm'/>) or if
<filename>$XORG_PREFIX/bin/Xorg</filename> has the suid bit set,
it will be located in the <filename class="directory">/var/log/</filename>
directory.
</para>
<bridgehead renderas="sect3">Xorg.0.log Issues</bridgehead>
<para>
When you look at Xorg.0.log, check for entries like (EE) or (WW).
Below are some common entries:
</para>
<bridgehead renderas="sect5">(WW) Open ACPI failed (/var/run/acpid.socket)</bridgehead>
<para>
This warning is because <xref linkend='acpid'/> is not installed. If you
are not on a laptop, it can be safely ignored. On a laptop, install
<xref linkend='acpid'/> to enable actions like recognizing when the lid is
closed.
</para>
<bridgehead renderas="sect5">(WW) VGA arbiter: cannot open kernel arbiter, no multi-card support</bridgehead>
<para>
This warning is displayed when a regular user starts Xorg. The library
<filename>libpciaccess.so</filename> issues this warning when it
tries to open <filename>/dev/vga_arbiter</filename>. If there is no
more than one legacy PCI (not PCIe) graphic cards on the system, it
can safely be ignored. If really necessary, the
permissions of this device can be changed by adding a udev rule and
adding the local user to the video group. As the &root; user:
</para>
<screen role="root"><userinput>cat > /etc/udev/rules.d/99-vga-arbiter.rules &lt;&lt; EOF
# /etc/udev/rules.d/99-vga-arbiter.rules: Set vga_arbiter group/mode
ACTION=="add", KERNEL=="vga_arbiter", GROUP="video" MODE="0660"
EOF
usermod -a -G video &lt;user running xorg&gt;</userinput></screen>
</sect2>
<sect2 role="configuration" id="hybrid-graphics" xreflabel="Hybrid Graphics">
<title>Hybrid Graphics</title>
<para>
Hybrid Graphics is still in experimental state for Linux. Xorg Developers
have developed a technology called PRIME that can be used for switching
between integrated and muxless discrete GPU at will. Automatic switching
is not possible at the moment.
</para>
<para>
In order to use PRIME for GPU switching, make sure that you are using
Linux Kernel 3.4 or later (recommended). You will need latest DRI and
DDX drivers for your hardware and <application>Xorg Server</application>
1.13 or later.
</para>
<para>
<application>Xorg Server</application> should load both GPU drivers
automatically. You can check that by running:
</para>
<screen><userinput>xrandr --listproviders</userinput></screen>
<para>
There should be two (or more) providers listed, for example:
</para>
<screen><computeroutput>Providers: number : 2
Provider 0: id: 0x7d cap: 0xb, Source Output, Sink Output, Sink Offload crtcs: 3 outputs: 4 associated providers: 1 name:modesetting
Provider 1: id: 0x56 cap: 0xf, Source Output, Sink Output, Source Offload, Sink Offload crtcs: 6 outputs: 1 associated providers: 1 name:modesetting</computeroutput></screen>
<!-- Well, both "id" and "name" are supposed to work here but after
the xf86-video-* removal all the names will be modesetting unless
a proprietary driver used... -->
<para>
In order to be able to run a GLX application on a discrete GPU, you will
need to run the following command, where &lt;provider&gt; is the id of
the more powerful discrete card, and &lt;sink&gt; is the id of card
which has a display connected:
</para>
<screen><userinput>xrandr --setprovideroffloadsink <replaceable>&lt;provider&gt; &lt;sink&gt;</replaceable></userinput></screen>
<note>
<para>
With the <application>Xorg</application> modesetting driver,
which is DRI3 capable, the above command is no longer
necessary. It does no harm however.
</para>
</note>
<para>
Then, you will need to export the <envar>DRI_PRIME=1</envar> environment
variable each time you want the powerful GPU to be used. For example,
<screen><userinput>DRI_PRIME=1 glxinfo | grep -E "(OpenGL vendor|OpenGL renderer|OpenGL version)"</userinput></screen>
will show OpenGL vendor, renderer and version for the discrete GPU.
</para>
<para>
If the last command reports same OpenGL renderer with and without
<envar>DRI_PRIME=1</envar>, you will need to check your installation.
</para>
</sect2>
<sect2 role="configuration" id='xconfig'>
<title>Setting up Xorg Devices</title>
<para>
For most hardware configurations, modern Xorg will automatically
get the server configuration correct without any user intervention. There
are, however, some cases where auto-configuration will be incorrect.
Following are some example manual configuration items that may be of use
in these instances.
</para>
<sect3 id="xinput">
<title>Setting up X Input Devices</title>
<para>
For most input devices, no additional configuration will be
necessary. This section is provided for informational purposes only.
</para>
<para>
A sample default XKB setup could look like the following (executed as
the <systemitem class="username">root</systemitem> user):
</para>
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/xkb-defaults.conf &lt;&lt; "EOF"
<literal>Section "InputClass"
Identifier "XKB Defaults"
MatchIsKeyboard "yes"
Option "XkbLayout" "fr"
Option "XkbOptions" "terminate:ctrl_alt_bksp"
EndSection</literal>
EOF</userinput></screen>
<para>
The <quote>XkbLayout</quote> line is an example for a French (AZERTY)
keyboard. Change it to your keyboard model. That line is not needed for
a QWERTY (US) keyboard.
</para>
</sect3>
<sect3 id="xdisplay">
<title>Fine Tuning Display Settings</title>
<para>
If you want to set the monitor resolution for Xorg, first run
<command>xrandr</command> in a X terminal to list the supported
resolutions and the corresponding refresh rates. For example, it
outputs the following for one monitor:
</para>
<screen><computeroutput>Screen 0: minimum 16 x 16, current 5760 x 2160, maximum 32767 x 32767
DP-1 connected primary 3840x2160+0+0 (normal left inverted right x axis y axis) 600mm x 340mm
3840x2160 59.98*+
2048x1536 59.95
1920x1440 59.90
1600x1200 59.87
1440x1080 59.99
1400x1050 59.98
1280x1024 59.89
1280x960 59.94
1152x864 59.96
1024x768 59.92
800x600 59.86
640x480 59.38</computeroutput></screen>
<para>
From the output we can see the monitor is identified
<literal>DP-1</literal>. Select a suitable resolution from the
output list, for example <literal>1920x1440</literal>. Then
as the &root; user, create a configuration file for the Xorg server:
</para>
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/monitor-DP-1.conf &lt;&lt; "EOF"
<literal>Section "Monitor"
Identifier "DP-1"
Option "PerferredMode" "1920x1440"
EndSection</literal>
EOF</userinput></screen>
<para>
Sometimes <command>xrandr</command> may fail to detect some
resolution settings supported by the monitor. It usually happens
with virtual monitors of virtual machine managers like
<xref linkend='qemu'/> or VMWare: a virtual monitor actually
supports all pairs of integers in a range as the resolution, but
<command>xrandr</command> will only list a few. To use a
resolution not listed by <command>xrandr</command>, first run
<command>cvt</command> to get the mode line for the resolution.
For example:
</para>
<screen><userinput>cvt 1600 900</userinput>
<computeroutput><literal># 1600x900 59.95 Hz (CVT 1.44M9) hsync: 55.99 kHz; pclk: 118.25 MHz
Modeline "1600x900_60.00" 118.25 1600 1696 1856 2112 900 903 908 934 -hsync +vsync</literal></computeroutput></screen>
<para>
As the &root; user, create a Xorg server configuration file
containing this mode line, and specify the mode as preferred mode:
</para>
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/monitor-DP-1.conf &lt;&lt; "EOF"
<literal>Section "Monitor"
Identifier "DP-1"
Modeline "1600x900_60.00" 118.25 1600 1696 1856 2112 900 903 908 934 -hsync +vsync
Option "PerferredMode" "1600x900_60.00"
EndSection</literal>
EOF</userinput></screen>
<para>
Some high-end LCD monitors support a refresh rate higher than 100 Hz
but <command>xrandr</command> may fail to recognize the supported
refresh rate and use 60 Hz instead. This issue would prevent you
from utilizing the full capability of the monitor, and may cause
the screen to flicker or show <quote>artifacts</quote> like meshes
or grids. To resolve the issue, again use <command>cvt</command>
to get the mode line with a custom refresh rate:
</para>
<screen><userinput>cvt 3840 2160 144</userinput>
<computeroutput><literal># 3840x2160 143.94 Hz (CVT) hsync: 338.25 kHz; pclk: 1829.25 MHz
Modeline "3840x2160_144.00" 1829.25 3840 4200 4624 5408 2160 2163 2168 2350 -hsync +vsync</literal></computeroutput></screen>
<para>
Then paste it into the Xorg server configuration file and set it
as the preferred mode.
</para>
<para>
Another common setup is having multiple server layouts for use in
different environments. Though the server will automatically detect the
presence of another monitor, it may get the order incorrect:
</para>
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/server-layout.conf &lt;&lt; "EOF"
<literal>Section "ServerLayout"
Identifier "DefaultLayout"
Screen 0 "Screen0" 0 0
Screen 1 "Screen1" LeftOf "Screen0"
Option "Xinerama"
EndSection</literal>
EOF</userinput></screen>
<para>
When you drag a window in twm (or any non-compositing window
manager) horizontally, you may observe that the vertical borders
of the window are broken into multiple segments. This is an example
of the visual artifacts called <emphasis>screen tearing</emphasis>.
To resolve the screen tearing problems, create a configuration file
that enables the TearFree option. Note that you must have the
Tearfree patch applied from <xref role="nodep"
linkend="xorg-server"/> for this to function properly, and it may
increase memory allocation and reduce performance.
</para>
<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/20-tearfree.conf &lt;&lt; "EOF"
<literal>Section "Device"
Identifier "Graphics Adapter"
Driver "modesetting"
Option "TearFree" "true"
EndSection</literal>
EOF</userinput></screen>
<para>
With modern Xorg, little or no additional graphic card configuration
is necessary. If you should need extra options passed to your video
driver, add them into the <literal>Device</literal> section as well.
The options supported by the modesetting driver are documented in
the man page <ulink role='man'
url='&man;modesetting.4'>modesetting(4)</ulink>.
</para>
</sect3>
</sect2>
</sect1>

View File

@ -0,0 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- Automatically generated by kernel-config.py
DO NOT EDIT! -->
<screen><emphasis role='blue'>D</emphasis>evice Drivers ---&gt;
<emphasis role='blue'>G</emphasis>raphics support ---&gt;
&lt;*/M&gt; <emphasis role='blue'>D</emphasis>irect Rendering Manager (XFree86 4.1.0 and higher DRI support) ---&gt;
... [DRM]
&lt; /*/M&gt; <emphasis role='blue'>D</emphasis>RM driver for VMware Virtual GPU [DRM_VMWGFX]
&lt; /*/M&gt; <emphasis role='blue'>D</emphasis>RM Support for bochs dispi vga interface (qemu stdvga) [DRM_BOCHS]
&lt; /*/M&gt; <emphasis role='blue'>V</emphasis>irtual Box Graphics Card [DRM_VBOXVIDEO]</screen>

View File

@ -0,0 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE note PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- Automatically generated by kernel-config.py
DO NOT EDIT! -->
<screen><emphasis role='blue'>D</emphasis>evice Drivers ---&gt;
<emphasis role='blue'>F</emphasis>irmware Drivers ---&gt;
[*] M<emphasis role='blue'>a</emphasis>rk VGA/VBE/EFI FB as generic system framebuffer [SYSFB_SIMPLEFB]
<emphasis role='blue'>G</emphasis>raphics support ---&gt;
&lt;*&gt; <emphasis role='blue'>D</emphasis>irect Rendering Manager (XFree86 4.1.0 and higher DRI support) ---&gt;
... [DRM]
&lt;*&gt; <emphasis role='blue'>S</emphasis>imple framebuffer driver [DRM_SIMPLEDRM]</screen>

View File

@ -0,0 +1,414 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY xorg-server-download-http "&xorg-download-http;/xserver/xorg-server-&xorg-server-version;.tar.xz">
<!ENTITY xorg-server-download-ftp " ">
<!ENTITY xorg-server-md5sum "69dbed93746d0af6b46de76d711614e4">
<!ENTITY xorg-server-size "4.7 MB">
<!ENTITY xorg-server-buildsize "147 MB (with tests)">
<!ENTITY xorg-server-time "0.3 SBU (using parallelism=4; with tests)">
<!ENTITY modesetting_drv
"<filename class='libraryfile'>modesetting_drv</filename>">
<!ENTITY BLFS113 "https://www.linuxfromscratch.org/blfs/view/11.3/x/x7driver.html">
<!ENTITY BLFS76 "https://www.linuxfromscratch.org/blfs/view/7.6/x/x7driver.html">
]>
<sect1 id="xorg-server" xreflabel="Xorg-Server-&xorg-server-version;">
<?dbhtml filename="xorg-server.html"?>
<title>Xorg-Server-&xorg-server-version;</title>
<indexterm zone="xorg-server">
<primary sortas="a-xorg-server">xorg-server</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Xorg Server</title>
<para>
The <application>Xorg</application> Server is the core
of the X Window system.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xorg-server-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xorg-server-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xorg-server-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xorg-server-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xorg-server-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xorg-server-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
With the removal of the xf86-video-* drivers, the TearFree option
is no longer functional. To work around this, upstream has added the
TearFree option to the default modesetting driver. This patch
backports this feature. Apply this patch if you are going to use Xorg
in an environment without a compositor (such as TWM, IceWM, Openbox,
or Fluxbox).
</para>
<para>
Optional patch:
<ulink url="&patch-root;/xorg-server-&xorg-server-version;-tearfree_backport-1.patch"/>
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="libxcvt"/>,
<xref linkend="pixman"/>,
<xref linkend="xorg7-font"/> (only font-util), and at runtime:
<xref role="runtime" linkend="xkeyboard-config"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend='dbus'/>,
<ulink role="runtime" url="&blfs-svn;/general/elogind.html">
if you aren't on Systemd: elogind</ulink> (runtime;
<systemitem class='library'>libelogind</systemitem> also referred
at build time but it's not really useful),
<xref linkend="libepoxy"/> (needed for glamor),
and <xref role='runtime' linkend='xorg-libinput-driver'/> (runtime)
</para>
<!-- TODO: Add -Dsystemd_logind=yes explicitly (like -Dglamor=true) to
make this more clear for BLFS 12.2. Now (Feb 16 2024) this package
is already under 12.1 freeze. -->
<note>
<para>
If you don't want to install the recommended dependency elogind,
add your regular user to the input and video groups.
</para>
</note>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="libunwind"/>,
<xref linkend="nettle"/>,
<xref linkend="xcb-util-keysyms"/>,
<xref linkend="xcb-util-image"/>,
<xref linkend="xcb-util-renderutil"/>,
<xref linkend="xcb-util-wm"/> (all four to build Xephyr),
<xref linkend="xkeyboard-config"/> (for tests),
<ulink url="https://gitlab.freedesktop.org/xorg/test/rendercheck">rendercheck</ulink> (for tests), and
<ulink url="https://www.x.org/archive/individual/doc/">xorg-sgml-doctools</ulink> (to build documentation)
</para>
</sect2>
<sect2 role="kernel" id="xorg-server-kernel">
<title>Kernel Configuration</title>
<para>
The traditional Device Dependent X (DDX) drivers have been removed
from BLFS in favor of the &modesetting_drv; driver which will be
built as a part of this package. To use the &modesetting_drv; driver,
the kernel must provide a Direct Rendering Manager (DRM) driver for
your GPU.
</para>
<para>
If your GPU supports 3D acceleration and <xref linkend='mesa'/>
provides a Gallium3D driver for utilizing its 3D capability, you
should have already enabled the necessary kernel configuration options
in <xref linkend='gpuconfig'/>. Otherwise, you need to find the
kernel configuration option of the DRM driver for the GPU and enable
it. Notably, the virtual GPUs provided by some virtual machine
managers:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="xorg-server-kernel.xml"/>
<para>
If the kernel does not provide a DRM driver for your GPU, on most x86
systems the <quote>simple frame buffer</quote> DRM driver running on
VESA or UEFI frame buffer can be used as a fallback. Enable the
following options in the kernel configurations if you don't have a
dedicated DRM driver for the GPU, or you want to keep the simple
frame buffer driver as a fallback in case the dedicated driver fails:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="xorg-server-simpledrm-kernel.xml"/>
<para>
To allow the kernel to print debug messages at an early boot stage,
<option>CONFIG_DRM</option> and <option>CONFIG_DRM_SIMPLEDRM</option>
should not be built as kernel modules unless an initramfs will be
used.
</para>
<para>
If you want to use the simple frame buffer driver on a system booted
via BIOS (instead of UEFI), add the following line before the first
<literal>menuentry</literal> block in the
<filename>/boot/grub/grub.cfg</filename> file to initialize the VESA
frame buffer:
</para>
<screen><literal>set gfxpayload=<replaceable>1024x768x32</replaceable></literal></screen>
<para>
You may replace <literal>1024</literal>, <literal>768</literal>, and
<literal>32</literal> with a resolution and color depth setting
suitable for your monitor.
</para>
<para>
If all of these DRM drivers do not work for you and you need to use
a DDX driver with a non-DRM kernel GPU driver (usually named
<option>CONFIG_FB_*</option> in the kernel configuration, or existing
as out-tree kernel modules), or you need an device specific
functionality requiring a DDX driver, consult
<ulink url="&BLFS113;">a prior version of BLFS</ulink>, or
<ulink url="&BLFS76;">an even earlier prior version</ulink> for more DDX
drivers.
</para>
<indexterm zone="xorg-server xorg-server-kernel">
<primary sortas="d-xorg-server">xorg-server</primary>
</indexterm>
</sect2>
<sect2 role="installation">
<title>Installation of Xorg Server</title>
<para>
First, if you need the TearFree option to work around screen tearing,
apply the backported patch:
</para>
<screen><userinput remap="pre">patch -Np1 -i ../xorg-server-&xorg-server-version;-tearfree_backport-1.patch</userinput></screen>
<para>
Install the server by running the following commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup .. \
--prefix=$XORG_PREFIX \
--localstatedir=/var \
-Dglamor=true \
-Dxkb_output_dir=/var/lib/xkb &amp;&amp;
ninja</userinput></screen>
<para>
To test the results, issue: <command>ninja test</command>. You
will need to run <command>ldconfig</command> as the <systemitem
class="username">root</systemitem> user first or some tests may fail.
</para>
<para>
Now as the <systemitem class="username">root</systemitem>
user:
</para>
<screen role="root"><userinput>ninja install &amp;&amp;
mkdir -pv /etc/X11/xorg.conf.d &amp;&amp;
install -v -d -m1777 /tmp/.{ICE,X11}-unix &amp;&amp;
cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
<literal>/tmp/.ICE-unix dir 1777 root root
/tmp/.X11-unix dir 1777 root root</literal>
EOF</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<parameter>-Dglamor=true</parameter>: Ensure building the Glamor
module. It's needed to build the &modesetting_drv; driver
which replaces the traditional Device Dependent X (DDX) drivers.
</para>
<para>
<option>-Dsuid_wrapper=true</option>: Builds the suid-root
wrapper for legacy DDX driver support on rootless xserver systems.
</para>
<!-- commented out because this option defaults to auto
<para>
<option>-Dsystemd_logind=false</option>:
This switch disables <phrase revision="systemd">systemd-logind</phrase>
<phrase revision="sysv">elogind</phrase> integration, allowing Xorg Server
to work without having the <phrase revision="systemd">systemd</phrase>
<phrase revision="elogind">elogind</phrase> PAM module configured.
</para>
-->
<para>
<command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
command creates the <filename class="directory">/tmp/.ICE-unix</filename>
and <filename class="directory">/tmp/.X11-unix</filename> directories at
startup, and ensures that the permissions and ownership are correct as
required by the server.
</para>
<para>
<option>-Dxephyr=true</option>: This option allows building Xephyr if its
dependencies are met.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
gtf, X, Xnest, Xorg, Xvfb, and optionally Xephyr
</seg>
<seg>
several under $XORG_PREFIX/lib/xorg/modules/ including the
&modesetting_drv; driver
</seg>
<seg>
/etc/X11/xorg.conf.d,
$XORG_PREFIX/include/xorg,
$XORG_PREFIX/lib/xorg, and
$XORG_PREFIX/share/X11/xorg.conf.d
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gtf-x7">
<term><command>gtf</command></term>
<listitem>
<para>
calculates VESA GTF mode lines
</para>
<indexterm zone="xorg-server gtf-x7">
<primary sortas="b-gtf">gtf</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="X-x7">
<term><command>X</command></term>
<listitem>
<para>
is a symbolic link to Xorg
</para>
<indexterm zone="xorg-server X-x7">
<primary sortas="b-X">X</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="Xephyr-x7">
<term><command>Xephyr</command></term>
<listitem>
<para>
is a nested X server which supports modern X extensions
</para>
<indexterm zone="xorg-server Xephyr-x7">
<primary sortas="b-Xephyr">Xephyr</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="Xnest-x7">
<term><command>Xnest</command></term>
<listitem>
<para>
is a nested X server
</para>
<indexterm zone="xorg-server Xnest-x7">
<primary sortas="b-Xnest">Xnest</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="Xorg-x7">
<term><command>Xorg</command></term>
<listitem>
<para>
is the X11R7 X Server
</para>
<indexterm zone="xorg-server Xorg-x7">
<primary sortas="b-Xorg">Xorg</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="Xvfb-x7">
<term><command>Xvfb</command></term>
<listitem>
<para>
is the virtual framebuffer X server for X Version 11
</para>
<indexterm zone="xorg-server Xvfb-x7">
<primary sortas="b-Xvfb">Xvfb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="modesetting_drv-x7">
<term><filename class="libraryfile">modesetting_drv.so</filename></term>
<listitem>
<para>
provides a video driver for machines using Kernel Mode Setting (KMS).
This will use glamor if that has been enabled and the hardware offers
acceleration
</para>
<indexterm zone="xorg-server modesetting_drv-x7">
<primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

265
shareddeps/dps/x/xterm.xml Normal file
View File

@ -0,0 +1,265 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY xterm-download-http "https://invisible-mirror.net/archives/xterm/xterm-&xterm-version;.tgz">
<!ENTITY xterm-download-ftp " ">
<!ENTITY xterm-md5sum "c3e71cfc6381d72fceb7165d324046d6">
<!ENTITY xterm-size "1.5 MB">
<!ENTITY xterm-buildsize "15 MB">
<!ENTITY xterm-time "0.2 SBU (with parallelism=4)">
]>
<sect1 id="xterm2" xreflabel="xterm-&xterm-version;">
<?dbhtml filename="xterm.html"?>
<title>xterm-&xterm-version;</title>
<indexterm zone="xterm2">
<primary sortas="a-xterm2">xterm</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to xterm</title>
<para>
<application>xterm</application> is a terminal emulator for
the X Window System.
</para>
&not-katamari;
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&xterm-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&xterm-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &xterm-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &xterm-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &xterm-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &xterm-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">xterm Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="luit"/>
</para>
<bridgehead renderas="sect4">Required (at runtime)</bridgehead>
<para role="required">
A monospace TTF or OTF font such as
<xref role="runtime" linkend="dejavu-fonts"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="emacs"/>, <!-- looks for ctags/etags -->
<xref linkend="pcre2"/>,
<xref linkend="valgrind"/> and
<ulink url="https://www.nongnu.org/man2html/">man2html</ulink>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of xterm</title>
<para>
Install <application>xterm</application> by running the
following commands:
</para>
<screen><userinput>sed -i '/v0/{n;s/new:/new:kb=^?:/}' termcap &amp;&amp;
printf '\tkbs=\\177,\n' &gt;&gt; terminfo &amp;&amp;
TERMINFO=/usr/share/terminfo \
./configure $XORG_CONFIG \
--with-app-defaults=/etc/X11/app-defaults &amp;&amp;
make</userinput></screen>
<!--
there is a 'make check' but i havn't found a description
how the output should look like
-->
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install &amp;&amp;
mkdir -pv /usr/share/applications &amp;&amp;
cp -v *.desktop /usr/share/applications/</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>sed -i ... termcap</command>,
<command>printf ... >> terminfo</command>:
These commands modify the terminal description so that the Backspace
key is expected to send the character with ASCII code 127. This is done
for consistency with the Linux console.
</para>
<para>
<envar>TERMINFO=/usr/share/terminfo</envar>: This ensures
that the <command>xterm</command> terminfo files are installed to the
system terminfo database.
</para>
<para>
<parameter>--with-app-defaults=...</parameter>: Sets the location
for the <filename class="directory">app-defaults</filename>
directory.
</para>
<!--
<para>
<command>make install-ti</command>: This command installs corrected
terminfo description files for use with
<application>xterm</application>.
</para>
-->
</sect2>
<sect2 role="configuration">
<title>Configuring xterm</title>
<para>
There are two ways to configure xterm. You can add the X resource
definitions to the user's <filename>~/.Xresources</filename> file, or
add them to the system-wide
<filename>$XORG_PREFIX/share/X11/app-defaults/Xterm</filename> file.
</para>
<para>
In order for xterm to follow the locale settings in the environment,
use TrueType fonts, and follow the Linux convention about the code sent by
the Backspace key, add the following definitions as the
<systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>cat &gt;&gt; /etc/X11/app-defaults/XTerm &lt;&lt; "EOF"
<literal>*VT100*locale: true
*VT100*faceName: Monospace
*VT100*faceSize: 10
*backarrowKeyIsErase: true
*ptyInitialErase: true</literal>
EOF</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>koi8rxterm, resize, uxterm, and xterm</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="koi8rxterm">
<term><command>koi8rxterm</command></term>
<listitem>
<para>
is a wrapper script to set up xterm with a KOI8-R locale
</para>
<indexterm zone="xterm2 koi8rxterm">
<primary sortas="b-koi8rxterm">koi8rxterm</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="resize">
<term><command>resize</command></term>
<listitem>
<para>
prints a shell command for setting the TERM and TERMCAP
environment variables to indicate the current size of xterm
window
</para>
<indexterm zone="xterm2 resize">
<primary sortas="b-resize">resize</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="uxterm">
<term><command>uxterm</command></term>
<listitem>
<para>
is a wrapper script that modifies the current locale to use
UTF-8 and starts xterm with the proper settings
</para>
<indexterm zone="xterm2 uxterm">
<primary sortas="b-uxterm">uxterm</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xterm-bin">
<term><command>xterm</command></term>
<listitem>
<para>
is a terminal emulator for the X Window System
</para>
<indexterm zone="xterm2 xterm2">
<primary sortas="b-xterm2">xterm</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -339,6 +339,14 @@ ldconfig</userinput></screen>
<sect2 role="installation">
<title>32-bit Installation of NVK</title>
<note>
<para>
NVK does not currently build with current GLFS instructions.
You can try but odds are the build will fail. The instructions
below serve as ground work.
</para>
</note>
<note>
<para>
Feel free to skip this section if you don't want to install the

View File

@ -1,11 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<sect1 role="dummy">
<title>Miscellaneous</title>
<para/>
</sect1>

View File

@ -67,6 +67,7 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/basicx/other/libunwind.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/basicx/other/nettle.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/basicx/other/gnutls.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/basicx/other/pixman.xml"/>
<!-- GRAPHICS APIS -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gfxapi/gfxapidummy.xml"/>
@ -104,11 +105,29 @@
<!-- X11 -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xdummy.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xcb-util.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xcb-util-image.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xcb-util-keysyms.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xcb-util-renderutil.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xcb-util-wm.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xcb-util-cursor.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xbitmaps.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/x7app.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/luit.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xcursor-themes.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/x7font.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xkeyboard-config.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/libepoxy.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/xorg-server.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/mtdev.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/x/x7driver.xml"/>
<!-- WAYLAND -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/wl/wldummy.xml"/>
<!-- MISC -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="misc/miscdummy.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/wl/icu.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/wl/libxml2.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/wl/wayland.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/wl/wayland-protocols.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dps/wl/xwayland.xml"/>
</chapter>

View File

@ -3,16 +3,186 @@
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY steam-download-http "https://repo.steampowered.com/steam/pool/steam/s/steam/steam_&steam-version;.tar.gz">
<!ENTITY steam-download-ftp " ">
<!ENTITY steam-md5sum "7caaae2f5a4942340a585e6b9d18bc2b">
<!ENTITY steam-size "3.8 MB">
<!ENTITY steam-buildsize "4 MB">
]>
<sect1 id="steam" xreflabel="Steam">
<sect1 id="steam" xreflabel="Steam-&steam-version;">
<?dbhtml filename="steam.html"?>
<title>Steam</title>
<title>Steam-&steam-version;</title>
<para>
a
</para>
<indexterm zone="steam">
<primary sortas="a-steam">steam</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Steam</title>
<para>
Steam.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&steam-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&steam-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &steam-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &steam-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &steam-buildsize;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Steam Dependencies</bridgehead>
<para>
<xref linkend="steamdeps"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of Steam</title>
<para>
First make a file empty as it does nothing on an LFS system besides
give a passive error:
</para>
<screen><userinput>ln -sf /usr/bin/true steamdeps</userinput></screen>
<para>
Install <application>Steam</application> by running
the following command as the <systemitem class="username">root
</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>ln -sf /usr/bin/true steamdeps</command>: This command
makes the <filename>steamdeps</filename> <application>Python
</application> script blank as it uses APT and its <application>
Python</application> module, which isn't installed in LFS and
probably shouldn't be.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
bin_steam.sh, bin_steamdeps.sh, steam, steamdeps
</seg>
<seg>
None
</seg>
<seg>
/usr/lib/steam and
/usr/share/doc/steam
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bin_steam.sh">
<term><command>bin_steam.sh</command></term>
<listitem>
<para>
is launcher shell script which does many things, including
downloading the <application>Steam</application> runtime
</para>
<indexterm zone="steam bin_steam.sh">
<primary sortas="c-bin_steam.sh">bin_steam.sh</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="bin_steamdeps.sh">
<term><command>bin_steamdeps.sh</command></term>
<listitem>
<para>
is a <application>Python</application> script which checks
for dependencies using APT
</para>
<indexterm zone="steam bin_steamdeps.sh">
<primary sortas="c-bin_steamdeps.sh">bin_steamdeps.sh</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="steam-bin">
<term><command>steam</command></term>
<listitem>
<para>
is a symlink to <command>bin_steam.sh</command>
</para>
<indexterm zone="steam steam-bin">
<primary sortas="c-steam-bin">steam</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="steam-steamdeps">
<term><command>steamdeps</command></term>
<listitem>
<para>
is symlink to <filename>/usr/bin/true</filename>, making the file
basically empty
</para>
<indexterm zone="steam steam-steamdeps">
<primary sortas="c-steam-steamdeps">steamdeps</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -30,7 +30,8 @@
<xref linkend="alsa-plugins"/>,
<xref linkend="curl"/>,
<xref linkend="dbus"/>,
Display server (X11 or Wayland w/ xwayland),
Display server (<xref linkend="xorg-server"/> or
<xref linkend="wayland"/> w/ <xref linkend="xwayland"/>),
<xref linkend="libglvnd"/> (32-bit is required for multilib),
<xref linkend="make-ca"/>,
<xref linkend="mesa"/> w/ the <parameter>--with-libglvnd

View File

@ -0,0 +1,268 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY libxkbcommon-download-http "https://xkbcommon.org/download/libxkbcommon-&libxkbcommon-version;.tar.xz">
<!ENTITY libxkbcommon-download-ftp " ">
<!ENTITY libxkbcommon-md5sum "b05b1a0d473189efb2dd995dd944f152">
<!ENTITY libxkbcommon-size "524 KB">
<!ENTITY libxkbcommon-buildsize "26 MB (with tests)">
<!ENTITY libxkbcommon-time "0.5 SBU (with tests)">
]>
<sect1 id="libxkbcommon" xreflabel="libxkbcommon-&libxkbcommon-version;">
<?dbhtml filename="libxkbcommon.html"?>
<title>libxkbcommon-&libxkbcommon-version;</title>
<indexterm zone="libxkbcommon">
<primary sortas="a-libxkbcommon">libxkbcommon</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to libxkbcommon</title>
<para>
<application>libxkbcommon</application> is a keymap compiler and
support library which processes a reduced subset of keymaps as
defined by the XKB specification.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&libxkbcommon-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&libxkbcommon-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &libxkbcommon-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &libxkbcommon-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &libxkbcommon-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &libxkbcommon-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">libxkbcommon Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref role="runtime" linkend="xkeyboard-config"/> (runtime)
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="libxcb"/>,
<xref linkend="wayland"/>, and
<xref linkend="wayland-protocols"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<command>Xvfb</command> from
<xref linkend='xorg-server'/> or
<xref role='nodep' linkend='xwayland'/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of libxkbcommon</title>
<para>
Install <application>libxkbcommon</application> by running the following
commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson setup .. \
--prefix=/usr \
--buildtype=release \
-Denable-docs=false &amp;&amp;
ninja</userinput></screen>
<para>
To test the results, ensure <command>Xvfb</command> and
<xref linkend='xkeyboard-config'/> are available, then issue:
<command>ninja test</command>.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
</sect2>
<sect2 role="installation">
<title>Installation of libxkbcommon</title>
<para>
First clean the build directory:
</para>
<screen><userinput>rm -rf *</userinput></screen>
<para>
Install lib32-<application>libxkbcommon</application> by running the following
commands:
</para>
<screen><userinput>CC="gcc -m32" CXX="g++ -m32" \
PKG_CONFIG_PATH=/usr/lib32/pkgconfig \
meson setup .. \
--prefix=/usr \
--libdir=/usr/lib32 \
--buildtype=release \
-Denable-docs=false &amp;&amp;
ninja</userinput></screen>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>DESTDIR=$PWD/DESTDIR ninja install
cp -vr DESTDIR/usr/lib32/* /usr/lib32
rm -rf DESTDIR
ldconfig</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../xincludes/meson-buildtype-release.xml"/>
<!--
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/static-libraries.xml"/>
<para>
<option>- -disable-x11</option>: Use this switch if you
have not installed <xref linkend="libxcb"/> and
don't need the <filename>libxkbcommon-x11.so</filename>
library.
</para>
-->
<para>
<command>mv -v /usr/share/doc/libxkbcommon{,-&libxkbcommon-version;}</command>:
If you built the documentation, use this command to install the
it in a versioned directory.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
xkbcli
</seg>
<seg>
libxkbcommon.so,
libxkbcommon-x11.so, and
libxkbregistry.so
</seg>
<seg>
/usr/include/xkbcommon,
/usr/libexec/xkbcommon, and
/usr/share/doc/libxkbcommon-&libxkbcommon-version;
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="xkbcli">
<term><command>xkbcli</command></term>
<listitem>
<para>
provides a debugger and compiler for XKB keymaps
</para>
<indexterm zone="libxkbcommon xkbcli">
<primary sortas="b-xkbcli">xkbcli</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libxkbcommon-lib">
<term><filename class="libraryfile">libxkbcommon.so</filename></term>
<listitem>
<para>
contains the <application>libxkbcommon</application> API functions
</para>
<indexterm zone="libxkbcommon libxkbcommon-lib">
<primary sortas="c-libxkbcommon">libxkbcommon.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libxkbcommon-x11">
<term><filename class="libraryfile">libxkbcommon-x11.so</filename></term>
<listitem>
<para>
contains the <application>libxkbcommon</application> X11 specific API
functions
</para>
<indexterm zone="libxkbcommon libxkbcommon-x11">
<primary sortas="c-libxkbcommon-x11">libxkbcommon-x11.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libxkbregistry">
<term><filename class="libraryfile">libxkbregistry.so</filename></term>
<listitem>
<para>
contains a list of available XKB models, layouts, and variants for a
given ruleset
</para>
<indexterm zone="libxkbcommon libxkbregistry">
<primary sortas="c-libxkbregistry">libxkbregistry.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

312
wine/deps/misc/sdl2.xml Normal file
View File

@ -0,0 +1,312 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../../general.ent">
%general-entities;
<!ENTITY sdl2-download-http "https://www.libsdl.org/release/SDL2-&sdl2-version;.tar.gz">
<!ENTITY sdl2-download-ftp " ">
<!ENTITY sdl2-md5sum "a28514e50ef4bb5cc2e1e8c70553425d">
<!ENTITY sdl2-size "7.1 MB">
<!ENTITY sdl2-buildsize "155 MB (with docs)">
<!ENTITY sdl2-time "0.6 SBU (using parallelism=4; with docs)">
]>
<sect1 id="sdl2" xreflabel="SDL2-&sdl2-version;">
<?dbhtml filename="sdl2.html"?>
<title>SDL2-&sdl2-version;</title>
<indexterm zone="sdl2">
<primary sortas="a-SDL2">SDL2</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to SDL2</title>
<para>
The Simple DirectMedia Layer Version 2 (<application>SDL2</application>
for short) is a cross-platform library designed to make it easy to write
multimedia software, such as games and emulators.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&sdl2-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&sdl2-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &sdl2-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &sdl2-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &sdl2-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &sdl2-time;
</para>
</listitem>
</itemizedlist>
<!--
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Required patch (for i686 systems):
<ulink url="&patch-root;/SDL2-&sdl2-version;-opengl_include_fix-1.patch"/>
</para>
</listitem>
</itemizedlist>
-->
<bridgehead renderas="sect3">SDL2 Dependencies</bridgehead>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="libxkbcommon"/>,
<xref linkend="wayland-protocols"/>, and
<xref linkend="xorg7-lib"/> (if those are not present, the corresponding modules are not built)
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="alsa-lib"/>,
ibus,
libsamplerate,
nasm,
pipewire,
<xref linkend="pulseaudio"/>,
a window manager or desktop environment,
<ulink url="https://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>,
<ulink url="https://fcitx-im.org/">fcitx</ulink>,
<ulink url="https://jackaudio.org/">jack</ulink>, and
<ulink url="https://sndio.org/">sndio</ulink>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of SDL2</title>
<!--
<para>
First, fix an overly restrictive build option:
</para>
<screen><userinput remap="pre">sed -i "s/-Werror=declaration-after-statement//" configure</userinput></screen>
-->
<para>
Install <application>SDL2</application> by running the
following commands:
</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>
If you have doxygen installed and want to build the
html documentation, run the following commands:
</para>
<screen remap="doc"><userinput>pushd docs &amp;&amp;
doxygen &amp;&amp;
popd</userinput></screen>
<note>
<para>
If you wish to build and run the package regression
tests, do not delete the static libraries below until after
the tests are built.
</para>
</note>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install &amp;&amp;
rm -v /usr/lib/libSDL2*.a</userinput></screen>
<para>
If you built the documentation, install it as the <systemitem
class="username">root</systemitem> user:
</para>
<screen role="root"
remap="doc"><userinput>install -v -m755 -d /usr/share/doc/SDL2-&sdl2-version;/html &amp;&amp;
cp -Rv docs/output/html/* /usr/share/doc/SDL2-&sdl2-version;/html</userinput></screen>
</sect2>
<sect2 role="installation">
<title>32-bit Installation of SDL2</title>
<para>
First clean the directory:
</para>
<screen><userinput>make distclean</userinput></screen>
<para>
Install lib32-<application>SDL2</application> by running the
following commands:
</para>
<screen><userinput>CC="gcc -m32" CXX="g++ -m32" \
PKG_CONFIG_PATH=/usr/lib32/pkgconfig \
./configure --prefix=/usr \
--libdir=/usr/lib32 \
--host=i686-pc-linux-gnu &amp;&amp;
make</userinput></screen>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput> make DESTDIR=$PWD/DESTDIR install
rm -v DESTDIR/usr/lib32/libSDL2*.a
cp -vr DESTDIR/usr/lib32/* /usr/lib32
rm -rf DESTDIR
ldconfig</userinput></screen>
</sect2>
<sect2 role="testing">
<title>Testing SDL2</title>
<para>
If you wish to, test the installation of <application>SDL2</application>
using the included test programs. None of the resulting binaries need
to be installed. Issue the following commands to build the test
programs:
</para>
<screen><userinput>cd test &amp;&amp;
./configure &amp;&amp;
make</userinput></screen>
<para>
Each of the test programs (they are listed in the
<filename>README</filename> file in this directory) will need to be run
individually. Many of them will need to be manually killed. Additionally,
speakers need to be on with the volume at a suitable level.
</para>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>rm -v /usr/lib/libSDL2*.a</command>: Normally
static libraries can be disabled with a <option>--disable-static</option>
option to configure, but that breaks the build in this package.
</para>
<para>
<option>--disable-alsa-shared</option>: This switch disables
dynamically loading ALSA shared libraries.
</para>
<para>
<option>--disable-sdl-dlopen</option>: This switch disables using
dlopen for shared object loading. Loading image backend libraries like
libpng dynamically on the fly does not work.
</para>
<para>
<option>--disable-x11-shared</option>: This switch disables
dynamically loading X11 shared libraries.
</para>
</sect2>
<sect2 role="configuration">
<title>Configuring SDL2</title>
<sect3>
<title>Configuration Information</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../../xincludes/lib-config.xml"/>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>sdl2-config</seg>
<seg>libSDL2.so</seg>
<seg>/usr/include/SDL2,
/usr/lib/cmake/SDL2, and
/usr/share/doc/SDL-&sdl2-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="sdl2-config">
<term><command>sdl2-config</command></term>
<listitem>
<para>
determines the compile and linker flags that should be used to
compile and link programs that use
<filename class="libraryfile">libSDL2</filename>
</para>
<indexterm zone="sdl2 sdl2-config">
<primary sortas="b-sdl2-config">sdl2-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libsdl2">
<term><filename class="libraryfile">libSDL2.so</filename></term>
<listitem>
<para>
contains functions that provide low level access to audio,
keyboard, mouse, joystick, 3D hardware via OpenGL, and
2D frame buffer across multiple platforms
</para>
<indexterm zone="sdl2 libsdl2">
<primary sortas="c-libsdl2">libSDL2.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -55,7 +55,9 @@
<para>
Audio (<xref linkend="alsa-plugins"/> and/or
<xref linkend="pulseaudio"/>), <xref linkend="dbus"/>,
Display server (X11 or Wayland w/ xwayland), <xref linkend="fontconfig"/>,
Display server (<xref linkend="xorg-server"/> or
<xref linkend="wayland"/> w/ <xref linkend="xwayland"/>),
<xref linkend="fontconfig"/>,
<xref linkend="freetype2-pass2"/>, <xref linkend="gnat"/>,
<xref linkend="gnutls"/>,
<xref linkend="libunwind"/> (if 64-bit),
@ -76,7 +78,7 @@
<title>Recommended</title>
<para>
GStreamer, SDL2, and <xref linkend="libvk"/>
GStreamer, <xref linkend="sdl2"/>, and <xref linkend="libvk"/>
</para>
</sect2>

View File

@ -28,6 +28,8 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="deps/tc/mingw-w64-winpthreads.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="deps/tc/mingw-w64-crt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="deps/tc/mingw-w64-gcc.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="deps/misc/libxkbcommon.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="deps/misc/sdl2.xml"/>
<!-- WINE -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="wine/wine.xml"/>