diff options
| -rw-r--r-- | build2/test/script/script | 29 |
1 files changed, 13 insertions, 16 deletions
diff --git a/build2/test/script/script b/build2/test/script/script index c3b717f..9ce352d 100644 --- a/build2/test/script/script +++ b/build2/test/script/script @@ -170,24 +170,21 @@ namespace build2 optional<description> desc; - // Files and directories that must be automatically cleaned up when - // the scope is left. If the path contains '*' it is a wildcard. If the - // path is not a wildcard and ends with a trailing slash, then it is - // assumed to be to a directory, otherwise -- to a file. A directory - // must be empty by the time of removal, + // Files and directories to be automatically cleaned up at the end of + // the scope. If the path ends with a trailing slash, then it is + // assumed to be a directory, otherwise -- a file. A directory that + // is about to be cleaned up must be empty. // - // The supported wildcards: + // The last component in the path may contain a wildcard that have the + // following semantics: // - // dir/*** - remove directory 'dir' with all files and sub-directories - // recursively. Removing non-existing 'dir' is not an error. - // - // The not yet supported wildcards: - // - // &dir/* - remove all immediate files of directory 'dir'; - // &dir/*/ - remove all immediate sub-directories (must be empty); - // &dir/** - remove all files recursively; - // &dir/**/ - remove all sub-directories recursively (must be empty by - // the time of removal). + // dir/* - remove all immediate files + // dir/*/ - remove all immediate sub-directories (must be empty) + // dir/** - remove all files recursively + // dir/**/ - remove all sub-directories recursively (must be empty) + // dir/*** - remove directory dir with all files and sub-directories + // recursively (removing non-existent directory is not an + // error) // paths cleanups; |