Changeset f716ef4 for postlfs/editors


Ignore:
Timestamp:
03/26/2020 01:13:18 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:
3defb8db
Parents:
29244b7
Message:

Format "editors"

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

Location:
postlfs/editors
Files:
7 edited

Legend:

Unmodified
Added
Removed
  • postlfs/editors/bluefish.xml

    r29244b7 rf716ef4  
    114114make</userinput></screen>
    115115
    116     <para>This package does not come with a test suite.</para>
     116    <para>
     117      This package does not come with a test suite.
     118    </para>
    117119
    118120    <para>
  • postlfs/editors/ed.xml

    r29244b7 rf716ef4  
    3030    <title>Introduction to Ed</title>
    3131
    32     <para><application>Ed</application> is a line-oriented text editor. It
    33     is used to create, display, modify and otherwise manipulate text files,
    34     both interactively and via shell scripts. Ed isn't something which many
    35     people use. It's described here because it can be used by the patch
    36     program if you encounter an ed-based patch file. This happens rarely
    37     because diff-based patches are preferred these days.</para>
     32    <para>
     33      <application>Ed</application> is a line-oriented text editor. It
     34      is used to create, display, modify and otherwise manipulate text files,
     35      both interactively and via shell scripts. Ed isn't something which many
     36      people use. It's described here because it can be used by the patch
     37      program if you encounter an ed-based patch file. This happens rarely
     38      because diff-based patches are preferred these days.
     39    </para>
    3840
    3941    &lfs91_checked;
     
    4244    <itemizedlist spacing="compact">
    4345      <listitem>
    44         <para>Download (HTTP): <ulink url="&ed-download-http;"/></para>
     46        <para>
     47          Download (HTTP): <ulink url="&ed-download-http;"/>
     48        </para>
    4549      </listitem>
    4650      <listitem>
    47         <para>Download (FTP): <ulink url="&ed-download-ftp;"/></para>
     51        <para>
     52          Download (FTP): <ulink url="&ed-download-ftp;"/>
     53        </para>
    4854      </listitem>
    4955      <listitem>
    50         <para>Download MD5 sum: &ed-md5sum;</para>
     56        <para>
     57          Download MD5 sum: &ed-md5sum;
     58        </para>
    5159      </listitem>
    5260      <listitem>
    53         <para>Download size: &ed-size;</para>
     61        <para>
     62          Download size: &ed-size;
     63        </para>
    5464      </listitem>
    5565      <listitem>
    56         <para>Estimated disk space required: &ed-buildsize;</para>
     66        <para>
     67          Estimated disk space required: &ed-buildsize;
     68        </para>
    5769      </listitem>
    5870      <listitem>
    59         <para>Estimated build time: &ed-time;</para>
     71        <para>
     72          Estimated build time: &ed-time;
     73        </para>
    6074      </listitem>
    6175    </itemizedlist>
     
    7690    <title>Installation of Ed</title>
    7791
    78     <para>Install <application>Ed</application> by running the following
    79     commands:</para>
     92    <para>
     93      Install <application>Ed</application> by running the following
     94      commands:
     95    </para>
    8096
    8197<screen><userinput>./configure --prefix=/usr --bindir=/bin &amp;&amp;
    8298make</userinput></screen>
    8399
    84     <para>To test the results, issue: <command>make check</command>.</para>
     100    <para>
     101      To test the results, issue: <command>make check</command>.
     102    </para>
    85103
    86     <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>
    87107
    88108<screen role="root"><userinput>make install</userinput></screen>
     
    113133        <term><command>ed</command></term>
    114134        <listitem>
    115           <para>is a line-oriented text editor.</para>
     135          <para>
     136            is a line-oriented text editor.
     137          </para>
    116138          <indexterm zone="ed ed-prog">
    117139            <primary sortas="b-ed">ed</primary>
     
    123145        <term><command>red</command></term>
    124146        <listitem>
    125           <para>is a restricted <command>ed</command>&mdash;it can only edit
    126           files in the current directory and cannot execute shell
    127           commands.</para>
     147          <para>
     148            is a restricted <command>ed</command>&mdash;it can only edit
     149            files in the current directory and cannot execute shell commands.
     150          </para>
    128151          <indexterm zone="ed red">
    129152            <primary sortas="b-red">red</primary>
  • postlfs/editors/editors.xml

    r29244b7 rf716ef4  
    1616  <title>Editors</title>
    1717
    18   <para>This chapter is referenced in the LFS book for those wishing to
    19   use other editors on their LFS system. You're also shown how some LFS
    20   installed programs benefit from being recompiled after GUI libraries
    21   have been installed.</para>
     18  <para>
     19    This chapter is referenced in the LFS book for those wishing to
     20    use other editors on their LFS system. You're also shown how some LFS
     21    installed programs benefit from being recompiled after GUI libraries
     22    have been installed.
     23  </para>
    2224
    2325  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bluefish.xml"/>
  • postlfs/editors/emacs.xml

    r29244b7 rf716ef4  
    3131    <title>Introduction to Emacs</title>
    3232
    33     <para>The <application>Emacs</application> package contains an extensible,
    34     customizable, self-documenting real-time display editor.</para>
     33    <para>
     34      The <application>Emacs</application> package contains an extensible,
     35      customizable, self-documenting real-time display editor.
     36    </para>
    3537
    3638    &lfs91_checked;
     
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&emacs-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&emacs-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &emacs-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &emacs-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &emacs-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &emacs-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&emacs-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&emacs-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &emacs-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &emacs-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &emacs-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &emacs-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
     
    101115    <title>Installation of Emacs</title>
    102116
    103     <para>Install <application>Emacs</application> by running the following
    104     commands:</para>
     117    <para>
     118      Install <application>Emacs</application> by running the following
     119      commands:
     120    </para>
    105121
    106122<screen><userinput>./configure --prefix=/usr --localstatedir=/var &amp;&amp;
     
    116132    </para>
    117133
    118     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     134    <para>
     135      Now, as the <systemitem class="username">root</systemitem> user:
     136    </para>
    119137
    120138<screen role="root" revision="systemd"><userinput>make install &amp;&amp;
     
    133151    <title>Command Explanations</title>
    134152
    135     <para><parameter>--localstatedir=/var</parameter>: Create game score files
    136     in <filename class='directory'>/var/games/emacs</filename> instead
    137     of <filename class='directory'>/usr/var/games/emacs</filename>.</para>
    138 
    139     <para><option>IMAGEMAGICK_CFLAGS=-I/usr/include/ImageMagick-6
    140     IMAGEMAGICK_LIBS="-lMagickCore-6.Q16HDRI -lMagick++-6.Q16HDRI
    141     -lMagickWand-6.Q16HDRI" </option>:
    142     use these when you invoke configure if you have installed <xref
    143     linkend="imagemagick6"/> and wish to link to them (the normal unversioned
    144     pkgconfig files collide with <xref linkend="imagemagick"/> which this
    145     package cannot use).</para>
    146 
    147     <para><option>--with-gif=no</option>: Use this if you have not installed
    148     <xref linkend="giflib"/> or
    149     <ulink url="http://directory.fsf.org/wiki/Libungif">libungif</ulink>.</para>
    150 
    151     <para><option>--with-tiff=no</option>: Use this if you have not installed
    152     <xref linkend="libtiff"/>.</para>
    153 
    154     <para><option>--with-gnutls=no</option>: Use this if you have not installed
    155     <xref linkend="gnutls"/>.</para>
     153    <para>
     154      <parameter>--localstatedir=/var</parameter>: Create game score files
     155      in <filename class='directory'>/var/games/emacs</filename> instead
     156      of <filename class='directory'>/usr/var/games/emacs</filename>.
     157    </para>
     158
     159    <para>
     160      <option>IMAGEMAGICK_CFLAGS=-I/usr/include/ImageMagick-6
     161      IMAGEMAGICK_LIBS="-lMagickCore-6.Q16HDRI -lMagick++-6.Q16HDRI
     162      -lMagickWand-6.Q16HDRI" </option>:
     163      use these when you invoke configure if you have installed <xref
     164      linkend="imagemagick6"/> and wish to link to them (the normal unversioned
     165      pkgconfig files collide with <xref linkend="imagemagick"/> which this
     166      package cannot use).
     167    </para>
     168
     169    <para>
     170      <option>--with-gif=no</option>: Use this if you have not installed
     171      <xref linkend="giflib"/> or
     172      <ulink url="http://directory.fsf.org/wiki/Libungif">libungif</ulink>.
     173    </para>
     174
     175    <para>
     176      <option>--with-tiff=no</option>: Use this if you have not installed
     177      <xref linkend="libtiff"/>.
     178    </para>
     179
     180    <para>
     181      <option>--with-gnutls=no</option>: Use this if you have not installed
     182      <xref linkend="gnutls"/>.
     183    </para>
    156184
    157185  </sect2>
     
    188216        <term><command>ctags</command></term>
    189217        <listitem>
    190           <para>creates cross-reference tagfile database files
    191           for source code.</para>
     218          <para>
     219            creates cross-reference tagfile database files
     220            for source code.
     221          </para>
    192222          <indexterm zone="emacs ctags">
    193223            <primary sortas="b-ctags">ctags</primary>
     
    199229        <term><command>ebrowse</command></term>
    200230        <listitem>
    201           <para>permits browsing of C++ class hierarchies from
    202           within <command>emacs</command>.</para>
     231          <para>
     232            permits browsing of C++ class hierarchies from
     233            within <command>emacs</command>.
     234          </para>
    203235          <indexterm zone="emacs ebrowse">
    204236            <primary sortas="b-ebrowse">ebrowse</primary>
     
    210242        <term><command>emacs</command></term>
    211243        <listitem>
    212           <para>is an editor.</para>
     244          <para>
     245            is an editor.
     246          </para>
    213247          <indexterm zone="emacs emacs-prog">
    214248            <primary sortas="b-emacs">emacs</primary>
     
    220254        <term><command>emacsclient</command></term>
    221255        <listitem>
    222           <para>attaches an <command>emacs</command> session to an already
    223           running <command>emacsserver</command> instance.</para>
     256          <para>
     257            attaches an <command>emacs</command> session to an already
     258            running <command>emacsserver</command> instance.
     259          </para>
    224260          <indexterm zone="emacs emacsclient">
    225261            <primary sortas="b-emacsclient">emacsclient</primary>
     
    231267        <term><command>etags</command></term>
    232268        <listitem>
    233           <para>is another program to generate source code
    234           cross-reference tagfiles.</para>
     269          <para>
     270            is another program to generate source code
     271            cross-reference tagfiles.
     272          </para>
    235273          <indexterm zone="emacs etags">
    236274            <primary sortas="b-etags">etags</primary>
     
    242280        <term><command>grep-changelog</command></term>
    243281        <listitem>
    244           <para>prints entries in Change Logs matching
    245           various criteria.</para>
     282          <para>
     283            prints entries in Change Logs matching
     284            various criteria.
     285          </para>
    246286          <indexterm zone="emacs grep-changelog">
    247287            <primary sortas="b-grep-changelog">grep-changelog</primary>
     
    253293        <term><command>rcs-checkin</command></term>
    254294        <listitem>
    255           <para>is a shell script used to check files into RCS.</para>
     295          <para>
     296            is a shell script used to check files into RCS.
     297          </para>
    256298          <indexterm zone="emacs rcs-checkin">
    257299            <primary sortas="b-rcs-checkin">rcs-checkin</primary>
  • postlfs/editors/joe.xml

    r29244b7 rf716ef4  
    3030    <title>Introduction to JOE</title>
    3131
    32     <para><application>JOE</application> (Joe's own editor) is a small text
    33     editor capable of emulating WordStar, <application>Pico</application>,
    34     and <application>Emacs</application>.</para>
     32    <para>
     33      <application>JOE</application> (Joe's own editor) is a small text
     34      editor capable of emulating WordStar, <application>Pico</application>,
     35      and <application>Emacs</application>.
     36    </para>
    3537
    3638    &lfs91_checked;
     
    3941    <itemizedlist spacing="compact">
    4042      <listitem>
    41         <para>Download (HTTP): <ulink url="&joe-download-http;"/></para>
    42       </listitem>
    43       <listitem>
    44         <para>Download (FTP): <ulink url="&joe-download-ftp;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download MD5 sum: &joe-md5sum;</para>
    48       </listitem>
    49       <listitem>
    50         <para>Download size: &joe-size;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Estimated disk space required: &joe-buildsize;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated build time: &joe-time;</para>
     43        <para>
     44          Download (HTTP): <ulink url="&joe-download-http;"/>
     45        </para>
     46      </listitem>
     47      <listitem>
     48        <para>
     49          Download (FTP): <ulink url="&joe-download-ftp;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download MD5 sum: &joe-md5sum;
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download size: &joe-size;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Estimated disk space required: &joe-buildsize;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated build time: &joe-time;
     70        </para>
    5771      </listitem>
    5872    </itemizedlist>
     
    6680    <title>Installation of JOE</title>
    6781
    68     <para>Install <application>JOE</application> by running the
    69     following commands:</para>
     82    <para>
     83      Install <application>JOE</application> by running the
     84      following commands:
     85    </para>
    7086
    7187<screen><userinput>./configure --prefix=/usr     \
     
    7490make</userinput></screen>
    7591
    76     <para>This package does not come with a test suite.</para>
    77 
    78     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     92    <para>
     93      This package does not come with a test suite.
     94    </para>
     95
     96    <para>
     97      Now, as the <systemitem class="username">root</systemitem> user:
     98    </para>
    7999
    80100<screen role="root"><userinput>make install &amp;&amp;
     
    95115      <title>Config Files</title>
    96116
    97       <para><filename>/etc/joe/jmacsrc</filename>,
    98       <filename>/etc/joe/joerc</filename>, <filename>/etc/joe/jpicorc</filename>,
    99       <filename>/etc/joe/jstarrc</filename>, <filename>/etc/joe/rjoerc</filename>,
    100       and <filename>~/.joerc</filename></para>
     117      <para>
     118        <filename>/etc/joe/jmacsrc</filename>,
     119        <filename>/etc/joe/joerc</filename>,
     120        <filename>/etc/joe/jpicorc</filename>,
     121        <filename>/etc/joe/jstarrc</filename>,
     122        <filename>/etc/joe/rjoerc</filename>,
     123        and <filename>~/.joerc</filename>
     124      </para>
    101125
    102126      <indexterm zone="joe joe-config">
     
    166190        <term><command>jmacs</command></term>
    167191        <listitem>
    168           <para>is a symbolic link to <command>joe</command> used to
    169           launch <application>Emacs</application> emulation mode.</para>
     192          <para>
     193            is a symbolic link to <command>joe</command> used to
     194            launch <application>Emacs</application> emulation mode.
     195          </para>
    170196          <indexterm zone="joe jmacs">
    171197            <primary sortas="b-jmacs">jmacs</primary>
     
    177203        <term><command>joe</command></term>
    178204        <listitem>
    179           <para>is a small text editor capable of emulating
    180           WordStar, <application>Pico</application>, and
    181           <application>Emacs</application>.</para>
     205          <para>
     206            is a small text editor capable of emulating
     207            WordStar, <application>Pico</application>, and
     208            <application>Emacs</application>.
     209          </para>
    182210          <indexterm zone="joe joe-prog">
    183211            <primary sortas="b-joe">joe</primary>
     
    189217        <term><command>jpico</command></term>
    190218        <listitem>
    191           <para>is a symbolic link to <command>joe</command> used to
    192           launch <application>Pico</application> emulation mode.</para>
     219          <para>
     220            is a symbolic link to <command>joe</command> used to
     221            launch <application>Pico</application> emulation mode.
     222          </para>
    193223          <indexterm zone="joe jpico">
    194224            <primary sortas="b-jpico">jpico</primary>
     
    200230        <term><command>jstar</command></term>
    201231        <listitem>
    202           <para>is a symbolic link to <command>joe</command> used to
    203           launch WordStar emulation mode.</para>
     232          <para>
     233            is a symbolic link to <command>joe</command> used to
     234            launch WordStar emulation mode.
     235          </para>
    204236          <indexterm zone="joe jstar">
    205237            <primary sortas="b-jstar">jstar</primary>
     
    211243        <term><command>rjoe</command></term>
    212244        <listitem>
    213           <para>is a symbolic link to <command>joe</command> that restricts
    214           <application>JOE</application> to editing only files which are
    215           specified on the command-line.</para>
     245          <para>
     246            is a symbolic link to <command>joe</command> that restricts
     247            <application>JOE</application> to editing only files which are
     248            specified on the command-line.
     249          </para>
    216250          <indexterm zone="joe rjoe">
    217251            <primary sortas="b-rjoe">rjoe</primary>
     
    223257        <term><command>stringify</command></term>
    224258        <listitem>
    225           <para>is a program used by <command>joe</command> to convert rc and
    226           .jsf files into a C file (see
    227           /usr/share/doc/joe-&joe-version;/util/README).</para>
     259          <para>
     260            is a program used by <command>joe</command> to convert rc and
     261            .jsf files into a C file (see
     262            /usr/share/doc/joe-&joe-version;/util/README).
     263          </para>
    228264          <indexterm zone="joe stringify">
    229265            <primary sortas="b-stringify">stringify</primary>
     
    235271        <term><command>termidx</command></term>
    236272        <listitem>
    237           <para>is a program used by <command>joe</command> to generate the
    238           termcap index file (see
    239           /usr/share/doc/joe-&joe-version;/util/README).</para>
     273          <para>
     274            is a program used by <command>joe</command> to generate the
     275            termcap index file (see
     276            /usr/share/doc/joe-&joe-version;/util/README).
     277          </para>
    240278          <indexterm zone="joe termidx">
    241279            <primary sortas="b-termidx">termidx</primary>
     
    247285        <term><command>uniproc</command></term>
    248286        <listitem>
    249           <para>is a program used by <command>joe</command> to generate joe's
    250           unicode database file unicat.c from Blocks.txt CaseFolding.txt
    251           EastAsianWidth.txt and UnicodeData.txt (find them at
    252           /usr/share/doc/joe-&joe-version;/util; see
    253           usr/share/doc/joe-&joe-version;/util/README).</para>
     287          <para>
     288            is a program used by <command>joe</command> to generate joe's
     289            unicode database file unicat.c from Blocks.txt CaseFolding.txt
     290            EastAsianWidth.txt and UnicodeData.txt (find them at
     291            /usr/share/doc/joe-&joe-version;/util; see
     292            usr/share/doc/joe-&joe-version;/util/README).
     293          </para>
    254294          <indexterm zone="joe uniproc">
    255295            <primary sortas="b-uniproc">uniproc</primary>
  • postlfs/editors/nano.xml

    r29244b7 rf716ef4  
    8181    <title>Installation of Nano</title>
    8282
    83     <para>Install <application>Nano</application> by running the following
    84     commands:</para>
     83    <para>
     84      Install <application>Nano</application> by running the following
     85      commands:
     86    </para>
    8587
    8688<screen><userinput>./configure --prefix=/usr     \
     
    119121      <title>Config Files</title>
    120122
    121       <para><filename>/etc/nanorc</filename> and
    122       <filename>~/.nanorc</filename></para>
     123      <para>
     124        <filename>/etc/nanorc</filename> and
     125        <filename>~/.nanorc</filename>
     126      </para>
    123127
    124128      <indexterm zone="nano nano-config">
  • postlfs/editors/vim.xml

    r29244b7 rf716ef4  
    3232    <title>Introduction to Vim</title>
    3333
    34     <para>The <application>Vim</application> package, which is an
    35     abbreviation for VI IMproved, contains a <command>vi</command>
    36     clone with extra features as compared to the original
    37     <command>vi</command>.</para>
    38 
    39     <para>The default LFS instructions install <application>vim</application>
    40     as a part of the base system. If you would prefer to link
    41     <application>vim</application> against <application>X</application>,
    42     you should recompile <application>vim</application> to enable GUI mode.
    43     There is no need for special instructions since
    44     <application>X</application> support is automatically detected.</para>
    45 
    46     <note><para>The version of vim changes daily.  The get the latest
    47     version, go to <ulink url="https://github.com/vim/vim/releases">
    48     https://github.com/vim/vim/releases</ulink>.</para></note>
     34    <para>
     35      The <application>Vim</application> package, which is an
     36      abbreviation for VI IMproved, contains a <command>vi</command>
     37      clone with extra features as compared to the original
     38      <command>vi</command>.
     39    </para>
     40
     41    <para>
     42      The default LFS instructions install <application>vim</application>
     43      as a part of the base system. If you would prefer to link
     44      <application>vim</application> against <application>X</application>,
     45      you should recompile <application>vim</application> to enable GUI mode.
     46      There is no need for special instructions since
     47      <application>X</application> support is automatically detected.
     48    </para>
     49
     50    <note>
     51      <para>
     52        The version of vim changes daily.  The get the latest
     53        version, go to <ulink url="https://github.com/vim/vim/releases">
     54        https://github.com/vim/vim/releases</ulink>.
     55      </para>
     56    </note>
    4957
    5058    &lfs91_checked;
     
    5361    <itemizedlist spacing="compact">
    5462      <listitem>
    55         <para>Download (HTTP): <ulink url="&vim-download-http;"/></para>
    56       </listitem>
    57       <listitem>
    58         <para>Download (FTP): <ulink url="&vim-download-ftp;"/></para>
    59       </listitem>
    60       <listitem>
    61         <para>Download MD5 sum: &vim-md5sum;</para>
    62       </listitem>
    63       <listitem>
    64         <para>Download size: &vim-size;</para>
    65       </listitem>
    66       <listitem>
    67         <para>Estimated disk space required: &vim-buildsize;</para>
    68       </listitem>
    69       <listitem>
    70         <para>Estimated build time: &vim-time;</para>
     63        <para>
     64          Download (HTTP): <ulink url="&vim-download-http;"/>
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Download (FTP): <ulink url="&vim-download-ftp;"/>
     70        </para>
     71      </listitem>
     72      <listitem>
     73        <para>
     74          Download MD5 sum: &vim-md5sum;
     75        </para>
     76      </listitem>
     77      <listitem>
     78        <para>
     79          Download size: &vim-size;
     80        </para>
     81      </listitem>
     82      <listitem>
     83        <para>
     84          Estimated disk space required: &vim-buildsize;
     85        </para>
     86      </listitem>
     87      <listitem>
     88        <para>
     89          Estimated build time: &vim-time;
     90        </para>
    7191      </listitem>
    7292    </itemizedlist>
     
    99119
    100120    <note>
    101       <para>If you recompile <application>Vim</application> to link against
    102       <application>X</application> and your <application>X</application>
    103       libraries are not on the root partition, you will no longer have an
    104       editor for use in emergencies. You may choose to install an additional
    105       editor, not link <application>Vim</application> against
    106       <application>X</application>, or move the current <command>vim</command>
    107       executable to the <filename class="directory">/bin</filename> directory
    108       under a different name such as <filename>vi</filename>.</para>
     121      <para>
     122        If you recompile <application>Vim</application> to link against
     123        <application>X</application> and your <application>X</application>
     124        libraries are not on the root partition, you will no longer have an
     125        editor for use in emergencies. You may choose to install an additional
     126        editor, not link <application>Vim</application> against
     127        <application>X</application>, or move the current <command>vim</command>
     128        executable to the <filename class="directory">/bin</filename> directory
     129        under a different name such as <filename>vi</filename>.
     130      </para>
    109131    </note>
    110132
    111     <para>Install <application>Vim</application> by running the following
    112     commands:</para>
     133    <para>
     134      Install <application>Vim</application> by running the following
     135      commands:
     136    </para>
    113137
    114138<screen><userinput>echo '#define SYS_VIMRC_FILE  "/etc/vimrc"' &gt;&gt;  src/feature.h &amp;&amp;
     
    121145make</userinput></screen>
    122146
    123     <para>To test the results, issue: <command>make test</command>.
    124     The <application>vim</application> test suite outputs a lot of binary
    125     data to the screen, which can cause issues with the settings of the
    126     current terminal. This can be resolved by redirecting the output to a
    127     log file. Even if one of the tests fails to produce the file
    128     <filename>test.out</filename> in <filename
    129     class="directory">src/testdir</filename>, the remaining tests will still
    130     be executed. If all goes well,the log will report <literal>ALL DONE</literal>.
    131     <emphasis>Note</emphasis>: Some color tests
    132     expect to be executed under the <command>xterm</command> terminal
    133     emulator. Three tests are known to fail occasionally and can be ignored.</para>
    134 
    135     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     147    <para>
     148      To test the results, issue: <command>make test</command>.  The
     149      <application>vim</application> test suite outputs a lot of binary data
     150      to the screen, which can cause issues with the settings of the current
     151      terminal. This can be resolved by redirecting the output to a log file.
     152      Even if one of the tests fails to produce the file
     153      <filename>test.out</filename> in <filename
     154      class="directory">src/testdir</filename>, the remaining tests will
     155      still be executed. If all goes well,the log will report
     156      <literal>ALL DONE</literal>.  <emphasis>Note</emphasis>: Some color
     157      tests expect to be executed under the <command>xterm</command> terminal
     158      emulator. Three tests are known to fail occasionally and can be ignored.
     159    </para>
     160
     161    <para>
     162      Now, as the <systemitem class="username">root</systemitem> user:
     163    </para>
    136164
    137165<screen role="root"><userinput>make install</userinput></screen>
    138166
    139     <para>By default, Vim's documentation is installed in <filename
    140     class="directory">/usr/share/vim</filename>.  The following symlink allows
    141     the documentation to be accessed via <filename
    142     class="directory">/usr/share/doc/vim-&vim-version;</filename>, making it
    143     consistent with the location of documentation for other packages:</para>
     167    <para>
     168      By default, Vim's documentation is installed in <filename
     169      class="directory">/usr/share/vim</filename>. The following symlink allows
     170      the documentation to be accessed via <filename
     171      class="directory">/usr/share/doc/vim-&vim-version;</filename>, making it
     172      consistent with the location of documentation for other packages:
     173    </para>
    144174
    145175<!-- When updating, be sure to change the vim-majmin entity for the
     
    148178<screen role="root"><userinput>ln -snfv ../vim/vim&vim-majmin;/doc /usr/share/doc/vim-&vim-version;</userinput></screen>
    149179
    150     <para>If you wish to update the runtime files, issue the
    151     following command (requires <xref linkend="rsync"/>):</para>
     180    <para>
     181      If you wish to update the runtime files, issue the
     182      following command (requires <xref linkend="rsync"/>):
     183    </para>
    152184
    153185<screen><userinput>rsync -avzcP --exclude="/dos/" --exclude="/spell/" \
    154186    ftp.nluug.nl::Vim/runtime/ ./runtime/</userinput></screen>
    155187
    156     <para>To install the runtime files and regenerate the
    157     <filename>tags</filename> file, as the
    158     <systemitem class="username">root</systemitem> user issue:</para>
     188    <para>
     189      To install the runtime files and regenerate the
     190      <filename>tags</filename> file, as the
     191      <systemitem class="username">root</systemitem> user issue:
     192    </para>
    159193
    160194<screen role="root"><userinput>make -C src installruntime &amp;&amp;
     
    166200    <title>Command Explanations</title>
    167201
    168     <para><parameter>--with-features=huge</parameter>: This switch enables all
    169     the additional features available in <application>Vim</application>,
    170     including support for multibyte characters.</para>
     202    <para>
     203      <parameter>--with-features=huge</parameter>: This switch enables all
     204      the additional features available in <application>Vim</application>,
     205      including support for multibyte characters.
     206    </para>
    171207
    172208    <para>
     
    176212    </para>
    177213
    178     <para><option>--enable-gui=no</option>: This will prevent compilation of the
    179     GUI. <application>Vim</application> will still link against
    180     <application>X</application>, so that some features such as the client-server
    181     model or the x11-selection (clipboard) are still available.</para>
    182 
    183     <para><option>--without-x</option>: If you prefer not to link
    184     <application>Vim</application> against <application>X</application>, use
    185     this switch.</para>
    186 
    187     <para><option>--enable-perlinterp</option>, <option>--enable-pythoninterp</option>,
    188     <option>--enable-tclinterp</option>, <option>--enable-rubyinterp</option>:
    189     These options include the Perl, Python, Tcl, or Ruby interpreters that allow
    190     using other application code in <application>vim</application> scripts.</para>
     214    <para>
     215      <option>--enable-gui=no</option>: This will prevent compilation of the
     216      GUI. <application>Vim</application> will still link against
     217      <application>X</application>, so that some features such as the
     218      client-server model or the x11-selection (clipboard) are still available.
     219    </para>
     220
     221    <para>
     222      <option>--without-x</option>: If you prefer not to link
     223      <application>Vim</application> against <application>X</application>, use
     224      this switch.
     225    </para>
     226
     227    <para>
     228      <option>--enable-perlinterp</option>,
     229      <option>--enable-pythoninterp</option>,
     230      <option>--enable-tclinterp</option>,
     231      <option>--enable-rubyinterp</option>:
     232      These options include the Perl, Python, Tcl, or Ruby interpreters that
     233      allow using other application code in <application>vim</application>
     234      scripts.
     235    </para>
    191236
    192237  </sect2>
     
    198243      <title>Config Files</title>
    199244
    200       <para><filename>/etc/vimrc</filename> and
    201       <filename>~/.vimrc</filename></para>
     245      <para>
     246        <filename>/etc/vimrc</filename> and
     247        <filename>~/.vimrc</filename>
     248      </para>
    202249
    203250      <indexterm zone="vim vim-config">
     
    240287      <title>Configuration Information</title>
    241288
    242       <para><application>Vim</application> has an integrated spell checker
    243       which you can enable it if you issue the following in a vim window:
     289      <para>
     290        <application>Vim</application> has an integrated spell checker
     291        which you can enable it if you issue the following in a vim window:
    244292      </para>
    245293
    246294<screen><literal>:setlocal spell spelllang=ru</literal></screen>
    247295
    248       <para>This setting will enable spell checking for the Russian
    249       language for the current session.</para>
    250 
    251       <para>By default, <application>Vim</application> only installs spell
    252       files for the English language. If a spell file is not available for
    253       a language, then <application>Vim</application> will call the
    254       <filename>$VIMRUNTIME/plugin/spellfile.vim</filename> plugin and will try
    255       to obtain the *.spl and optionally *.sug from the vim ftp server,
    256       by using the <filename>$VIMRUNTIME/plugin/netrwPlugin.vim</filename>
    257       plugin.</para>
    258 
    259 <!-- When updating, be sure to change the line below for the proper 'vimxx' unpacked
    260      directory -->
    261       <para>Alternatively you can manually download the *.spl and *.sug files
    262       from: <ulink url="ftp://ftp.vim.org/pub/vim/runtime/spell/"/> and save
    263       them to <filename class="directory"> ~/.vim/spell </filename> or in
    264       <filename class="directory">/usr/share/vim/vim&vim-majmin;/spell/</filename>.</para>
    265 
    266       <para>To find out what's new in <application>Vim-&vim-version;</application>
    267       issue the following command:</para>
     296      <para>
     297        This setting will enable spell checking for the Russian
     298        language for the current session.
     299      </para>
     300
     301      <para>
     302        By default, <application>Vim</application> only installs spell
     303        files for the English language. If a spell file is not available for
     304        a language, then <application>Vim</application> will call the
     305        <filename>$VIMRUNTIME/plugin/spellfile.vim</filename> plugin and will
     306        try to obtain the *.spl and optionally *.sug from the vim ftp server,
     307        by using the <filename>$VIMRUNTIME/plugin/netrwPlugin.vim</filename>
     308        plugin.
     309      </para>
     310
     311<!-- When updating, be sure to change the line below for the proper 'vimxx'
     312     unpacked directory -->
     313      <para>
     314        Alternatively you can manually download the *.spl and *.sug files
     315        from: <ulink url="ftp://ftp.vim.org/pub/vim/runtime/spell/"/> and save
     316        them to <filename class="directory"> ~/.vim/spell </filename> or in
     317        <filename
     318          class="directory">/usr/share/vim/vim&vim-majmin;/spell/</filename>.
     319      </para>
     320
     321      <para>
     322        To find out what's new in <application>Vim-&vim-version;</application>
     323        issue the following command:
     324      </para>
    268325
    269326<screen><literal>:help version-&vim-version;</literal></screen>
    270327
    271       <para>For additional information on setting up
    272       <application>Vim</application> configuration files, see <xref
    273       linkend="postlfs-config-vimrc"/> and <ulink
    274       url='http://vim.wikia.com/wiki/Example_vimrc'/>.</para>
     328      <para>
     329        For additional information on setting up
     330        <application>Vim</application> configuration files, see <xref
     331        linkend="postlfs-config-vimrc"/> and <ulink
     332        url='http://vim.wikia.com/wiki/Example_vimrc'/>.
     333      </para>
    275334
    276335    </sect3>
     
    281340    <title>Contents</title>
    282341
    283     <para>A list of the reinstalled files, along with their short
    284     descriptions can be found in the <ulink
    285     url="&lfs-root;/chapter06/vim.html#contents-vim">LFS Vim Installation
    286     Instructions</ulink></para>
     342    <para>
     343      A list of the reinstalled files, along with their short
     344      descriptions can be found in the <ulink
     345      url="&lfs-root;/chapter06/vim.html#contents-vim">LFS Vim Installation
     346      Instructions</ulink>
     347    </para>
    287348
    288349    <segmentedlist>
     
    306367        <term><command>gview</command></term>
    307368        <listitem>
    308           <para>starts <command>gvim</command> in read-only mode.</para>
     369          <para>
     370            starts <command>gvim</command> in read-only mode.
     371          </para>
    309372          <indexterm zone="vim gview">
    310373            <primary sortas="b-gview">gview</primary>
     
    316379        <term><command>gvim</command></term>
    317380        <listitem>
    318           <para>is the editor that runs under <application>X</application>
    319           and includes a GUI.</para>
     381          <para>
     382            is the editor that runs under <application>X</application>
     383            and includes a GUI.
     384          </para>
    320385          <indexterm zone="vim gvim">
    321386            <primary sortas="b-gvim">gvim</primary>
     
    327392        <term><command>gvimdiff</command></term>
    328393        <listitem>
    329           <para>edits two or three versions of a file with
    330           <command>gvim</command> and shows the differences.</para>
     394          <para>
     395            edits two or three versions of a file with
     396            <command>gvim</command> and shows the differences.
     397          </para>
    331398          <indexterm zone="vim gvimdiff">
    332399            <primary sortas="b-gvimdiff">gvimdiff</primary>
     
    338405        <term><command>gvimtutor</command></term>
    339406        <listitem>
    340           <para>teaches the basic keys and commands of
    341           <command>gvim</command>.</para>
     407          <para>
     408            teaches the basic keys and commands of
     409            <command>gvim</command>.
     410          </para>
    342411          <indexterm zone="vim gvimtutor">
    343412            <primary sortas="b-gvimtutor">gvimtutor</primary>
     
    349418        <term><command>rgview</command></term>
    350419        <listitem>
    351           <para>is a restricted version of <command>gview</command>.</para>
     420          <para>
     421            is a restricted version of <command>gview</command>.
     422          </para>
    352423          <indexterm zone="vim rgview">
    353424            <primary sortas="b-rgview">rgview</primary>
     
    359430        <term><command>rgvim</command></term>
    360431        <listitem>
    361           <para>is a restricted version of <command>gvim</command>. </para>
     432          <para>
     433            is a restricted version of <command>gvim</command>.
     434          </para>
    362435          <indexterm zone="vim gvim">
    363436            <primary sortas="b-gvim">gvim</primary>
Note: See TracChangeset for help on using the changeset viewer.