30509: updates for 5.0.0

ChangeLog

@@ -1,5 +1,7 @@
 2012-06-15  Peter Stephenson  <p.w.stephenson@ntlworld.com>
 
+	* 30509: FEATURES, README, Etc/FAQ.yo: updates for 5.0.0.
+
 	* Danek: 30510: Doc/Zsh/params.yo: bad indentation.
 
 2012-06-10  Clint Adams  <clint@zsh.org>
@@ -16359,5 +16361,5 @@
 
 *****************************************************
 * This is used by the shell to define $ZSH_PATCHLEVEL
-* $Revision: 1.5667 $
+* $Revision: 1.5668 $
 *****************************************************

Etc/FAQ.yo

@@ -52,8 +52,8 @@ myreport(Z-Shell Frequently-Asked Questions)(Peter Stephenson)(2010/02/15)
 COMMENT(-- the following are for Usenet and must appear first)\
 description(\
 mydit(Archive-Name:) unix-faq/shell/zsh
-mydit(Last-Modified:) 2010/02/15
-mydit(Submitted-By:) email(pws@pwstephenson.fsnet.co.uk (Peter Stephenson))
+mydit(Last-Modified:) 2012/06/15
+mydit(Submitted-By:) email(coordinator@zsh.org (Peter Stephenson))
 mydit(Posting-Frequency:) Monthly
 mydit(Copyright:) (C) P.W. Stephenson, 1995--2010 (see end of document)
 )
@@ -301,13 +301,9 @@ sect(On what machines will it run?)
 
 sect(What's the latest version?)
 
-  Zsh 4.2.7 is the latest production version.  The latest development
-  version is 4.3.17; this contains support for multibyte character strings
-  (such as UTF-8 locales).  All the main features for multibyte
-  support are now in place and this is likely soon to become the
-  stable series 5.0.
-
-  There will not be any further 4.2 releases.
+  Zsh 5.0.0 is the latest production version, replacing the now
+  rather antiquated 4.2.7.  For details of all the changes, see
+  the NEWS file in the source distribution.
 
   A beta of the next version is sometimes available.  Development of zsh is
   patch by patch, with each intermediate version publicly available.  Note
@@ -2292,8 +2288,9 @@ Wischnowsky).
 nsect(Copyright Information:)
 
 This document is copyright (C) P.W. Stephenson, 1995, 1996, 1997,
-1998, 1999, 2000. This text originates in the U.K. and the author asserts
-his moral rights under the Copyrights, Designs and Patents Act, 1988.
+1998, 1999, 2000, 2012. This text originates in the U.K. and the author
+asserts his moral rights under the Copyrights, Designs and Patents Act,
+1988.
 
 Permission is hereby granted, without written agreement and without
 license or royalty fees, to use, copy, modify, and distribute this

FEATURES

@@ -2,6 +2,10 @@
 ZSH FEATURES
 ------------
 
+(Note that this file only lists basic shell features, for those who
+may not have encountered zsh before.  Those familiar with zsh are
+unlikely to find anything new here.)
+
 very close to ksh/sh grammar, with csh additions
 most features of ksh, bash, and tcsh
 can emulate ksh or POSIX sh

README

@@ -5,11 +5,11 @@ THE Z SHELL (ZSH)
 Version
 -------
 
-This is version 4.3.17 of the shell.  This is a development release,
-but is believed to be reasonably stable.  Sites where the users need to
-edit command lines with multibyte characters (in particular UTF-8)
-will probably want to upgrade.  The previous widely released version
-of the shell was 4.3.15.
+This is version 5.0.0 of the shell.  This is a stable release.
+There have been only incremental changes since the last development
+version, 4.3.17.  The new major version number represents the
+substantial changes since the 4.2 stable release series.  The
+changes are detailed in the file NEWS.
 
 Installing Zsh
 --------------
@@ -33,16 +33,8 @@ details, see the documentation.
 Possible incompatibilities
 ---------------------------
 
-In some 4.3.X releases of zsh, the completion system added a ".."  as a
-trial completion whenever completing directories.  This was a bug: as
-documented in the zshcompsys manual, this feature needs to be turned on by
-a style:
-
-  zstyle ':completion:*' special-dirs true
-
-
-The rest of this section documents incompatibilities in the shell since the
-4.2 series of releases.
+Here are some incompatibilities in the shell since the 4.2 series of
+releases.  It is hoped most users will not be adversely affected by these.
 
 In previous releases of the shell, builtin commands and precommand
 modifiers that did not accept options also did not recognize the