aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com
diff options
context:
space:
mode:
authorGravatar Laszlo Csomor <laszlocsomor@google.com>2018-06-21 06:02:16 -0700
committerGravatar Copybara-Service <copybara-piper@google.com>2018-06-21 06:04:04 -0700
commite926cfc8f5ce4c6db666ceb7058bba263fbede36 (patch)
treec5d2c1752fce20ff13a9fd433df41ef00709c7da /src/main/java/com
parentdc986d290bad8a76d3429f73c8244376b4c59494 (diff)
shell tests, windows: enable more tests
Enable on Windows: //src/test/shell/bazel:bazel_experimental_ui_test //src/test/shell/bazel:bazel_random_characters_test Also document the (surprising) semantics of http_file() on Windows. See https://github.com/bazelbuild/bazel/issues/4292 Change-Id: Id636b9cf03cc8d12449eed2be493dcfc176146c7 Closes #5409. Change-Id: I15677548f2f3fd6b4822e8e6af4b78d8517f953a PiperOrigin-RevId: 201512812
Diffstat (limited to 'src/main/java/com')
-rw-r--r--src/main/java/com/google/devtools/build/lib/bazel/rules/workspace/HttpFileRule.java31
1 files changed, 18 insertions, 13 deletions
diff --git a/src/main/java/com/google/devtools/build/lib/bazel/rules/workspace/HttpFileRule.java b/src/main/java/com/google/devtools/build/lib/bazel/rules/workspace/HttpFileRule.java
index 4f13114982..63a4db1478 100644
--- a/src/main/java/com/google/devtools/build/lib/bazel/rules/workspace/HttpFileRule.java
+++ b/src/main/java/com/google/devtools/build/lib/bazel/rules/workspace/HttpFileRule.java
@@ -79,21 +79,26 @@ public class HttpFileRule implements RuleDefinition {
}
/*<!-- #BLAZE_RULE (NAME = http_file, TYPE = OTHER, FAMILY = Workspace)[GENERIC_RULE] -->
- <p>Downloads a file from a URL and makes it available to be used as a file group.</p>
+<p>Downloads a file from a URL and makes it available to be used as a file group.</p>
- <h4 id="http_file_examples">Examples</h4>
+<h4 id="http_file_examples">Examples</h4>
- <p>Suppose you need to have a debian package for your custom rules. This package is available from
- <i>http://example.com/package.deb</i>. Then you can add to your WORKSPACE file:</p>
+<p>Suppose you need to have a debian package for your custom rules. This package is available from
+<i>http://example.com/package.deb</i>. Then you can add to your WORKSPACE file:</p>
- <pre class="code">
- http_file(
- name = "my_deb",
- url = "http://example.com/package.deb",
- sha256 = "03a58ac630e59778f328af4bcc4acb4f80208ed4",
- )
- </pre>
+<pre class="code">
+http_file(
+ name = "my_deb",
+ url = "http://example.com/package.deb",
+ sha256 = "03a58ac630e59778f328af4bcc4acb4f80208ed4",
+)
+</pre>
- <p>Targets would specify <code>@my_deb//file</code> as a dependency to depend on this file.</p>
+<p>Targets would specify <code>@my_deb//file</code> as a dependency to depend on this file.</p>
- <!-- #END_BLAZE_RULE -->*/
+<p>You may also reference files on the current system (localhost) by using "file:///path/to/file"
+if you are on Unix-based systems. If you're on Windows, use "file:///c:/path/to/file". In both
+examples, note the three slashes (<code>/</code>) -- the first two slashes belong to
+<code>file://</code> and the third one belongs to the absolute path to the file.</p>
+
+<!-- #END_BLAZE_RULE -->*/