Skip to content

Commit

Permalink
Fix the documentation for bazel fetch --configure
Browse files Browse the repository at this point in the history
With `bazel fetch`, `--configure` and `--force` are now independent and both need to be specified to refetch configure repos. The docs did not reflect this correctly.

Fixes #23639

Closes #23665.

PiperOrigin-RevId: 676520136
Change-Id: I07040c743c2b047f8511d1a42ea94d858c520011
  • Loading branch information
fmeum authored and iancha1992 committed Sep 20, 2024
1 parent 4e4a4aa commit fc94c00
Show file tree
Hide file tree
Showing 2 changed files with 5 additions and 5 deletions.
8 changes: 4 additions & 4 deletions site/en/extending/repo.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,9 +125,9 @@ changes:
There are two parameters of `repository_rule` that control when the repositories
are re-fetched:

* If the `configure` flag is set, the repository is only re-fetched on `bazel
fetch` when the` --configure` parameter is passed to it (if the attribute is
unset, this command will not cause a re-fetch)
* If the `configure` flag is set, the repository is re-fetched on `bazel
fetch --force --configure` (non-`configure` repositories are not
re-fetched).
* If the `local` flag is set, in addition to the above cases, the repo is also
re-fetched when the Bazel server restarts.

Expand All @@ -142,7 +142,7 @@ unconditionally by calling `bazel fetch --force --all`.
Moreover, some repo rules inspect the local machine and might become outdated if
the local machine was upgraded. Here you can ask Bazel to only refetch those
external repos where the [`repository_rule`](/rules/lib/globals#repository_rule)
definition has the `configure` attribute set, use `bazel fetch --all
definition has the `configure` attribute set, use `bazel fetch --force
--configure`.

## Examples
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,4 +14,4 @@

"""Semantics for Bazel Xcode rules"""

unavailable_xcode_message = "'bazel fetch --configure' (Bzlmod) or 'bazel sync --configure' (WORKSPACE)"
unavailable_xcode_message = "'bazel fetch --force --configure' (Bzlmod) or 'bazel sync --configure' (WORKSPACE)"

0 comments on commit fc94c00

Please sign in to comment.