Changeset 7c56ece for networking


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

Location:
networking
Files:
27 edited

Legend:

Unmodified
Added
Removed

  • networking/connect/connect.xml

    rbb65a3c r7c56ece  
    1616  <title>Connecting to a Network</title>
    1717
    18   <para>The LFS book covers setting up networking by connecting to a LAN
     18  <para>
     19    The LFS book covers setting up networking by connecting to a LAN
    1920  with a static IP address. There are other methods used to obtain an IP
    2021  address and connect to a LAN and other networks (such as the Internet).
    2122  The most popular methods (DHCP and PPP) are covered in this chapter.</para>
    2223
    23   <para>DHCP stands for Dynamic Host Configuration Protocol. It is a protocol
    24   used by many sites to automatically provide information such as IP addresses,
    25   subnet masks and routing information to computers.  If your network uses
    26   DHCP, you will need a DHCP client in order to connect to it.</para>
    27 
    28   <para>PPP stands for Point-to-Point Protocol. It is a data link protocol
    29   commonly used for establishing authenticated IP connections over
    30   a phone line with a modem, or over radio waves with a cellular phone. There
    31   is also a variant (PPPoE) that works over Ethernet and is used by cable
    32   providers to authenticate the Internet connections.</para>
    33 
     24  <para>
     25    DHCP stands for Dynamic Host Configuration Protocol. It is a protocol used
     26    by many sites to automatically provide information such as IP addresses,
     27    subnet masks and routing information to computers.  If your network uses
     28    DHCP, you will need a DHCP client in order to connect to it.
     29  </para>
     30<!-- we do not include ppp
     31  <para>
     32    PPP stands for Point-to-Point Protocol. It is a data link protocol
     33    commonly used for establishing authenticated IP connections over
     34    a phone line with a modem, or over radio waves with a cellular phone. There
     35    is also a variant (PPPoE) that works over Ethernet and is used by cable
     36    providers to authenticate the Internet connections.
     37  </para>
     38-->
    3439<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ppp.xml"/> -->
    3540  <!-- systemd only -->

  • networking/connect/dhcpcd.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to dhcpcd</title>
    3131
    32     <para><application>dhcpcd</application> is an implementation of the
    33     DHCP client specified in RFC2131. A DHCP client is useful for connecting
    34     your computer to a network which uses DHCP to assign network
    35     addresses. dhcpcd strives to be a fully featured, yet very lightweight
    36     DHCP client.</para>
     32    <para>
     33      <application>dhcpcd</application> is an implementation of the
     34      DHCP client specified in RFC2131. A DHCP client is useful for connecting
     35      your computer to a network which uses DHCP to assign network
     36      addresses. dhcpcd strives to be a fully featured, yet very lightweight
     37      DHCP client.
     38    </para>
    3739
    3840    &lfs91_checked;
    … …  
    4143    <itemizedlist spacing="compact">
    4244      <listitem>
    43         <para>Download (HTTP): <ulink url="&dhcpcd-download-http;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download (FTP): <ulink url="&dhcpcd-download-ftp;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download MD5 sum: &dhcpcd-md5sum;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Download size: &dhcpcd-size;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated disk space required: &dhcpcd-buildsize;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated build time: &dhcpcd-time;</para>
     45        <para>
     46          Download (HTTP): <ulink url="&dhcpcd-download-http;"/>
     47        </para>
     48      </listitem>
     49      <listitem>
     50        <para>
     51          Download (FTP): <ulink url="&dhcpcd-download-ftp;"/>
     52        </para>
     53      </listitem>
     54      <listitem>
     55        <para>
     56          Download MD5 sum: &dhcpcd-md5sum;
     57        </para>
     58      </listitem>
     59      <listitem>
     60        <para>
     61          Download size: &dhcpcd-size;
     62        </para>
     63      </listitem>
     64      <listitem>
     65        <para>
     66          Estimated disk space required: &dhcpcd-buildsize;
     67        </para>
     68      </listitem>
     69      <listitem>
     70        <para>
     71          Estimated build time: &dhcpcd-time;
     72        </para>
    5973      </listitem>
    6074    </itemizedlist>
    … …  
    6478    <bridgehead renderas="sect4">Optional</bridgehead>
    6579    <para role="optional">
    66        <xref linkend="llvm"/> (with Clang),
    67        <xref linkend="ntp"/>,
    68        <ulink url="https://chrony.tuxfamily.org/">chronyd</ulink>, and
    69        <ulink url="https://github.com/thkukuk/ypbind-mt/">ypbind</ulink>
     80      <xref linkend="llvm"/> (with Clang),
     81      <xref linkend="ntp"/>,
     82      <ulink url="https://chrony.tuxfamily.org/">chronyd</ulink>, and
     83      <ulink url="https://github.com/thkukuk/ypbind-mt/">ypbind</ulink>
    7084    </para>
    7185
    … …  
    7892    <title>Installation of dhcpcd</title>
    7993
    80     <para>Install <application>dhcpcd</application> by running the following
    81     commands:</para>
     94    <para>
     95      Install <application>dhcpcd</application> by running the following
     96      commands:
     97    </para>
    8298
    8399<screen><userinput>./configure --libexecdir=/lib/dhcpcd \
    … …  
    85101make</userinput></screen>
    86102
    87     <para>To test the results, issue: <command>make test</command>.</para>
    88 
    89     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     103    <para>
     104      To test the results, issue: <command>make test</command>.
     105    </para>
     106
     107    <para>
     108      Now, as the <systemitem class="username">root</systemitem> user:
     109    </para>
    90110
    91111<screen role='root'><userinput>make install</userinput></screen>
    92112
    93113<!--
    94     <para>By default, a plain text lease info file isn't created but the
    95     <application>dhcpcd</application> provides a hook which can be used for creating
    96     such a file. Install the hook by running the following
    97     commands as the <systemitem class="username">root</systemitem> user:</para>
     114    <para>
     115      By default, a plain text lease info file isn't created but the
     116      <application>dhcpcd</application> provides a hook which can be used for
     117      creating such a file. Install the hook by running the following commands
     118      as the <systemitem class="username">root</systemitem> user:
     119    </para>
    98120
    99121<screen role='root'><userinput>sed -i "s;/var/lib;/run;g" dhcpcd-hooks/50-dhcpcd-compat &amp;&amp;
    … …  
    133155      <title>Config Files</title>
    134156
    135       <para><filename>/etc/dhcpcd.conf</filename></para>
     157      <para>
     158        <filename>/etc/dhcpcd.conf</filename>
     159      </para>
    136160
    137161      <indexterm zone="dhcpcd dhcpcd-config">
    … …  
    144168      <title>General Configuration Information</title>
    145169
    146       <para>To configure <command>dhcpcd</command>, you need to first install
    147       the network service script,
    148       <filename>/lib/services/dhcpcd</filename>
    149       included in the <xref linkend="bootscripts"/> package
    150       (as user <systemitem class="username">root</systemitem>):</para>
     170      <para>
     171        To configure <command>dhcpcd</command>, you need to first install
     172        the network service script,
     173        <filename>/lib/services/dhcpcd</filename>
     174        included in the <xref linkend="bootscripts"/> package
     175        (as user <systemitem class="username">root</systemitem>):
     176      </para>
    151177
    152178      <indexterm zone="dhcpcd dhcpcd-init">
    … …  
    156182<screen role='root'><userinput>make install-service-dhcpcd</userinput></screen>
    157183
    158       <para>Whenever <command>dhcpcd</command> configures or shuts down
    159       a network interface, it executes hook scripts. For more details
    160       about those scripts, see the <command>dhcpcd-run-hooks</command> and
    161       <command>dhcpcd</command> man pages.</para>
    162 
    163       <para id="dhcpcd-config2">Finally, as the <systemitem
    164       class="username">root</systemitem> user create the
    165       <filename>/etc/sysconfig/ifconfig.eth0</filename>
    166       configuration file using the following commands.  Adjust appropriately
    167       for additional interfaces:</para>
     184      <note>
     185        <para id="dhcpcd-config3">
     186          The default for <command>dhcpcd</command> is to set the hostname
     187          and mtu. It also overwrites <filename>/etc/resolv.conf </filename>
     188          and <filename>/etc/ntp.conf</filename>. These
     189          modifications to system files are done by hooks which are stored in
     190          <filename class="directory">/lib/dhcpcd/dhcpcd-hooks</filename>.
     191          Setup <command>dhcpcd</command> by removing or adding hooks from/to
     192          that directory.  The execution of hooks can be disabled by using
     193          the <option>--nohook</option> (<option>-C</option>) command line
     194          option or by the <option>nohook</option> option in the
     195          <filename>/etc/dhcpcd.conf</filename> file.
     196        </para>
     197      </note>
     198
     199      <para id="dhcpcd-config2">
     200        Finally, as the <systemitem class="username">root</systemitem> user
     201        create the <filename>/etc/sysconfig/ifconfig.eth0</filename>
     202        configuration file using the following commands. Adjust appropriately
     203        for additional interfaces:
     204      </para>
    168205
    169206      <indexterm zone="dhcpcd dhcpcd-config2">
    … …  
    179216EOF</userinput></screen>
    180217
    181       <para>For more information on the appropriate <envar>DHCP_START</envar> and
    182       <envar>DHCP_STOP</envar> values, examine the man page for
    183       <command>dhcpcd</command>.</para>
    184 
    185       <note>
    186 
    187         <para id="dhcpcd-config3">The default behavior of
    188         <command>dhcpcd</command> sets the hostname and mtu settings.  It also
    189         overwrites <filename>/etc/resolv.conf</filename> and
    190         <filename>/etc/ntp.conf</filename>.
    191 
    192         These modifications to system files and settings on system
    193         configuration files are done by hooks which are stored in <filename
    194         class="directory">/lib/dhcpcd/dhcpcd-hooks</filename>.
    195 
    196         Setup <command>dhcpcd</command> by removing or adding hooks from/to
    197         that directory.  The execution of hooks can be disabled by using the
    198         <option>--nohook</option> (<option>-C</option>) command line option or
    199         by the <option>nohook</option> option in the
    200         <filename>/etc/dhcpcd.conf</filename> file.</para>
    201 
    202         <para>Review the <command>dhcpcd</command> man page for switches to add
    203         to the <envar>DHCP_START</envar> value.</para>
    204 
    205       </note>
     218      <para>
     219        For more information on the appropriate <envar>DHCP_START</envar> and
     220        <envar>DHCP_STOP</envar> values, examine the man page for
     221        <command>dhcpcd</command>.
     222      </para>
    206223
    207224      <indexterm zone="dhcpcd dhcpcd-config3">
    … …  
    213230      <title>Configuration Information: fixed ip</title>
    214231
    215       <para id="dhcpcd-config4">Although not usual, it is possible that you need
     232      <para id="dhcpcd-config4">
     233        Although not usual, it is possible that you need
    216234        to configure <application>dhcpcd</application> to use a fixed ip. Here,
    217235        we give an example. As the
    … …  
    219237        <filename>/etc/sysconfig/ifconfig.eth0</filename> configuration file
    220238        using the following commands.  Adjust appropriately for additional
    221         interfaces and for the actual ip and router you need:</para>
     239        interfaces and for the actual ip and router you need:
     240      </para>
    222241
    223242      <indexterm zone="dhcpcd dhcpcd-config4">
    … …  
    225244      </indexterm>
    226245
    227 <screen role='root'><userinput>cat &gt; /etc/sysconfig/ifconfig.eth0 &lt;&lt; "EOF"
     246<screen role='nodump'><userinput>cat &gt; /etc/sysconfig/ifconfig.eth0 &lt;&lt; "EOF"
    228247<literal>ONBOOT="yes"
    229248IFACE="eth0"
    … …  
    233252EOF</userinput></screen>
    234253
    235       <para>You can either use DNS servers in
     254      <para>
     255        You can either use DNS servers in
    236256        <filename>/etc/resolv.conf</filename> from another system, your
    237257        preferred servers, or just the example
    238         <filename>/etc/resolv.conf.head</filename> file below as is:</para>
    239 
    240 <screen role='root'><userinput>cat &gt; /etc/resolv.conf.head &lt;&lt; "EOF"
     258        <filename>/etc/resolv.conf.head</filename> file below as is:
     259      </para>
     260
     261<screen role='nodump'><userinput>cat &gt; /etc/resolv.conf.head &lt;&lt; "EOF"
    241262<literal># OpenDNS servers
    242263nameserver 208.67.222.222
    … …  
    263284      </indexterm>
    264285
    265       <para>
    266         Whenever <command>dhcpcd</command> configures or shuts down
    267         a network interface, it executes hook scripts. For more details
    268         about those scripts, see the <command>dhcpcd-run-hooks</command> and
    269         <command>dhcpcd</command> man pages.
    270       </para>
    271 
    272286      <note>
    273         <para id="dhcpcd-config5">The default behavior of
    274         <command>dhcpcd</command> sets the hostname and mtu settings. It also
    275         overwrites <filename>/etc/resolv.conf</filename> and
    276         <filename>/etc/ntp.conf</filename>.
    277 
    278         These modifications to system files and settings on system
    279         configuration files are done by hooks which are stored in <filename
    280         class="directory">/lib/dhcpcd/dhcpcd-hooks</filename>.
    281 
    282         Setup <command>dhcpcd</command> by removing or adding hooks from/to
    283         that directory.  The execution of hooks can be disabled by using the
    284         <option>--nohook</option> (<option>-C</option>) command line option or
    285         by the <option>nohook</option> option in the
    286         <filename>/etc/dhcpcd.conf</filename> file.</para>
     287        <para id="dhcpcd-config5">
     288          The default behavior of <command>dhcpcd</command> is to set the
     289          hostname and the mtu. It also overwrites <filename>/etc/resolv.conf
     290          </filename> and <filename>/etc/ntp.conf</filename>. These
     291          modifications to system configuration files are done by hooks which
     292          are stored in <filename class="directory">
     293          /lib/dhcpcd/dhcpcd-hooks</filename>. Setup <command>dhcpcd</command>
     294          by removing or adding hooks from/to that directory. The execution
     295          of hooks can be disabled by using the <option>--nohook</option>
     296          (<option>-C</option>) command line option or by the
     297          <option>nohook</option> option in the <filename>/etc/dhcpcd.conf
     298          </filename> file.
     299        </para>
    287300      </note>
    288301
    … …  
    291304      </indexterm>
    292305
    293     <note>
    294       <para>
    295         Make sure that you disable the <command>systemd-networkd</command>
    296         service or configure it not to manage the interfaces you want to manage
    297         with <application>dhcpcd</application>.
    298       </para>
    299     </note>
     306      <note>
     307        <para>
     308          Make sure that you disable the <command>systemd-networkd</command>
     309          service or configure it not to manage the interfaces you want to
     310          manage with <application>dhcpcd</application>.
     311        </para>
     312      </note>
    300313
    301314      <para>
    … …  
    347360        <term><command>dhcpcd</command></term>
    348361        <listitem>
    349           <para>is an implementation of the DHCP client specified
    350           in RFC2131.</para>
     362          <para>
     363            is an implementation of the DHCP client specified in RFC2131.
     364          </para>
    351365          <indexterm zone="dhcpcd dhcpcd-prog">
    352366            <primary sortas="b-dhcpcd">dhcpcd</primary>

  • networking/mailnews/fetchmail.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to Fetchmail</title>
    3131
    32     <para>The <application>Fetchmail</application> package contains a mail
    33     retrieval program. It retrieves mail from remote mail servers and
    34     forwards it to the local (client) machine's delivery system, so it can then be
    35     read by normal mail user agents.</para>
     32    <para>
     33      The <application>Fetchmail</application> package contains a mail
     34      retrieval program. It retrieves mail from remote mail servers and
     35      forwards it to the local (client) machine's delivery system, so it can
     36      then be read by normal mail user agents.
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing='compact'>
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&fetchmail-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&fetchmail-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &fetchmail-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &fetchmail-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &fetchmail-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &fetchmail-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&fetchmail-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&fetchmail-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &fetchmail-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &fetchmail-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &fetchmail-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &fetchmail-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    7286      libintl is part of gettext so enabled by default on LFS -->
    7387      <xref linkend="mitkrb"/>,
    74       <!-- fetchmailconf is unmaintained so even with these deps it will be useless
     88      <!-- fetchmailconf is unmaintained so even with these deps it will be
     89           useless
    7590      <xref linkend="python2"/>, built after
    7691      <xref linkend="tk"/>-->
    77       <ulink url="http://www.citi.umich.edu/projects/nfsv4/linux/">libgssapi</ulink>
     92      <ulink url="http://www.citi.umich.edu/projects/nfsv4/linux/">
     93        libgssapi
     94      </ulink>
    7895    </para>
    7996
    … …  
    95112        -s /bin/false -u 38 fetchmail</userinput></screen>
    96113
    97     <para>Install <application>Fetchmail</application> by running the following
    98     commands:</para>
     114    <para>
     115      Install <application>Fetchmail</application> by running the following
     116      commands:
     117    </para>
    99118
    100119<screen><userinput>PYTHON=python3 \
    … …  
    108127
    109128
    110     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     129    <para>
     130      Now, as the <systemitem class="username">root</systemitem> user:
     131    </para>
    111132
    112133<screen role='root'><userinput>make install                                  &amp;&amp;
    … …  
    125146    </para>
    126147
    127     <para><parameter>--enable-fallback=procmail</parameter>: This tells
    128     <application>Fetchmail</application> to hand incoming mail to
    129     <application>Procmail</application> for delivery, if the port 25 mail server is
    130     not present or not responding.</para>
     148    <para>
     149      <parameter>--enable-fallback=procmail</parameter>: This tells
     150      <application>Fetchmail</application> to hand incoming mail to
     151      <application>Procmail</application> for delivery, if the port 25 mail
     152      server is not present or not responding.
     153    </para>
    131154
    132155  </sect2>
    … …  
    138161      <title>Config Files</title>
    139162
    140       <para><filename>~/.fetchmailrc</filename></para>
     163      <para>
     164        <filename>~/.fetchmailrc</filename>
     165      </para>
    141166
    142167      <indexterm zone="fetchmail fetchmail-config">
    … …  
    167192chmod -v 0600 ~/.fetchmailrc</userinput></screen>
    168193
    169       <para>This is an example configuration that should suffice for most people.
    170       You can add as many users and servers as you need using the same syntax.</para>
    171 
    172       <para><command>man fetchmail</command>: Look for the section near the
    173       bottom named <emphasis>CONFIGURATION EXAMPLES</emphasis>. It gives some
    174       quick examples. There are countless other configuration options once you
    175       get used to it.</para>
    176 
    177       <para>If you expect to receive very little mail you can invoke fetchmail
    178       when you wish to receive any incoming mail. More commonly, it is either
    179       invoked in daemon mode with the <literal>-d</literal> option either on the
    180       command line, or in <filename>.fetchmailrc</filename> (see 'DAEMON MODE'
    181       in man fetchmailconf), or alternatively it is invoked from a cron job.</para>
     194      <para>
     195        This is an example configuration that should suffice for most people.
     196        You can add as many users and servers as you need using the same syntax.
     197      </para>
     198
     199      <para>
     200        <command>man fetchmail</command>: Look for the section near the bottom
     201        named <emphasis>CONFIGURATION EXAMPLES</emphasis>. It gives some quick
     202        examples. There are countless other configuration options once you get
     203        used to it.
     204      </para>
     205
     206      <para>
     207        If you expect to receive very little mail you can invoke fetchmail
     208        when you wish to receive any incoming mail. More commonly, it is either
     209        invoked in daemon mode with the <literal>-d</literal> option either on
     210        the command line, or in <filename>.fetchmailrc</filename> (see 'DAEMON
     211        MODE' in man fetchmailconf), or alternatively it is invoked from a
     212        cron job.
     213      </para>
    182214
    183215    </sect3>
    … …  
    208240        <term><command>fetchmail</command></term>
    209241        <listitem>
    210           <para>when executed as a user, this will source
    211           <filename>~/.fetchmailrc</filename> and download the appropriate mail.
     242          <para>
     243            when executed as a user, this will source
     244            <filename>~/.fetchmailrc</filename> and download the appropriate
     245            mail.
    212246          </para>
    213247          <indexterm zone="fetchmail fetchmail-prog">
    … …  
    221255        <listitem>
    222256          <!-- keep detailed description commented pending any feedback
    223           <para>was intended to assist you in setting up and editing a
    224           <filename>~/.fetchmailrc</filename> configuration file, by using
    225           a <application>Tk</application> GUI interface. It is written for
    226           <application>Python</application> and the Tkinker module but is
    227           unmaintained and labelled with a WARNING that it needs to be updated
    228           for fetchmail 6.4's SSL options and other recent new options, and
    229           for Python3 it will need to be run through 2to3.py.</para>-->
     257          <para>
     258            was intended to assist you in setting up and editing a
     259            <filename>~/.fetchmailrc</filename> configuration file, by using
     260            a <application>Tk</application> GUI interface. It is written for
     261            <application>Python</application> and the Tkinker module but is
     262            unmaintained and labelled with a WARNING that it needs to be updated
     263            for fetchmail 6.4's SSL options and other recent new options, and
     264            for Python3 it will need to be run through 2to3.py.
     265          </para>-->
    230266          <para>
    231267            is an unmaintained GUI command to assist in creating a

  • networking/mailnews/mailnews.xml

    rbb65a3c r7c56ece  
    1515  <title>Mail/News Clients</title>
    1616
    17   <para>Mail Clients help you retrieve (Fetchmail), sort (Procmail), read and
    18   compose responses (Heirloom mailx, Mutt, Pine, Kmail, Balsa, Evolution,
    19   SeaMonkey) to email.</para>
     17  <para>
     18    Mail Clients help you retrieve (Fetchmail), sort (Procmail), read and
     19    compose responses (Heirloom mailx, Mutt, Pine, Kmail, Balsa, Evolution,
     20    SeaMonkey) to email.
     21  </para>
    2022
    21   <para>News clients also help you retrieve, sort, read and compose
    22   responses, but these messages travel through USENET (a worldwide
    23   bulletin board system) using the Network News Transfer Protocol
    24   (NNTP).</para>
     23  <para>
     24    News clients also help you retrieve, sort, read and compose
     25    responses, but these messages travel through USENET (a worldwide
     26    bulletin board system) using the Network News Transfer Protocol
     27    (NNTP).
     28  </para>
    2529
    2630<!--  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="alpine.xml"/>-->

  • networking/mailnews/mailx.xml

    rbb65a3c r7c56ece  
    3333    <title>Introduction to Heirloom mailx</title>
    3434
    35     <para>The <application>Heirloom mailx</application> package (formerly
    36     known as the <application>Nail</application> package) contains
    37     <command>mailx</command>, a command-line Mail User Agent derived from
    38     Berkeley Mail. It is intended to provide the functionality of the POSIX
    39     <command>mailx</command> command with additional support for MIME messages,
    40     IMAP (including caching), POP3, SMTP, S/MIME, message threading/sorting,
    41     scoring, and filtering. <application>Heirloom mailx</application> is
    42     especially useful for writing scripts and batch processing.</para>
     35    <para>
     36      The <application>Heirloom mailx</application> package (formerly
     37      known as the <application>Nail</application> package) contains
     38      <command>mailx</command>, a command-line Mail User Agent derived from
     39      Berkeley Mail. It is intended to provide the functionality of the POSIX
     40      <command>mailx</command> command with additional support for MIME
     41      messages, IMAP (including caching), POP3, SMTP, S/MIME, message
     42      threading/sorting, scoring, and filtering. <application>Heirloom
     43      mailx</application> is especially useful for writing scripts and batch
     44      processing.
     45    </para>
    4346
    4447    &lfs91_checked;
    … …  
    4750    <itemizedlist spacing='compact'>
    4851      <listitem>
    49         <para>Download (HTTP): <ulink url="&mailx-download-http;"/></para>
    50       </listitem>
    51       <listitem>
    52         <para>Download (FTP): <ulink url="&mailx-download-ftp;"/></para>
    53       </listitem>
    54       <listitem>
    55         <para>Download MD5 sum: &mailx-md5sum;</para>
    56       </listitem>
    57       <listitem><para>Download size: &mailx-size;</para>
    58       </listitem>
    59       <listitem>
    60         <para>Estimated disk space required: &mailx-buildsize;</para>
    61       </listitem>
    62       <listitem>
    63         <para>Estimated build time: &mailx-time;</para>
     52        <para>
     53          Download (HTTP): <ulink url="&mailx-download-http;"/>
     54        </para>
     55      </listitem>
     56      <listitem>
     57        <para>
     58          Download (FTP): <ulink url="&mailx-download-ftp;"/>
     59        </para>
     60      </listitem>
     61      <listitem>
     62        <para>
     63          Download MD5 sum: &mailx-md5sum;
     64        </para>
     65      </listitem>
     66      <listitem>
     67        <para>
     68          Download size: &mailx-size;
     69        </para>
     70      </listitem>
     71      <listitem>
     72        <para>
     73          Estimated disk space required: &mailx-buildsize;
     74        </para>
     75      </listitem>
     76      <listitem>
     77        <para>
     78          Estimated build time: &mailx-time;
     79        </para>
    6480      </listitem>
    6581    </itemizedlist>
    … …  
    6884    <itemizedlist spacing='compact'>
    6985      <listitem>
    70         <para>Required patch: <ulink
    71         url="&patch-root;/heirloom-mailx-&mailx-version;-fixes-1.patch"/>
     86        <para>
     87          Required patch: <ulink
     88          url="&patch-root;/heirloom-mailx-&mailx-version;-fixes-1.patch"/>
    7289        </para>
    7390      </listitem>
    … …  
    100117    </note>
    101118
    102     <para>Install <application>Heirloom mailx</application> by running the
    103     following commands.</para>
     119    <para>
     120      Install <application>Heirloom mailx</application> by running the
     121      following commands.
     122    </para>
    104123
    105124<screen><userinput>patch -Np1 -i ../heirloom-mailx-&mailx-version;-fixes-1.patch &amp;&amp;
    … …  
    111130     SENDMAIL=/usr/sbin/sendmail</userinput></screen>
    112131
    113     <para>This package does not come with a test suite.</para>
    114 
    115     <para>Now, as the <systemitem class='username'>root</systemitem> user:</para>
     132    <para>
     133      This package does not come with a test suite.
     134    </para>
     135
     136    <para>
     137      Now, as the <systemitem class='username'>root</systemitem> user:
     138    </para>
    116139
    117140<screen role='root'><userinput>make PREFIX=/usr UCBINSTALL=/usr/bin/install install &amp;&amp;
    … …  
    128151    <title>Command Explanations</title>
    129152
    130     <para><command>make SENDMAIL=/usr/sbin/sendmail</command>: This changes the
    131     default MTA path of <command>/usr/lib/sendmail</command>.</para>
    132 
    133     <para><command>make PREFIX=/usr UCBINSTALL=/usr/bin/install
    134     install</command>: This changes the default installation path of
    135     <filename class='directory'>/usr/local</filename> and the default
    136     <command>install</command> command path of
    137     <filename class='directory'>/usr/ucb</filename>.</para>
     153    <para>
     154      <command>make SENDMAIL=/usr/sbin/sendmail</command>: This changes the
     155      default MTA path of <command>/usr/lib/sendmail</command>.
     156    </para>
     157
     158    <para>
     159      <command>make PREFIX=/usr UCBINSTALL=/usr/bin/install
     160      install</command>: This changes the default installation path of
     161      <filename class='directory'>/usr/local</filename> and the default
     162      <command>install</command> command path of
     163      <filename class='directory'>/usr/ucb</filename>.
     164    </para>
    138165
    139166  </sect2>
    … …  
    145172      <title>Config Files</title>
    146173
    147       <para><filename>/etc/nail.rc</filename>, <filename>~/.mailrc</filename>
    148       and <filename>~/.nailrc</filename></para>
     174      <para>
     175        <filename>/etc/nail.rc</filename>, <filename>~/.mailrc</filename>
     176        and <filename>~/.nailrc</filename>
     177      </para>
    149178
    150179      <indexterm zone="mailx mailx-config">
    … …  
    187216        <term><command>mailx</command></term>
    188217        <listitem>
    189           <para>is a command-line mail user agent compatible with the
    190           <command>mailx</command> command found on commercial Unix
    191           versions.</para>
     218          <para>
     219            is a command-line mail user agent compatible with the
     220            <command>mailx</command> command found on commercial Unix
     221            versions.
     222          </para>
    192223          <indexterm zone="mailx mailx-prog">
    193224            <primary sortas="b-mailx">mailx</primary>
    … …  
    199230        <term><command>mail</command></term>
    200231        <listitem>
    201           <para>is a symbolic link to <command>mailx</command>.</para>
     232          <para>
     233            is a symbolic link to <command>mailx</command>.
     234          </para>
    202235          <indexterm zone="mailx mail-mailx">
    203236            <primary sortas="b-mail">mail</primary>
    … …  
    209242        <term><command>nail</command></term>
    210243        <listitem>
    211           <para>is a symbolic link to <command>mailx</command>.</para>
     244          <para>
     245            is a symbolic link to <command>mailx</command>.
     246          </para>
    212247          <indexterm zone="mailx nail-mailx">
    213248            <primary sortas="b-nail">nail</primary>

  • 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>

  • networking/mailnews/other.xml

    rbb65a3c r7c56ece  
    1515
    1616  <title>Other Mail and News Programs</title>
     17  <!--
     18  <para>
     19    <xref linkend="pan"/> is a GTK2 based newsreader program.
     20  </para>
     21  -->
     22  <!--
     23  <para>
     24    <command>knode</command> is a <application>Qt</application> based
     25    newseader program from <xref linkend="kdepim"/>.
     26  </para>
     27  -->
     28  <!--
     29  <para>
     30    <command>kmail</command> is a <application>Qt</application> based mail
     31    client from <xref linkend="kdepim"/>.
     32  </para>
     33  -->
     34  <para>
     35    <xref linkend="balsa"/> is a GTK2 based mail client.
     36  </para>
    1737
    18   <!-- <para><xref linkend="pan"/> is a GTK2 based newsreader program.</para> -->
     38  <para>
     39    <xref linkend="seamonkey"/> includes both a mail client and newsreader in
     40    its installation.
     41  </para>
    1942
    20   <!--<para><command>knode</command> is a <application>Qt</application> based
    21   newseader program from <xref linkend="kdepim"/>.</para>-->
    22 
    23   <!--<para><command>kmail</command> is a <application>Qt</application> based mail
    24   client from <xref linkend="kdepim"/>.</para>-->
    25 
    26   <para><xref linkend="balsa"/> is a GTK2 based mail client.</para>
    27 
    28   <para><xref linkend="seamonkey"/> includes both a mail client and newsreader in
    29   its installation.</para>
    30 
    31   <para><xref linkend="thunderbird"/> is a mail/news client based on the
    32   <application>Mozilla</application> code base.</para>
     43  <para>
     44    <xref linkend="thunderbird"/> is a mail/news client based on the
     45    <application>Mozilla</application> code base.
     46  </para>
    3347
    3448</sect1>

  • networking/mailnews/procmail.xml

    rbb65a3c r7c56ece  
    3232    <title>Introduction to Procmail</title>
    3333
    34     <para>The <application>Procmail</application> package contains an autonomous
    35     mail processor. This is useful for filtering and sorting incoming mail.</para>
     34    <para>
     35      The <application>Procmail</application> package contains an autonomous
     36      mail processor. This is useful for filtering and sorting incoming mail.
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing='compact'>
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&procmail-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&procmail-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &procmail-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &procmail-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &procmail-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &procmail-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&procmail-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&procmail-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &procmail-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &procmail-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &procmail-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &procmail-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    8498    <title>Installation of Procmail</title>
    8599
    86     <para>This package does not come with a test suite.</para>
    87 
    88     <para>Install <application>Procmail</application> by running the following
    89     commands as the <systemitem class="username">root</systemitem> user:</para>
     100    <para>
     101      This package does not come with a test suite.
     102    </para>
     103
     104    <para>
     105      Install <application>Procmail</application> by running the following
     106      commands as the <systemitem class="username">root</systemitem> user:
     107    </para>
    90108
    91109<screen role='root'><userinput>sed -i 's/getline/get_line/' src/*.[ch]                   &amp;&amp;
    … …  
    100118    <title>Command Explanations</title>
    101119
    102     <para><command>sed -i 's/getline/get_line/' src/*.[ch]</command>: This renames
    103     procmail's getline function to avoid conflict with the getline function from
    104     <application>glibc</application>.</para>
    105 
    106     <para><command>make LOCKINGTEST=/tmp install</command>: This prevents
    107     <command>make</command> from asking you where to test file-locking
    108     patterns.</para>
    109 
    110     <para><command>make install-suid</command>: Modifies permissions of
    111     the installed files.</para>
     120    <para>
     121      <command>sed -i 's/getline/get_line/' src/*.[ch]</command>: This renames
     122      procmail's getline function to avoid conflict with the getline function
     123      from <application>glibc</application>.
     124    </para>
     125
     126    <para>
     127      <command>make LOCKINGTEST=/tmp install</command>: This prevents
     128      <command>make</command> from asking you where to test file-locking
     129      patterns.
     130    </para>
     131
     132    <para>
     133      <command>make install-suid</command>: Modifies permissions of
     134      the installed files.
     135    </para>
    112136
    113137  </sect2>
    … …  
    119143      <title>Config Files</title>
    120144
    121       <para><filename>/etc/procmailrc</filename> and
    122       <filename>~/.procmailrc</filename></para>
     145      <para>
     146        <filename>/etc/procmailrc</filename> and
     147        <filename>~/.procmailrc</filename>
     148      </para>
    123149
    124150      <indexterm zone="procmail procmail-config">
    … …  
    135161      <title>Configuration Information</title>
    136162
    137       <para>Recipes have to be written and placed in
    138       <filename>~/.procmailrc</filename> for execution. The procmailex man
    139       page is the starting place to learn how to write recipes.
    140       For additional information, see also
    141       <ulink url="http://pm-doc.sourceforge.net/"/>.
     163      <para>
     164        Recipes have to be written and placed in
     165        <filename>~/.procmailrc</filename> for execution. The procmailex man
     166        page is the starting place to learn how to write recipes.
     167        For additional information, see also
     168        <ulink url="http://pm-doc.sourceforge.net/"/>.
    142169      </para>
    143170
    … …  
    169196        <term><command>formail</command></term>
    170197        <listitem>
    171           <para>is a filter that can be used to format mail into mailbox format.</para>
     198          <para>
     199            is a filter that can be used to format mail into mailbox format.
     200          </para>
    172201          <indexterm zone="procmail formail">
    173202            <primary sortas="b-formail">formail</primary>
    … …  
    179208        <term><command>lockfile</command></term>
    180209        <listitem>
    181           <para>is a utility that can lock a file for single use interactively or in a
    182           script.</para>
     210          <para>
     211            is a utility that can lock a file for single use interactively or
     212            in a script.
     213          </para>
    183214          <indexterm zone="procmail lockfile">
    184215            <primary sortas="b-lockfile">lockfile</primary>
    … …  
    190221        <term><command>mailstat</command></term>
    191222        <listitem>
    192           <para>prints a summary report of mail that has been filtered by
    193           <command>procmail</command> since the last time <command>mailstat</command>
    194           was ran.</para>
     223          <para>
     224            prints a summary report of mail that has been filtered by
     225            <command>procmail</command> since the last time
     226            <command>mailstat</command> was ran.
     227          </para>
    195228          <indexterm zone="procmail mailstat">
    196229            <primary sortas="b-mailstat">mailstat</primary>
    … …  
    202235        <term><command>procmail</command></term>
    203236        <listitem>
    204           <para>is an autonomous mail processor. It performs all the functions
    205           of an MDA (Mail Delivery Agent).</para>
     237          <para>
     238            is an autonomous mail processor. It performs all the functions
     239            of an MDA (Mail Delivery Agent).
     240          </para>
    206241          <indexterm zone="procmail procmail-prog">
    207242            <primary sortas="b-procmail">procmail</primary>

  • networking/netlibs/curl.xml

    rbb65a3c r7c56ece  
    7878    <itemizedlist spacing="compact">
    7979      <listitem>
    80         <para>Patch to fix DNS resolution issues: <ulink
    81         url="&patch-root;/curl-7.65.1-fix_dns_segfaults-2.patch"/>
     80        <para>
     81          Patch to fix DNS resolution issues: <ulink
     82          url="&patch-root;/curl-7.65.1-fix_dns_segfaults-2.patch"/>
    8283        </para>
    8384      </listitem>

  • networking/netlibs/libpcap.xml

    rbb65a3c r7c56ece  
    134134    <title>Command Explanations</title>
    135135
    136     <para><option>--enable-bluetooth=no</option>: Necessary, if the
    137     recommended patch is not applied, because since 1.6.1 this application
    138     needs a fix, in order to build with
    139     <application>bluez-5.21</application>.</para>
     136    <para>
     137      <option>--enable-bluetooth=no</option>: Necessary, if the recommended
     138      patch is not applied, because since 1.6.1 this application needs a fix,
     139      in order to build with <application>bluez-5.21</application>.
     140    </para>
    140141
    141142  </sect2>

  • networking/netlibs/libtirpc.xml

    rbb65a3c r7c56ece  
    8888    <title>Installation of libtirpc</title>
    8989
    90     <note><para>If updating this package, you will also need to update
    91     any existing version of <xref linkend='rpcbind'/></para></note>
     90    <note>
     91      <para>
     92        If updating this package, you will also need to update
     93        any existing version of <xref linkend='rpcbind'/>
     94      </para>
     95    </note>
    9296<!--  Looks like this is incorporated in version 1.0.3
    9397    <para>

  • networking/netlibs/neon.xml

    rbb65a3c r7c56ece  
    8080      <xref linkend="mitkrb"/>,
    8181      <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>, and
    82       <ulink url="https://web.archive.org/web/20180310225603/http://www.manyfish.co.uk:80/pakchois/">pakchois</ulink>
    83       <!-- Note - this URL is broken as of 08-16-2018
    84       01-01-2019 - still broken.  -->
     82      <ulink url="http://www.manyfish.co.uk/pakchois/">PaKChoiS</ulink>
    8583    </para>
    8684
    … …  
    9391    <title>Installation of neon</title>
    9492
    95     <para>Fix some code when building with gnutls-3.4 and later:</para>
     93    <para>
     94      Fix some code when building with gnutls-3.4 and later:
     95    </para>
    9696
    9797<screen><userinput>sed -e 's/client_set/set/'  \

  • networking/netlibs/netlibs.xml

    rbb65a3c r7c56ece  
    1616  <title>Networking Libraries</title>
    1717
    18   <para>These applications are support libraries for other applications in
    19   the book.  It is unlikely that you would just install these libraries, you will
    20   generally find that you will be referred to this chapter to satisfy a
    21   dependency of other applications.</para>
    22 
     18  <para>
     19    These applications are support libraries for other applications in the
     20    book. It is unlikely that you would just install these libraries, you
     21    will generally find that you will be referred to this chapter to satisfy
     22    a dependency of other applications.
     23  </para>
    2324
    2425  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="c-ares.xml"/>
    2526  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="curl.xml"/>
    26   <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="geoclue.xml"/> -->
    2727  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="geoclue2.xml"/>
    2828  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="glib-networking.xml"/>
    … …  
    4242  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="rpcsvc-proto.xml"/>
    4343  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="serf.xml"/>
    44 
    45   <!-- systemd only -->
    4644  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="uhttpmock.xml"/>
    4745</chapter>

  • networking/netlibs/nghttp2.xml

    rbb65a3c r7c56ece  
    7070      </listitem>
    7171    </itemizedlist>
    72 <!--
    73     <note><para>Download this file via wget as:</para>
    74 <screen><userinput>wget https://github.com/nghttp2/nghttp2/archive/v&nghttp2-version;.tar.gz \
    75      -O nghttp2-&nghttp2-version;.tar.gz</userinput></screen>
    76     </note>
    77 -->
     72
    7873    <bridgehead renderas="sect3">nghttp2 Dependencies</bridgehead>
    7974

  • networking/netprogs/bridgeutils.xml

    rbb65a3c r7c56ece  
    130130  </sect2>
    131131
    132   <sect2 role="configuration">
     132  <sect2 role="configuration" revision="sysv">
    133133    <title>Configuring bridge-utils</title>
    134134
    135     <sect3 id='bridgeutils-init' revision="sysv">
     135    <sect3 id='bridgeutils-init'>
    136136      <title>Configuration Information</title>
    137137
    … …  
    206206
    207207    </sect3>
    208 
    209     <sect3 id='bridgeutils-init-systemd' revision="systemd">
     208  </sect2>
     209<!-- There is a whole page about bridging for systemd in the "Connecting to
     210     a network" chapter
     211  <sect2 role="configuration" revision="systemd">
     212    <title>Configuring bridge-utils</title>
     213
     214    <sect3 id='bridgeutils-init-systemd'>
    210215      <title>Configuration Information</title>
    211216      <para>
    … …  
    213218      </para>
    214219    </sect3>
    215 
    216   </sect2>
     220  </sect2>
     221-->
    217222
    218223

  • networking/netprogs/wpa_supplicant.xml

    rbb65a3c r7c56ece  
    321321        <phrase revision="sysv">
    322322          <filename>
    323             /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf
    324           </filename>.
     323 /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.
    325324        </phrase>
    326325        <phrase revision="systemd">
    327326          <filename>
    328             /etc/wpa_supplicant/wpa_supplicant-<replaceable>wifi0</replaceable>.conf
    329           </filename>.
     327 /etc/wpa_supplicant/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.
    330328        </phrase>
    331329        SSID is the string that the access point/router transmits to
    … …  
    360358        <phrase revision="sysv">
    361359          <filename>
    362             /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf
    363           </filename>
     360/etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.
    364361        </phrase>
    365362        <phrase revision="systemd">
    366363          <filename>
    367             /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf
    368           </filename>
    369         </phrase>.
     364/etc/wpa_supplicant/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.
     365        </phrase>
    370366        Replace "Some-SSID" with the SSID of the access point/router.
    371367      </para>

  • networking/netutils/avahi.xml

    rbb65a3c r7c56ece  
    125125<screen role="root"><userinput>groupadd -fg 86 netdev</userinput></screen>
    126126
    127     <para>Install <application>Avahi</application> by running the following
    128     commands:</para>
     127    <para>
     128      Install <application>Avahi</application> by running the following
     129      commands:
     130    </para>
    129131
    130132<screen revision="sysv"><userinput>./configure --prefix=/usr        \
    … …  
    162164    </para>
    163165
    164     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     166    <para>
     167      Now, as the <systemitem class="username">root</systemitem> user:
     168    </para>
    165169
    166170<screen role="root"><userinput>make install</userinput></screen>
    … …  
    339343        <term><command>avahi-autoipd</command></term>
    340344        <listitem>
    341           <para>is a IPv4LL network address configuration daemon.</para>
     345          <para>
     346            is a IPv4LL network address configuration daemon.
     347          </para>
    342348          <indexterm zone="avahi avahi-autoipd">
    343349            <primary sortas="b-avahi-autoipd">avahi-autoipd</primary>
    … …  
    349355        <term><command>avahi-bookmarks</command></term>
    350356        <listitem>
    351           <para>is a Web service showing mDNS/DNS-SD announced HTTP services
    352           using the <application>Avahi</application> daemon.</para>
     357          <para>
     358            is a Web service showing mDNS/DNS-SD announced HTTP services
     359            using the <application>Avahi</application> daemon.
     360          </para>
    353361          <indexterm zone="avahi avahi-bookmarks">
    354362            <primary sortas="b-avahi-bookmarks">avahi-bookmarks</primary>
    … …  
    360368        <term><command>avahi-browse</command></term>
    361369        <listitem>
    362           <para>browses for mDNS/DNS-SD services using the
    363           <application>Avahi</application> daemon.</para>
     370          <para>
     371            browses for mDNS/DNS-SD services using the
     372            <application>Avahi</application> daemon.
     373          </para>
    364374          <indexterm zone="avahi avahi-browse">
    365375            <primary sortas="b-avahi-browse">avahi-browse</primary>
    … …  
    371381        <term><command>avahi-browse-domains</command></term>
    372382        <listitem>
    373           <para>browses for mDNS/DNS-SD services using the
    374           <application>Avahi</application> daemon.</para>
     383          <para>
     384            browses for mDNS/DNS-SD services using the
     385            <application>Avahi</application> daemon.
     386          </para>
    375387          <indexterm zone="avahi avahi-browse-domains">
    376388            <primary sortas="b-avahi-browse-domains">avahi-browse-domains</primary>
    … …  
    382394        <term><command>avahi-daemon</command></term>
    383395        <listitem>
    384           <para>is the <application>Avahi</application> mDNS/DNS-SD
    385           daemon.</para>
     396          <para>
     397            is the <application>Avahi</application> mDNS/DNS-SD daemon.
     398          </para>
    386399          <indexterm zone="avahi avahi-daemon">
    387400            <primary sortas="b-avahi-daemon">avahi-daemon</primary>
    … …  
    393406        <term><command>avahi-discover</command></term>
    394407        <listitem>
    395           <para>browses for mDNS/DNS-SD services using the
    396           <application>Avahi</application> daemon.</para>
     408          <para>
     409            browses for mDNS/DNS-SD services using the
     410            <application>Avahi</application> daemon.
     411          </para>
    397412          <indexterm zone="avahi avahi-discover">
    398413            <primary sortas="b-avahi-discover">avahi-discover</primary>
    … …  
    404419        <term><command>avahi-discover-standalone</command></term>
    405420        <listitem>
    406           <para>browses for mDNS/DNS-SD services using the
    407           <application>Avahi</application> daemon.</para>
     421          <para>
     422            browses for mDNS/DNS-SD services using the
     423            <application>Avahi</application> daemon.
     424          </para>
    408425          <indexterm zone="avahi avahi-discover-standalone">
    409426            <primary sortas="b-avahi-discover-standalone">avahi-discover-standalone</primary>
    … …  
    415432        <term><command>avahi-dnsconfd</command></term>
    416433        <listitem>
    417           <para>is a Unicast DNS server from mDNS/DNS-SD configuration
    418           daemon.</para>
     434          <para>
     435            is a Unicast DNS server from mDNS/DNS-SD configuration daemon.
     436          </para>
    419437          <indexterm zone="avahi avahi-dnsconfd">
    420438            <primary sortas="b-avahi-dnsconfd">avahi-dnsconfd</primary>
    … …  
    426444        <term><command>avahi-publish</command></term>
    427445        <listitem>
    428           <para>registers a mDNS/DNS-SD service or host name or address mapping
    429           using the <application>Avahi</application> daemon.</para>
     446          <para>
     447            registers a mDNS/DNS-SD service or host name or address mapping
     448            using the <application>Avahi</application> daemon.
     449          </para>
    430450          <indexterm zone="avahi avahi-publish">
    431451            <primary sortas="b-avahi-publish">avahi-publish</primary>
    … …  
    437457        <term><command>avahi-publish-address</command></term>
    438458        <listitem>
    439           <para>registers a mDNS/DNS-SD service or host name or address mapping
    440           using the <application>Avahi</application> daemon.</para>
     459          <para>
     460            registers a mDNS/DNS-SD service or host name or address mapping
     461            using the <application>Avahi</application> daemon.
     462          </para>
    441463          <indexterm zone="avahi avahi-publish-address">
    442464            <primary sortas="b-avahi-publish-address">avahi-publish-address</primary>
    … …  
    448470        <term><command>avahi-publish-service</command></term>
    449471        <listitem>
    450           <para>registers a mDNS/DNS-SD service or host name or address mapping
    451           using the <application>Avahi</application> daemon.</para>
     472          <para>
     473            registers a mDNS/DNS-SD service or host name or address mapping
     474            using the <application>Avahi</application> daemon.
     475          </para>
    452476          <indexterm zone="avahi avahi-publish-service">
    453477            <primary sortas="b-avahi-publish-service">avahi-publish-service</primary>
    … …  
    459483        <term><command>avahi-resolve</command></term>
    460484        <listitem>
    461           <para>resolves one or more mDNS/DNS host name(s) to IP address(es)
    462           (and vice versa) using the <application>Avahi</application>
    463           daemon.</para>
     485          <para>
     486            resolves one or more mDNS/DNS host name(s) to IP address(es)
     487            (and vice versa) using the <application>Avahi</application>
     488            daemon.
     489          </para>
    464490          <indexterm zone="avahi avahi-resolve">
    465491            <primary sortas="b-avahi-resolve">avahi-resolve</primary>
    … …  
    471497        <term><command>avahi-resolve-address</command></term>
    472498        <listitem>
    473           <para>resolves one or more mDNS/DNS host name(s) to IP address(es)
    474           (and vice versa) using the <application>Avahi</application>
    475           daemon.</para>
     499          <para>
     500            resolves one or more mDNS/DNS host name(s) to IP address(es)
     501            (and vice versa) using the <application>Avahi</application>
     502            daemon.
     503          </para>
    476504          <indexterm zone="avahi avahi-resolve-address">
    477505            <primary sortas="b-avahi-resolve-address">avahi-resolve-address</primary>
    … …  
    483511        <term><command>avahi-resolve-host-name</command></term>
    484512        <listitem>
    485           <para>resolves one or more mDNS/DNS host name(s) to IP address(es)
    486           (and vice versa) using the <application>Avahi</application>
    487           daemon.</para>
     513          <para>
     514            resolves one or more mDNS/DNS host name(s) to IP address(es)
     515            (and vice versa) using the <application>Avahi</application>
     516            daemon.
     517          </para>
    488518          <indexterm zone="avahi avahi-resolve-host-name">
    489519            <primary sortas="b-avahi-resolve-host-name">avahi-resolve-host-name</primary>
    … …  
    495525        <term><command>avahi-set-host-name</command></term>
    496526        <listitem>
    497           <para>changes the mDNS host name.</para>
     527          <para>
     528            changes the mDNS host name.
     529          </para>
    498530          <indexterm zone="avahi avahi-set-host-name">
    499531            <primary sortas="b-avahi-set-host-name">avahi-set-host-name</primary>
    … …  
    505537        <term><command>bshell</command></term>
    506538        <listitem>
    507           <para>does this .....</para>
     539          <para>
     540            does this .....
     541          </para>
    508542          <indexterm zone="avahi bshell">
    509543            <primary sortas="b-bshell">bshell</primary>
    … …  
    515549        <term><command>bssh</command></term>
    516550        <listitem>
    517           <para>browses for SSH servers on the local network.</para>
     551          <para>
     552            browses for SSH servers on the local network.
     553          </para>
    518554          <indexterm zone="avahi bssh">
    519555            <primary sortas="b-bssh">bssh</primary>
    … …  
    525561        <term><command>bvnc</command></term>
    526562        <listitem>
    527           <para>browses for VNC servers on the local network.</para>
     563          <para>
     564            browses for VNC servers on the local network.
     565          </para>
    528566          <indexterm zone="avahi bvnc">
    529567            <primary sortas="b-bvnc">bvnc</primary>
    … …  
    535573        <term><filename class='libraryfile'>libavahi-client.{so,a}</filename></term>
    536574        <listitem>
    537           <para>contains functions that .....</para>
     575          <para>
     576            contains functions that .....
     577          </para>
    538578          <indexterm zone="avahi libavahi-client">
    539579            <primary sortas="c-libavahi-client">libavahi-client.{so,a}</primary>
    … …  
    545585        <term><filename class='libraryfile'>libavahi-common.{so,a}</filename></term>
    546586        <listitem>
    547           <para>contains functions that .....</para>
     587          <para>
     588            contains functions that .....
     589          </para>
    548590          <indexterm zone="avahi libavahi-common">
    549591            <primary sortas="c-libavahi-common">libavahi-common.{so,a}</primary>
    … …  
    555597        <term><filename class='libraryfile'>libavahi-core.{so,a}</filename></term>
    556598        <listitem>
    557           <para>contains functions that .....</para>
     599          <para>
     600            contains functions that .....
     601          </para>
    558602          <indexterm zone="avahi libavahi-core">
    559603            <primary sortas="c-libavahi-core">libavahi-core.{so,a}</primary>
    … …  
    565609        <term><filename class='libraryfile'>libavahi-glib.{so,a}</filename></term>
    566610        <listitem>
    567           <para>contains functions that .....</para>
     611          <para>
     612            contains functions that .....
     613          </para>
    568614          <indexterm zone="avahi libavahi-glib">
    569615            <primary sortas="c-libavahi-glib">libavahi-glib.{so,a}</primary>
    … …  
    575621        <term><filename class='libraryfile'>libavahi-gobject.{so,a}</filename></term>
    576622        <listitem>
    577           <para>contains functions that .....</para>
     623          <para>
     624            contains functions that .....
     625          </para>
    578626          <indexterm zone="avahi libavahi-gobject">
    579627            <primary sortas="c-libavahi-gobject">libavahi-gobject.{so,a}</primary>
    … …  
    585633        <term><filename class='libraryfile'>libavahi-ui-gtk3.{so,a}</filename></term>
    586634        <listitem>
    587           <para>contains functions that .....</para>
     635          <para>
     636            contains functions that .....
     637          </para>
    588638          <indexterm zone="avahi libavahi-ui-gtk3">
    589639            <primary sortas="c-libavahi-ui-gtk3">libavahi-ui-gtk3.{so,a}</primary>
    … …  
    595645        <term><filename class='libraryfile'>libavahi-ui.{so,a}</filename></term>
    596646        <listitem>
    597           <para>contains functions that .....</para>
     647          <para>
     648            contains functions that .....
     649          </para>
    598650          <indexterm zone="avahi libavahi-ui">
    599651            <primary sortas="c-libavahi-ui">libavahi-ui.{so,a}</primary>
    … …  
    605657        <term><filename class='libraryfile'>libdns_sd.{so,a}</filename></term>
    606658        <listitem>
    607           <para>contains functions that .....</para>
     659          <para>
     660            contains functions that .....
     661          </para>
    608662          <indexterm zone="avahi libdns_sd">
    609663            <primary sortas="c-libdns_sd">libdns_sd.{so,a}</primary>
    … …  
    615669        <term><filename class='libraryfile'>libhowl.{so,a}</filename></term>
    616670        <listitem>
    617           <para>contains functions that .....</para>
     671          <para>
     672            contains functions that .....
     673          </para>
    618674          <indexterm zone="avahi libhowl">
    619675            <primary sortas="c-libhowl">libhowl.{so,a}</primary>

  • networking/netutils/bind-utils.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to BIND Utilities</title>
    3131
    32     <para><application>BIND Utilities</application> is not a separate
     32    <para>
     33      <application>BIND Utilities</application> is not a separate
    3334    package, it is a collection of the client side programs that are included
    3435    with <xref linkend="bind"/>. The <application>BIND</application>
    … …  
    4546    <itemizedlist spacing="compact">
    4647      <listitem>
    47         <para>Download (HTTP): <ulink url="&bind-download-http;"/></para>
     48        <para>
     49          Download (HTTP): <ulink url="&bind-download-http;"/></para>
    4850      </listitem>
    4951      <listitem>
    50         <para>Download (FTP): <ulink url="&bind-download-ftp;"/></para>
     52        <para>
     53          Download (FTP): <ulink url="&bind-download-ftp;"/></para>
    5154      </listitem>
    5255      <listitem>
    53         <para>Download MD5 sum: &bind-md5sum;</para>
     56        <para>
     57          Download MD5 sum: &bind-md5sum;</para>
    5458      </listitem>
    5559      <listitem>
    56         <para>Download size: &bind-size;</para>
     60        <para>
     61          Download size: &bind-size;</para>
    5762      </listitem>
    5863      <listitem>
    59         <para>Estimated disk space required: &bind-utils-buildsize;</para>
     64        <para>
     65          Estimated disk space required: &bind-utils-buildsize;</para>
    6066      </listitem>
    6167      <listitem>
    62         <para>Estimated build time: &bind-utils-time;</para>
     68        <para>
     69          Estimated build time: &bind-utils-time;</para>
    6370      </listitem>
    6471    </itemizedlist>
    … …  
    8087    <title>Installation of BIND Utilities</title>
    8188
    82     <para>Install <application>BIND Utilities</application> by
     89    <para>
     90      Install <application>BIND Utilities</application> by
    8391    running the following commands:</para>
    8492
    … …  
    9199make -C bin/dig</userinput></screen>
    92100
    93     <para>This portion of the package does not come with a test suite.</para>
     101    <para>
     102      This portion of the package does not come with a test suite.</para>
    94103
    95     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     104    <para>
     105      Now, as the <systemitem class="username">root</systemitem> user:</para>
    96106
    97107<screen role='root'><userinput>make -C bin/dig install</userinput></screen>
    … …  
    102112    <title>Command Explanations</title>
    103113
    104     <para><parameter>--without-python</parameter>: This option eliminates
     114    <para>
     115      <parameter>--without-python</parameter>: This option eliminates
    105116    the need for an unused python module.</para>
    106117
    107     <para><command>make -C lib/...</command>: These commands build the
     118    <para>
     119      <command>make -C lib/...</command>: These commands build the
    108120    libraries that are needed for the client programs.</para>
    109121
    110     <para><command>make -C bin/dig</command>: This command builds the
     122    <para>
     123      <command>make -C bin/dig</command>: This command builds the
    111124    client programs.</para>
    112125
    … …  
    130143    <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    131144
    132     <para>See the program descriptions in the <xref linkend="bind"/>
    133     section.</para>
     145    <para>
     146      See the program descriptions in the <xref linkend="bind"/> section.
     147    </para>
    134148
    135149  </sect2>

  • networking/netutils/netutils.xml

    rbb65a3c r7c56ece  
    1616  <title>Networking Utilities</title>
    1717
    18   <para>This chapter contains some tools that come in handy when the network
    19   needs investigating.</para>
     18  <para>
     19    This chapter contains some tools that come in handy when the network
     20    needs investigating.
     21  </para>
    2022
    2123  <para condition="html" role="usernotes">User Notes:

  • networking/netutils/networkmanager.xml

    rbb65a3c r7c56ece  
    163163    <title>Installation of NetworkManager</title>
    164164
    165     <para>If <xref linkend="qt5"/> is installed and the Qt based
    166     examples are desired, fix two meson.build files:</para>
     165    <para>
     166      If <xref linkend="qt5"/> is installed and the Qt based
     167      examples are desired, fix two meson.build files:
     168    </para>
    167169
    168170<screen><userinput>sed -e 's/-qt4/-qt5/'              \

  • networking/netutils/nmap.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to Nmap</title>
    3131
    32     <para><application>Nmap</application> is a utility for network exploration
    33     and security auditing. It supports ping scanning, port scanning and
    34     TCP/IP fingerprinting.</para>
     32    <para>
     33      <application>Nmap</application> is a utility for network exploration
     34      and security auditing. It supports ping scanning, port scanning and
     35      TCP/IP fingerprinting.
     36    </para>
    3537
    3638    &lfs91_checked;
    … …  
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&nmap-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&nmap-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &nmap-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &nmap-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &nmap-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &nmap-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&nmap-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&nmap-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &nmap-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &nmap-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &nmap-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &nmap-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
    … …  
    7488      <xref linkend="pcre"/>, and
    7589      <xref linkend="liblinear"/>
    76 <!--  libdnet is not recommended, see: http://nmap.org/svn/libdnet-stripped/NMAP_MODIFICATIONS
     90<!--  libdnet is not recommended, see:
     91      http://nmap.org/svn/libdnet-stripped/NMAP_MODIFICATIONS
    7792      <ulink url="http://code.google.com/p/libdnet/">libdnet</ulink>
    7893-->
    … …  
    8297    <para role="optional">
    8398      <xref linkend="pygtk"/> (required for <command>zenmap</command>),
    84       <xref linkend="python2"/> (required for <command>ndiff</command>) and
    85       <xref linkend="subversion"/> (required for <command>nmap-update</command>), and
     99      <xref linkend="python2"/> (required for <command>ndiff</command>),
     100      <xref linkend="subversion"/> (required for
     101      <command>nmap-update</command>), and
    86102      <xref linkend="libssh2"/>
    87103    </para>
    … …  
    95111    <title>Installation of Nmap</title>
    96112
    97     <para>Install <application>Nmap</application> by running the following
    98     commands:</para>
     113    <para>
     114      Install <application>Nmap</application> by running the following
     115      commands:
     116    </para>
    99117
    100118<screen><userinput>./configure --prefix=/usr --with-liblua=included &amp;&amp;
    101119make</userinput></screen>
    102120
    103     <para>If you wish to run the test suite, run the following command:</para>
     121    <para>
     122      If you wish to run the test suite, run the following command:
     123    </para>
    104124
    105125<screen><userinput>sed -i 's/lib./lib/' zenmap/test/run_tests.py</userinput></screen>
    106126
    107     <para>To test the results, issue: <command>make check</command> as the
    108     <systemitem class="username">root</systemitem> user. Tests need a
    109     graphical session.</para>
    110 
    111     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     127    <para>
     128      To test the results, issue: <command>make check</command> as the
     129      <systemitem class="username">root</systemitem> user. Tests need a
     130      graphical session.
     131    </para>
     132
     133    <para>
     134      Now, as the <systemitem class="username">root</systemitem> user:
     135    </para>
    112136
    113137<screen role="root"><userinput>make install</userinput></screen>
    … …  
    118142    <title>Command Explanations</title>
    119143
    120     <para><parameter>--with-liblua=included</parameter>: This switch is
    121     required to fix compilation with <application>lua</application> 5.3.</para>
     144    <para>
     145      <parameter>--with-liblua=included</parameter>: This switch is
     146      required to fix compilation with <application>lua</application> 5.3.
     147    </para>
    122148
    123149  </sect2>
    … …  
    136162          uninstall_zenmap, xnmap and zenmap
    137163        </seg>
    138 <!--    <seg>/usr/lib/python&python2-version;/site-packages/</seg>-->
    139164        <seg>
    140165          None
    … …  
    155180        <term><command>ncat</command></term>
    156181        <listitem>
    157           <para>is a utility for reading and writing data across networks from
    158           the command line.</para>
     182          <para>
     183            is a utility for reading and writing data across networks from
     184            the command line.
     185          </para>
    159186          <indexterm zone="nmap ncat">
    160187            <primary sortas="b-ncat">ncat</primary>
    … …  
    166193        <term><command>ndiff</command></term>
    167194        <listitem>
    168           <para>is a tool to aid in the comparison of Nmap scans.</para>
     195          <para>
     196            is a tool to aid in the comparison of Nmap scans.
     197          </para>
    169198          <indexterm zone="nmap ndiff">
    170199            <primary sortas="b-ndiff">ndiff</primary>
    … …  
    176205        <term><command>nmap</command></term>
    177206        <listitem>
    178           <para>is a utility for network exploration and security auditing. It
    179           supports ping scanning, port scanning and TCP/IP
    180           fingerprinting.</para>
     207          <para>
     208            is a utility for network exploration and security auditing. It
     209            supports ping scanning, port scanning and TCP/IP fingerprinting.
     210          </para>
    181211          <indexterm zone="nmap nmap-prog">
    182212            <primary sortas="b-nmap">nmap</primary>
    … …  
    188218        <term><command>nmapfe</command></term>
    189219        <listitem>
    190           <para>is a symbolic link to <command>zenmap</command>.</para>
     220          <para>
     221            is a symbolic link to <command>zenmap</command>.
     222          </para>
    191223          <indexterm zone="nmap nmapfe">
    192224            <primary sortas="b-nmapfe">nmapfe</primary>
    … …  
    198230        <term><command>nmap-update</command></term>
    199231        <listitem>
    200           <para>is an updater for Nmap architecture-independent files.</para>
     232          <para>
     233            is an updater for Nmap architecture-independent files.
     234          </para>
    201235          <indexterm zone="nmap nmap-update">
    202236            <primary sortas="b-nmap-update">nmap-update</primary>
    … …  
    209243        <listitem>
    210244          <para>
    211              is an open-source tool for network packet generation, response
    212              analysis and response time measurement.
     245            is an open-source tool for network packet generation, response
     246            analysis and response time measurement.
    213247          </para>
    214248          <indexterm zone="nmap nping">
    … …  
    222256        <listitem>
    223257          <para>
    224              is a Python script to uninstall <command>ndiff</command>.
     258            is a Python script to uninstall <command>ndiff</command>.
    225259          </para>
    226260          <indexterm zone="nmap uninstall_ndiff">
    … …  
    234268        <listitem>
    235269          <para>
    236              is a Python script to uninstall <command>zenmap</command>.
     270            is a Python script to uninstall <command>zenmap</command>.
    237271          </para>
    238272          <indexterm zone="nmap uninstall_zenmap">
    … …  
    245279        <term><command>xnmap</command></term>
    246280        <listitem>
    247           <para>is a symbolic link to <command>zenmap</command>.</para>
     281          <para>
     282            is a symbolic link to <command>zenmap</command>.
     283          </para>
    248284          <indexterm zone="nmap xnmap">
    249285            <primary sortas="f-xnmap">xnmap</primary>
    … …  
    255291        <term><command>zenmap</command></term>
    256292        <listitem>
    257           <para>is a Python based graphical nmap frontend viewer.</para>
     293          <para>
     294            is a Python based graphical nmap frontend viewer.
     295          </para>
    258296          <indexterm zone="nmap zenmap">
    259297            <primary sortas="f-zenmap">zenmap</primary>

  • networking/netutils/traceroute.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to Traceroute</title>
    3131
    32     <para>The <application>Traceroute</application> package contains a program
    33     which is used to display the network route that packets take to reach a
    34     specified host. This is a standard network troubleshooting tool. If you find
    35     yourself unable to connect to another system, traceroute can help pinpoint
    36     the problem.</para>
     32    <para>
     33      The <application>Traceroute</application> package contains a program
     34      which is used to display the network route that packets take to reach a
     35      specified host. This is a standard network troubleshooting tool. If you
     36      find yourself unable to connect to another system, traceroute can help
     37      pinpoint the problem.
     38    </para>
    3739
    38     <note><para>This package overwrites the version of
    39     <command>traceroute</command> that was installed in the inetutils package
    40     in LFS.  This version is more powerful and allows many more options than
    41     the standard version.</para></note>
     40    <note>
     41      <para>
     42        This package overwrites the version of <command>traceroute</command>
     43        that was installed in the inetutils package in LFS. This version is
     44        more powerful and allows many more options than the standard version.
     45      </para>
     46    </note>
     47
    4248
    4349    &lfs91_checked;
    … …  
    4652    <itemizedlist spacing="compact">
    4753      <listitem>
    48         <para>Download (HTTP): <ulink url="&traceroute-download-http;"/></para>
     54        <para>
     55          Download (HTTP): <ulink url="&traceroute-download-http;"/>
     56        </para>
    4957      </listitem>
    5058      <listitem>
    51         <para>Download (FTP): <ulink url="&traceroute-download-ftp;"/></para>
     59        <para>
     60          Download (FTP): <ulink url="&traceroute-download-ftp;"/>
     61        </para>
    5262      </listitem>
    5363      <listitem>
    54         <para>Download MD5 sum: &traceroute-md5sum;</para>
     64        <para>
     65          Download MD5 sum: &traceroute-md5sum;
     66        </para>
    5567      </listitem>
    5668      <listitem>
    57         <para>Download size: &traceroute-size;</para>
     69        <para>
     70          Download size: &traceroute-size;
     71        </para>
    5872      </listitem>
    5973      <listitem>
    60         <para>Estimated disk space required: &traceroute-buildsize;</para>
     74        <para>
     75          Estimated disk space required: &traceroute-buildsize;
     76        </para>
    6177      </listitem>
    6278      <listitem>
    63         <para>Estimated build time: &traceroute-time;</para>
     79        <para>
     80          Estimated build time: &traceroute-time;
     81        </para>
    6482      </listitem>
    6583    </itemizedlist>
    … …  
    7391    <title>Installation of Traceroute</title>
    7492
    75     <para>Install <application>Traceroute</application> by running the following
    76     commands:</para>
     93    <para>
     94      Install <application>Traceroute</application> by running the following
     95      commands:
     96    </para>
    7797
    7898<screen><userinput>make</userinput></screen>
    7999
    80     <para>This package does not come with a test suite.</para>
     100    <para>
     101      This package does not come with a test suite.
     102    </para>
    81103
    82     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     104    <para>
     105      Now, as the <systemitem class="username">root</systemitem> user:
     106    </para>
    83107
    84108<screen role='root'><userinput>make prefix=/usr install                                 &amp;&amp;
    … …  
    88112rm -fv /usr/share/man/man1/traceroute.1</userinput></screen>
    89113
    90     <para>The traceroute.1 file that was installed in LFS
    91     by inetutils is no longer relevant.  This package overwrites
    92     that version of traceroute and installs the man page in man
    93     chapter 8.</para>
     114    <para>
     115      The traceroute.1 file that was installed in LFS
     116      by inetutils is no longer relevant.  This package overwrites
     117      that version of traceroute and installs the man page in man
     118      chapter 8.
     119    </para>
     120
    94121  </sect2>
    95122
    … …  
    117144        <term><command>traceroute</command></term>
    118145        <listitem>
    119           <para>does basically what it says: it traces the route your packets
    120           take from the host you are working on to another host on a network,
    121           showing all the intermediate hops (gateways) along the way.</para>
     146          <para>
     147            does basically what it says: it traces the route your packets
     148            take from the host you are working on to another host on a network,
     149            showing all the intermediate hops (gateways) along the way.
     150          </para>
    122151          <indexterm zone="traceroute traceroute-prog">
    123152            <primary sortas="b-traceroute">traceroute</primary>
    … …  
    129158        <term><command>traceroute6</command></term>
    130159        <listitem>
    131           <para>is equivalent to <command>traceroute -6</command>.</para>
     160          <para>
     161            is equivalent to <command>traceroute -6</command>.
     162          </para>
    132163          <indexterm zone="traceroute traceroute6-prog">
    133164            <primary sortas="b-traceroute6">traceroute6</primary>

  • networking/netutils/whois.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to Whois</title>
    3131
    32     <para><application>Whois</application> is a client-side application which
    33     queries the whois directory service for information pertaining to a
    34     particular domain name. This package will install two programs by default:
    35     <command>whois</command> and <command>mkpasswd</command>. The
    36     <command>mkpasswd</command> command is also installed by the
    37     <xref linkend="expect"/> package.</para>
     32    <para>
     33      <application>Whois</application> is a client-side application which
     34      queries the whois directory service for information pertaining to a
     35      particular domain name. This package will install two programs by default:
     36      <command>whois</command> and <command>mkpasswd</command>. The
     37      <command>mkpasswd</command> command is also installed by the
     38      <xref linkend="expect"/> package.
     39    </para>
    3840
    3941    &lfs91_checked;
    … …  
    4244    <itemizedlist spacing="compact">
    4345      <listitem>
    44         <para>Download (HTTP): <ulink url="&whois-download-http;"/></para>
     46        <para>
     47          Download (HTTP): <ulink url="&whois-download-http;"/>
     48        </para>
    4549      </listitem>
    4650      <listitem>
    47         <para>Download (FTP): <ulink url="&whois-download-ftp;"/></para>
     51        <para>
     52          Download (FTP): <ulink url="&whois-download-ftp;"/>
     53        </para>
    4854      </listitem>
    4955      <listitem>
    50         <para>Download MD5 sum: &whois-md5sum;</para>
     56        <para>
     57          Download MD5 sum: &whois-md5sum;
     58        </para>
    5159      </listitem>
    5260      <listitem>
    53         <para>Download size: &whois-size;</para>
     61        <para>
     62          Download size: &whois-size;
     63        </para>
    5464      </listitem>
    5565      <listitem>
    56         <para>Estimated disk space required: &whois-buildsize;</para>
     66        <para>
     67          Estimated disk space required: &whois-buildsize;
     68        </para>
    5769      </listitem>
    5870      <listitem>
    59         <para>Estimated build time: &whois-time;</para>
     71        <para>
     72          Estimated build time: &whois-time;
     73        </para>
    6074      </listitem>
    6175    </itemizedlist>
    … …  
    7791    <title>Installation of Whois</title>
    7892
    79     <para>Build the application with:</para>
     93    <para>
     94      Build the application with:
     95    </para>
    8096
    8197<screen><userinput>make</userinput></screen>
    8298
    83     <para>You can install the <command>whois</command> program, the
    84     <command>mkpasswd</command> program, and the locale files independently.
    85     Control your choice of what is installed with the following commands issued
    86     as the <systemitem class="username">root</systemitem> user:</para>
     99    <para>
     100      You can install the <command>whois</command> program, the
     101      <command>mkpasswd</command> program, and the locale files independently.
     102      Control your choice of what is installed with the following commands
     103      issued as the <systemitem class="username">root</systemitem> user:
     104    </para>
    87105
    88     <note><para>Installing this version of <command>mkpasswd</command> will
    89     overwrite the same command installed by <xref
    90     linkend="expect"/>.</para></note>
     106    <note>
     107      <para>
     108        Installing this version of <command>mkpasswd</command> will
     109        overwrite the same command installed by <xref linkend="expect"/>.
     110      </para>
     111    </note>
    91112
    92113<!-- dev note: make BASEDIR=<DESTDIR> prefix=/usr install-whois -->
    … …  
    121142        <term><command>whois</command></term>
    122143        <listitem>
    123           <para>is a client-side application which queries the whois directory
    124           service for information pertaining to a particular domain name.</para>
     144          <para>
     145            is a client-side application which queries the whois directory
     146            service for information pertaining to a particular domain name.
     147          </para>
    125148          <indexterm zone="whois whois-prog">
    126149            <primary sortas="b-whois">whois</primary>

  • networking/netutils/wireshark.xml

    rbb65a3c r7c56ece  
    4949    <itemizedlist spacing="compact">
    5050      <listitem>
    51         <para>Download (HTTP): <ulink url="&wireshark-download-http;"/></para>
    52       </listitem>
    53       <listitem>
    54         <para>Download (FTP): <ulink url="&wireshark-download-ftp;"/></para>
    55       </listitem>
    56       <listitem>
    57         <para>Download MD5 sum: &wireshark-md5sum;</para>
    58       </listitem>
    59       <listitem>
    60         <para>Download size: &wireshark-size;</para>
    61       </listitem>
    62       <listitem>
    63         <para>Estimated disk space required: &wireshark-buildsize;</para>
    64       </listitem>
    65       <listitem>
    66         <para>Estimated build time: &wireshark-time;</para>
     51        <para>
     52          Download (HTTP): <ulink url="&wireshark-download-http;"/>
     53        </para>
     54      </listitem>
     55      <listitem>
     56        <para>
     57          Download (FTP): <ulink url="&wireshark-download-ftp;"/>
     58        </para>
     59      </listitem>
     60      <listitem>
     61        <para>
     62          Download MD5 sum: &wireshark-md5sum;
     63        </para>
     64      </listitem>
     65      <listitem>
     66        <para>
     67          Download size: &wireshark-size;
     68        </para>
     69      </listitem>
     70      <listitem>
     71        <para>
     72          Estimated disk space required: &wireshark-buildsize;
     73        </para>
     74      </listitem>
     75      <listitem>
     76        <para>
     77          Estimated build time: &wireshark-time;
     78        </para>
    6779      </listitem>
    6880    </itemizedlist>
    … …  
    7587          <ulink url="https://www.wireshark.org/download/docs/"/>
    7688          (contains links to several different docs in a variety of formats)
    77          </para>
     89        </para>
    7890      </listitem>
    7991    </itemizedlist>
    … …  
    250262      <title>Config Files</title>
    251263
    252       <para><filename>/etc/wireshark.conf</filename> and
    253       <filename>~/.config/wireshark/*</filename> (unless there is already
    254       <filename>~/.wireshark/*</filename> in the system)</para>
     264      <para>
     265        <filename>/etc/wireshark.conf</filename> and
     266        <filename>~/.config/wireshark/*</filename> (unless there is already
     267        <filename>~/.wireshark/*</filename> in the system)
     268      </para>
    255269
    256270      <indexterm zone="wireshark wireshark-config">
    … …  
    267281      <title>Configuration Information</title>
    268282
    269       <para>Though the default configuration parameters are very sane, reference
    270       the configuration section of the <ulink
    271       url="http://www.wireshark.org/docs/wsug_html/">Wireshark User's
    272       Guide</ulink> for configuration information. Most of
    273       <application>Wireshark</application>'s configuration can be accomplished
    274       using the menu options of the <command>wireshark</command> graphical
    275       interfaces.</para>
     283      <para>
     284        Though the default configuration parameters are very sane, reference
     285        the configuration section of the <ulink url=
     286        "http://www.wireshark.org/docs/wsug_html/">Wireshark User's Guide
     287        </ulink> for configuration information. Most of <application>Wireshark
     288        </application>'s configuration can be accomplished
     289        using the menu options of the <command>wireshark</command> graphical
     290        interfaces.
     291      </para>
    276292
    277293      <note>
    278         <para>If you want to look at packets, make sure you don't filter them
    279         out with <xref linkend="iptables"/>. If you want to exclude certain
    280         classes of packets, it is more efficient to do it with
    281         <application>iptables</application> than it is with
    282         <application>Wireshark</application>.</para>
     294        <para>
     295          If you want to look at packets, make sure you don't filter them
     296          out with <xref linkend="iptables"/>. If you want to exclude certain
     297          classes of packets, it is more efficient to do it with
     298          <application>iptables</application> than it is with
     299          <application>Wireshark</application>.
     300        </para>
    283301      </note>
    284302
    … …  
    320338        <term><command>capinfos</command></term>
    321339        <listitem>
    322           <para>reads a saved capture file and returns any or all of several
    323           statistics about that file. It is able to detect and read any capture
    324           supported by the <application>Wireshark</application> package.</para>
     340          <para>
     341            reads a saved capture file and returns any or all of several
     342            statistics about that file. It is able to detect and read any
     343            capture supported by the <application>Wireshark</application>
     344            package.
     345          </para>
    325346          <indexterm zone="wireshark capinfos">
    326347            <primary sortas="b-capinfos">capinfos</primary>
    … …  
    332353        <term><command>captype</command></term>
    333354        <listitem>
    334           <para>prints the file types of capture files.</para>
     355          <para>
     356            prints the file types of capture files.
     357          </para>
    335358          <indexterm zone="wireshark captype">
    336359            <primary sortas="b-captype">captype</primary>
    … …  
    342365        <term><command>dumpcap</command></term>
    343366        <listitem>
    344           <para>is a network traffic dump tool. It lets you capture packet data
    345           from a live network and write the packets to a file.</para>
     367          <para>
     368            is a network traffic dump tool. It lets you capture packet data
     369            from a live network and write the packets to a file.
     370          </para>
    346371          <indexterm zone="wireshark dumpcap">
    347372            <primary sortas="b-dumpcap">dumpcap</primary>
    … …  
    353378        <term><command>editcap</command></term>
    354379        <listitem>
    355           <para>edits and/or translates the format of capture files. It knows
    356           how to read <application>libpcap</application> capture files,
    357           including those of <command>tcpdump</command>,
    358           <application>Wireshark</application> and other tools that write
    359           captures in that format.</para>
     380          <para>
     381            edits and/or translates the format of capture files. It knows
     382            how to read <application>libpcap</application> capture files,
     383            including those of <command>tcpdump</command>,
     384            <application>Wireshark</application> and other tools that write
     385            captures in that format.
     386          </para>
    360387          <indexterm zone="wireshark editcap">
    361388            <primary sortas="b-editcap">editcap</primary>
    … …  
    367394        <term><command>idl2wrs</command></term>
    368395        <listitem>
    369           <para>is a program that takes a user specified CORBA IDL file and
    370           generates <quote>C</quote> source code for a
    371           <application>Wireshark</application> <quote>plugin</quote>. It relies
    372           on two Python programs <command>wireshark_be.py</command> and
    373           <command>wireshark_gen.py</command>, which are not installed
    374           by default. They have to be copied manually from the <filename
    375           class="directory">tools</filename> directory to the <filename
    376           class="directory">$PYTHONPATH/site-packages/</filename> directory.
     396          <para>
     397            is a program that takes a user specified CORBA IDL file and
     398            generates <quote>C</quote> source code for a
     399            <application>Wireshark</application> <quote>plugin</quote>. It
     400            relies on two Python programs <command>wireshark_be.py</command>
     401            and <command>wireshark_gen.py</command>, which are not installed
     402            by default. They have to be copied manually from the <filename
     403            class="directory">tools</filename> directory to the <filename
     404            class="directory">$PYTHONPATH/site-packages/</filename> directory.
    377405          </para>
    378406          <indexterm zone="wireshark idl2wrs">
    … …  
    385413        <term><command>mergecap</command></term>
    386414        <listitem>
    387           <para>combines multiple saved capture files into a single output
    388           file.</para>
     415          <para>
     416            combines multiple saved capture files into a single output file.
     417          </para>
    389418          <indexterm zone="wireshark mergecap">
    390419            <primary sortas="b-mergecap">mergecap</primary>
    … …  
    396425        <term><command>randpkt</command></term>
    397426        <listitem>
    398           <para>creates random-packet capture files.</para>
     427          <para>
     428            creates random-packet capture files.
     429          </para>
    399430          <indexterm zone="wireshark randpkt">
    400431            <primary sortas="b-randpkt">randpkt</primary>
    … …  
    406437        <term><command>rawshark</command></term>
    407438        <listitem>
    408           <para>dump and analyze raw libpcap data.</para>
     439          <para>
     440            dumps and analyzes raw libpcap data.
     441          </para>
    409442          <indexterm zone="wireshark rawshark">
    410443            <primary sortas="b-rawshark">rawshark</primary>
    … …  
    416449        <term><command>reordercap</command></term>
    417450        <listitem>
    418           <para>reorder timestamps of input file frames into output file.</para>
     451          <para>
     452            reorders timestamps of input file frames into output file.
     453          </para>
    419454          <indexterm zone="wireshark reordercap">
    420455            <primary sortas="b-reordercap">reordercap</primary>
    … …  
    426461        <term><command>sharkd</command></term>
    427462        <listitem>
    428           <para>is a daemon that listens on UNIX sockets.</para>
     463          <para>
     464            is a daemon that listens on UNIX sockets.
     465          </para>
    429466          <indexterm zone="wireshark sharkd">
    430467            <primary sortas="b-sharkd">sharkd</primary>
    … …  
    436473        <term><command>text2pcap</command></term>
    437474        <listitem>
    438           <para>reads in an ASCII hex dump and writes the
    439           data described into a <application>libpcap</application>-style
    440           capture file.</para>
     475          <para>
     476            reads in an ASCII hex dump and writes the data described into a
     477            <application>libpcap</application>-style capture file.
     478          </para>
    441479          <indexterm zone="wireshark text2pcap">
    442480            <primary sortas="b-text2pcap">text2pcap</primary>
    … …  
    448486        <term><command>tshark</command></term>
    449487        <listitem>
    450           <para>is a TTY-mode network protocol analyzer. It lets you capture
    451           packet data from a live network or read packets from a
    452           previously saved capture file.</para>
     488          <para>
     489            is a TTY-mode network protocol analyzer. It lets you capture
     490            packet data from a live network or read packets from a
     491            previously saved capture file.
     492          </para>
    453493          <indexterm zone="wireshark tshark">
    454494            <primary sortas="b-tshark">tshark</primary>
    … …  
    488528        <term><filename class='libraryfile'>libwireshark.so</filename></term>
    489529        <listitem>
    490           <para>contains functions used by the
    491           <application>Wireshark</application> programs to perform filtering and
    492           packet capturing.</para>
     530          <para>
     531            contains functions used by the <application>Wireshark</application>
     532            programs to perform filtering and packet capturing.
     533          </para>
    493534          <indexterm zone="wireshark libwireshark">
    494535            <primary sortas="c-libwireshark">libwireshark.so</primary>
    … …  
    500541        <term><filename class='libraryfile'>libwiretap.so</filename></term>
    501542        <listitem>
    502           <para>is a library being developed as a future replacement for
    503           <filename class='libraryfile'>libpcap</filename>, the current
    504           standard Unix library for packet capturing. For more information,
    505           see the <filename>README</filename> file in the source
    506           <filename class='directory'>wiretap</filename> directory.</para>
     543          <para>
     544            is a library being developed as a future replacement for
     545            <filename class='libraryfile'>libpcap</filename>, the current
     546            standard Unix library for packet capturing. For more information,
     547            see the <filename>README</filename> file in the source
     548            <filename class='directory'>wiretap</filename> directory.
     549          </para>
    507550          <indexterm zone="wireshark libwiretap">
    508551            <primary sortas="c-libwiretap">libwiretap.so</primary>

  • networking/textweb/links.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to Links</title>
    3131
    32     <para><application>Links</application> is a text and graphics mode
    33     WWW browser. It includes support for rendering
    34     tables and frames, features background downloads, can display colors
    35     and has many other features.</para>
     32    <para>
     33      <application>Links</application> is a text and graphics mode
     34      WWW browser. It includes support for rendering
     35      tables and frames, features background downloads, can display colors
     36      and has many other features.
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&links-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&links-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &links-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &links-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &links-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &links-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&links-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&links-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &links-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &links-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &links-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &links-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    6276
    6377    <bridgehead renderas="sect4">Recommended</bridgehead>
    64     <para role="recommended"><xref linkend="libevent"/></para>
     78    <para role="recommended">
     79      <xref linkend="libevent"/>
     80    </para>
    6581
    6682    <bridgehead renderas="sect4">Optional</bridgehead>
    67     <para role="optional">Graphics mode requires at least one of
    68     <xref linkend="gpm"/> (mouse support to be used with a framebuffer-based console),
    69     <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
    70     <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">DirectFB</ulink>, and
    71     <xref linkend="x-window-system"/></para>
    72 
    73     <para>For decoding various image formats <application>Links</application>
    74     can utilize
    75     <xref linkend="libpng"/>,
    76     <xref linkend="libjpeg"/>,
    77     <xref linkend="librsvg"/>, and
    78     <xref linkend="libtiff"/></para>
     83    <para role="optional">
     84      Graphics mode requires at least one of
     85      <xref linkend="gpm"/> (mouse support to be used with a framebuffer-based
     86      console),
     87      <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
     88      <ulink url="http://pkgs.fedoraproject.org/repo/pkgs/directfb/">
     89        DirectFB
     90      </ulink>, and
     91      <xref linkend="x-window-system"/>
     92    </para>
     93
     94    <para role="optional">
     95      For decoding various image formats <application>Links</application>
     96      can utilize
     97      <xref linkend="libpng"/>,
     98      <xref linkend="libjpeg"/>,
     99      <xref linkend="librsvg"/>, and
     100      <xref linkend="libtiff"/>
     101    </para>
    79102
    80103    <para condition="html" role="usernotes">User Notes:
    … …  
    86109    <title>Installation of Links</title>
    87110
    88    <para>Install <application>Links</application> by running the following
    89     commands:</para>
     111    <para>
     112      Install <application>Links</application> by running the following
     113      commands:
     114    </para>
    90115
    91116<screen><userinput>./configure --prefix=/usr --mandir=/usr/share/man &amp;&amp;
    92117make</userinput></screen>
    93118
    94     <para>This package does not come with a test suite.</para>
    95 
    96     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     119    <para>
     120      This package does not come with a test suite.
     121    </para>
     122
     123    <para>
     124      Now, as the <systemitem class="username">root</systemitem> user:
     125    </para>
    97126
    98127<screen role='root'><userinput>make install &amp;&amp;
    … …  
    106135    <title>Command Explanations</title>
    107136
    108     <para><option>--enable-graphics</option>: This switch enables support
    109     for graphics mode.</para>
     137    <para>
     138      <option>--enable-graphics</option>: This switch enables support
     139      for graphics mode.
     140    </para>
    110141
    111142  </sect2>
    … …  
    117148      <title>Config Files</title>
    118149
    119       <para><filename>~/.links/*</filename></para>
     150      <para>
     151        <filename>~/.links/*</filename>
     152      </para>
    120153
    121154      <indexterm zone="Links links-config">
    … …  
    128161      <title>Configuration Information</title>
    129162
    130       <para><application>Links</application> stores its configuration in per-user
    131       files in the <filename class="directory">~/.links</filename> directory. These
    132       files are created automatically when <command>links</command> is run for the
    133       first time.</para>
     163      <para>
     164        <application>Links</application> stores its configuration in per-user
     165        files in the <filename class="directory">~/.links</filename> directory.
     166        These files are created automatically when <command>links</command> is
     167        run for the first time.
     168      </para>
    134169
    135170    </sect3>
    … …  
    160195        <term><command>links</command></term>
    161196        <listitem>
    162           <para>is a text and graphics mode WWW browser.</para>
     197          <para>
     198            is a text and graphics mode WWW browser.
     199          </para>
    163200          <indexterm zone="Links links">
    164201            <primary sortas="b-links">links</primary>

  • networking/textweb/lynx.xml

    rbb65a3c r7c56ece  
    3030    <title>Introduction to Lynx</title>
    3131
    32     <para><application>Lynx</application> is a text based web browser.</para>
     32    <para>
     33      <application>Lynx</application> is a text based web browser.
     34    </para>
    3335
    3436    &lfs91_checked;
    … …  
    3739    <itemizedlist spacing="compact">
    3840      <listitem>
    39         <para>Download (HTTP): <ulink url="&lynx-download-http;"/></para>
    40       </listitem>
    41       <listitem>
    42         <para>Download (FTP): <ulink url="&lynx-download-ftp;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download MD5 sum: &lynx-md5sum;</para>
    46       </listitem>
    47       <listitem>
    48         <para>Download size: &lynx-size;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Estimated disk space required: &lynx-buildsize;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated build time: &lynx-time;</para>
     41        <para>
     42          Download (HTTP): <ulink url="&lynx-download-http;"/>
     43        </para>
     44      </listitem>
     45      <listitem>
     46        <para>
     47          Download (FTP): <ulink url="&lynx-download-ftp;"/>
     48        </para>
     49      </listitem>
     50      <listitem>
     51        <para>
     52          Download MD5 sum: &lynx-md5sum;
     53        </para>
     54      </listitem>
     55      <listitem>
     56        <para>
     57          Download size: &lynx-size;
     58        </para>
     59      </listitem>
     60      <listitem>
     61        <para>
     62          Estimated disk space required: &lynx-buildsize;
     63        </para>
     64      </listitem>
     65      <listitem>
     66        <para>
     67          Estimated build time: &lynx-time;
     68        </para>
    5569      </listitem>
    5670    </itemizedlist>
    … …  
    8498      <xref linkend="zip"/>,
    8599      <xref linkend="unzip"/>,
    86       an <xref linkend="server-mail"/> (that provides a <command>sendmail</command> command), and
     100      an <xref linkend="server-mail"/> (that provides a
     101      <command>sendmail</command> command), and
    87102      <xref linkend='sharutils'/> (for a <command>uudecode</command> program)
    88103    </para>
    … …  
    110125<screen><userinput>patch -p1 -i ../lynx-&lynx-version;-ncurses_6.1-1.patch</userinput></screen>
    111126-->
    112     <para>Install <application>Lynx</application> by running the following
    113     commands:</para>
     127    <para>
     128      Install <application>Lynx</application> by running the following
     129      commands:
     130    </para>
    114131
    115132<screen><userinput>./configure --prefix=/usr          \
    … …  
    123140make</userinput></screen>
    124141
    125     <para>This package does not come with a test suite.</para>
    126 
    127     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     142    <para>
     143      This package does not come with a test suite.
     144    </para>
     145
     146    <para>
     147      Now, as the <systemitem class="username">root</systemitem> user:
     148    </para>
    128149
    129150<screen role='root'><userinput>make install-full &amp;&amp;
    … …  
    135156    <title>Command Explanations</title>
    136157
    137     <para><parameter>--sysconfdir=/etc/lynx</parameter>: This parameter is
    138     used so that the configuration files are located in
    139     <filename class="directory">/etc/lynx</filename> instead of
    140     <filename class="directory">/usr/etc</filename>.</para>
    141 
    142     <para><parameter>--datadir=/usr/share/doc/lynx-&lynx-version;</parameter>:
    143     This parameter is used so that the documentation files are installed into
    144     <filename class="directory">/usr/share/doc/lynx-&lynx-version;</filename>
    145     instead of
    146     <filename class="directory">/usr/share/lynx_{doc,help}</filename>.</para>
    147 
    148     <para><parameter>--with-zlib</parameter>: This enables support for
    149     linking <filename class="libraryfile">libz</filename> into
    150     <application>Lynx</application>.</para>
    151 
    152     <para><parameter>--with-bzlib</parameter>: This enables support for
    153     linking <filename class="libraryfile">libbz2</filename> into
    154     <application>Lynx</application>.</para>
    155 
    156     <para><parameter>--with-ssl</parameter>: This enables support for
    157     linking SSL into <application>Lynx</application>.</para>
    158 
    159     <para><parameter>--with-screen=ncursesw</parameter>: This switch enables
    160     the use of advanced wide-character support present in the system
    161     <application>NCurses</application> library. This is needed for
    162     proper display of characters and line wrapping in multibyte locales.</para>
    163 
    164     <para><parameter>--enable-locale-charset</parameter>: This switch allows
    165     <application>Lynx</application> to deduce the proper character encoding
    166     for terminal output from the current locale.
    167     A configuration step is still needed (see below), but
    168     unlike the situation without this switch, the configuration step becomes
    169     the same for all users (without the switch one must specify the
    170     display character set explicitly). This is important for environments such
    171     as a LiveCD, where the amount of system-specific configuration steps has
    172     to be reduced to the minimum.</para>
    173 
    174     <para><option>--enable-nls</option>: This switch allows
    175     <application>Lynx</application> to print translated messages (such as
    176     questions about cookies and SSL certificates).</para>
    177 
    178     <para><option>--with-gnutls</option>: This enables experimental support
    179     for linking <application>GnuTLS</application> into
    180     <application>Lynx</application>. Remove the
    181     <parameter>--with-ssl</parameter>  switch if you want to use gnutls.</para>
    182 
    183     <para><command>make install-full</command>: In addition to the standard
    184     installation, this target installs the documentation and help files.</para>
    185 
    186     <para><command>chgrp -v -R root
    187     /usr/share/doc/lynx-&lynx-version;/lynx_doc</command>:
    188     This command corrects the improper group ownership of installed
    189     documentation files.</para>
     158    <para>
     159      <parameter>--sysconfdir=/etc/lynx</parameter>: This parameter is
     160      used so that the configuration files are located in
     161      <filename class="directory">/etc/lynx</filename> instead of
     162      <filename class="directory">/usr/etc</filename>.
     163    </para>
     164
     165    <para>
     166      <parameter>--datadir=/usr/share/doc/lynx-&lynx-version;</parameter>:
     167      This parameter is used so that the documentation files are installed into
     168      <filename class="directory">/usr/share/doc/lynx-&lynx-version;</filename>
     169      instead of
     170      <filename class="directory">/usr/share/lynx_{doc,help}</filename>.
     171    </para>
     172
     173    <para>
     174      <parameter>--with-zlib</parameter>: This enables support for
     175      linking <filename class="libraryfile">libz</filename> into
     176      <application>Lynx</application>.
     177    </para>
     178
     179    <para>
     180      <parameter>--with-bzlib</parameter>: This enables support for
     181      linking <filename class="libraryfile">libbz2</filename> into
     182      <application>Lynx</application>.
     183    </para>
     184
     185    <para>
     186      <parameter>--with-ssl</parameter>: This enables support for
     187      linking SSL into <application>Lynx</application>.
     188    </para>
     189
     190    <para>
     191      <parameter>--with-screen=ncursesw</parameter>: This switch enables
     192      the use of advanced wide-character support present in the system
     193      <application>NCurses</application> library. This is needed for
     194      proper display of characters and line wrapping in multibyte locales.
     195    </para>
     196
     197    <para>
     198      <parameter>--enable-locale-charset</parameter>: This switch allows
     199      <application>Lynx</application> to deduce the proper character encoding
     200      for terminal output from the current locale. A configuration step is
     201      still needed (see below), but unlike the situation without this switch,
     202      the configuration step becomes the same for all users (without the
     203      switch one must specify the display character set explicitly). This is
     204      important for environments such as a LiveCD, where the amount of
     205      system-specific configuration steps has to be reduced to the minimum.
     206    </para>
     207
     208    <para>
     209      <option>--enable-nls</option>: This switch allows
     210      <application>Lynx</application> to print translated messages (such as
     211      questions about cookies and SSL certificates).
     212    </para>
     213
     214    <para>
     215      <option>--with-gnutls</option>: This enables experimental support
     216      for linking <application>GnuTLS</application> into
     217      <application>Lynx</application>. Remove the
     218      <parameter>--with-ssl</parameter>  switch if you want to use gnutls.
     219    </para>
     220
     221    <para>
     222      <command>make install-full</command>: In addition to the standard
     223      installation, this target installs the documentation and help files.
     224    </para>
     225
     226    <para>
     227      <command>
     228        chgrp -v -R root /usr/share/doc/lynx-&lynx-version;/lynx_doc
     229      </command>:
     230      This command corrects the improper group ownership of installed
     231      documentation files.
     232    </para>
    190233
    191234    <!-- This was fixed in the 2.8.6 release, though it still could
    192235         be considered an issue by some
    193236    <note>
    194       <para>There has been a security vulnerability identified if you enable
    195       support for CGI links by passing the <option>-enable-cgi-links</option>
    196       parameter to <command>configure</command>. See <ulink
    197       url="http://seclists.org/lists/vulnwatch/2005/Oct-Dec/0041.html"/> for
    198       details.</para>
     237      <para>
     238        There has been a security vulnerability identified if you enable
     239        support for CGI links by passing the <option>-enable-cgi-links</option>
     240        parameter to <command>configure</command>. See <ulink
     241        url="http://seclists.org/lists/vulnwatch/2005/Oct-Dec/0041.html"/> for
     242        details.
     243      </para>
    199244    </note>
    200245    -->
    … …  
    208253      <title>Config Files</title>
    209254
    210       <para><filename>/etc/lynx/lynx.cfg</filename></para>
     255      <para>
     256        <filename>/etc/lynx/lynx.cfg</filename>
     257      </para>
    211258
    212259      <indexterm zone="lynx lynx-config">
    … …  
    219266      <title>Configuration Information</title>
    220267
    221       <para>The proper way to get the display character set is to examine the
    222       current locale. However, <application>Lynx</application> does not do
    223       this by default. As the <systemitem class="username">root</systemitem>
    224       user, change this setting:</para>
     268      <para>
     269        The proper way to get the display character set is to examine the
     270        current locale. However, <application>Lynx</application> does not do
     271        this by default. As the <systemitem class="username">root</systemitem>
     272        user, change this setting:
     273      </para>
    225274
    226275<screen role="root"><userinput>sed -e '/#LOCALE/     a LOCALE_CHARSET:TRUE'     \
    227276    -i /etc/lynx/lynx.cfg</userinput></screen>
    228277
    229       <para>The built-in editor in <application>Lynx</application>
    230       <xref linkend="locale-wrong-multibyte-characters"/>. This issue manifests
    231       itself in multibyte locales, e.g., as the Backspace key not erasing
    232       non-ASCII characters properly, and as incorrect data being sent to the
    233       network when one edits the contents of text areas. The only solution
    234       to this problem is to configure <application>Lynx</application> to
    235       use an external editor (bound to the <quote>Ctrl+X e</quote> key
    236       combination by default). Still as the
    237       <systemitem class="username">root</systemitem> user:</para>
     278      <para>
     279        The built-in editor in <application>Lynx</application> <xref
     280        linkend="locale-wrong-multibyte-characters"/>. This issue manifests
     281        itself in multibyte locales, e.g., as the Backspace key not erasing
     282        non-ASCII characters properly, and as incorrect data being sent to the
     283        network when one edits the contents of text areas. The only solution
     284        to this problem is to configure <application>Lynx</application> to
     285        use an external editor (bound to the <quote>Ctrl+X e</quote> key
     286        combination by default). Still as the
     287        <systemitem class="username">root</systemitem> user:
     288      </para>
     289
    238290<screen role="root"><userinput>sed -e '/#DEFAULT_ED/ a DEFAULT_EDITOR:vi'       \
    239291    -i /etc/lynx/lynx.cfg</userinput></screen>
    240292
    241       <para><application>Lynx</application> handles the following values of
    242       the DEFAULT_EDITOR option specially by adding cursor-positioning
    243       arguments: <quote>emacs</quote>, <quote>jed</quote>,
    244       <quote>jmacs</quote>, <quote>joe</quote>, <quote>jove</quote>,
    245       <quote>jpico</quote>, <quote>jstar</quote>, <quote>nano</quote>,
    246       <quote>pico</quote>, <quote>rjoe</quote>, <quote>vi</quote> (but not
    247       <quote>vim</quote>: in order to position the cursor in
    248       <xref linkend="vim"/>, set this option to <quote>vi</quote>).</para>
    249 
    250       <para>By default, <application>Lynx</application> doesn't save cookies
    251       between sessions. Again as the
    252       <systemitem class="username">root</systemitem> user, change this
    253       setting:</para>
     293      <para>
     294        <application>Lynx</application> handles the following values of
     295        the DEFAULT_EDITOR option specially by adding cursor-positioning
     296        arguments: <quote>emacs</quote>, <quote>jed</quote>,
     297        <quote>jmacs</quote>, <quote>joe</quote>, <quote>jove</quote>,
     298        <quote>jpico</quote>, <quote>jstar</quote>, <quote>nano</quote>,
     299        <quote>pico</quote>, <quote>rjoe</quote>, <quote>vi</quote> (but not
     300        <quote>vim</quote>: in order to position the cursor in
     301        <xref linkend="vim"/>, set this option to <quote>vi</quote>).
     302      </para>
     303
     304      <para>
     305        By default, <application>Lynx</application> doesn't save cookies
     306        between sessions. Again as the
     307        <systemitem class="username">root</systemitem> user, change this
     308        setting:
     309      </para>
    254310<screen role="root"><userinput>sed -e '/#PERSIST/    a PERSISTENT_COOKIES:TRUE' \
    255311    -i /etc/lynx/lynx.cfg</userinput></screen>
    256312
    257       <para>Many other system-wide settings such as proxies can also be set
    258       in the <filename>/etc/lynx/lynx.cfg</filename> file.</para>
     313      <para>
     314        Many other system-wide settings such as proxies can also be set
     315        in the <filename>/etc/lynx/lynx.cfg</filename> file.
     316      </para>
    259317
    260318    </sect3>
    … …  
    285343        <term><command>lynx</command></term>
    286344        <listitem>
    287           <para>is a general purpose, text-based, distributed information
    288           browser for the World Wide Web.</para>
     345          <para>
     346            is a general purpose, text-based, distributed information
     347            browser for the World Wide Web.
     348          </para>
    289349          <indexterm zone="lynx lynx-prog">
    290350            <primary sortas="b-lynx">lynx</primary>

  • networking/textweb/textweb.xml

    rbb65a3c r7c56ece  
    1616  <title>Text Web Browsers</title>
    1717
    18   <para>People who are new to Unix-based systems tend to ask the question "Why on
    19   earth would I want a text-mode browser?  I'm going to compile
    20   <application>X</application> and use
    21   <application>Konqueror</application>/<application>Mozilla</application>/Whatever!".
    22   Those who have been around systems for a while
    23   know that when (not if) you manage to mess up your graphical browser install
    24   and you need to look up some information on the web, a console based browser
    25   will save you.  Also, there are quite a few people who prefer to use one of
    26   these browsers as their primary method of browsing; either to avoid the
    27   clutter and bandwidth which accompanies images or because they may use a
    28   text-to-speech synthesizer which can read the page to them (of use for instance
    29   to partially sighted or blind users).  In this chapter you will find installation
    30   instructions for three console web browsers:</para>
     18  <para>
     19    People who are new to Unix-based systems tend to ask the question "Why on
     20    earth would I want a text-mode browser? I'm going to compile
     21    <application>X</application> and use <application>
     22    Konqueror</application>/<application>Mozilla</application>/Whatever!".
     23    Those who have been around systems for a while know that when (not if)
     24    you manage to mess up your graphical browser install and you need to
     25    look up some information on the web, a console based browser will save
     26    you.  Also, there are quite a few people who prefer to use one of these
     27    browsers as their primary method of browsing; either to avoid the clutter
     28    and bandwidth which accompanies images or because they may use a
     29    text-to-speech synthesizer which can read the page to them (of use for
     30    instance to partially sighted or blind users). In this chapter you will
     31    find installation instructions for three console web browsers:
     32  </para>
    3133
    3234  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="links.xml"/>
Note: See TracChangeset for help on using the changeset viewer.