source: x/installing/libinput.xml@ d5aefd5c

10.0 10.1 11.0 11.1 11.2 11.3 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/inkscape-core-mods lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since d5aefd5c was d5aefd5c, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to xinit-1.4.0 and 12 Xorg apps.
Update to twm-1.0.10.
Update to libinput-1.10.2.
Update to libevdev-1.5.9.
Update to harfbuzz-1.7.6.

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

  • Property mode set to 100644
File size: 9.4 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 libinput-version "1.10.2">
8
9 <!ENTITY libinput-download-http "https://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz">
10 <!ENTITY libinput-download-ftp " ">
11 <!ENTITY libinput-md5sum "f188d826de5b958cc561eec2b0c3d254">
12 <!ENTITY libinput-size "484 KB">
13 <!ENTITY libinput-buildsize "8.2 MB">
14 <!ENTITY libinput-time "less than 0.1 SBU">
15]>
16
17<sect2 id="libinput" xreflabel="libinput-&libinput-version;">
18 <?dbhtml filename="libinput.html"?>
19
20 <sect2info>
21 <othername>$LastChangedBy: renodr $</othername>
22 <date>$Date: 2015-09-14 17:42:53 -0500 (Mon, 14 Sep 2015) $</date>
23 </sect2info>
24
25 <title>libinput-&libinput-version;</title>
26
27 <indexterm zone="libinput">
28 <primary sortas="a-libinput">libinput</primary>
29 </indexterm>
30
31 <sect3 role="package">
32 <title>Introduction to libinput</title>
33
34 <para>
35 <application>libinput</application> is a library that handles
36 input devices for display servers and other applications that
37 need to directly deal with input devices.
38 </para>
39
40 &lfs82_checked;
41
42 <bridgehead renderas="sect4">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&libinput-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&libinput-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &libinput-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &libinput-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &libinput-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &libinput-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect4">libinput Dependencies</bridgehead>
77
78 <bridgehead renderas="sect5">Required</bridgehead>
79 <para role="required">
80 <xref linkend="libevdev"/> and
81 <xref linkend="mtdev"/>
82 </para>
83
84 <bridgehead renderas="sect5">Optional</bridgehead>
85 <para role="optional">
86 <xref linkend="valgrind"/> (to run the tests),
87 <xref linkend="doxygen"/> and
88 <xref linkend="graphviz"/> (to build the documentation)
89 <xref linkend="gtk3"/> (to build the GUI event viewer),
90 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink> (required for tests), and
91 <ulink revision="sysv" url="https://sourceforge.net/projects/linuxwacom/files/libwacom/">libwacom</ulink>
92 <xref revision="systemd" linkend="libwacom"/>
93 </para>
94
95 <para condition="html" role="usernotes">
96 User Notes: <ulink url="&blfs-wiki;/libinput"/>
97 </para>
98 </sect3>
99
100 <sect3 role="installation">
101 <title>Installation of libinput</title>
102
103 <para>
104 Install <application>libinput</application> by running the following
105 commands:
106 </para>
107
108<screen><userinput>mkdir build &amp;&amp;
109cd build &amp;&amp;
110
111meson --prefix=$XORG_PREFIX \
112 -Dudev-dir=/lib/udev \
113 -Ddebug-gui=false \
114 -Dtests=false \
115 -Ddocumentation=false \
116 -Dlibwacom=false \
117 .. &amp;&amp;
118ninja</userinput></screen>
119
120<!--
121 <note>
122 <para>If you want to run the tests, remove -Dtests from the
123 <command>meson</command> command above. The external
124 library, libunwind, must be installed.</para>
125
126 <para> To run the tests for this package, valgrind requires a version of
127 the /lib/ld-2.23.so (or later) library with debugging symbols present.
128 Normally in LFS these debugging symbols are stripped at the end of
129 Chapter 6. To get this library, glibc must be rebuilt with the current
130 glibc version using the same compiler that was used to build LFS. The
131 ld-2.23.so can then be renamed to ld-2.23.so.dbg and copied to /lib.
132 Then a symlink needs to be changed:</para>
133
134 <screen role="nodump"><userinput>ln -sfv ld-2.23.so.dbg /lib/ld-linux-x86-64.so.2</userinput></screen>
135
136 <para>Adjust the above instruction as needed for a 32-bit system
137 or for a different version of glibc</para>
138
139 </note>
140
141 <para>
142 Running the testsuite for this package can cause problems.
143 It creates a number of dummy input devices on the currently
144 running system that can lead to crashing a local X server or
145 a desktop environment. If you understand the risks and have
146 the optional <xref linkend="check"/> and
147 <xref linkend="valgrind"/> packages installed, the regression
148 tests can be run as the <systemitem
149 class="username">root</systemitem> user with
150 <userinput>ninja test</userinput>. Note that depending on
151 the system configuration and hardware, some tests may fail.
152 </para>
153-->
154 <para>
155 This package does not currently have a functioning test suite.
156 </para>
157
158 <para>
159 Now, as the <systemitem class="username">root</systemitem> user:
160 </para>
161
162<screen role="root"><userinput>ninja install</userinput></screen>
163
164 <para>
165 If <xref linkend="doxygen"/> and <xref linkend="graphviz"/> were
166 present during the build, you can install the generated documentation
167 by running the following commands as the <systemitem
168 class="username">root</systemitem> user:
169 </para>
170
171<screen role="root"><userinput>install -v -dm755 /usr/share/doc/libinput-&libinput-version; &amp;&amp;
172cp -rv html/* /usr/share/doc/libinput-&libinput-version;</userinput></screen>
173
174 </sect3>
175
176 <sect3 role="commands">
177 <title>Command Explanations</title>
178
179 <para>
180 <option>-Dudev-dir=/lib/udev</option>: This switch
181 specifies where UDev rules and hwdb files will be installed.
182 </para>
183
184 <para>
185 <option>-Ddebug-gui=false</option>: This switch
186 disables creation of a visual debug helper for libinput. Remove
187 if you want it, and you have <xref linkend="gtk3"/> installed.
188 </para>
189
190 <para>
191 <option>-Dtests=false</option>: This switch disables compilation
192 of tests. Remove if you want to run the tests, and you have the external
193 libraries, libunwind and libwacom, installed.
194 </para>
195
196 <para>
197 <option>-Ddocumentation=false</option>: This switch disables
198 generation of the documentation. Remove if you want to generate it, and
199 you have <xref linkend="doxygen"/> and <xref linkend="graphviz"/>
200 installed.
201 </para>
202
203 <para>
204 <option>-Dlibwacom=false</option>: Remove this
205 option if you have the external library libwacom installed.
206 </para>
207
208 </sect3>
209
210 <sect3 role="content">
211 <title>Contents</title>
212
213 <segmentedlist>
214 <segtitle>Installed Programs</segtitle>
215 <segtitle>Installed Libraries</segtitle>
216 <segtitle>Installed Directories</segtitle>
217
218 <seglistitem>
219 <seg>
220 libinput,
221 libinput-debug-events, and
222 libinput-list-devices
223 </seg>
224 <seg>
225 libinput.so
226 </seg>
227 <seg>
228 $XORG_PREFIX/libexec/libinput and (optional)
229 /usr/share/doc/libinput-&libinput-version;
230 </seg>
231 </seglistitem>
232 </segmentedlist>
233
234 <variablelist>
235 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
236 <?dbfo list-presentation="list"?>
237 <?dbhtml list-presentation="table"?>
238
239 <varlistentry id="libinput-prog">
240 <term><command>libinput</command></term>
241 <listitem>
242 <para>
243 is a set of tools to interface with the
244 <application>libinput</application> library.
245 </para>
246 <indexterm zone="libinput libinput-prog">
247 <primary sortas="b-libinput-prog">libinput</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="libinput-debug-events">
253 <term><command>libinput-debug-events</command></term>
254 <listitem>
255 <para>
256 is a debug helper for <application>libinput</application>.
257 </para>
258 <indexterm zone="libinput libinput-debug-events">
259 <primary sortas="b-libinput-debug-events">libinput-debug-events</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="libinput-list-devices">
265 <term><command>libinput-list-devices</command></term>
266 <listitem>
267 <para>
268 lists local devices as recognized by
269 <application>libinput</application>.
270 </para>
271 <indexterm zone="libinput libinput-list-devices">
272 <primary sortas="b-libinput-list-devices">libinput-list-devices</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 <varlistentry id="libinput-lib">
278 <term><filename class="libraryfile">libinput.so</filename></term>
279 <listitem>
280 <para>
281 contains API functions for handling input devices.
282 </para>
283 <indexterm zone="libinput libinput-lib">
284 <primary sortas="c-libinput-lib">libinput.so</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 </variablelist>
290
291 </sect3>
292
293</sect2>
Note: See TracBrowser for help on using the repository browser.