aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com/google/devtools
diff options
context:
space:
mode:
authorGravatar laurentlb <laurentlb@google.com>2017-07-19 14:53:15 +0200
committerGravatar Klaus Aehlig <aehlig@google.com>2017-07-19 16:49:47 +0200
commit286f1e9839f34efc910ce49f040bac23716f8520 (patch)
tree99dbbfad4600efab098ec92377e3c150c0e9b288 /src/main/java/com/google/devtools
parentb8514f533d4546d3bfbec3700012f2bbeffd1c37 (diff)
Mark PACKAGE_NAME and REPOSITORY_NAME as deprecated.
RELNOTES: None. PiperOrigin-RevId: 162475651
Diffstat (limited to 'src/main/java/com/google/devtools')
-rw-r--r--src/main/java/com/google/devtools/build/lib/syntax/Runtime.java6
1 files changed, 4 insertions, 2 deletions
diff --git a/src/main/java/com/google/devtools/build/lib/syntax/Runtime.java b/src/main/java/com/google/devtools/build/lib/syntax/Runtime.java
index 4c2b10dea8..4b5230b8bd 100644
--- a/src/main/java/com/google/devtools/build/lib/syntax/Runtime.java
+++ b/src/main/java/com/google/devtools/build/lib/syntax/Runtime.java
@@ -97,7 +97,8 @@ public final class Runtime {
public static final NoneType NONE = new NoneType();
@SkylarkSignature(name = "PACKAGE_NAME", returnType = String.class,
- doc = "The name of the package being evaluated. "
+ doc = "<b>Deprecated. Use <a href=\"native.html#package_name\">package_name()</a> "
+ + "instead.</b> The name of the package being evaluated. "
+ "For example, in the BUILD file <code>some/package/BUILD</code>, its value "
+ "will be <code>some/package</code>. "
+ "If the BUILD file calls a function defined in a .bzl file, PACKAGE_NAME will "
@@ -117,7 +118,8 @@ public final class Runtime {
public static final String PKG_NAME = "PACKAGE_NAME";
@SkylarkSignature(name = "REPOSITORY_NAME", returnType = String.class,
- doc = "The name of the repository the rule or build extension is called from. "
+ doc = "<b>Deprecated. Use <a href=\"native.html#repository_name\">repository_name()</a> "
+ + "instead.</b> The name of the repository the rule or build extension is called from. "
+ "For example, in packages that are called into existence by the WORKSPACE stanza "
+ "<code>local_repository(name='local', path=...)</code> it will be set to "
+ "<code>@local</code>. In packages in the main repository, it will be empty. "