source: postlfs/shells/zsh.xml@ 5603a81

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5603a81 was 5603a81, checked in by Andrew Benton <andy@…>, 9 years ago

Added some checked tags

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

  • Property mode set to 100644
File size: 10.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY zsh-download-http "&sourceforge-repo;/zsh/zsh-&zsh-version;.tar.bz2">
8 <!ENTITY zsh-download-ftp " ">
9 <!ENTITY zsh-md5sum "74c5b275544400082a1cde806c98682a">
10 <!ENTITY zsh-size "2.7 MB">
11 <!ENTITY zsh-buildsize "49 MB (includes installing all documentation)">
12 <!ENTITY zsh-time "0.8 SBU">
13
14 <!ENTITY zsh-doc-md5sum "b3a026cf02471b66454a2b241a4d92a4">
15]>
16
17<sect1 id="zsh" xreflabel="ZSH-&zsh-version;">
18 <?dbhtml filename="zsh.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>ZSH-&zsh-version;</title>
26
27 <indexterm zone="zsh">
28 <primary sortas="a-ZSH">ZSH</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to ZSH</title>
33
34 <para>The <application>ZSH</application> package contains a command
35 interpreter (shell) usable as an interactive login shell and as
36 a shell script command processor. Of the standard shells,
37 <application>ZSH</application> most closely resembles
38 <application>KSH</application> but includes many enhancements.</para>
39
40 <note>
41 <para>This version of <application>ZSH</application> is a development
42 release. The BLFS staff has determined that it provides a stable
43 program which works properly with multibyte locales (e.g., UTF-8).
44 To find the current stable release, refer to the
45 <ulink url="http://www.zsh.org/">ZSH home page</ulink> and compile
46 <application>ZSH</application> with the same instructions.</para>
47 </note>
48
49 &lfs71_checked;
50
51 <bridgehead renderas="sect3">Package Information</bridgehead>
52 <itemizedlist spacing="compact">
53 <listitem>
54 <para>Download (HTTP): <ulink url="&zsh-download-http;"/></para>
55 </listitem>
56 <listitem>
57 <para>Download (FTP): <ulink url="&zsh-download-ftp;"/></para>
58 </listitem>
59 <listitem>
60 <para>Download MD5 sum: &zsh-md5sum;</para>
61 </listitem>
62 <listitem>
63 <para>Download size: &zsh-size;</para>
64 </listitem>
65 <listitem>
66 <para>Estimated disk space required: &zsh-buildsize;</para>
67 </listitem>
68 <listitem>
69 <para>Estimated build time: &zsh-time;</para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>Optional Documentation: <ulink
77 url="&sourceforge-repo;/zsh/zsh-&zsh-version;-doc.tar.bz2"/></para>
78 </listitem>
79 <listitem>
80 <para>MD5 sum: &zsh-doc-md5sum;</para>
81 </listitem>
82 </itemizedlist>
83
84 <bridgehead renderas="sect3">ZSH Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Optional</bridgehead>
87 <para role="optional"><xref linkend="pcre"/> and
88 <xref linkend="libcap2"/>
89 </para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/zsh"/></para>
93
94 </sect2>
95
96 <sect2 role="installation">
97 <title>Installation of ZSH</title>
98
99 <para>If you downloaded the optional documentation, unpack it with
100 the following command:</para>
101
102<screen><userinput>tar --strip-components=1 -xvf ../zsh-&zsh-version;-doc.tar.bz2</userinput></screen>
103
104 <para>Install <application>ZSH</application> by running the following
105 commands:</para>
106
107<screen><userinput>./configure --prefix=/usr \
108 --bindir=/bin \
109 --sysconfdir=/etc/zsh \
110 --enable-etcdir=/etc/zsh &amp;&amp;
111make &amp;&amp;
112
113makeinfo Doc/zsh.texi --html -o Doc/html &amp;&amp;
114makeinfo Doc/zsh.texi --html --no-split --no-headers \
115 -o Doc/zsh.html &amp;&amp;
116makeinfo Doc/zsh.texi --plaintext -o Doc/zsh.txt</userinput></screen>
117
118 <para>If you have <!--<xref linkend="tetex"/> or--> <xref linkend="texlive"/>
119 installed, you can build PDF format of the documentation by issuing
120 the following command:</para>
121
122<screen><userinput>texi2pdf Doc/zsh.texi -o Doc/zsh.pdf</userinput></screen>
123
124 <para>To test the results, issue: <command>make check</command>.</para>
125
126 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
127
128<screen role="root"><userinput>make install &amp;&amp;
129make infodir=/usr/share/info install.info
130
131install -v -m755 -d /usr/share/doc/zsh-&zsh-version;/html &amp;&amp;
132install -v -m644 Doc/html/* \
133 /usr/share/doc/zsh-&zsh-version;/html &amp;&amp;
134install -v -m644 Doc/zsh.{html,txt} \
135 /usr/share/doc/zsh-&zsh-version;</userinput></screen>
136
137 <para>If you downloaded the optional documentation, install it by issuing
138 the following commands as the
139 <systemitem class="username">root</systemitem> user:</para>
140
141<screen role="root"><userinput>make htmldir=/usr/share/doc/zsh-&zsh-version;/html install.html &amp;&amp;
142install -v -m644 Doc/zsh.dvi /usr/share/doc/zsh-&zsh-version;</userinput></screen>
143
144 <para>If you built the PDF format of the documentation, install
145 it by issuing the following command as the
146 <systemitem class="username">root</systemitem> user:</para>
147
148<screen role="root"><userinput>install -v -m644 Doc/zsh.pdf \
149 /usr/share/doc/zsh-&zsh-version;</userinput></screen>
150
151 </sect2>
152
153 <sect2 role="commands">
154 <title>Command Explanations</title>
155
156 <para><parameter>--sysconfdir=/etc/zsh</parameter> and
157 <parameter>--enable-etcdir=/etc/zsh</parameter>: These parameters are
158 used so that all the <application>ZSH</application> configuration files
159 are consolidated into the <filename class='directory'>/etc/zsh</filename>
160 directory. Omit these parameters if you wish to retain historical
161 compatibility by having all the files located in the
162 <filename class='directory'>/etc</filename> directory.</para>
163
164 <para><parameter>--bindir=/bin</parameter>: This parameter places the
165 <command>zsh</command> binaries into the root filesystem.</para>
166
167 <para><parameter>--enable-cap</parameter>: This parameter enables
168 POSIX capabilities.</para>
169
170 <para><parameter>--disable-gdbm</parameter>: This parameter disables the
171 use of the <application>GDBM</application> library.</para>
172
173 <para><parameter>--enable-pcre</parameter>: This parameter allows to use
174 the <application>PCRE</application> regular expression library in shell
175 builtins.</para>
176
177 <sect3 id="mountpoints">
178 <title>Multiple partitions</title>
179
180 <para>Linking <application>ZSH</application> dynamically against
181 <application>PCRE</application> and/or <application>GDBM</application>
182 produces runtime dependencies on <filename class='libraryfile'>
183 libpcre.so</filename> and/or <filename class='libraryfile'>libgdbm.so
184 </filename>respectively, which both reside in
185 <filename class='directory'>/usr</filename> hierarchy. If
186 <filename class='directory'>/usr</filename> is a separate mount point
187 and <application>ZSH</application> needs to be available in boot time,
188 then its supporting libraries should be in
189 <filename class='directory'>/lib</filename> too. You can move the
190 libraries as follows:</para>
191
192<screen role="root"><userinput>mv -v /usr/lib/libpcre.so.* /lib &amp;&amp;
193ln -v -sf ../../lib/libpcre.so.0 /usr/lib/libpcre.so
194
195mv -v /usr/lib/libgdbm.so.* /lib &amp;&amp;
196ln -v -sf ../../lib/libgdbm.so.3 /usr/lib/libgdbm.so</userinput>
197</screen>
198
199 <para>Alternatively you can statically link <application>ZSH</application>
200 against <application>PCRE</application> and <application>GDBM</application>
201 if you modify the <filename>config.modules</filename> file (you need first
202 to run configure to generate it).</para>
203
204 </sect3>
205
206 </sect2>
207
208 <sect2 role="configuration">
209 <title>Configuring ZSH</title>
210
211 <sect3 id="zsh-config">
212 <title>Config Files</title>
213
214 <para>There are a whole host of configuration files for
215 <application>ZSH</application> including
216 <filename>/etc/zsh/zshenv</filename>,
217 <filename>/etc/zsh/zprofile</filename>,
218 <filename>/etc/zsh/zshrc</filename>,
219 <filename>/etc/zsh/zlogin</filename> and
220 <filename>/etc/zsh/zlogout</filename>.
221 You can find more information on these in the <filename>zsh(1)</filename>
222 and related manual pages.</para>
223
224 <indexterm zone="zsh zsh-config">
225 <primary sortas="e-etc-zsh-zshenv">/etc/zsh/zshenv</primary>
226 </indexterm>
227
228 <indexterm zone="zsh zsh-config">
229 <primary sortas="e-etc-zsh-zprofile">/etc/zsh/zprofile</primary>
230 </indexterm>
231
232 <indexterm zone="zsh zsh-config">
233 <primary sortas="e-etc-zsh-zshrc">/etc/zsh/zshrc</primary>
234 </indexterm>
235
236 <indexterm zone="zsh zsh-config">
237 <primary sortas="e-etc-zsh-zlogin">/etc/zsh/zlogin</primary>
238 </indexterm>
239
240 <indexterm zone="zsh zsh-config">
241 <primary sortas="e-etc-zsh-zlogout">/etc/zsh/zlogout</primary>
242 </indexterm>
243
244 </sect3>
245
246 <sect3>
247 <title>Configuration Information</title>
248
249 <para>Update <filename>/etc/shells</filename> to include the
250 <application>ZSH</application> shell program names (as the
251 <systemitem class="username">root</systemitem> user):</para>
252
253<screen role="root"><userinput>cat &gt;&gt; /etc/shells &lt;&lt; "EOF"
254<literal>/bin/zsh
255/bin/zsh-&zsh-version;</literal>
256EOF</userinput></screen>
257
258 </sect3>
259
260 </sect2>
261
262 <sect2 role="content">
263 <title>Contents</title>
264
265 <segmentedlist>
266 <segtitle>Installed Programs</segtitle>
267 <segtitle>Installed Libraries</segtitle>
268 <segtitle>Installed Directories</segtitle>
269
270 <seglistitem>
271 <seg>zsh and zsh-&zsh-version;</seg>
272 <seg>Numerous plugin helper modules</seg>
273 <seg>/etc/zsh, /usr/lib/zsh, /usr/share/doc/zsh-&zsh-version; and
274 /usr/share/zsh</seg>
275 </seglistitem>
276 </segmentedlist>
277
278 <variablelist>
279 <bridgehead renderas="sect3">Short Description</bridgehead>
280 <?dbfo list-presentation="list"?>
281 <?dbhtml list-presentation="table"?>
282
283 <varlistentry id="zsh-prog">
284 <term><command>zsh</command></term>
285 <listitem>
286 <para>is a shell which has command-line editing, built-in spelling
287 correction, programmable command completion, shell functions (with
288 autoloading), a history mechanism, and a host of other features.</para>
289 <indexterm zone="zsh zsh-prog">
290 <primary sortas="b-zsh">zsh</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 </variablelist>
296
297 </sect2>
298
299</sect1>
Note: See TracBrowser for help on using the repository browser.