diff --git a/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm b/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm index 08634cf0849dd5..a7da2ed42d1916 100644 --- a/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm +++ b/src/main/java/com/google/devtools/build/docgen/templates/be/functions.vm @@ -651,12 +651,12 @@ sh_binary( that lists subpackages instead of files and directories. It uses the same path patterns as glob() and can match any subpackage that is a direct decendant of the currently loading BUILD file. See glob for detailed explinations and example of include and + href="#glob">glob for a detailed explanation and examples of include and exclude patterns.

- The resulting list of subpackages returned is in sorted order and contains a + The resulting list of subpackages returned is in sorted order and contains paths relative to the current loading package that match the given patterns in include and not those in exclude. @@ -675,15 +675,16 @@ sh_binary( # In foo/BUILD a call to subs = subpackages(include = ["**"]) -# results in subs == ["sub", "foo/bar/baz"]` +# results in subs == ["sub", "bar/baz"] # -# foo/sub/deeper is not included because it is a subpackage of 'foo/sub' not of +# 'sub/deeper' is not included because it is a subpackage of 'foo/sub' not of # 'foo'

In general it is preferred that instead of calling this function directly that users use the 'subpackages' module of + skylib. #if (!$singlePage) #parse("com/google/devtools/build/docgen/templates/be/footer.vm")