Add strip_prefix to the C++ documentation -- MOS_MIGRATED_REVID=104097995
diff --git a/site/docs/cpp.md b/site/docs/cpp.md index 8f8900d..db0a1b7 100644 --- a/site/docs/cpp.md +++ b/site/docs/cpp.md
@@ -200,6 +200,39 @@ ) ``` +This is somewhat messy: everything is prefixed with gtest-1.7.0 as a byproduct +of the archive's structure. You can make `new_http_archive` strip this prefix by +adding the `strip_prefix` attribute: + +```python +new_http_archive( + name = "gtest", + url = "https://googletest.googlecode.com/files/gtest-1.7.0.zip", + sha256 = "247ca18dd83f53deb1328be17e4b1be31514cedfc1e3424f672bf11fd7e0d60d", + build_file = "gtest.BUILD", + strip_prefix = "gtest-1.7.0", +) +``` + +Then `gtest.BUILD` would look like this: + +```python +cc_library( + name = "main", + srcs = glob( + ["src/*.cc"], + exclude = ["src/gtest-all.cc"] + ), + hdrs = glob(["include/**/*.h"]), + includes = [ + ".", + "include" + ], + linkopts = ["-pthread"], + visibility = ["//visibility:public"], +) +``` + Now `cc_` rules can depend on `//external:gtest/main`. For example, we could create a test such as: