From 840d5add25c184aed1c3d70ed568c3372c7ab90f Mon Sep 17 00:00:00 2001 From: Klaus Aehlig Date: Mon, 16 Apr 2018 09:44:41 -0700 Subject: repository_ctx.download_and_extract: mention cache in documentation Since the repository_cache is now enabled by default, extend the documentation of the download_and_extract method to mention its effect, if a sha256 checksum is specified. Change-Id: I3cb714e60a5957e338ceb83fe4f1a3c6eaf64960 PiperOrigin-RevId: 193053375 --- .../build/lib/bazel/repository/skylark/SkylarkRepositoryContext.java | 3 +++ 1 file changed, 3 insertions(+) (limited to 'src/main/java/com/google/devtools/build/lib') diff --git a/src/main/java/com/google/devtools/build/lib/bazel/repository/skylark/SkylarkRepositoryContext.java b/src/main/java/com/google/devtools/build/lib/bazel/repository/skylark/SkylarkRepositoryContext.java index 2b31d6d784..a3f70b3813 100644 --- a/src/main/java/com/google/devtools/build/lib/bazel/repository/skylark/SkylarkRepositoryContext.java +++ b/src/main/java/com/google/devtools/build/lib/bazel/repository/skylark/SkylarkRepositoryContext.java @@ -581,6 +581,9 @@ public class SkylarkRepositoryContext { + " to omit the SHA-256 as remote files can change. At best omitting this field" + " will make your build non-hermetic. It is optional to make development easier" + " but should be set before shipping." + + " If provided, the repository cache will first be checked for a file with the" + + " given hash; a download will only be attempted, if the file was not found in the" + + " cache. After a successful download, the file will be added to the cache." ), @Param( name = "type", -- cgit v1.2.3