source: x/installing/libinput.xml@ 054cfee

10.0 10.1 11.0 11.1 11.2 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 054cfee was 054cfee, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to bluez-5.40.
Update to libinput-1.3.1.

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

  • Property mode set to 100644
File size: 7.0 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.3.0">
8
9 <!ENTITY libinput-download-http "http://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz">
10 <!ENTITY libinput-download-ftp " ">
11 <!ENTITY libinput-md5sum "458fc483f7227d3c4c330f4abd6dfa77">
12 <!ENTITY libinput-size "860 KB">
13 <!ENTITY libinput-buildsize "32 MB">
14 <!ENTITY libinput-time "0.3 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 &lfs79_checked;
41 &gcc6_checked;
42
43 <bridgehead renderas="sect4">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&libinput-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&libinput-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &libinput-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &libinput-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &libinput-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &libinput-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect4">libinput Dependencies</bridgehead>
78
79 <bridgehead renderas="sect5">Required</bridgehead>
80 <para role="required">
81 <xref linkend="libevdev"/> and
82 <xref linkend="mtdev"/>
83 </para>
84
85 <bridgehead renderas="sect5">Optional</bridgehead>
86 <para role="optional">
87 <xref linkend="check"/> and
88 <xref linkend="valgrind"/> (to build the tests),
89 <xref linkend="doxygen"/> and
90 <xref linkend="graphviz"/> (to build the documentation)
91 <xref linkend="gtk3"/> (to build the GUI event viewer),
92 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>, and
93 <ulink url="https://sourceforge.net/projects/linuxwacom/files/libwacom/">libwacom</ulink>
94 </para>
95
96 <para condition="html" role="usernotes">
97 User Notes: <ulink url="&blfs-wiki;/libinput"/>
98 </para>
99 </sect3>
100
101 <sect3 role="installation">
102 <title>Installation of libinput</title>
103
104 <para>
105 Install <application>libinput</application> by running the following
106 commands:
107 </para>
108
109<screen><userinput>./configure $XORG_CONFIG \
110 --disable-libwacom \
111 --with-udev-dir=/lib/udev &amp;&amp;
112make</userinput></screen>
113
114 <para>
115 Running the testsuite for this package can be dangerous, as
116 it creates a number of dummy input devices on the currently
117 running system that can lead to crashing a local X server or
118 a desktop environment. If you understand the risks and have
119 the optional <xref linkend="check"/> and
120 <xref linkend="valgrind"/> packages installed, the regression
121 tests can be run as the <systemitem
122 class="username">root</systemitem> user with
123 <userinput>make check</userinput>. Note that depending on
124 the system configuration and hardware, some tests may fail.
125 </para>
126
127 <para>
128 Now, as the <systemitem class="username">root</systemitem> user:
129 </para>
130
131<screen role="root"><userinput>make install</userinput></screen>
132
133 <para>
134 If <xref linkend="doxygen"/> and <xref linkend="graphviz"/> were
135 present during the build, you can install the generated documentation
136 by running the following commands as the <systemitem
137 class="username">root</systemitem> user:
138 </para>
139
140<screen role="root"><userinput>install -v -dm755 $XORG_PREFIX/share/doc/libinput-&libinput-version; &amp;&amp;
141cp -rv doc/html/* $XORG_PREFIX/share/doc/libinput-&libinput-version;</userinput></screen>
142
143 </sect3>
144
145 <sect3 role="commands">
146 <title>Command Explanations</title>
147
148 <para>
149 <parameter>--disable-libwacom</parameter>: Remove this
150 option if you have the external library libwacom installed.
151 </para>
152
153 <para>
154 <parameter>--with-udev-dir=/lib/udev</parameter>: This switch
155 specifies where UDev rules and hwdb files will be installed.
156 </para>
157
158 </sect3>
159
160 <sect3 role="content">
161 <title>Contents</title>
162
163 <segmentedlist>
164 <segtitle>Installed Programs</segtitle>
165 <segtitle>Installed Libraries</segtitle>
166 <segtitle>Installed Directories</segtitle>
167
168 <seglistitem>
169 <seg>
170 libinput-debug-events and libinput-list-devices
171 </seg>
172 <seg>
173 libinput.so
174 </seg>
175 <seg>
176 $XORG_PREFIX/share/doc/libinput-&libinput-version;
177 </seg>
178 </seglistitem>
179 </segmentedlist>
180
181 <variablelist>
182 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
183 <?dbfo list-presentation="list"?>
184 <?dbhtml list-presentation="table"?>
185
186 <varlistentry id="libinput-debug-events">
187 <term><command>libinput-debug-events</command></term>
188 <listitem>
189 <para>
190 is a debug helper for <application>libinput</application>.
191 </para>
192 <indexterm zone="libinput libinput-debug-events">
193 <primary sortas="b-libinput-debug-events">libinput-debug-events</primary>
194 </indexterm>
195 </listitem>
196 </varlistentry>
197
198 <varlistentry id="libinput-list-devices">
199 <term><command>libinput-list-devices</command></term>
200 <listitem>
201 <para>
202 lists local devices as recognized by
203 <application>libinput</application>.
204 </para>
205 <indexterm zone="libinput libinput-list-devices">
206 <primary sortas="b-libinput-list-devices">libinput-list-devices</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="libinput-lib">
212 <term><filename class="libraryfile">libinput.so</filename></term>
213 <listitem>
214 <para>
215 contains API functions for handling input devices.
216 </para>
217 <indexterm zone="libinput libinput-lib">
218 <primary sortas="c-libinput">libinput.so</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 </variablelist>
224
225 </sect3>
226
227</sect2>
Note: See TracBrowser for help on using the repository browser.