Changeset cb704b48 for networking/mailnews/mutt.xml

Timestamp:

06/15/2020 08:51:48 PM (4 years ago)

Author:

Ken Moffat <ken@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, 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:

fe2553a

Parents:

152d154

Message:

mutt-1.14.3 and create a plain text version of the manual.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23285 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• networking/mailnews/mutt.xml (modified) (6 diffs)

networking/mailnews/mutt.xml

@@ -7 +7 @@
   <!ENTITY mutt-download-http "https://bitbucket.org/mutt/mutt/downloads/mutt-&mutt-version;.tar.gz">
   <!ENTITY mutt-download-ftp  "ftp://ftp.mutt.org/pub/mutt/mutt-&mutt-version;.tar.gz">
-  <!ENTITY mutt-md5sum        "1c109c6211477e6dc3decd63c6f99199">
-  <!ENTITY mutt-size          "5.0 MB">
+  <!ENTITY mutt-md5sum        "121e23c472852323337240d68ca1c41e">
+  <!ENTITY mutt-size          "4.8 MB">
   <!ENTITY mutt-buildsize     "46 MB">
   <!ENTITY mutt-time          "0.3 SBU">
@@ -83 +83 @@
 
     <bridgehead renderas="sect3">Mutt Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Recommended (for a text version of the manual)</bridgehead>
+    <para role="recommended">
+      <xref linkend="lynx"/>, or
+      <xref linkend="Links"/> (or
+      <ulink url="&w3m-url;">W3m</ulink>, or
+      <ulink url="&elinks-url;">ELinks</ulink>) - please read the Note.
+    </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
@@ -106 +114 @@
     </para>
 
-    <bridgehead renderas="sect4">Optional (To Regenerate HTML
-    Documentation)</bridgehead>
-    <para role="optional">
-      <xref linkend="libxslt"/> and either
-      <xref linkend="lynx"/>,
-      <ulink url="&w3m-url;">W3m</ulink>, or
-      <ulink url="&elinks-url;">ELinks</ulink>
-    </para>
-
 <!--<bridgehead renderas="sect4">Optional (To Generate PDF Manual)</bridgehead>
     <para role="optional">
@@ -131 +130 @@
     <title>Installation of Mutt</title>
 
+    <note>
+      <para>
+        <application>Mutt</application> ships with an HTML version of its
+        manual, but the text version is no longer provided because differences
+        in the formatting from different text browsers compared to the shipped
+        version caused complaints. To get a text file, the following are used
+        in order of preference: <application>lynx</application> with overstriking
+        (backspaces) for emphasis, <application>w3m</application> or
+        <application>elinks</application>: the latter two apparently provide
+        plain text. Plain text is generally preferred unless reading the HTML
+        manual, so the instructions below use <application>lynx</application>
+        if available, or else <application>links</application> to produce plain
+        text.
+      </para>
+    </note>
+
     <para>
       <application>Mutt</application> requires a group named
@@ -148 +163 @@
 
     <para>
-      <application>Mutt</application> will rebuild the html documentation
-      if <application>libxslt</application> is present, then use that to update
-      the text manual - even if none of the specified browsers are present. That
-      will create an empty text file, so we will save the shipped file.
-    </para>
-
-    <para>
       Install <application>Mutt</application> by running the following
       commands:
+    </para>
+
+    <para>
+      To ensure that a plain text manual is created when using
+      <application>lynx</application> or to otherwise use
+      <application>links</application> to produce it (instead of
+      <application>elinks</application>), run the following command:
+    </para>
+
+<screen><userinput>sed -i -e 's/ -with_backspaces//' -e 's/elinks/links/' \
+  -e 's/-no-numbering -no-references//' doc/Makefile.in</userinput></screen>
+
+    <para>
+      Now configure and build the application:
     </para>
 
@@ -222 +244 @@
 
     <para>
+      <parameter>sed ... -e 's/ -with_backspaces//' ...</parameter>: This turns
+      off the backspaces used for overstriking when <application>lynx</application>
+      is used, resulting in readable plain text when using <command>view</command>.
+    </para>
+
+    <para>
+      <parameter>sed ... -e 's/elinks/links/' ...</parameter>: This allows
+      <command>links</command> to be run instead of <command>elinks</command>
+      which is not in the book.
+    </para>
+
+    <para>
+      <parameter>sed ... -e 's/-no-numbering -no-references//' ...</parameter>:
+      This removes switches which are not understood by <command>links</command>.
+    </para>
+
+    <para>
       <parameter>--enable-external-dotlock</parameter>: In some circumstances
       the mutt-dotlock program is not created. This switch ensures it is always