source: general/genlib/libwacom.xml@ b2ac1cf

11.0 ken/refactor-virt lazarus qt5new trunk upgradedb
Last change on this file since b2ac1cf was b2ac1cf, checked in by Thomas Trepl (Moody) <thomas@…>, 5 months ago

Upgrade libwacom to 1.11

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