Changeset f716ef4


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
Files:
11 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>

  • postlfs/shells/shells.xml

    r29244b7 rf716ef4  
    1616  <title>Shells</title>
    1717
    18   <para>We are all familiar with the Bourne Again SHell, but there are two
    19   other user interfaces that are considered useful modern shells &ndash; the
    20   Berkeley Unix C shell and the Korn shell.  This chapter installs
    21   packages compatible with these additional shell types.</para>
     18  <para>
     19    We are all familiar with the Bourne Again SHell, but there are two
     20    other user interfaces that are considered useful modern shells &ndash; the
     21    Berkeley Unix C shell and the Korn shell.  This chapter installs
     22    packages compatible with these additional shell types.
     23  </para>
    2224
    2325  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dash.xml"/>

  • postlfs/shells/tcsh.xml

    r29244b7 rf716ef4  
    3535    <title>Introduction to Tcsh</title>
    3636
    37     <para>The <application>Tcsh</application> package contains <quote>an
    38     enhanced but completely compatible version of the Berkeley Unix C shell
    39     (<command>csh</command>)</quote>. This is useful as an alternative shell
    40     for those who prefer C syntax to that of the <command>bash</command> shell,
    41     and also because some programs require the C shell in order to perform
    42     installation tasks.</para>
     37    <para>
     38      The <application>Tcsh</application> package contains <quote>an
     39      enhanced but completely compatible version of the Berkeley Unix C shell
     40      (<command>csh</command>)</quote>. This is useful as an alternative shell
     41      for those who prefer C syntax to that of the <command>bash</command>
     42      shell, and also because some programs require the C shell in order to
     43      perform installation tasks.
     44    </para>
    4345
    4446    &lfs91_checked;
    … …  
    4749    <itemizedlist spacing="compact">
    4850      <listitem>
    49         <para>Download (HTTP): <ulink url="&tcsh-download-http;"/></para>
    50       </listitem>
    51       <listitem>
    52         <para>Download (FTP): <ulink url="&tcsh-download-ftp;"/></para>
    53       </listitem>
    54       <listitem>
    55         <para>Download MD5 sum: &tcsh-md5sum;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Download size: &tcsh-size;</para>
    59       </listitem>
    60       <listitem>
    61         <para>Estimated disk space required: &tcsh-buildsize;</para>
    62       </listitem>
    63       <listitem>
    64         <para>Estimated build time: &tcsh-time;</para>
     51        <para>
     52          Download (HTTP): <ulink url="&tcsh-download-http;"/>
     53        </para>
     54      </listitem>
     55      <listitem>
     56        <para>
     57          Download (FTP): <ulink url="&tcsh-download-ftp;"/>
     58        </para>
     59      </listitem>
     60      <listitem>
     61        <para>
     62          Download MD5 sum: &tcsh-md5sum;
     63        </para>
     64      </listitem>
     65      <listitem>
     66        <para>
     67          Download size: &tcsh-size;
     68        </para>
     69      </listitem>
     70      <listitem>
     71        <para>
     72          Estimated disk space required: &tcsh-buildsize;
     73        </para>
     74      </listitem>
     75      <listitem>
     76        <para>
     77          Estimated build time: &tcsh-time;
     78        </para>
    6579      </listitem>
    6680    </itemizedlist>
    … …  
    8195sed -i 's|BSD_SOURCE|DEFAULT_SOURCE|g'  config/linux</userinput></screen>
    8296-->
    83     <para>Install <application>Tcsh</application> by running the following
    84     commands:</para>
     97    <para>
     98      Install <application>Tcsh</application> by running the following
     99      commands:
     100    </para>
    85101
    86102<screen><userinput>./configure --prefix=/usr --bindir=/bin &amp;&amp;
    … …  
    89105sh ./tcsh.man2html</userinput></screen>
    90106
    91     <para>To test the results, issue: <command>make check</command>.</para>
    92 
    93     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     107    <para>
     108      To test the results, issue: <command>make check</command>.
     109    </para>
     110
     111    <para>
     112      Now, as the <systemitem class="username">root</systemitem> user:
     113    </para>
    94114
    95115<screen role="root"><userinput>make install install.man &amp;&amp;
    … …  
    107127    <title>Command Explanations</title>
    108128
    109     <para><parameter>--bindir=/bin</parameter>: This installs the
    110     <command>tcsh</command> program in <filename
    111     class='directory'>/bin</filename> instead of <filename
    112     class='directory'>/usr/bin</filename>.</para>
    113 
    114     <para><command>sh ./tcsh.man2html</command>: This creates HTML documentation
    115     from the formatted man page.</para>
    116 
    117     <para><command>ln -v -sf tcsh /bin/csh</command>: The FHS states that if
    118     there is a <application>C</application> shell installed, there should be a
    119     symlink from <filename>/bin/csh</filename> to it. This creates that
    120     symlink.</para>
     129    <para>
     130      <parameter>--bindir=/bin</parameter>: This installs the
     131      <command>tcsh</command> program in <filename
     132      class='directory'>/bin</filename> instead of <filename
     133      class='directory'>/usr/bin</filename>.
     134    </para>
     135
     136    <para>
     137      <command>sh ./tcsh.man2html</command>: This creates HTML documentation
     138      from the formatted man page.
     139    </para>
     140
     141    <para>
     142      <command>ln -v -sf tcsh /bin/csh</command>: The FHS states that if
     143      there is a <application>C</application> shell installed, there should
     144      be a symlink from <filename>/bin/csh</filename> to it. This creates
     145      that symlink.
     146    </para>
    121147
    122148  </sect2>
    … …  
    128154      <title>Config Files</title>
    129155
    130       <para>There are numerous configuration files for the C shell. Examples
    131       of these are <filename>/etc/csh.cshrc</filename>,
    132       <filename>/etc/csh.login</filename>, <filename>/etc/csh.logout</filename>,
    133       <filename>~/.tcshrc</filename>, <filename>~/.cshrc</filename>,
    134       <filename>~/.history</filename>, <filename>~/.cshdirs</filename>,
    135       <filename>~/.login</filename>, and <filename>~/.logout</filename>. More
    136       information on these files can be found in the
    137       <filename>tcsh(1)</filename> man page.</para>
     156      <para>
     157        There are numerous configuration files for the C shell. Examples
     158        of these are <filename>/etc/csh.cshrc</filename>,
     159        <filename>/etc/csh.login</filename>,
     160        <filename>/etc/csh.logout</filename>,
     161        <filename>~/.tcshrc</filename>, <filename>~/.cshrc</filename>,
     162        <filename>~/.history</filename>, <filename>~/.cshdirs</filename>,
     163        <filename>~/.login</filename>, and <filename>~/.logout</filename>. More
     164        information on these files can be found in the
     165        <filename>tcsh(1)</filename> man page.
     166      </para>
    138167
    139168      <indexterm zone="tcsh tcsh-config">
    … …  
    178207      <title>Configuration Information</title>
    179208
    180       <para>Update <filename>/etc/shells</filename> to include the C shell
    181       program names (as the <systemitem class="username">root</systemitem>
    182       user):</para>
     209      <para>
     210        Update <filename>/etc/shells</filename> to include the C shell
     211        program names (as the <systemitem class="username">root</systemitem>
     212        user):
     213      </para>
    183214
    184215<screen role="root"><userinput>cat &gt;&gt; /etc/shells &lt;&lt; "EOF"
    … …  
    256287        <term><command>tcsh</command></term>
    257288        <listitem>
    258           <para>is an enhanced but completely compatible version of the
    259           Berkeley Unix C shell, <command>csh</command>. It is usable as both an
    260           interactive shell and a script processor.</para>
     289          <para>
     290            is an enhanced but completely compatible version of the
     291            Berkeley Unix C shell, <command>csh</command>. It is usable as
     292            both an interactive shell and a script processor.
     293          </para>
    261294          <indexterm zone="tcsh tcsh-prog">
    262295            <primary sortas="b-tcsh">tcsh</primary>

  • postlfs/shells/zsh.xml

    r29244b7 rf716ef4  
    3333    <title>Introduction to zsh</title>
    3434
    35     <para>The <application>zsh</application> package contains a command
    36     interpreter (shell) usable as an interactive login shell and as
    37     a shell script command processor. Of the standard shells,
    38     <application>zsh</application> most closely resembles
    39     <application>ksh</application> but includes many enhancements.</para>
     35    <para>
     36      The <application>zsh</application> package contains a command
     37      interpreter (shell) usable as an interactive login shell and as
     38      a shell script command processor. Of the standard shells,
     39      <application>zsh</application> most closely resembles
     40      <application>ksh</application> but includes many enhancements.
     41    </para>
    4042
    4143    &lfs91_checked;
    … …  
    4446    <itemizedlist spacing="compact">
    4547      <listitem>
    46         <para>Download (HTTP): <ulink url="&zsh-download-http;"/></para>
    47       </listitem>
    48       <listitem>
    49         <para>Download (FTP): <ulink url="&zsh-download-ftp;"/></para>
    50       </listitem>
    51       <listitem>
    52         <para>Download MD5 sum: &zsh-md5sum;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Download size: &zsh-size;</para>
    56       </listitem>
    57       <listitem>
    58         <para>Estimated disk space required: &zsh-buildsize;</para>
    59       </listitem>
    60       <listitem>
    61         <para>Estimated build time: &zsh-time;</para>
     48        <para>
     49          Download (HTTP): <ulink url="&zsh-download-http;"/>
     50        </para>
     51      </listitem>
     52      <listitem>
     53        <para>
     54          Download (FTP): <ulink url="&zsh-download-ftp;"/>
     55        </para>
     56      </listitem>
     57      <listitem>
     58        <para>
     59          Download MD5 sum: &zsh-md5sum;
     60        </para>
     61      </listitem>
     62      <listitem>
     63        <para>
     64          Download size: &zsh-size;
     65        </para>
     66      </listitem>
     67      <listitem>
     68        <para>
     69          Estimated disk space required: &zsh-buildsize;
     70        </para>
     71      </listitem>
     72      <listitem>
     73        <para>
     74          Estimated build time: &zsh-time;
     75        </para>
    6276      </listitem>
    6377    </itemizedlist>
    … …  
    6680    <itemizedlist spacing="compact">
    6781      <listitem>
    68         <para>Optional Documentation: <ulink
    69         url="http://www.zsh.org/pub/zsh-&zsh-version;-doc.tar.xz"/></para>
    70       </listitem>
    71       <listitem>
    72         <para>Documentation MD5 sum: &zsh-doc-md5sum;</para>
    73       </listitem>
    74       <listitem>
    75         <para>Documentation download size: &zsh-doc-size;</para>
     82        <para>
     83          Optional Documentation: <ulink
     84          url="http://www.zsh.org/pub/zsh-&zsh-version;-doc.tar.xz"/>
     85        </para>
     86      </listitem>
     87      <listitem>
     88        <para>
     89          Documentation MD5 sum: &zsh-doc-md5sum;
     90        </para>
     91      </listitem>
     92      <listitem>
     93        <para>
     94          Documentation download size: &zsh-doc-size;
     95        </para>
    7696      </listitem>
    7797    </itemizedlist>
    … …  
    102122    <title>Installation of zsh</title>
    103123
    104     <para>If you downloaded the optional documentation, unpack it with
    105     the following command:</para>
     124    <para>
     125      If you downloaded the optional documentation, unpack it with
     126      the following command:
     127    </para>
    106128
    107129<screen><userinput>tar --strip-components=1 -xvf ../zsh-&zsh-version;-doc.tar.xz</userinput></screen>
    … …  
    115137    </note>
    116138-->
    117     <para>Install <application>zsh</application> by running the following
    118     commands:</para>
     139    <para>
     140      Install <application>zsh</application> by running the following
     141      commands:
     142    </para>
    119143
    120144<screen><userinput>./configure --prefix=/usr         \
    … …  
    128152makeinfo  Doc/zsh.texi --html --no-split --no-headers -o Doc/zsh.html</userinput></screen>
    129153
    130     <para>If you have <xref linkend="texlive"/>
    131     installed, you can build PDF format of the documentation by issuing
    132     the following command:</para>
     154    <para>
     155      If you have <xref linkend="texlive"/>
     156      installed, you can build PDF format of the documentation by issuing
     157      the following command:
     158    </para>
    133159
    134160<screen remap="doc"><userinput>texi2pdf  Doc/zsh.texi -o Doc/zsh.pdf</userinput></screen>
    135161
    136     <para>To test the results, issue: <command>make check</command>.</para>
    137 
    138     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     162    <para>
     163      To test the results, issue: <command>make check</command>.
     164    </para>
     165
     166    <para>
     167      Now, as the <systemitem class="username">root</systemitem> user:
     168    </para>
    139169
    140170<screen role="root"><userinput>make install                              &amp;&amp;
    … …  
    145175install -v -m644 Doc/zsh.{html,txt} /usr/share/doc/zsh-&zsh-version;</userinput></screen>
    146176
    147     <para>If you downloaded the optional documentation, install it by issuing
    148     the following commands as the
    149     <systemitem class="username">root</systemitem> user:</para>
     177    <para>
     178      If you downloaded the optional documentation, install it by issuing
     179      the following commands as the
     180      <systemitem class="username">root</systemitem> user:
     181    </para>
    150182
    151183<screen role="root"><userinput>make htmldir=/usr/share/doc/zsh-&zsh-version;/html install.html &amp;&amp;
    152184install -v -m644 Doc/zsh.dvi /usr/share/doc/zsh-&zsh-version;</userinput></screen>
    153185
    154     <para>If you built the PDF format of the documentation, install
    155     it by issuing the following command as the
    156     <systemitem class="username">root</systemitem> user:</para>
     186    <para>
     187      If you built the PDF format of the documentation, install
     188      it by issuing the following command as the
     189      <systemitem class="username">root</systemitem> user:
     190    </para>
    157191
    158192<screen role="root"
    … …  
    164198    <title>Command Explanations</title>
    165199
    166     <para><parameter>--sysconfdir=/etc/zsh</parameter> and
    167     <parameter>--enable-etcdir=/etc/zsh</parameter>: These parameters are
    168     used so that all the <application>zsh</application> configuration files
    169     are consolidated into the <filename class='directory'>/etc/zsh</filename>
    170     directory. Omit these parameters if you wish to retain historical
    171     compatibility by having all the files located in the
    172     <filename class='directory'>/etc</filename> directory.</para>
    173 
    174     <para><parameter>--bindir=/bin</parameter>: This parameter places the
    175     <command>zsh</command> binaries into the root filesystem.</para>
    176 
    177     <para><option>--enable-cap</option>: This option enables
    178     POSIX capabilities.</para>
    179 
    180     <para><option>--disable-gdbm</option>: This option disables the
    181     use of the <application>GDBM</application> library.</para>
    182 
    183     <para><option>--enable-pcre</option>: This option allows zsh to use
    184     the <application>PCRE</application> regular expression library in shell
    185     builtins.</para>
     200    <para>
     201      <parameter>--sysconfdir=/etc/zsh</parameter> and
     202      <parameter>--enable-etcdir=/etc/zsh</parameter>: These parameters are
     203      used so that all the <application>zsh</application> configuration files
     204      are consolidated into the <filename class='directory'>/etc/zsh</filename>
     205      directory. Omit these parameters if you wish to retain historical
     206      compatibility by having all the files located in the
     207      <filename class='directory'>/etc</filename> directory.
     208    </para>
     209
     210    <para>
     211      <parameter>--bindir=/bin</parameter>: This parameter places the
     212      <command>zsh</command> binaries into the root filesystem.
     213    </para>
     214
     215    <para>
     216      <option>--enable-cap</option>: This option enables
     217      POSIX capabilities.
     218    </para>
     219
     220    <para>
     221      <option>--disable-gdbm</option>: This option disables the
     222      use of the <application>GDBM</application> library.
     223    </para>
     224
     225    <para>
     226      <option>--enable-pcre</option>: This option allows zsh to use
     227      the <application>PCRE</application> regular expression library in shell
     228      builtins.
     229    </para>
    186230
    187231    <sect3 id="mountpoints">
    188232      <title>Multiple partitions</title>
    189233
    190       <para>Linking <application>zsh</application> dynamically against
    191       <application>pcre</application> and/or <application>gdbm</application>
    192       produces runtime dependencies on <filename class='libraryfile'>
    193       libpcre.so</filename> and/or <filename class='libraryfile'>libgdbm.so
    194       </filename>respectively, which both reside in
    195       <filename class='directory'>/usr</filename> hierarchy. If
    196       <filename class='directory'>/usr</filename> is a separate mount point
    197       and <application>zsh</application> needs to be available in boot time,
    198       then its supporting libraries should be in
    199       <filename class='directory'>/lib</filename> too. You can move the
    200       libraries as follows:</para>
     234      <para>
     235        Linking <application>zsh</application> dynamically against
     236        <application>pcre</application> and/or <application>gdbm</application>
     237        produces runtime dependencies on <filename class='libraryfile'>
     238        libpcre.so</filename> and/or <filename class='libraryfile'>libgdbm.so
     239        </filename>respectively, which both reside in
     240        <filename class='directory'>/usr</filename> hierarchy. If
     241        <filename class='directory'>/usr</filename> is a separate mount point
     242        and <application>zsh</application> needs to be available in boot time,
     243        then its supporting libraries should be in
     244        <filename class='directory'>/lib</filename> too. You can move the
     245        libraries as follows:
     246      </para>
    201247
    202248<screen role="root"><userinput>mv -v /usr/lib/libpcre.so.* /lib &amp;&amp;
    … …  
    207253</screen>
    208254
    209       <para>Alternatively you can statically link <application>zsh</application>
    210       against <application>pcre</application> and <application>gdbm</application>
    211       if you modify the <filename>config.modules</filename> file (you need first
    212       to run configure to generate it).</para>
     255      <para>
     256        Alternatively you can statically link <application>zsh</application>
     257        against <application>pcre</application> and
     258        <application>gdbm</application> if you modify the
     259        <filename>config.modules</filename> file (you need first to run
     260        configure to generate it).
     261      </para>
    213262
    214263    </sect3>
    … …  
    222271      <title>Config Files</title>
    223272
    224       <para>There are a whole host of configuration files for
    225       <application>zsh</application> including
    226       <filename>/etc/zsh/zshenv</filename>,
    227       <filename>/etc/zsh/zprofile</filename>,
    228       <filename>/etc/zsh/zshrc</filename>,
    229       <filename>/etc/zsh/zlogin</filename> and
    230       <filename>/etc/zsh/zlogout</filename>.
    231       You can find more information on these in the <filename>zsh(1)</filename>
    232       and related manual pages.</para>
     273      <para>
     274        There are a whole host of configuration files for
     275        <application>zsh</application> including
     276        <filename>/etc/zsh/zshenv</filename>,
     277        <filename>/etc/zsh/zprofile</filename>,
     278        <filename>/etc/zsh/zshrc</filename>,
     279        <filename>/etc/zsh/zlogin</filename> and
     280        <filename>/etc/zsh/zlogout</filename>.
     281        You can find more information on these in the
     282        <filename>zsh(1)</filename> and related manual pages.
     283      </para>
    233284
    234285      <para>
    … …  
    246297        <command>promptinit</command>. Available prompt names are listed with
    247298        <command>prompt -l</command>. Select a particular one with
    248         <command>prompt <literal>&lt;prompt-name&gt;</literal></command>. Display all available
     299        <command>prompt <literal>&lt;prompt-name&gt;</literal></command>.
     300        Display all available
    249301        prompts with <command>prompt -p</command>. Except for the list and
    250302        display commands above, you can insert the other ones in
    … …  
    278330      <title>Configuration Information</title>
    279331
    280       <para>Update <filename>/etc/shells</filename> to include the
    281       <application>zsh</application> shell program names (as the
    282       <systemitem class="username">root</systemitem> user):</para>
     332      <para>
     333        Update <filename>/etc/shells</filename> to include the
     334        <application>zsh</application> shell program names (as the
     335        <systemitem class="username">root</systemitem> user):
     336      </para>
    283337
    284338<screen role="root"><userinput>cat &gt;&gt; /etc/shells &lt;&lt; "EOF"
    … …  
    314368        <term><command>zsh</command></term>
    315369        <listitem>
    316           <para>is a shell which has command-line editing, built-in spelling
    317           correction, programmable command completion, shell functions (with
    318           autoloading), a history mechanism, and a host of other features.</para>
     370          <para>
     371            is a shell which has command-line editing, built-in spelling
     372            correction, programmable command completion, shell functions (with
     373            autoloading), a history mechanism, and a host of other features.
     374          </para>
    319375          <indexterm zone="zsh zsh-prog">
    320376            <primary sortas="b-zsh">zsh</primary>

  • postlfs/virtualization/virtualization.xml

    r29244b7 rf716ef4  
    1616  <title>Virtualization</title>
    1717
    18   <para>Virtualization allows running a complete operating system, or virtual
    19   machine (VM), within another operating environment as a task.  There are
    20   several commercial and open source environments that either emulate another
    21   processor or utilize the hardware virtualization features of the host
    22   processor.</para>
     18  <para>
     19    Virtualization allows running a complete operating system, or virtual
     20    machine (VM), within another operating environment as a task.  There are
     21    several commercial and open source environments that either emulate another
     22    processor or utilize the hardware virtualization features of the host
     23    processor.
     24  </para>
    2325
    2426  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="qemu.xml"/>
Note: See TracChangeset for help on using the changeset viewer.