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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • 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>
Note: See TracChangeset for help on using the changeset viewer.