From aa48c25feda8005386b423db1e0d9193962755d9 Mon Sep 17 00:00:00 2001
From: Thomas Trepl <thomas@linuxfromscratch.org>
Date: Sat, 26 Nov 2022 17:25:30 +0100
Subject: [PATCH] Add some info about PAGER,EDITOR,MAILDIR options

---
 networking/mailnews/mailx.xml | 49 ++++++++++++++++++++++++++++++++++-
 1 file changed, 48 insertions(+), 1 deletion(-)

diff --git a/networking/mailnews/mailx.xml b/networking/mailnews/mailx.xml
index bafc094aa5..3bd7781b1b 100644
--- a/networking/mailnews/mailx.xml
+++ b/networking/mailnews/mailx.xml
@@ -171,8 +171,11 @@ install -v -m644 README /usr/share/doc/heirloom-mailx-&mailx-version;</userinput
       <title>Config Files</title>
 
       <para>
+<!-- ~/.nailrc seems not to be supported anymore
         <filename>/etc/nail.rc</filename>, <filename>~/.mailrc</filename>
         and <filename>~/.nailrc</filename>
+-->
+        <filename>/etc/nail.rc</filename> and <filename>~/.mailrc</filename>
       </para>
 
       <indexterm zone="mailx mailx-config">
@@ -182,10 +185,54 @@ install -v -m644 README /usr/share/doc/heirloom-mailx-&mailx-version;</userinput
       <indexterm zone="mailx mailx-config">
         <primary sortas="e-AA.mailrc">~/.mailrc</primary>
       </indexterm>
-
+<!--
       <indexterm zone="mailx mailx-config">
         <primary sortas="e-AA.nailrc">~/.nailrc</primary>
       </indexterm>
+-->
+    </sect3>
+
+    <sect3>
+      <title>Configuration Information</title>
+
+      <para>
+        For displaying mails, <application>mailx</application>
+        uses a pager program. Since the default of <command>pg</command>
+        is not available on a LFS system, its required to
+        specify which pager is to use. By default, there is
+        <command>more</command> and the more comfortable
+        <command>less</command> installed. If the
+        variable PAGER is not set in <filename>/etc/profile</filename>
+        or <filename>~/.bash_profile</filename>, or if it
+        should be another pager just for reading mails, it can be
+        set system wide in <filename>/etc/nail.rc</filename>:
+      </para>
+
+<screen><userinput role="nodump">echo "set PAGER=&lt;more|less&gt;" &gt;&gt; /etc/nail.rc</userinput></screen>
+
+      <para>or individually for the actual user in <filename>~/.mailrc</filename>:</para>
+
+<screen><userinput role="nodump">echo "set PAGER=&lt;more|less&gt;" &gt;&gt; ~/.mailrc</userinput></screen>
+
+      <para>
+        Other interesting options to set in the config files might
+        be EDITOR and MAILDIR. 
+      </para>
+
+      <para>
+        If not set in the environment for other packages, the
+        default editor can be set by:
+      </para>
+
+<screen><userinput role="nodump">echo "set EDITOR=&lt;vim|nano|...&gt;" &gt;&gt; /etc/nail.rc</userinput></screen>
+
+      <para>
+        Depending on which kind of <xref linkend="server-mail"/> is
+        installed, it might be required to set the MAILDIR variable
+        so <application>mailx</application> is able to find the mails:
+      </para>
+
+<screen><userinput role="nodump">echo "set MAILDIR=Maildir" &gt;&gt; /etc/nail.rc</userinput></screen>
 
     </sect3>