Ignore:
Timestamp:
03/23/2020 09:46:15 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
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:
2aa0f3b
Parents:
bb65a3c
Message:

Finish formatting "networking"

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • networking/mailnews/mutt.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to Mutt</title>
    3131
    32     <para>The <application>Mutt</application> package contains a Mail User
    33     Agent. This is useful for reading, writing, replying to, saving, and
    34     deleting your email.</para>
     32    <para>
     33      The <application>Mutt</application> package contains a Mail User
     34      Agent. This is useful for reading, writing, replying to, saving, and
     35      deleting your email.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing='compact'>
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&mutt-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&mutt-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &mutt-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &mutt-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &mutt-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &mutt-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&mutt-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&mutt-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &mutt-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &mutt-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &mutt-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &mutt-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    6175    <itemizedlist spacing='compact'>
    6276      <listitem>
    63         <para>Required patch: <ulink
    64         url="&patch-root;/mutt-&mutt-version;-upstream_fixes-1.patch"/>
     77        <para>
     78          Required patch: <ulink
     79          url="&patch-root;/mutt-&mutt-version;-upstream_fixes-1.patch"/>
    6580        </para>
    6681      </listitem>
    … …  
    8499      <ulink url="http://www.citi.umich.edu/projects/nfsv4/linux/">libgssapi</ulink>,
    85100      <ulink url="http://mixmaster.sourceforge.net/">Mixmaster</ulink>,
    86       <!-- from configure: \-\-with-bdb[=DIR] Use BerkeleyDB4 if gdbm is not available
    87       but gdbm is installed in LFS, so do not mention BerkeleyDB
     101      <!-- from configure: \-\-with-bdb[=DIR] Use BerkeleyDB4 if gdbm is not
     102      available but gdbm is installed in LFS, so do not mention BerkeleyDB
    88103      <xref linkend="db"/> or -->
    89104      <ulink url="http://fallabs.com/qdbm/">QDBM</ulink> or
    … …  
    116131    <title>Installation of Mutt</title>
    117132
    118     <para><application>Mutt</application> requires a group named
    119     <systemitem class="groupname">mail</systemitem>.  You can
    120     add this group, if it does not exist, with this command:</para>
     133    <para>
     134      <application>Mutt</application> requires a group named
     135      <systemitem class="groupname">mail</systemitem>.  You can
     136      add this group, if it does not exist, with this command:
     137    </para>
    121138
    122139<screen role="root"><userinput>groupadd -g 34 mail</userinput></screen>
    123140
    124     <para>If you did not install an <xref linkend="server-mail"/>, you need to
    125     modify the ownership of <filename class="directory">/var/mail</filename>
    126     with this command:</para>
     141    <para>
     142      If you did not install an <xref linkend="server-mail"/>, you need to
     143      modify the ownership of <filename class="directory">/var/mail</filename>
     144      with this command:
     145    </para>
    127146
    128147<screen role="root"><userinput>chgrp -v mail /var/mail</userinput></screen>
    129148
    130     <para><application>Mutt</application> will rebuild the html documentation
    131     if <application>libxslt</application> is present, then use that to update
    132     the text manual - even if none of the specified browsers are present. That
    133     will create an empty text file, so we will save the shipped file.
    134     </para>
    135 
    136     <para>Install <application>Mutt</application> by running the following
    137     commands:</para>
     149    <para>
     150      <application>Mutt</application> will rebuild the html documentation
     151      if <application>libxslt</application> is present, then use that to update
     152      the text manual - even if none of the specified browsers are present. That
     153      will create an empty text file, so we will save the shipped file.
     154    </para>
     155
     156    <para>
     157      Install <application>Mutt</application> by running the following
     158      commands:
     159    </para>
    138160
    139161<screen><userinput>cp -v doc/manual.txt{,.shipped} &amp;&amp;
    … …  
    149171make</userinput></screen>
    150172
    151     <para>To generate the PDF manual with <xref linkend="texlive"/>, run
    152     the following command:</para>
     173    <para>
     174      To generate the PDF manual with <xref linkend="texlive"/>, run
     175      the following command:
     176    </para>
    153177
    154178<screen remap="doc"><userinput>make -C doc manual.pdf</userinput></screen>
    155179
    156     <para>This package does not come with a test suite.</para>
    157 
    158     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     180    <para>
     181      This package does not come with a test suite.
     182    </para>
     183
     184    <para>
     185      Now, as the <systemitem class="username">root</systemitem> user:
     186    </para>
    159187
    160188    <screen role='root'><userinput>make install &amp;&amp;
    … …  
    163191  /usr/share/doc/mutt-&mutt-version;/manual.txt</userinput></screen>
    164192
    165     <para>If you generated the PDF manual, install it
    166     by issuing the following command as the
    167     <systemitem class="username">root</systemitem> user:</para>
     193    <para>
     194      If you generated the PDF manual, install it
     195      by issuing the following command as the
     196      <systemitem class="username">root</systemitem> user:
     197    </para>
    168198
    169199<screen role='root' remap='doc'><userinput>install -v -m644 doc/manual.pdf \
    … …  
    174204        If you used a DESTDIR method to only install to a temporary location as
    175205        a regular user (as part of a package menagement process), you will need
    176         to run the following as the <systemitem class="username">root</systemitem>
    177         user after completing the real install:
     206        to run the following as the <systemitem class="username">root
     207        </systemitem> user after completing the real install:
    178208      </para>
    179209
    … …  
    194224    <title>Command Explanations</title>
    195225
    196     <para><parameter>--enable-external-dotlock</parameter>: In some circumstances
    197     the mutt-dotlock program is not created. This switch ensures it is always
    198     created.</para>
    199 
    200     <para><parameter>--enable-pop</parameter>: This switch enables
    201     POP3 support.</para>
    202 
    203     <para><parameter>--enable-imap</parameter>: This switch enables
    204     IMAP support.</para>
    205 
    206     <para><parameter>--enable-hcache</parameter>: This switch enables
    207     header caching.</para>
    208 
    209     <para><parameter>--enable-sidebar</parameter>: This switch enables support
    210     for the sidebar (a list of mailboxes). It is off by default, but can be
    211     turned on by <command>:set sidebar_visible</command> in mutt (and off again
    212     with ':unset'), or it can be enabled in  <filename>~/.muttrc</filename>.</para>
    213 
    214     <para><parameter>--with-ssl</parameter>: This parameter adds SSL/TLS
    215     support from openssl in POP3/IMAP/SMTP.</para>
    216 
    217     <para><option>--enable-autocrypt --with-sqlite3</option>: These two
    218     switches add support for passive protection against data collection,
    219     using gnupg and gpgme (gpgme is enabled by autocrypt). See <ulink
    220     url="http://www.mutt.org/doc/manual/#autocryptdoc">The Manual</ulink>
    221     </para>
    222 
    223     <para><option>--enable-gpgme</option>: This switch enables GPG support
    224     through the GPGME package. Use this switch if you want GPG support in
    225     Mutt.</para>
    226 
    227     <para><option>--enable-smtp</option>: This switch enables
    228     SMTP relay support.</para>
    229 
    230     <para><option>--with-idn2</option>: Use this parameter if both libidn and
    231     libidn2 have been installed, and you wish to use libidn2 here.</para>
    232 
    233     <para><option>--with-sasl</option>: This parameter adds
    234     authentication support from <xref linkend="cyrus-sasl"/> in POP3/IMAP/SMTP
    235     if they are enabled. Depending on the server configuration, this may not
    236     be needed for POP3 or IMAP. However, it is needed for SMTP
    237     authentication.</para>
     226    <para>
     227      <parameter>--enable-external-dotlock</parameter>: In some circumstances
     228      the mutt-dotlock program is not created. This switch ensures it is always
     229      created.
     230    </para>
     231
     232    <para>
     233      <parameter>--enable-pop</parameter>: This switch enables POP3 support.
     234    </para>
     235
     236    <para>
     237      <parameter>--enable-imap</parameter>: This switch enables IMAP support.
     238    </para>
     239
     240    <para>
     241      <parameter>--enable-hcache</parameter>: This switch enables
     242      header caching.
     243    </para>
     244
     245    <para>
     246      <parameter>--enable-sidebar</parameter>: This switch enables support
     247      for the sidebar (a list of mailboxes). It is off by default, but can be
     248      turned on by <command>:set sidebar_visible</command> in mutt (and off
     249      again with ':unset'), or it can be enabled in <filename>
     250      ~/.muttrc</filename>.
     251    </para>
     252
     253    <para>
     254      <parameter>--with-ssl</parameter>: This parameter adds SSL/TLS
     255      support from openssl in POP3/IMAP/SMTP.
     256    </para>
     257
     258    <para>
     259      <option>--enable-autocrypt --with-sqlite3</option>: These two
     260      switches add support for passive protection against data collection,
     261      using gnupg and gpgme (gpgme is enabled by autocrypt). See <ulink
     262      url="http://www.mutt.org/doc/manual/#autocryptdoc">The Manual</ulink>.
     263    </para>
     264
     265    <para>
     266      <option>--enable-gpgme</option>: This switch enables GPG support
     267      through the GPGME package. Use this switch if you want GPG support in
     268      Mutt.
     269    </para>
     270
     271    <para>
     272      <option>--enable-smtp</option>: This switch enables
     273      SMTP relay support.
     274    </para>
     275
     276    <para>
     277      <option>--with-idn2</option>: Use this parameter if both libidn and
     278      libidn2 have been installed, and you wish to use libidn2 here.
     279    </para>
     280
     281    <para>
     282      <option>--with-sasl</option>: This parameter adds authentication support
     283      from <xref linkend="cyrus-sasl"/> in POP3/IMAP/SMTP if they are enabled.
     284      Depending on the server configuration, this may not be needed for POP3
     285      or IMAP. However, it is needed for SMTP authentication.
     286    </para>
    238287
    239288    <!-- we do not normally list all possible switches. LFS installs ncurses.
    240     <para><option>\-\-with-slang</option>: Use <application>S-Lang
    241     </application> instead of <application>Ncurses</application>.</para> -->
    242 
    243     <para><command>test -s doc/manual.txt || install -v -m644 doc/manual.txt.shipped ...</command>:
    244     if the text manual is now empty (<application>libxslt</application> is
    245     installed, but without any of the specified text browsers), install the
    246     saved copy <emphasis>after</emphasis> running 'make install'
    247     <emphasis>(which would itself empty manual.txt if the shipped file had
    248     already been copied back)</emphasis>.</para>
     289    <para>
     290      <option>\-\-with-slang</option>: Use <application>S-Lang
     291      </application> instead of <application>Ncurses</application>.
     292    </para> -->
     293
     294    <para>
     295      <command>test -s doc/manual.txt || install -v -m644 doc/manual.txt.shipped ...</command>:
     296      if the text manual is now empty (<application>libxslt</application> is
     297      installed, but without any of the specified text browsers), install the
     298      saved copy <emphasis>after</emphasis> running 'make install'
     299      <emphasis>(which would itself empty manual.txt if the shipped file had
     300      already been copied back)</emphasis>.
     301    </para>
    249302
    250303  </sect2>
    … …  
    256309      <title>Config Files</title>
    257310
    258       <para><filename>/etc/Muttrc</filename>, <filename>~/.muttrc</filename>,
    259       <filename>/etc/mime.types</filename>, <filename>~/.mime.types</filename></para>
     311      <para>
     312        <filename>/etc/Muttrc</filename>,
     313        <filename>~/.muttrc</filename>,
     314        <filename>/etc/mime.types</filename>, and
     315        <filename>~/.mime.types</filename>
     316      </para>
    260317
    261318      <indexterm zone="mutt mutt-config">
    … …  
    280337      <title>Configuration Information</title>
    281338
    282       <para>No changes in these files are necessary to begin using
    283       <application>Mutt</application>.  When you are ready to make changes, the
    284       man page for <filename>muttrc</filename> is a good starting place.</para>
    285 
    286       <para>In order to utilize <application>GnuPG</application>, use the following
    287       command:</para>
     339      <para>
     340        No changes in these files are necessary to begin using
     341        <application>Mutt</application>.  When you are ready to make changes,
     342        the man page for <filename>muttrc</filename> is a good starting place.
     343      </para>
     344
     345      <para>
     346        In order to utilize <application>GnuPG</application>, use the following
     347        command:
     348      </para>
    288349
    289350<screen><userinput>cat /usr/share/doc/mutt-&mutt-version;/samples/gpg.rc &gt;&gt; ~/.muttrc</userinput></screen>
    … …  
    317378        <term><command>flea</command></term>
    318379        <listitem>
    319           <para>is a script showing where to report bugs.</para>
     380          <para>
     381            is a script showing where to report bugs.
     382          </para>
    320383          <indexterm zone="mutt flea">
    321384            <primary sortas="b-flea">flea</primary>
    … …  
    327390        <term><command>mutt</command></term>
    328391        <listitem>
    329           <para>is a Mail User Agent (MUA) which enables you to read, write
    330           and delete your email.</para>
     392          <para>
     393            is a Mail User Agent (MUA) which enables you to read, write
     394            and delete your email.
     395          </para>
    331396          <indexterm zone="mutt mutt-prog">
    332397            <primary sortas="b-mutt">mutt</primary>
    … …  
    338403        <term><command>mutt_dotlock</command></term>
    339404        <listitem>
    340           <para>implements the mail spool file lock.</para>
     405          <para>
     406            implements the mail spool file lock.
     407          </para>
    341408          <indexterm zone="mutt mutt_dotlock">
    342409            <primary sortas="b-mutt_dotlock">mutt_dotlock</primary>
    … …  
    348415        <term><command>muttbug</command></term>
    349416        <listitem>
    350                 <para>is a script identical to <command>flea</command>.</para>
     417          <para>
     418            is a script identical to <command>flea</command>.
     419          </para>
    351420          <indexterm zone="mutt muttbug">
    352421            <primary sortas="b-muttbug">muttbug</primary>
    … …  
    358427        <term><command>pgpewrap</command></term>
    359428        <listitem>
    360           <para>prepares a command line for the <xref linkend="gnupg2"/>
    361           utilities.</para>
     429          <para>
     430            prepares a command line for the <xref linkend="gnupg2"/> utilities.
     431          </para>
    362432          <indexterm zone="mutt pgpewrap">
    363433            <primary sortas="b-pgpewrap">pgpewrap</primary>
    … …  
    369439        <term><command>pgpring</command></term>
    370440        <listitem>
    371           <para>is a key ring dumper for <ulink
    372           url="http://www.pgp.com/">PGP</ulink>. It is not needed for
    373           <xref linkend="gnupg2"/>.</para>
     441          <para>
     442            is a key ring dumper for <ulink
     443            url="http://www.pgp.com/">PGP</ulink>. It is not needed for
     444            <xref linkend="gnupg2"/>.
     445          </para>
    374446          <indexterm zone="mutt pgpring">
    375447            <primary sortas="b-pgpring">pgpring</primary>
    … …  
    381453        <term><command>smime_keys</command></term>
    382454        <listitem>
    383           <para>manages a keystore for S/MIME certificates.</para>
     455          <para>
     456            manages a keystore for S/MIME certificates.
     457          </para>
    384458          <indexterm zone="mutt smime_keys">
    385459            <primary sortas="b-smime_keys">smime_keys</primary>
Note: See TracChangeset for help on using the changeset viewer.