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

[Fred L. Drake, Jr.]

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

Modified Files:
	metadata.txt 
Log Message:
add another example, and fix some markup


=== Packages/zpkgtools/doc/metadata.txt 1.12 => 1.13 ===
--- Packages/zpkgtools/doc/metadata.txt:1.12	Fri Apr 23 18:23:18 2004
+++ Packages/zpkgtools/doc/metadata.txt	Tue Apr 27 17:26:22 2004
@@ -59,11 +59,11 @@
 --------------------------------
 
   The `PACKAGE.cfg` file can contain three distinct sections; the
-  <load> section identifies files that need to be loaded from other
-  sources, the <distribution> section is used to include files in the
-  distribution root, and the <collection> section is used to include
-  files in the component itself (even if the component isn't a
-  collection; this name is used since it usually will be a
+  ``<load>`` section identifies files that need to be loaded from
+  other sources, the ``<distribution>`` section is used to include
+  files in the distribution root, and the ``<collection>`` section is
+  used to include files in the component itself (even if the component
+  isn't a collection; this name is used since it usually will be a
   collection).
 
   As an example, this is the `PACKAGE.cfg` being used for the
@@ -93,6 +93,20 @@
       # We'll remove this too, since it's only of interest to CVS users:
       BRANCHES.txt -
     </collection>
+
+  Note that when excluding files from the collection, wildcards are
+  supported using the convention POSIX globbing syntax.  The
+  ``<collection>`` section above could have been written as::
+
+    <collection>
+      doc          -
+      *.txt        -
+    </collection>
+
+  This wouldn't have made it as screamingly obvious that we were
+  dropping a text file from the finished package that wasn't already
+  mentioned, however.
+
 
 Embedded Package Definitions
 ----------------------------