Changes in x/installing/libinput.xml [f713df3:48771ae]

File:

• x/installing/libinput.xml (modified) (13 diffs)

x/installing/libinput.xml

@@ -5 +5 @@
   %general-entities;
 
-  <!ENTITY libinput-version "1.19.2">
-
-  <!ENTITY libinput-download-http "https://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz">
+  <!ENTITY libinput-version "1.22.0">
+
+<!--  <!ENTITY libinput-download-http "https://www.freedesktop.org/software/libinput/libinput-&libinput-version;.tar.xz">-->
+  <!ENTITY libinput-download-http "https://gitlab.freedesktop.org/libinput/libinput/-/archive/&libinput-version;/libinput-&libinput-version;.tar.gz"
+>
   <!ENTITY libinput-download-ftp  " ">
-  <!ENTITY libinput-md5sum        "2c7f2aa4032bacb562a535b74829c56d">
-  <!ENTITY libinput-size          "640 KB">
-  <!ENTITY libinput-buildsize     "12 MB (add 17 MB for documentation)">
+  <!ENTITY libinput-md5sum        "9affca17377aab2057d91640e3dd635e">
+  <!ENTITY libinput-size          "968 KB">
+  <!ENTITY libinput-buildsize     "11 MB (add 17 MB for documentation)">
   <!ENTITY libinput-time          "0.1 SBU (add 0.1 SBU for documentation)">
 ]>
@@ -29 +31 @@
 
     <sect3 role="package">
-      <title>Introduction to libinput</title>
+      <title>Introduction to Libinput</title>
 
       <para>
@@ -37 +39 @@
       </para>
 
-      &lfs110a_checked;
+      &lfs112_checked;
 
       <bridgehead renderas="sect4">Package Information</bridgehead>
@@ -84 +86 @@
       <para role="optional">
         <xref linkend="valgrind"/> (to run the tests),
-        <ulink url="http://sphinx-doc.org/">Sphinx</ulink> (required to build documentation),
         <xref linkend="gtk3"/> (to build the GUI event viewer),
-        <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink> (required for tests),
+        <xref linkend="libunwind"/> (required for tests),
         <xref linkend="libwacom"/>, and
+        <ulink url="https://www.sphinx-doc.org/">Sphinx</ulink> (required to build documentation),
         <ulink url="https://pypi.org/project/pyparsing/">PyParsing</ulink> (for one non-root test)
       </para>
@@ -97 +99 @@
 
     <sect3 role="kernel" id="libinput-kernel">
-      <title>kernel configuration for running the libinput testsuite</title>
+      <title>Kernel Configuration for Running the Libinput Test Suite</title>
 
       <para>
         Although libinput works with the same kernel configuration used by <xref
-        linkend="libevdev"/>, its extensive testsuite requires the presence of
+        linkend="libevdev"/>, its extensive test suite requires the presence of
         <filename>/dev/uinput</filename>  (as well as both <xref linkend="valgrind"/>
-        and <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>).
+        and <xref linkend="libunwind"/>).
       </para>
 
@@ -117 +119 @@
 
       <para>
-        If you build this as a module, it needs to be inserted before the testsuite
+        If you build this as a module, it needs to be inserted before the test suite
         runs.
       </para>
@@ -123 +125 @@
       <para>
         On an Xorg system you will also need to prevent the events generated
-        during the testsuite from interfering with your desktop.  Copy the
+        during the test suite from interfering with your desktop.  Copy the
         file <filename>test/50-litest.conf</filename> into
         <filename class="directory">${XORG_PREFIX}/share/X11/xorg.conf.d</filename>
@@ -136 +138 @@
 
     <sect3 role="installation">
-      <title>Installation of libinput</title>
+      <title>Installation of Libinput</title>
 
       <para>
@@ -146 +148 @@
 cd    build &amp;&amp;
 
-meson --prefix=$XORG_PREFIX \
-      --buildtype=release   \
-      -Ddebug-gui=false     \
-      -Dtests=false         \
-      -Dlibwacom=false      \
+meson --prefix=$XORG_PREFIX    \
+      --buildtype=release      \
+      -Ddebug-gui=false        \
+      -Dtests=false            \
+      -Dlibwacom=false         \
+      -Dudev-dir=/usr/lib/udev \
       ..                    &amp;&amp;
 ninja</userinput></screen>
@@ -158 +161 @@
           If you want to run the full tests, remove -Dtests from the
           <command>meson</command> command above. Please read "kernel
-          configuration for running the libinput testsuite" (above).
+          configuration for running the libinput test suite" (above).
         </para>
 
@@ -214 +217 @@
         have <xref linkend="libwacom"/> installed, or if you are installing
         GNOME.
+      </para>
+
+      <para>
+        <parameter>-Dudev-dir=/usr/lib/udev</parameter>: In case that the
+        value of <envar>XORG_PREFIX</envar> is not set to
+        <filename class='directory'>/usr</filename>, this option prevents
+        the package from installing Udev rules and helpers into
+        <filename class='directory'>$XORG_PREFIX/lib/udev</filename> which
+        is not searched by Udev daemon.  This option is not needed for
+        systems with <envar>XORG_PREFIX</envar> set to
+        <filename class='directory'>/usr</filename>, but does no harm.
       </para>
 
@@ -243 +257 @@
           </seg>
           <seg>
+            /etc/libinput,
             $XORG_PREFIX/libexec/libinput,
-            /etc/libinput,
-            /usr/share/libinput, and (optionally)
-            /usr/share/doc/libinput-&libinput-version;
+            $XORG_PREFIX/usr/share/libinput, and (optionally)
+            $XORG_PREFIX/share/doc/libinput-&libinput-version;
           </seg>
         </seglistitem>
@@ -268 +282 @@
           </listitem>
         </varlistentry>
-<!--
-        <varlistentry id="libinput-debug-events">
-          <term><command>libinput-debug-events</command></term>
-          <listitem>
-            <para>
-              is a debug helper for <application>libinput</application>.
-            </para>
-            <indexterm zone="libinput libinput-debug-events">
-              <primary sortas="b-libinput-debug-events">libinput-debug-events</primary>
-            </indexterm>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="libinput-list-devices">
-          <term><command>libinput-list-devices</command></term>
-          <listitem>
-            <para>
-              lists local devices as recognized by
-              <application>libinput</application>.
-            </para>
-            <indexterm zone="libinput libinput-list-devices">
-              <primary sortas="b-libinput-list-devices">libinput-list-devices</primary>
-            </indexterm>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="libinput-measure">
-          <term><command>libinput-measure</command></term>
-          <listitem>
-            <para>
-              is the entry to a set of debugging programs to measure
-              the properties of one or more devices.
-            </para>
-            <indexterm zone="libinput libinput-measure">
-              <primary sortas="b-libinput-measure">libinput-measure</primary>
-            </indexterm>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="libinput-record">
-          <term><command>libinput-record</command></term>
-          <listitem>
-            <para>
-              records kernel events from a device in a form that can later be
-              replayed by libinput-replay.
-            </para>
-            <indexterm zone="libinput libinput-record">
-              <primary sortas="b-libinput-record">libinput-record</primary>
-            </indexterm>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry id="libinput-replay">
-          <term><command>libinput-replay</command></term>
-          <listitem>
-            <para>
-              replays kernel events from a recording made by libinput-record.
-            </para>
-            <indexterm zone="libinput libinput-replay">
-              <primary sortas="b-libinput-replay">libinput-replay</primary>
-            </indexterm>
-          </listitem>
-        </varlistentry>
--->
+
         <varlistentry id="libinput-lib">
           <term><filename class="libraryfile">libinput.so</filename></term>