about summary refs log tree commit diff
path: root/Etc
diff options
context:
space:
mode:
authorPeter Stephenson <p.w.stephenson@ntlworld.com>2014-08-28 20:54:10 +0100
committerPeter Stephenson <p.w.stephenson@ntlworld.com>2014-08-28 20:54:10 +0100
commit40d559d8803ddbfa6d6d628e86491398f543aca3 (patch)
tree72b624daeb7f28cba8e80fdfeb1816adc5ddddad /Etc
parent93d923b8c12269157dd975b3fd1dfc91fb712313 (diff)
downloadzsh-40d559d8803ddbfa6d6d628e86491398f543aca3.tar.gz
zsh-40d559d8803ddbfa6d6d628e86491398f543aca3.tar.xz
zsh-40d559d8803ddbfa6d6d628e86491398f543aca3.zip
Update notes on use of .distfiles
Diffstat (limited to 'Etc')
-rw-r--r--Etc/zsh-development-guide16
1 files changed, 10 insertions, 6 deletions
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.