source: general/genlib/libwacom.xml@ 5d2965c

11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5d2965c was 5d2965c, checked in by Douglas R. Reno <renodr@…>, 8 months ago

Update to ModemManager-1.16.2
Update to qpdf-10.2.0
Update to libgxps-0.3.2
Update to babl-0.1.86
Update to libqmi-1.28.2
Update to poppler-21.03.0
Update to URI-5.09 (Perl Module)
Update to gtksourceview4-4.8.1
Update to OpenSSH-8.5p1 (and ssh-askpass-8.5p1)
libwacom: Correct version number
libwacom: Add libwacom-show-stylus
bluez: Drop the patch

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

  • Property mode set to 100644
File size: 6.3 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 libwacom-download-http "https://github.com/linuxwacom/libwacom/releases/download/libwacom-&libwacom-version;/libwacom-&libwacom-version;.tar.bz2">
8 <!ENTITY libwacom-download-ftp " ">
9 <!ENTITY libwacom-md5sum "67aec245e7c1ee7f585a85a2c27db9d8">
10 <!ENTITY libwacom-size "508 KB">
11 <!ENTITY libwacom-buildsize "6.2 MB (with tests)">
12 <!ENTITY libwacom-time "less than 0.1 SBU (with tests)">
13]>
14
15<sect1 id="libwacom" xreflabel="libwacom-&libwacom-version;">
16 <?dbhtml filename="libwacom.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>libwacom-&libwacom-version;</title>
24
25 <indexterm zone="libwacom">
26 <primary sortas="a-libwacom">libwacom</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to libwacom</title>
31
32 <para>
33 The <application>libwacom</application> package contains a library used
34 to identify wacom tablets and their model-specific features.
35 </para>
36
37 &lfs101_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&libwacom-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&libwacom-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &libwacom-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &libwacom-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &libwacom-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &libwacom-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">libwacom Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Required</bridgehead>
76 <para role="required">
77 <xref linkend="libgudev"/>
78 </para>
79
80 <bridgehead renderas="sect4">Recommended</bridgehead>
81 <para role="recommended">
82 <xref linkend="libxml2"/>
83 </para>
84
85 <bridgehead renderas="sect4">Optional</bridgehead>
86 <para role="optional">
87 <xref linkend="doxygen"/>,
88 <xref linkend="git"/>,
89 <xref linkend="librsvg"/>,
90 <xref linkend="valgrind"/> (optional for some tests), and
91 <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink>
92 </para>
93
94 <para condition="html" role="usernotes">
95 User Notes: <ulink url="&blfs-wiki;/libwacom"/>
96 </para>
97 </sect2>
98
99 <sect2 role="installation">
100 <title>Installation of libwacom</title>
101
102<!-- Fixed in libwacom-1.7
103 <para>
104 First, adapt the udev rules to upstream udev/kernel changes:
105 </para>
106
107<screen><userinput remap="pre">sed -i 's/ACTION!="add|change"/ACTION=="remove"/' tools/65-libwacom.rules.in</userinput></screen>
108-->
109
110 <para>
111 Install <application>libwacom</application> by running the following
112 commands:
113 </para>
114
115<screen><userinput>mkdir build &amp;&amp;
116cd build &amp;&amp;
117
118meson --prefix=/usr -Dudev-dir=/lib/udev -Dtests=disabled .. &amp;&amp;
119ninja</userinput></screen>
120
121 <para>
122 To test the results, issue: <command>ninja test</command>.
123 To run additional tests, install
124 <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink> and remove
125 the "-Dtests=disabled" option from the meson line above.
126 </para>
127
128 <para>
129 Now, as the <systemitem class="username">root</systemitem> user:
130 </para>
131
132<screen role="root"><userinput>ninja install</userinput></screen>
133
134 </sect2>
135
136 <sect2 role="commands">
137 <title>Command Explanations</title>
138
139 <para>
140 <parameter>-Dudev-dir=/lib/udev</parameter>: This parameter sets the
141 proper installation directory for udev rules.
142 </para>
143
144 <para>
145 <parameter>-Dtests=disabled</parameter>: This parameter disables some of
146 the more advanced tests because they require
147 <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink> to work
148 properly.
149 </para>
150
151 </sect2>
152
153 <sect2 role="content">
154 <title>Contents</title>
155
156 <segmentedlist>
157 <segtitle>Installed Programs</segtitle>
158 <segtitle>Installed Libraries</segtitle>
159 <segtitle>Installed Directories</segtitle>
160
161 <seglistitem>
162 <seg>
163 libwacom-list-local-devices and
164 libwacom-show-stylus
165 </seg>
166 <seg>
167 libwacom.so
168 </seg>
169 <seg>
170 /usr/include/libwacom-1.0 and
171 /usr/share/libwacom
172 </seg>
173 </seglistitem>
174 </segmentedlist>
175
176 <variablelist>
177 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
178 <?dbfo list-presentation="list"?>
179 <?dbhtml list-presentation="table"?>
180
181 <varlistentry id="libwacom-list-local-devices">
182 <term><command>libwacom-list-local-devices</command></term>
183 <listitem>
184 <para>
185 lists tablet devices that are connected to the system
186 </para>
187 <indexterm zone="libwacom libwacom-list-local-devices">
188 <primary sortas="b-libwacom-list-local-devices">libwacom-list-local-devices</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 <varlistentry id="libwacom-show-stylus">
194 <term><command>libwacom-show-stylus</command></term>
195 <listitem>
196 <para>
197 lists tablet stylus IDs
198 </para>
199 <indexterm zone="libwacom libwacom-show-stylus">
200 <primary sortas="b-libwacom-show-stylus">libwacom-show-stylus</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 <varlistentry id="libwacom-lib">
206 <term><filename class="libraryfile">libwacom.so</filename></term>
207 <listitem>
208 <para>
209 contains functions used for accessing Wacom information
210 </para>
211 <indexterm zone="libwacom libwacom-lib">
212 <primary sortas="c-libwacom">libwacom.so</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 </variablelist>
218
219 </sect2>
220
221</sect1>
Note: See TracBrowser for help on using the repository browser.