Changeset 0b12914 for general/genutils/ibus.xml

Timestamp:

11/22/2023 02:35:30 AM (5 months ago)

Author:

Douglas R. Reno <renodr@…>

Branches:

12.1, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18

Children:

cb3d7ec

Parents:

e1caa7a

Message:

Ibus: some minor text tweaks and formatting

File:

• general/genutils/ibus.xml (modified) (10 diffs)

general/genutils/ibus.xml

@@ -72 +72 @@
     </itemizedlist>
 
-    <bridgehead renderas="sect3">Optional Download</bridgehead>
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
 
     <itemizedlist spacing="compact">
@@ -88 +88 @@
     <para role="required">
       <xref linkend="dconf"/>,
+      <!-- needed since we're using autogen.sh -->
+      <xref linkend="gtk-doc"/>,
       <xref linkend="iso-codes"/>, and
       <xref linkend="vala"/>
@@ -104 +106 @@
       <xref linkend="dbus-python"/> and
       <xref linkend="pygobject3"/> (both to build the Python support library),
-      <xref linkend="gtk-doc"/>, and
+      <!--<xref linkend="gtk-doc"/>, and-->
       <!--<xref linkend="pyxdg" role="runtime"/>
       (runtime, for the <command>ibus-setup</command>), and
@@ -118 +120 @@
     <title>Installation of ibus</title>
 
+<!--
     <para>
       If the optional Unicode Character Database was downloaded, install it
       now as the <systemitem class="username">root</systemitem> user:
     </para>
+-->
+
+    <para>
+      First, install the Unicode Character Database as the &root; user:
+    </para>
 
 <screen role="root"><userinput>mkdir -p                /usr/share/unicode/ucd &amp;&amp;
 unzip -uo ../UCD.zip -d /usr/share/unicode/ucd</userinput></screen>
+
 <!--
     <note>
@@ -134 +143 @@
 -->
     <para>
-      Fix an issue with deprecated schema entries:</para>
+      Fix an issue with deprecated schema entries:
+    </para>
 
 <screen><userinput>sed -e 's@/desktop/ibus@/org/freedesktop/ibus@g' \
@@ -144 +154 @@
     </para>
 
-<screen revision='sysv'><userinput>SAVE_DIST_FILES=1 \
-PYTHON=python3    \
+<screen revision='sysv'><userinput>SAVE_DIST_FILES=1                   \
+PYTHON=python3                      \
 ./autogen.sh --prefix=/usr          \
              --sysconfdir=/etc      \
@@ -154 +164 @@
 make</userinput></screen>
 
-<screen revision='systemd'><userinput>SAVE_DIST_FILES=1 \
-PYTHON=python3    \
+<screen revision='systemd'><userinput>SAVE_DIST_FILES=1                   \
+PYTHON=python3                      \
 ./autogen.sh --prefix=/usr          \
              --sysconfdir=/etc      \
@@ -169 +179 @@
       <!-- The log says "No idea to simulate key events in Wayland"
            in a Mutter wayland session.  -->
-      The test named xkb-latin-layouts is known to fail with a recent
-      xkeyboard-config release.
     </para>
 
@@ -190 +198 @@
     </para>
 
-    <para>
-      <parameter>--disable-unicode-dict</parameter>: This switch disables the use
+<!--
+    <para>
+      <parameter>- -disable-unicode-dict</parameter>: This switch disables the use
       of unicode dictionaries. Omit if you installed the optional
       Unicode Character Database.
     </para>
+-->
 
     <para>
@@ -226 +236 @@
       to build the <application>Python 3</application> support
       library.
+    </para>
+
+    <para>
+      <envar>SAVE_DIST_FILES=1</envar>: This environment variable makes
+      the <command>autogen.sh</command> script save some pre-generated
+      header files instead of overwriting them when it is run. This prevents
+      build failures when generating <filename>ibusemojigen.h</filename>.
+      <!-- This is needed because we do not have the Emoji dictionary.-->
     </para>