From 926447361bb23da069d006c2c7d6d277b23c49fd Mon Sep 17 00:00:00 2001 From: Kristian Hartikainen Date: Sun, 1 Nov 2026 15:21:38 +0000 Subject: [PATCH 1/2] docs(gazelle): Clarify manifest paths in subdirectories My agent pointed out that #3133 is not actually a bug put just a user-error. Gazelle resolves the root manifest paths relative to each `BUILD` file, so the directives in #3133 example need a `../` prefix. This documents the path base and relative manifest lookup. Closes #3133. --- gazelle/docs/directives.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/gazelle/docs/directives.md b/gazelle/docs/directives.md index 60f948e4af..0072da6cdd 100644 --- a/gazelle/docs/directives.md +++ b/gazelle/docs/directives.md @@ -229,9 +229,11 @@ py_libary( (directive-python-manifest-file-name)= ## `python_manifest_file_name` -:::{error} -Detailed docs are not yet written. -::: +Sets the manifest used to resolve third-party imports in this directory and its subdirectories (default: `gazelle_python.yaml`). Paths are relative to the `BUILD` file containing the directive. For example, in `a/BUILD.bazel`, select a manifest at the repository root with: + +```starlark +# gazelle:python_manifest_file_name ../gazelle_python_a.yaml +``` (directive-python-ignore-files)= From 31341ac353247665908906cd2a0c2977b6efcdc9 Mon Sep 17 00:00:00 2001 From: Kristian Hartikainen Date: Sun, 1 Nov 2026 13:36:07 -0500 Subject: [PATCH 2/2] Revise `python_manifest_file_name` directive description Updated the description for the `python_manifest_file_name` directive to improve clarity and formatting. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- gazelle/docs/directives.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/gazelle/docs/directives.md b/gazelle/docs/directives.md index 0072da6cdd..5d3ddf7c13 100644 --- a/gazelle/docs/directives.md +++ b/gazelle/docs/directives.md @@ -229,7 +229,10 @@ py_libary( (directive-python-manifest-file-name)= ## `python_manifest_file_name` -Sets the manifest used to resolve third-party imports in this directory and its subdirectories (default: `gazelle_python.yaml`). Paths are relative to the `BUILD` file containing the directive. For example, in `a/BUILD.bazel`, select a manifest at the repository root with: +Sets the manifest used to resolve third-party imports in this directory and its +subdirectories (default: `gazelle_python.yaml`). Paths are relative to the `BUILD` +file containing the directive. For example, in `a/BUILD.bazel`, select a manifest +at the repository root with: ```starlark # gazelle:python_manifest_file_name ../gazelle_python_a.yaml