Index: general.ent
===================================================================
--- general.ent	(revision 4ad483bf409e223651234b856c5d5b993c74b889)
+++ general.ent	(revision 37b6e78334d59ae3c2f527e7f8f23e82c812d577)
@@ -189,5 +189,5 @@
 <!ENTITY dash-version                 "0.5.7">
 <!ENTITY tcsh-version                 "6.18.01">
-<!ENTITY zsh-version                  "5.0.4">
+<!ENTITY zsh-version                  "5.0.5">
 
 <!-- Chapter 8 Virtualization -->
Index: introduction/welcome/changelog.xml
===================================================================
--- introduction/welcome/changelog.xml	(revision 4ad483bf409e223651234b856c5d5b993c74b889)
+++ introduction/welcome/changelog.xml	(revision 37b6e78334d59ae3c2f527e7f8f23e82c812d577)
@@ -48,4 +48,8 @@
       <itemizedlist>
         <listitem>
+          <para>[fernando] - Update to zsh-5.0.5. Fixes
+          <ulink url="&blfs-ticket-root;4531">#4531</ulink>.</para>
+        </listitem>
+        <listitem>
           <para>[fernando] - Update to apache-ant-1.9.3. Fixes
           <ulink url="&blfs-ticket-root;4536">#4536</ulink>.</para>
Index: postlfs/shells/zsh.xml
===================================================================
--- postlfs/shells/zsh.xml	(revision 4ad483bf409e223651234b856c5d5b993c74b889)
+++ postlfs/shells/zsh.xml	(revision 37b6e78334d59ae3c2f527e7f8f23e82c812d577)
@@ -7,11 +7,12 @@
   <!ENTITY zsh-download-http "http://www.zsh.org/pub/zsh-&zsh-version;.tar.bz2">
   <!ENTITY zsh-download-ftp  " ">
-  <!ENTITY zsh-md5sum        "9829fe8932c25740173a272e8959cf8c">
+  <!ENTITY zsh-md5sum        "6156dc2f19b0a067bdbc0fb7f81e2017">
   <!ENTITY zsh-size          "3.0 MB">
   <!ENTITY zsh-buildsize     "61 MB (includes installing documentation -
                               additional 2 MB for PDF documentation)">
-  <!ENTITY zsh-time          "0.8 SBU">
-
-  <!ENTITY zsh-doc-md5sum    "2505867639d58726cd09e6884cb7863c">
+  <!ENTITY zsh-time          "0.8 SBU (additional 2 SBU for tests)">
+
+  <!ENTITY zsh-doc-md5sum    "1eea70e7401a7a2116fa8de6ee5e8d32">
+  <!ENTITY zsh-doc-size      "2.9 MB">
 ]>
 
@@ -72,4 +73,7 @@
         <para>Documentation MD5 sum: &zsh-doc-md5sum;</para>
       </listitem>
+      <listitem>
+        <para>Documentation download size: &zsh-doc-size;</para>
+      </listitem>
     </itemizedlist>
 
@@ -94,4 +98,12 @@
 
 <screen><userinput>tar --strip-components=1 -xvf ../zsh-&zsh-version;-doc.tar.bz2</userinput></screen>
+
+    <note>
+      <para>
+        Using a script to build with "su -c script" may produce a funny
+        configure error message: "no controlling tty". If this happens, add
+        the switch --with-tcsetpgrp to configure.
+      </para>
+    </note>
 
     <para>Install <application>zsh</application> by running the following
@@ -215,4 +227,25 @@
       and related manual pages.</para>
 
+      <para>
+        The first time zsh is executed, you will be prompted by messages asking
+        several questions. The answers will be used to create a 
+        <filename>~/.zshrc</filename> file. If you wish to run these questions
+        again, run <command>zsh
+        /usr/share/zsh/&zsh-version;/functions/zsh-newuser-install -f</command>.
+      </para>
+
+      <para>
+        There are several built-in advanced prompts. In the
+        <command>zsh</command> shell, start advanced prompt support with
+        <command>autoload -U promptinit</command>, then
+        <command>promptinit</command>. Available prompt names are listed with
+        <command>prompt -l</command>. Select a particular one with
+        <command>prompt <literal>&lt;prompt-name&gt;</literal></command>. Display all available
+        prompts with <command>prompt -p</command>. Except for the list and
+        display commands above, you can insert the other ones in
+        <filename>~/.zshrc</filename> to be automatically executed at
+        shell start, with the prompt you chose.
+      </para>
+
       <indexterm zone="zsh zsh-config">
         <primary sortas="e-etc-zsh-zshenv">/etc/zsh/zshenv</primary>
