Ignore:
Timestamp:
03/22/2020 03:52:07 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:
254bc90d
Parents:
dcee7a56
Message:

Format netprogs

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • networking/netprogs/ncftp.xml

    rdcee7a56 rb51fe6e  
    3030    <title>Introduction to NcFTP</title>
    3131
    32     <para>The <application>NcFTP</application> package contains
    33     a powerful and flexible interface to the Internet standard File Transfer
    34     Protocol.  It is intended to replace or supplement the stock
    35     <command>ftp</command> program.</para>
     32    <para>
     33      The <application>NcFTP</application> package contains
     34      a powerful and flexible interface to the Internet standard File Transfer
     35      Protocol.  It is intended to replace or supplement the stock
     36      <command>ftp</command> program.
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&ncftp-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&ncftp-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &ncftp-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &ncftp-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &ncftp-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &ncftp-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&ncftp-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&ncftp-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &ncftp-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &ncftp-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &ncftp-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &ncftp-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    7488    <title>Installation of NcFTP</title>
    7589
    76     <para>There are two ways to build <application>NcFTP</application>.
    77     The first (and optimal) way builds most of the functionality as a shared library
    78     and then builds and installs the program linked against this library.  The
    79     second method simply links all of the functionality into the binary statically.
    80     This doesn't make the dynamic library available for linking by other applications.
    81     You need to choose which method best suits you.  Note that the second method
    82     does <emphasis>not</emphasis> create an entirely statically linked binary;
    83     only the <filename class="libraryfile">libncftp</filename> parts are statically
    84     linked in, in this case. Be aware that building and using the shared library is
    85     covered by the Clarified Artistic License; however, developing applications that
    86     utilize the shared library is subject to a different license.</para>
    87 
    88     <para>To install <application>NcFTP</application> using the
    89     first (and optimal) method, run the following commands:</para>
     90    <para>
     91      There are two ways to build <application>NcFTP</application>.  The first
     92      (and optimal) way builds most of the functionality as a shared library
     93      and then builds and installs the program linked against this library.
     94      The second method simply links all of the functionality into the binary
     95      statically.  This doesn't make the dynamic library available for linking
     96      by other applications.  You need to choose which method best suits you.
     97      Note that the second method does <emphasis>not</emphasis> create an
     98      entirely statically linked binary; only the <filename
     99      class="libraryfile">libncftp</filename> parts are statically linked in,
     100      in this case. Be aware that building and using the shared library is
     101      covered by the Clarified Artistic License; however, developing
     102      applications that utilize the shared library is subject to a different
     103      license.
     104    </para>
     105
     106    <para>
     107      To install <application>NcFTP</application> using the
     108      first (and optimal) method, run the following commands:
     109    </para>
    90110
    91111<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
    … …  
    93113make</userinput></screen>
    94114
    95     <para>This package does not come with a test suite.</para>
    96 
    97     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     115    <para>
     116      This package does not come with a test suite.
     117    </para>
     118
     119    <para>
     120      Now, as the <systemitem class="username">root</systemitem> user:
     121    </para>
    98122
    99123<screen role='root'><userinput>make -C libncftp soinstall &amp;&amp;
    100124make install</userinput></screen>
    101125
    102     <para>To install <application>NcFTP</application> using the
    103     second method (with the <filename class="libraryfile">libncftp</filename>
    104     functionality linked in statically) run the following commands:</para>
     126    <para>
     127      To install <application>NcFTP</application> using the
     128      second method (with the <filename class="libraryfile">libncftp</filename>
     129      functionality linked in statically) run the following commands:
     130    </para>
    105131
    106132<screen role="nodump"><userinput>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
    107133make</userinput></screen>
    108134
    109     <para>This package does not come with a test suite.</para>
    110 
    111     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     135    <para>
     136      This package does not come with a test suite.
     137    </para>
     138
     139    <para>
     140      Now, as the <systemitem class="username">root</systemitem> user:
     141    </para>
    112142
    113143<screen role="nodump"><userinput>make install</userinput></screen>
    … …  
    118148    <title>Command Explanations</title>
    119149
    120     <para><command>make -C ... &amp;&amp; make -C ...</command>:
    121     These commands make and install the dynamic library <filename
    122     class="libraryfile">libncftp</filename> which is then used to link
    123     against when compiling the main program.</para>
     150    <para>
     151      <command>make -C ... &amp;&amp; make -C ...</command>:
     152      These commands make and install the dynamic library <filename
     153      class="libraryfile">libncftp</filename> which is then used to link
     154      against when compiling the main program.
     155    </para>
    124156
    125157  </sect2>
    … …  
    131163      <title>Config Files</title>
    132164
    133       <para><filename>/etc/ncftp.*</filename> and
    134       <filename>~/.ncftp/*</filename>; especially
    135       <filename>/etc/ncftp.prefs_v3</filename> and
    136       <filename>~/.ncftp/prefs_v3</filename></para>
     165      <para>
     166        <filename>/etc/ncftp.*</filename> and
     167        <filename>~/.ncftp/*</filename>; especially
     168        <filename>/etc/ncftp.prefs_v3</filename> and
     169        <filename>~/.ncftp/prefs_v3</filename>
     170      </para>
    137171
    138172      <indexterm zone="ncftp ncftp-config">
    … …  
    149183      <title>Configuration Information</title>
    150184
    151       <para>Most <application>NcFTP</application> configuration
    152       is done while in the program, and the configuration files are dealt with
    153       automatically. One exception to this is <filename>~/.ncftp/prefs_v3</filename>.
    154       There are various options to alter in there, including:</para>
     185      <para>
     186        Most <application>NcFTP</application> configuration is done while in
     187        the program, and the configuration files are dealt with automatically.
     188        One exception to this is <filename>~/.ncftp/prefs_v3</filename>. There
     189        are various options to alter in there, including:
     190      </para>
    155191
    156192<screen><literal>yes-i-know-about-NcFTPd=yes</literal></screen>
    157193
    158       <para>This disables the splash screen advertising the
    159       <application>NcFTPd</application> server.</para>
    160 
    161       <para>There are other options in the <filename>prefs_v3</filename> file.
    162       Most of these are self-explanatory. Global defaults can be set in
    163       <filename>/etc/ncftp.prefs_v3</filename>.</para>
     194      <para>
     195        This disables the splash screen advertising the
     196        <application>NcFTPd</application> server.
     197      </para>
     198
     199      <para>
     200        There are other options in the <filename>prefs_v3</filename> file.
     201        Most of these are self-explanatory. Global defaults can be set in
     202        <filename>/etc/ncftp.prefs_v3</filename>.
     203      </para>
    164204
    165205    </sect3>
    … …  
    191231        <term><command>ncftp</command></term>
    192232        <listitem>
    193           <para>is a browser program for File Transfer Protocol.</para>
     233          <para>
     234            is a browser program for File Transfer Protocol.
     235          </para>
    194236          <indexterm zone="ncftp ncftp-prog">
    195237            <primary sortas="b-ncftp">ncftp</primary>
    … …  
    201243        <term><command>ncftpbatch</command></term>
    202244        <listitem>
    203           <para>is an individual batch FTP job processor.</para>
     245          <para>
     246            is an individual batch FTP job processor.
     247          </para>
    204248          <indexterm zone="ncftp ncftpbatch">
    205249            <primary sortas="b-ncftpbatch">ncftpbatch</primary>
    … …  
    211255        <term><command>ncftpbookmarks</command></term>
    212256        <listitem>
    213           <para>is the <application>NcFTP</application> Bookmark Editor
    214           (<application>NCurses</application>-based).</para>
     257          <para>
     258            is the <application>NcFTP</application> Bookmark Editor
     259            (<application>NCurses</application>-based).
     260          </para>
    215261          <indexterm zone="ncftp ncftpbookmarks">
    216262            <primary sortas="b-ncftpbookmarks">ncftpbookmarks</primary>
    … …  
    222268        <term><command>ncftpget</command></term>
    223269        <listitem>
    224           <para>is an internet file transfer program for scripts used to
    225           retrieve files.</para>
     270          <para>
     271            is an internet file transfer program for scripts used to
     272            retrieve files.
     273          </para>
    226274          <indexterm zone="ncftp ncftpget">
    227275            <primary sortas="b-ncftpget">ncftpget</primary>
    … …  
    233281        <term><command>ncftpls</command></term>
    234282        <listitem>
    235           <para>is an internet file transfer program for scripts used to
    236           list files.</para>
     283          <para>
     284            is an internet file transfer program for scripts used to
     285            list files.
     286          </para>
    237287          <indexterm zone="ncftp ncftpls">
    238288            <primary sortas="b-ncftpls">ncftpls</primary>
    … …  
    244294        <term><command>ncftpput</command></term>
    245295        <listitem>
    246           <para>is an internet file transfer program for scripts used to
    247           transfer files.</para>
     296          <para>
     297            is an internet file transfer program for scripts used to
     298            transfer files.
     299          </para>
    248300          <indexterm zone="ncftp ncftpput">
    249301            <primary sortas="b-ncftpput">ncftpput</primary>
    … …  
    255307        <term><command>ncftpspooler</command></term>
    256308        <listitem>
    257           <para>is a global batch FTP job processor daemon.</para>
     309          <para>
     310            is a global batch FTP job processor daemon.
     311          </para>
    258312          <indexterm zone="ncftp ncftpspooler">
    259313            <primary sortas="b-ncftpspooler">ncftpspooler</primary>
Note: See TracChangeset for help on using the changeset viewer.