diff --git a/v2/doc/src/reference.xml b/v2/doc/src/reference.xml
index 5b9c1cf80..9ea1df927 100644
--- a/v2/doc/src/reference.xml
+++ b/v2/doc/src/reference.xml
@@ -287,12 +287,35 @@ target1 debug gcc/runtime-link=dynamic,static
glob
- The glob rule takes a shell pattern and
- returns the list of files in the project's source directory that
+ The glob rule takes a list shell pattern
+ and returns the list of files in the project's source directory that
match the pattern. For example:
lib tools : [ glob *.cpp ] ;
+ It is possible to also pass a second argument—the list of
+ exclude patterns. The result will then include the list of
+ files patching any of include patterns, and not matching any
+ of the exclude patterns. For example:
+
+lib tools : [ glob *.cpp : file_to_exclude.cpp bad*.cpp ] ;
+
+
+
+
+
+ glob-tree
+
+ The glob-tree is similar to the
+ glob except that it operates recursively from
+ the directory of the containing Jamfile. For example:
+
+ECHO [ glob-tree *.cpp : .svn ] ;
+
+ will print the names of all C++ files in your project. The
+ .svn exclude pattern prevents the
+ glob-tree rule from entering administrative
+ directories of the Subverion version control system.