[Zope-CVS] CVS: Packages/zpkgtools/doc - metadata.txt:1.25

[Fred L. Drake, Jr.]

Update of /cvs-repository/Packages/zpkgtools/doc
In directory cvs.zope.org:/tmp/cvs-serv28265/doc

Modified Files:
	metadata.txt 
Log Message:
permit components to specify files to exclude from distribution as an
alternative to only allowing specific inclusions to be defined


=== Packages/zpkgtools/doc/metadata.txt 1.24 => 1.25 ===
--- Packages/zpkgtools/doc/metadata.txt:1.24	Tue May 11 16:09:41 2004
+++ Packages/zpkgtools/doc/metadata.txt	Thu May 20 12:35:34 2004
@@ -81,7 +81,8 @@
    If `PACKAGE.cfg` contains a ``<collection>`` section, it is used
    to specify which files should be copied into the
    component-specific portion of the distribution tree.  Only files
-   listed will be copied.
+   listed will be copied.  If the ``<collection>`` section specifies
+   exclusions, all files will be copied *except* for those excluded.
 
    If the ``<collection>`` section is not present or is empty, all
    files in the workspace are copied; directories are copied
@@ -101,6 +102,18 @@
    the same name as the source.  In this case, *source* can contain
    POSIX globbing wildcards.
 
+   Files and directories can be excluded from the collection by
+   specifying exclusions instead of inclusions.  It is not possible to
+   specify both using the current |zpkg|_ implementation.  An
+   exclusion is similar to an inclusion, but the destination is always
+   ``-`` (a single hyphen):
+
+     *source* ``-``
+
+   will cause files and directories matching *source* to be excluded
+   from the distribution.  *source* can contain POSIX globbing
+   wildcards.
+
 4. If the component being processed is the primary resource being
    packaged, files from the workspace can be copied into the
    distribution root.  This is done using the ``<distribution>``
@@ -290,3 +303,5 @@
 of the `SETUP.cfg` file containing this section) to be copied into the
 directory `$prefix/etc/myapp/`; this directory will be created if
 necessary.
+
+.. include:: links.rst