From c82c7fdbc3f935468c282ee0b5153876179c04b9 Mon Sep 17 00:00:00 2001 From: Fabian Meumertzheim Date: Tue, 25 Oct 2022 18:45:33 +0200 Subject: [PATCH] Use "apparent name" instead of "local name" in Bzlmod docs "Apparent" is used all over the codebase now, so it makes sense to also use it in user-facing docs. Also slightly rewords the definition of an "apparent repository name" to make it easier to understand. --- site/en/build/bzlmod.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/site/en/build/bzlmod.md b/site/en/build/bzlmod.md index fdb0864c8d4125..bcf89dd3e36a38 100644 --- a/site/en/build/bzlmod.md +++ b/site/en/build/bzlmod.md @@ -164,9 +164,9 @@ mechanism in the new system. Here are two important concepts: * For module extension repos: `{{ "" }}module_name{{ "" }}~{{ "" }}version{{ "" }}~{{ "" }}extension_name{{ "" }}~{{ "" }}repo_name{{ "" }}`
(Example. `@rules_cc~0.0.1~cc_configure~local_config_cc`) -* **Local repository name**: The repository name to be used in the `BUILD` and - `.bzl` files within a repo. The same dependency could have different local - names for different repos. +* **Apparent repository name**: The repository name to be used in the `BUILD` and + `.bzl` files within a repo. The same dependency could have different apparent + names in different repos.
It's determined as follows: * For Bazel module repos: `{{ "" }}module_name{{ "" }}` by @@ -176,10 +176,10 @@ mechanism in the new system. Here are two important concepts: [`use_repo`](/rules/lib/globals#use_repo). Every repository has a repository mapping dictionary of its direct dependencies, -which is a map from the local repository name to the canonical repository name. +which is a map from the apparent repository name to the canonical repository name. We use the repository mapping to resolve the repository name when constructing a label. Note that, there is no conflict of canonical repository names, and the -usages of local repository names can be discovered by parsing the `MODULE.bazel` +usages of apparent repository names can be discovered by parsing the `MODULE.bazel` file, therefore conflicts can be easily caught and resolved without affecting other dependencies.