diff --git a/docs/paths.md b/docs/paths.md
index bc9f9f871..293c28650 100644
--- a/docs/paths.md
+++ b/docs/paths.md
@@ -42,23 +42,24 @@ to_manifest_path(<a href="#to_manifest_path-ctx">ctx</a>, <a href="#to_manifest_
 
 The rlocation path for a `File`
 
-The path a built binary can pass to the `Rlocation` function of a runfiles library to find a
-dependency at runtime, either in the runfiles directory (if available) or using the runfiles
-manifest.
+This produces the same value as the `rlocationpath` predefined source/output path variable.
 
-This is similar to root path (a.k.a. [short_path](https://bazel.build/rules/lib/File#short_path))
-in that it does not contain configuration prefixes, but differs in that it always starts with the
-name of the repository.
+From https://bazel.build/reference/be/make-variables#predefined_genrule_variables:
 
-The rlocation path of a `File` in an external repository repo will start with `repo/`, followed by the
-repository-relative path.
+> `rlocationpath`: The path a built binary can pass to the `Rlocation` function of a runfiles
+> library to find a dependency at runtime, either in the runfiles directory (if available)
+> or using the runfiles manifest.
 
-Passing this path to a binary and resolving it to a file system path using the runfiles libraries
-is the preferred approach to find dependencies at runtime. Compared to root path, it has the
-advantage that it works on all platforms and even if the runfiles directory is not available.
+> This is similar to root path (a.k.a. [short_path](https://bazel.build/rules/lib/File#short_path))
+> in that it does not contain configuration prefixes, but differs in that it always starts with the
+> name of the repository.
 
-Based on the $(rlocation) predefined source/output path variable:
-https://bazel.build/reference/be/make-variables#predefined_genrule_variables.
+> The rlocation path of a `File` in an external repository repo will start with `repo/`, followed by the
+> repository-relative path.
+
+> Passing this path to a binary and resolving it to a file system path using the runfiles libraries
+> is the preferred approach to find dependencies at runtime. Compared to root path, it has the
+> advantage that it works on all platforms and even if the runfiles directory is not available.
 
 
 **PARAMETERS**
@@ -71,7 +72,7 @@ https://bazel.build/reference/be/make-variables#predefined_genrule_variables.
 
 **RETURNS**
 
-The rlocation path for the `File`
+The rlocationpath for the `File`
 
 
 <a id="to_output_relative_path"></a>
@@ -134,23 +135,24 @@ to_rlocation_path(<a href="#to_rlocation_path-ctx">ctx</a>, <a href="#to_rlocati
 
 The rlocation path for a `File`
 
-The path a built binary can pass to the `Rlocation` function of a runfiles library to find a
-dependency at runtime, either in the runfiles directory (if available) or using the runfiles
-manifest.
+This produces the same value as the `rlocationpath` predefined source/output path variable.
+
+From https://bazel.build/reference/be/make-variables#predefined_genrule_variables:
 
-This is similar to root path (a.k.a. [short_path](https://bazel.build/rules/lib/File#short_path))
-in that it does not contain configuration prefixes, but differs in that it always starts with the
-name of the repository.
+> `rlocationpath`: The path a built binary can pass to the `Rlocation` function of a runfiles
+> library to find a dependency at runtime, either in the runfiles directory (if available)
+> or using the runfiles manifest.
 
-The rlocation path of a `File` in an external repository repo will start with `repo/`, followed by the
-repository-relative path.
+> This is similar to root path (a.k.a. [short_path](https://bazel.build/rules/lib/File#short_path))
+> in that it does not contain configuration prefixes, but differs in that it always starts with the
+> name of the repository.
 
-Passing this path to a binary and resolving it to a file system path using the runfiles libraries
-is the preferred approach to find dependencies at runtime. Compared to root path, it has the
-advantage that it works on all platforms and even if the runfiles directory is not available.
+> The rlocation path of a `File` in an external repository repo will start with `repo/`, followed by the
+> repository-relative path.
 
-Based on the $(rlocation) predefined source/output path variable:
-https://bazel.build/reference/be/make-variables#predefined_genrule_variables.
+> Passing this path to a binary and resolving it to a file system path using the runfiles libraries
+> is the preferred approach to find dependencies at runtime. Compared to root path, it has the
+> advantage that it works on all platforms and even if the runfiles directory is not available.
 
 
 **PARAMETERS**
@@ -163,7 +165,7 @@ https://bazel.build/reference/be/make-variables#predefined_genrule_variables.
 
 **RETURNS**
 
-The rlocation path for the `File`
+The rlocationpath for the `File`
 
 
 <a id="to_workspace_path"></a>
diff --git a/lib/private/paths.bzl b/lib/private/paths.bzl
index 3e9588af9..856f66039 100644
--- a/lib/private/paths.bzl
+++ b/lib/private/paths.bzl
@@ -80,30 +80,31 @@ def _to_output_relative_path(file):
 def _to_rlocation_path(ctx, file):
     """The rlocation path for a `File`
 
-    The path a built binary can pass to the `Rlocation` function of a runfiles library to find a
-    dependency at runtime, either in the runfiles directory (if available) or using the runfiles
-    manifest.
+    This produces the same value as the `rlocationpath` predefined source/output path variable.
 
-    This is similar to root path (a.k.a. [short_path](https://bazel.build/rules/lib/File#short_path))
-    in that it does not contain configuration prefixes, but differs in that it always starts with the
-    name of the repository.
+    From https://bazel.build/reference/be/make-variables#predefined_genrule_variables:
 
-    The rlocation path of a `File` in an external repository repo will start with `repo/`, followed by the
-    repository-relative path.
+    > `rlocationpath`: The path a built binary can pass to the `Rlocation` function of a runfiles
+    > library to find a dependency at runtime, either in the runfiles directory (if available)
+    > or using the runfiles manifest.
 
-    Passing this path to a binary and resolving it to a file system path using the runfiles libraries
-    is the preferred approach to find dependencies at runtime. Compared to root path, it has the
-    advantage that it works on all platforms and even if the runfiles directory is not available.
+    > This is similar to root path (a.k.a. [short_path](https://bazel.build/rules/lib/File#short_path))
+    > in that it does not contain configuration prefixes, but differs in that it always starts with the
+    > name of the repository.
 
-    Based on the $(rlocation) predefined source/output path variable:
-    https://bazel.build/reference/be/make-variables#predefined_genrule_variables.
+    > The rlocation path of a `File` in an external repository repo will start with `repo/`, followed by the
+    > repository-relative path.
+
+    > Passing this path to a binary and resolving it to a file system path using the runfiles libraries
+    > is the preferred approach to find dependencies at runtime. Compared to root path, it has the
+    > advantage that it works on all platforms and even if the runfiles directory is not available.
 
     Args:
         ctx: starlark rule execution context
         file: a `File` object
 
     Returns:
-        The rlocation path for the `File`
+        The rlocationpath for the `File`
     """
     if file.short_path.startswith("../"):
         return file.short_path[3:]