source: x/installing/libinput.xml@ 6961e42

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

Remove old text about symlinking a dbg version of ld: for any LFS build from the last fourteen months that will make the system both unusable and unbootable.

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

  • Property mode set to 100644
File size: 8.6 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.7">
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 "4369212564f8359f48c8f683c8c829b5">
12 <!ENTITY libinput-size "484 KB">
13 <!ENTITY libinput-buildsize "8.3 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 </note>
127
128 <para>
129 Running the testsuite for this package can cause problems.
130 It creates a number of dummy input devices on the currently
131 running system that can lead to crashing a local X server or
132 a desktop environment. If you understand the risks and have
133 the optional <xref linkend="check"/> and
134 <xref linkend="valgrind"/> packages installed, the regression
135 tests can be run as the <systemitem
136 class="username">root</systemitem> user with
137 <userinput>ninja test</userinput>. Note that depending on
138 the system configuration and hardware, some tests may fail.
139 </para>
140-->
141 <para>
142 This package does not currently have a functioning test suite.
143 </para>
144
145 <para>
146 Now, as the <systemitem class="username">root</systemitem> user:
147 </para>
148
149<screen role="root"><userinput>ninja install</userinput></screen>
150
151 <para>
152 If <xref linkend="doxygen"/> and <xref linkend="graphviz"/> were
153 present during the build, you can install the generated documentation
154 by running the following commands as the <systemitem
155 class="username">root</systemitem> user:
156 </para>
157
158<screen role="root"><userinput>install -v -dm755 /usr/share/doc/libinput-&libinput-version; &amp;&amp;
159cp -rv html/* /usr/share/doc/libinput-&libinput-version;</userinput></screen>
160
161 </sect3>
162
163 <sect3 role="commands">
164 <title>Command Explanations</title>
165
166 <para>
167 <option>-Dudev-dir=/lib/udev</option>: This switch
168 specifies where UDev rules and hwdb files will be installed.
169 </para>
170
171 <para>
172 <option>-Ddebug-gui=false</option>: This switch
173 disables creation of a visual debug helper for libinput. Remove
174 if you want it, and you have <xref linkend="gtk3"/> installed.
175 </para>
176
177 <para>
178 <option>-Dtests=false</option>: This switch disables compilation
179 of tests. Remove if you want to run the tests, and you have the external
180 libraries, libunwind and libwacom, installed.
181 </para>
182
183 <para>
184 <option>-Ddocumentation=false</option>: This switch disables
185 generation of the documentation. Remove if you want to generate it, and
186 you have <xref linkend="doxygen"/> and <xref linkend="graphviz"/>
187 installed.
188 </para>
189
190 <para>
191 <option>-Dlibwacom=false</option>: Remove this
192 option if you have the external library libwacom installed.
193 </para>
194
195 </sect3>
196
197 <sect3 role="content">
198 <title>Contents</title>
199
200 <segmentedlist>
201 <segtitle>Installed Programs</segtitle>
202 <segtitle>Installed Libraries</segtitle>
203 <segtitle>Installed Directories</segtitle>
204
205 <seglistitem>
206 <seg>
207 libinput,
208 libinput-debug-events, and
209 libinput-list-devices
210 </seg>
211 <seg>
212 libinput.so
213 </seg>
214 <seg>
215 $XORG_PREFIX/libexec/libinput and (optional)
216 /usr/share/doc/libinput-&libinput-version;
217 </seg>
218 </seglistitem>
219 </segmentedlist>
220
221 <variablelist>
222 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
223 <?dbfo list-presentation="list"?>
224 <?dbhtml list-presentation="table"?>
225
226 <varlistentry id="libinput-prog">
227 <term><command>libinput</command></term>
228 <listitem>
229 <para>
230 is a set of tools to interface with the
231 <application>libinput</application> library.
232 </para>
233 <indexterm zone="libinput libinput-prog">
234 <primary sortas="b-libinput-prog">libinput</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="libinput-debug-events">
240 <term><command>libinput-debug-events</command></term>
241 <listitem>
242 <para>
243 is a debug helper for <application>libinput</application>.
244 </para>
245 <indexterm zone="libinput libinput-debug-events">
246 <primary sortas="b-libinput-debug-events">libinput-debug-events</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="libinput-list-devices">
252 <term><command>libinput-list-devices</command></term>
253 <listitem>
254 <para>
255 lists local devices as recognized by
256 <application>libinput</application>.
257 </para>
258 <indexterm zone="libinput libinput-list-devices">
259 <primary sortas="b-libinput-list-devices">libinput-list-devices</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="libinput-lib">
265 <term><filename class="libraryfile">libinput.so</filename></term>
266 <listitem>
267 <para>
268 contains API functions for handling input devices.
269 </para>
270 <indexterm zone="libinput libinput-lib">
271 <primary sortas="c-libinput-lib">libinput.so</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 </variablelist>
277
278 </sect3>
279
280</sect2>
Note: See TracBrowser for help on using the repository browser.