source: x/installing/libxcb.xml@ bb7f58e

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since bb7f58e was bb7f58e, checked in by Krejzi <krejzi@…>, 9 years ago

Xorg packages and xml updates.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10911 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 5.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY libxcb-download-http "http://xcb.freedesktop.org/dist/libxcb-&libxcb-version;.tar.bz2">
8 <!ENTITY libxcb-download-ftp " ">
9 <!ENTITY libxcb-md5sum "2b05856e9d1cb37836aae7406f2f4ce2">
10 <!ENTITY libxcb-size "380 KB">
11 <!ENTITY libxcb-buildsize "40 MB">
12 <!ENTITY libxcb-time "0.3 SBU">
13]>
14
15<sect1 id="libxcb" xreflabel="libxcb-&libxcb-version;">
16 <?dbhtml filename="libxcb.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>libxcb-&libxcb-version;</title>
24
25 <indexterm zone="libxcb">
26 <primary sortas="a-libxcb">libxcb</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to libxcb</title>
31
32 <para>The <application>libxcb</application> package provides an interface
33 to the X Window System protocol, which replaces the current Xlib interface.
34 Xlib can also use XCB as a transport layer, allowing software to make
35 requests and receive responses with both.</para>
36
37 &lfs72_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download (HTTP): <ulink url="&libxcb-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&libxcb-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &libxcb-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size: &libxcb-size;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated disk space required: &libxcb-buildsize;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated build time: &libxcb-time;</para>
58 </listitem>
59 </itemizedlist>
60
61 <bridgehead renderas="sect3">libxcb Dependencies</bridgehead>
62
63 <bridgehead renderas="sect4">Required</bridgehead>
64 <para role="required">
65 <xref linkend="libXau"/>,
66 <xref linkend="libXdmcp"/>,
67 <xref linkend="libpthread-stubs"/>,
68 <xref linkend="libxslt"/>, and
69 <xref linkend="xcb-proto"/>
70 </para>
71
72 <bridgehead renderas="sect4">Optional</bridgehead>
73 <para role="optional">
74 <xref linkend="doxygen"/> (to generate API documentation) and
75 <xref linkend="check"/> (to run tests)
76 </para>
77
78 <para condition="html" role="usernotes">User Notes:
79 <ulink url="&blfs-wiki;/libxcb"/></para>
80
81 </sect2>
82
83 <sect2 role="installation">
84 <title>Installation of libxcb</title>
85
86 <para>Install <application>libxcb</application> by running the following
87 commands:</para>
88
89<screen><userinput>./configure $XORG_CONFIG --enable-xinput --docdir='${datadir}'/doc/libxcb-&libxcb-version; &amp;&amp;
90make</userinput></screen>
91
92 <para>To test the results, issue: <command>make check</command>.</para>
93
94 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
95
96<screen role="root"><userinput>make install</userinput></screen>
97
98 </sect2>
99
100 <sect2 role="commands">
101 <title>Command Explanations</title>
102
103 <para><option>--enable-xinput</option>: This switch enables XCB Xinput
104 extension.</para>
105
106 <para><parameter>--docdir='${datadir}'/doc/libxcb-&libxcb-version;</parameter>:
107 This parameter ensures the <application>libxcb</application> documentation
108 is installed to a versioned directory.</para>
109
110 <para><parameter>--without-doxygen</parameter>: This switch can be used
111 to disable the API documentation if <xref linkend="doxygen"/> is
112 installed.</para>
113
114 </sect2>
115<!--
116 <sect2 role="configuration">
117 <title>Configuring libxcb</title>
118
119 <sect3 id="libxcb-config">
120 <title>Configuration Information</title>
121
122 <para>The <application>libxcb</application> developers have decided
123 to be strict in asserting locking bugs in X11 applications. This is
124 different than the behavior of <application>libX11</application> when
125 used on its own, and it will cause some applications to crash when
126 they previously did not. When an application has these types of bugs,
127 it will crash with the following assertion:</para>
128
129<screen><literal>xcb_xlib_lock: Assertion `!c->xlib.lock' failed.</literal></screen>
130
131 <para>An environment variable, <envar>LIBXCB_ALLOW_SLOPPY_LOCK</envar>,
132 can be set which will allow the locking bugs to not crash the
133 application. It is a workaround that is known to be needed in a few
134 cases. If it is found that these bugs affect an application in use, add
135 the following to your system or personal profile:</para>
136
137<screen><literal>export LIBXCB_ALLOW_SLOPPY_LOCK=1</literal></screen>
138
139 </sect3>
140
141 </sect2>
142-->
143 <sect2 role="content">
144 <title>Contents</title>
145
146 <segmentedlist>
147 <segtitle>Installed Programs</segtitle>
148 <segtitle>Installed Libraries</segtitle>
149 <segtitle>Installed Directories</segtitle>
150
151 <seglistitem>
152 <seg>None</seg>
153 <seg>libxcb.so and libxcb-*.so</seg>
154 <seg><envar>$XORG_PREFIX</envar>/include/xcb and
155 <envar>$XORG_PREFIX</envar>/share/doc/libxcb-&libxcb-version;</seg>
156 </seglistitem>
157 </segmentedlist>
158
159 <variablelist>
160 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
161 <?dbfo list-presentation="list"?>
162 <?dbhtml list-presentation="table"?>
163
164 <varlistentry id="libxcb-lib">
165 <term><filename class="libraryfile">libxcb.so</filename></term>
166 <listitem>
167 <para>is an interface to the X Window System protocol.</para>
168 <indexterm zone="libxcb libxcb-lib">
169 <primary sortas="c-libxcb">libxcb.so</primary>
170 </indexterm>
171 </listitem>
172 </varlistentry>
173
174 </variablelist>
175
176 </sect2>
177
178</sect1>
Note: See TracBrowser for help on using the repository browser.