2 files changed, 11 insertions, 7 deletions

diff --git a/Etc/FAQ.yo b/Etc/FAQ.yo
index ed703c68b..08ea979ee 100644
--- a/Etc/FAQ.yo
+++ b/Etc/FAQ.yo
@@ -302,7 +302,7 @@ sect(On what machines will it run?)
 
 sect(What's the latest version?)
 
-  Zsh 5.0.6 is the latest production version.  For details of all the
+  Zsh 5.0.7 is the latest production version.  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
diff --git a/Etc/zsh-development-guide b/Etc/zsh-development-guide
index 37364e118..2ed75423b 100644
--- a/Etc/zsh-development-guide
+++ b/Etc/zsh-development-guide
@@ -931,18 +931,22 @@ freely available tools.
 To indicate which files should be distributed, each directory in the git
 tree includes a file .distfiles that sets any number of a set of Bourne
 shell (scalar) parameters.  The value of the parameter is expanded as a
-set of standard command line arguments.  Basic globbing is allowed in the
-values.
+set of standard command line arguments.  Apart from DISTFILES_NOT, which
+must be an explicit list of files separated by whitespace, basic
+globbing is allowed in the values.
+
+Because of the way DISTFILES_SRC is constructed it is only possible
+to make a release from a git checkout.
 
 The following parameters are currently used:
 
 - DISTFILES_SRC is a list of files from the directory for the "src"
-  distribution.
+  distribution.  However, if the file .distfiles is present in
+  a directory, all files known to git will be added to DISTFILES_SRC
+  except for files listed explicitly in DISTFILES_NOT.
 
 - DISTFILES_DOC is a list of files from the directory for the "doc"
   distribution.
 
 - DISTFILES_NOT is a list of files that will not be included in a
-  distribution, but that need to be present in the git tree.  This
-  variable is not used by the zsh build process and is present for
-  the convenience of external checks.
+  distribution even though they are present in the git tree.