- Timestamp:
- 06/30/2018 11:07:27 PM (6 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- ca6af403
- Parents:
- 6961e423
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
x/installing/libinput.xml
r6961e423 r2f2ca343 5 5 %general-entities; 6 6 7 <!ENTITY libinput-version "1.1 0.7">7 <!ENTITY libinput-version "1.11.0"> 8 8 9 9 <!ENTITY libinput-download-http "https://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz"> 10 10 <!ENTITY libinput-download-ftp " "> 11 <!ENTITY libinput-md5sum " 4369212564f8359f48c8f683c8c829b5">12 <!ENTITY libinput-size "4 84KB">13 <!ENTITY libinput-buildsize " 8.3MB">11 <!ENTITY libinput-md5sum "a182dab52f4d33bc1ef50668dcf53cc6"> 12 <!ENTITY libinput-size "475 KB"> 13 <!ENTITY libinput-buildsize "9.7 MB"> 14 14 <!ENTITY libinput-time "less than 0.1 SBU"> 15 15 ]> … … 87 87 <xref linkend="doxygen"/> and 88 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), and89 <xref linkend="gtk3"/> (to build the GUI event viewer), 90 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink> (required for tests), 91 91 <ulink revision="sysv" url="https://sourceforge.net/projects/linuxwacom/files/libwacom/">libwacom</ulink> 92 92 <xref revision="systemd" linkend="libwacom"/> 93 <!-- commas outside the rev get rendered on either version --> 94 , and 95 <ulink url="https://pypi.org/project/pyparsing/"/> (for one non-root test) 93 96 </para> 94 97 … … 96 99 User Notes: <ulink url="&blfs-wiki;/libinput"/> 97 100 </para> 101 </sect3> 102 103 <sect3 role="kernel" id="libinput-kernel"> 104 <title>kernel configuration for running the libinput testsuite</title> 105 106 <para> 107 Although libinput works with the same kernel configuration used by <xref 108 linkend="libevdev"/>, its extensive testsuite requires the presence of 109 <filename>/dev/uinput</filename> (as well as both <xref linkend="valgrind"/> 110 and <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>). 111 </para> 112 113 <para> 114 If you wish to run the full tests, enable the following option in the kernel 115 configuration and recompile the kernel if necessary: 116 </para> 117 118 <screen><literal>Device Drivers ---> 119 Input device support ---> 120 Miscellaneous Devices ---> 121 <*/M> User level driver support [CONFIG_INPUT_UINPUT]</literal></screen> 122 123 <para> 124 If you build this as a module, it needs to be inserted before the testsuite 125 runs. 126 </para> 127 128 <para> 129 On an Xorg system you will also need to prevent the events generated 130 during the testsuite from interfering with your desktop. Copy the 131 file <filename>test/50-litest.conf</filename> into 132 <filename class="directory"> ${XORG_PREFIX}/share/X11/xorg.conf.d</filename> 133 and restart X. For further information see 134 <ulink url="https://wayland.freedesktop.org/libinput/doc/&libinput-version;/test-suite.html">libinput test suite</ulink>. 135 </para> 136 137 <indexterm zone="libinput libinput-kernel"> 138 <primary sortas="d-libinput">libinput</primary> 139 </indexterm> 98 140 </sect3> 99 141 … … 118 160 ninja</userinput></screen> 119 161 120 <!--121 162 <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 163 <para>If you want to run the full tests, remove -Dtests from the 164 <command>meson</command> command above. Please read "kernel configuration 165 for running the libinput testsuite" (above). 166 </para> 167 168 <para> 169 If you have enabled the full tests, you can run the main tests 170 <emphasis>as the root user</emphasis> by executing: 171 <command>ninja test</command>. A very large number of tests will 172 be run, about 20 fail (at least on an Xorg system). 173 </para> 126 174 </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 currently131 running system that can lead to crashing a local X server or132 a desktop environment. If you understand the risks and have133 the optional <xref linkend="check"/> and134 <xref linkend="valgrind"/> packages installed, the regression135 tests can be run as the <systemitem136 class="username">root</systemitem> user with137 <userinput>ninja test</userinput>. Note that depending on138 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 175 145 176 <para> … … 176 207 177 208 <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. 209 <option>-Dtests=false</option>: This switch disables compilation of the 210 main tests. Even with the tests defined as false, you can still run the 211 first four minor tests, as a regular user, but one will be skipped if 212 <ulink url="https://pypi.org/project/pyparsing"/> is not installed. 181 213 </para> 182 214 … … 205 237 <seglistitem> 206 238 <seg> 207 libinput, 208 libinput-debug-events, and209 libinput- list-devices239 libinput, 240 libinput-debug-events, libinput-list-devices, libinput-measure*, 241 libinput-record, libinput-replay 210 242 </seg> 211 243 <seg> … … 262 294 </varlistentry> 263 295 296 <varlistentry id="libinput-measure"> 297 <term><command>libinput-measure</command></term> 298 <listitem> 299 <para> 300 is the entry to a set of debugging programs to measure 301 the properties of one or more devices. 302 </para> 303 <indexterm zone="libinput libinput-measure"> 304 <primary sortas="b-libinput-measure">libinput-measure</primary> 305 </indexterm> 306 </listitem> 307 </varlistentry> 308 309 <varlistentry id="libinput-record"> 310 <term><command>libinput-record</command></term> 311 <listitem> 312 <para> 313 records kernel events from a device in a form that can later be 314 replayed by libinput-replay. 315 </para> 316 <indexterm zone="libinput libinput-record"> 317 <primary sortas="b-libinput-record">libinput-record</primary> 318 </indexterm> 319 </listitem> 320 </varlistentry> 321 322 <varlistentry id="libinput-replay"> 323 <term><command>libinput-replay</command></term> 324 <listitem> 325 <para> 326 replays kernel events from a recording made by libinput-record. 327 </para> 328 <indexterm zone="libinput libinput-replay"> 329 <primary sortas="b-libinput-replay">libinput-replay</primary> 330 </indexterm> 331 </listitem> 332 </varlistentry> 333 264 334 <varlistentry id="libinput-lib"> 265 335 <term><filename class="libraryfile">libinput.so</filename></term>
Note:
See TracChangeset
for help on using the changeset viewer.