Changeset 7ffcdc1 for general/sysutils/gpm.xml

Timestamp:

09/06/2023 12:08:15 PM (9 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

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

Children:

79736ae6

Parents:

32244fa

git-author:

Xi Ruoyao <xry111@…> (09/06/2023 12:06:53 PM)

git-committer:

Xi Ruoyao <xry111@…> (09/06/2023 12:08:15 PM)

Message:

gpm: Add ac_cv_path_emacs=no, and add texlive as optional dependency for doc

File:

• general/sysutils/gpm.xml (modified) (4 diffs)

general/sysutils/gpm.xml

@@ -87 +87 @@
     <ulink url="&blfs-wiki;/GPM"/></para>
 
+    <bridgehead renderas="sect3">GPM Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="texlive"/> (for documentation)
+    </para>
   </sect2>
 
@@ -114 +120 @@
     </para>
 
-<screen><userinput>patch -Np1 -i ../gpm-&gpm-version;-consolidated-1.patch &amp;&amp;
-./autogen.sh                                     &amp;&amp;
-./configure --prefix=/usr --sysconfdir=/etc      &amp;&amp;
+<screen><userinput>patch -Np1 -i ../gpm-&gpm-version;-consolidated-1.patch                &amp;&amp;
+./autogen.sh                                                    &amp;&amp;
+./configure --prefix=/usr --sysconfdir=/etc ac_cv_path_emacs=no &amp;&amp;
 make</userinput></screen>
+
+    <para>
+      If <xref linkend='texlive'/> is installed, build the GPM manual as
+      dvi, ps, and pdf formats:
+    </para>
+
+<screen remap='doc'><userinput>make -C doc gpm.{dvi,ps} &amp;&amp;
+dvipdfm doc/gpm.dvi -o doc/gpm.pdf</userinput></screen>
 
     <para>
@@ -142 +156 @@
                     /usr/share/doc/gpm-&gpm-version;</userinput></screen>
 
+    <para>
+      If <xref linkend='texlive'/> is installed and you've built GPM
+      manual as dvi, ps, and pdf formats, install them as the &root; user:
+    </para>
+
+<screen role='root' remap='doc'><userinput>install -vm644 doc/gpm.{dvi,ps,pdf} /usr/share/doc/gpm-&gpm-version;</userinput></screen>
+
   </sect2>
 
@@ -150 +171 @@
       <command>./autogen.sh</command>: This command creates the missing
       <command>configure</command> script.
+    </para>
+
+    <para>
+      <parameter>ac_cv_path_emacs=no</parameter>: This variable works around
+      an issue causing the package fail to build with
+      <xref linkend='emacs'/> installed.  It also suppresses the
+      installations of some <quote>Emacs support files</quote> shipped with
+      GPM.  These files are quite outdated and they should be superseded
+      with <xref linkend='emacs'/> built-in GPM support.  If you need to use
+      <xref linkend='emacs'/> in Linux console with mouse support, you
+      should install (or reinstall) <xref linkend='emacs'/>
+      <emphasis role='bold'>after</emphasis> GPM.
     </para>