Changeset f716ef4 for postlfs/shells


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/shells
Files:
3 edited

Legend:

Unmodified
Added
Removed

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