aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJacob Bachmeyer <jcb62281@gmail.com>2018-12-11 13:44:02 +1100
committerBen Elliston <bje@gnu.org>2018-12-11 13:44:02 +1100
commit28ae6432670ca0aadecbf2114cd828f793537713 (patch)
tree19caa17f3687b455b7bf99c4181d5ae2d7edd8d4
parentaaee01475fee922b8e1d3a5231f4cf03763002af (diff)
downloaddejagnu-28ae6432670ca0aadecbf2114cd828f793537713.zip
dejagnu-28ae6432670ca0aadecbf2114cd828f793537713.tar.gz
dejagnu-28ae6432670ca0aadecbf2114cd828f793537713.tar.bz2
* doc/dejagnu.texi (getdirs procedure): Document hard-coded
directory exclusions by name in this procedure. Signed-off-by: Ben Elliston <bje@gnu.org>
-rw-r--r--ChangeLog5
-rw-r--r--doc/dejagnu.texi13
2 files changed, 16 insertions, 2 deletions
diff --git a/ChangeLog b/ChangeLog
index f026226..88279b0 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2018-12-11 Jacob Bachmeyer <jcb62281@gmail.com>
+
+ * doc/dejagnu.texi (getdirs procedure): Document hard-coded
+ directory exclusions by name in this procedure.
+
2018-12-10 Ben Elliston <bje@gnu.org>
* doc/dejagnu.texi (getdirs procedure): This procedure accepts Tcl
diff --git a/doc/dejagnu.texi b/doc/dejagnu.texi
index b0392ff..b5dbc0a 100644
--- a/doc/dejagnu.texi
+++ b/doc/dejagnu.texi
@@ -4793,6 +4793,15 @@ Returns a list of all the subdirectories in a single directory that
match a glob pattern. If no directories match the pattern, then an empty
list is returned.
+This procedure is specialized as a search for tests in
+testsuites: @code{getdirs} ignores directories named
+@samp{testsuite}, @samp{config}, or @samp{lib}, and also ignores
+directories associated with a few revision control systems,
+specifically Git (@samp{.git}), Subversion (@samp{.svn}), CVS
+(@samp{CVS}), RCS (@samp{RCS}), and SCCS (@samp{SCCS}). These ignored
+directories will not appear in the returned list, nor will they be
+examined in a recursive search.
+
@quotation
@t{@b{getdirs} @i{-all} @i{rootdir} @i{pattern}}
@end quotation
@@ -5589,5 +5598,5 @@ This makes @code{runtest} exit. Abbreviation: @kbd{q}.
@bye
-@c LocalWords: subdirectory prepend prepended testsuite filename Expect's
-@c LocalWords: DejaGnu
+@c LocalWords: subdirectory prepend prepended testsuite filename Expect's svn
+@c LocalWords: DejaGnu CVS RCS SCCS