This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch v2-8-test
in repository https://gitbox.apache.org/repos/asf/airflow.git

commit b39bbf0ea7c2ab7ba0c17c2a7b7926b934a69c94
Author: Jarek Potiuk <[email protected]>
AuthorDate: Mon Feb 12 13:04:39 2024 +0100

    Clarify docs around --package-filter flags in docs breeze commands (#37354)
    
    (cherry picked from commit 4c3732850f5f1c640eefad7f1bc7dbc80c6b76f9)
---
 airflow/providers/MANAGING_PROVIDERS_LIFECYCLE.rst |  6 +--
 contributing-docs/07_local_virtualenv.rst          |  2 +-
 dev/README_RELEASE_AIRFLOW.md                      |  4 +-
 dev/README_RELEASE_HELM_CHART.md                   |  4 +-
 dev/breeze/doc/03_developer_tasks.rst              | 10 ++---
 dev/breeze/doc/09_release_management_tasks.rst     | 20 ++++++---
 dev/breeze/doc/images/output_build-docs.svg        | 43 ++++++++-----------
 dev/breeze/doc/images/output_build-docs.txt        |  2 +-
 .../output_release-management_publish-docs.svg     | 49 ++++++++++-----------
 .../output_release-management_publish-docs.txt     |  2 +-
 .../images/output_sbom_update-sbom-information.svg | 50 ++++++++++++----------
 .../images/output_sbom_update-sbom-information.txt |  2 +-
 .../airflow_breeze/commands/developer_commands.py  |  6 +--
 .../commands/release_management_commands.py        |  6 +--
 .../src/airflow_breeze/commands/sbom_commands.py   |  5 ++-
 docs/build_docs.py                                 |  4 +-
 16 files changed, 111 insertions(+), 104 deletions(-)

diff --git a/airflow/providers/MANAGING_PROVIDERS_LIFECYCLE.rst 
b/airflow/providers/MANAGING_PROVIDERS_LIFECYCLE.rst
index 142ac2925e..e4bad57bd1 100644
--- a/airflow/providers/MANAGING_PROVIDERS_LIFECYCLE.rst
+++ b/airflow/providers/MANAGING_PROVIDERS_LIFECYCLE.rst
@@ -129,7 +129,7 @@ Add chicken-egg-provider to constraint generation
 This is controlled by ``chicken_egg_providers`` property in Selective Checks - 
and our CI will automatically
 build and use those chicken-egg providers during the CI process if pre-release 
version of Airflow is built.
 
-The short provider id (``common.io`` for example) for such a provider should 
be added
+The short ``provider id`` (``common.io`` for example) for such a provider 
should be added
 to ``CHICKEN_EGG_PROVIDERS`` list in 
``src/airflow_breeze/utils/selective_checks.py``:
 
 This list will be kept here until the official version of Airflow the 
chicken-egg-providers depend on
@@ -320,8 +320,8 @@ main Airflow documentation that involves some steps with 
the providers is also w
 
   .. code-block:: bash
 
-    breeze build-docs --package-filter apache-airflow-providers-<NEW_PROVIDER>
-    breeze build-docs --package-filter apache-airflow
+    breeze build-docs <provider id>
+    breeze build-docs apache-airflow
 
 Additional changes needed for cross-dependent providers
 =======================================================
diff --git a/contributing-docs/07_local_virtualenv.rst 
b/contributing-docs/07_local_virtualenv.rst
index d4c1b7b423..182a705f29 100644
--- a/contributing-docs/07_local_virtualenv.rst
+++ b/contributing-docs/07_local_virtualenv.rst
@@ -317,7 +317,7 @@ Running ``pipinstall -e .`` will install Airflow in 
editable mode, but all provi
 available in the same environment. However, most provider need some additional 
dependencies.
 
 You can install the dependencies of the provider you want to develop by 
installing airflow in editable
-mode with provider id as extra. You can see the list of provider's extras in 
the
+mode with ``provider id`` as extra (with ``-`` instead of ``.``) . You can see 
the list of provider's extras in the
 `extras reference <./docs/apache-airflow/extra-packages-ref.rst>`_.
 
 For example, if you want to develop Google provider, you can install it with:
diff --git a/dev/README_RELEASE_AIRFLOW.md b/dev/README_RELEASE_AIRFLOW.md
index 2748543cf2..be8991cff8 100644
--- a/dev/README_RELEASE_AIRFLOW.md
+++ b/dev/README_RELEASE_AIRFLOW.md
@@ -844,7 +844,7 @@ Documentation for providers can be found in the 
``/docs/apache-airflow`` directo
 
     ```shell script
     cd "${AIRFLOW_REPO_ROOT}"
-    breeze build-docs --package-filter apache-airflow --package-filter 
docker-stack --clean-build
+    breeze build-docs apache-airflow docker-stack --clean-build
     ```
 
 - Now you can preview the documentation.
@@ -856,7 +856,7 @@ Documentation for providers can be found in the 
``/docs/apache-airflow`` directo
 - Copy the documentation to the ``airflow-site`` repository, create commit, 
push changes, open a PR and merge it when the build is green.
 
     ```shell script
-    breeze release-management publish-docs --package-filter apache-airflow 
--package-filter docker-stack
+    breeze release-management publish-docs apache-airflow docker-stack
     breeze release-management add-back-references apache-airflow 
--airflow-site-directory "${AIRFLOW_SITE_DIRECTORY}"
     breeze sbom update-sbom-information --airflow-version ${VERSION} 
--airflow-site-directory ${AIRFLOW_SITE_DIRECTORY} --force
     cd "${AIRFLOW_SITE_DIRECTORY}"
diff --git a/dev/README_RELEASE_HELM_CHART.md b/dev/README_RELEASE_HELM_CHART.md
index 77faa3fea3..31bb4fe616 100644
--- a/dev/README_RELEASE_HELM_CHART.md
+++ b/dev/README_RELEASE_HELM_CHART.md
@@ -688,7 +688,7 @@ between the two repositories to be able to build the 
documentation.
     ```shell
     cd "${AIRFLOW_REPO_ROOT}"
     git checkout helm-chart/${VERSION}
-    breeze build-docs --package-filter helm-chart --clean-build
+    breeze build-docs helm-chart --clean-build
     ```
 
 - Now you can preview the documentation.
@@ -700,7 +700,7 @@ between the two repositories to be able to build the 
documentation.
 - Copy the documentation to the ``airflow-site`` repository.
 
     ```shell
-    breeze release-management publish-docs --package-filter helm-chart
+    breeze release-management publish-docs helm-chart
     ```
 
 - Update `index.yaml`
diff --git a/dev/breeze/doc/03_developer_tasks.rst 
b/dev/breeze/doc/03_developer_tasks.rst
index cf8294fa59..95eeac5d17 100644
--- a/dev/breeze/doc/03_developer_tasks.rst
+++ b/dev/breeze/doc/03_developer_tasks.rst
@@ -151,15 +151,15 @@ extra ``--`` flag.
 
     breeze build-docs --spellcheck-only
 
-This process can take some time, so in order to make it shorter you can filter 
by package, using the flag
-``--package-filter <PACKAGE-NAME>``. The package name has to be one of the 
providers or ``apache-airflow``. For
-instance, for using it with Amazon, the command would be:
+This process can take some time, so in order to make it shorter you can filter 
by package, using package
+short ``provider id`` (might be multiple of them).
 
 .. code-block:: bash
 
-     breeze build-docs provider_id provider id
+     breeze build-docs <provider id> <provider id>
 
-or you can us package filter:
+or you can use package filter. The filters are glob pattern matching full
+package names and can be used to select more than one package with single 
filter.
 
 .. code-block:: bash
 
diff --git a/dev/breeze/doc/09_release_management_tasks.rst 
b/dev/breeze/doc/09_release_management_tasks.rst
index cffe31a0c9..d634233f74 100644
--- a/dev/breeze/doc/09_release_management_tasks.rst
+++ b/dev/breeze/doc/09_release_management_tasks.rst
@@ -462,7 +462,7 @@ use the ``release-management publish-docs`` command:
 
      breeze release-management publish-docs
 
-The publishing documentation consists  steps:
+The publishing documentation consists of the following steps:
 
 * checking out the latest ``main`` of cloned ``airflow-site``
 * copying the documentation to ``airflow-site``
@@ -470,11 +470,21 @@ The publishing documentation consists  steps:
 
 .. code-block:: bash
 
-     breeze release-management publish-docs --package-filter 
apache-airflow-providers-amazon
+     breeze release-management publish-docs <provider id>
+
+Where ``provider id`` is a short form of provider name.
+
+.. code-block:: bash
+
+     breeze release-management publish-docs amazon
+
+The flag ``--package-filter`` can be used to selectively publish docs during a 
release. The filters are glob
+pattern matching full package names and can be used to select more than one 
package with single filter.
+
+.. code-block:: bash
+
+     breeze release-management publish-docs 
"apache-airflow-providers-microsoft*"
 
-The flag ``--package-filter`` can be used to selectively publish docs during a 
release. It can take
-values such as apache-airflow, helm-chart, apache-airflow-providers, or any 
individual providers.
-The documentation publication happens based on this flag.
 
 .. code-block:: bash
 
diff --git a/dev/breeze/doc/images/output_build-docs.svg 
b/dev/breeze/doc/images/output_build-docs.svg
index 2d9b15ed6e..7e9aef3100 100644
--- a/dev/breeze/doc/images/output_build-docs.svg
+++ b/dev/breeze/doc/images/output_build-docs.svg
@@ -1,4 +1,4 @@
-<svg class="rich-terminal" viewBox="0 0 1482 1001.5999999999999" 
xmlns="http://www.w3.org/2000/svg";>
+<svg class="rich-terminal" viewBox="0 0 1482 977.1999999999999" 
xmlns="http://www.w3.org/2000/svg";>
     <!-- Generated with Rich https://www.textualize.io -->
     <style>
 
@@ -38,13 +38,12 @@
 .breeze-build-docs-r4 { fill: #68a0b3;font-weight: bold }
 .breeze-build-docs-r5 { fill: #868887 }
 .breeze-build-docs-r6 { fill: #98a84b;font-weight: bold }
-.breeze-build-docs-r7 { fill: #d0b344;font-weight: bold }
-.breeze-build-docs-r8 { fill: #8d7b39 }
+.breeze-build-docs-r7 { fill: #8d7b39 }
     </style>
 
     <defs>
     <clipPath id="breeze-build-docs-clip-terminal">
-      <rect x="0" y="0" width="1463.0" height="950.5999999999999" />
+      <rect x="0" y="0" width="1463.0" height="926.1999999999999" />
     </clipPath>
     <clipPath id="breeze-build-docs-line-0">
     <rect x="0" y="1.5" width="1464" height="24.65"/>
@@ -157,12 +156,9 @@
 <clipPath id="breeze-build-docs-line-36">
     <rect x="0" y="879.9" width="1464" height="24.65"/>
             </clipPath>
-<clipPath id="breeze-build-docs-line-37">
-    <rect x="0" y="904.3" width="1464" height="24.65"/>
-            </clipPath>
     </defs>
 
-    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" 
x="1" y="1" width="1480" height="999.6" rx="8"/><text 
class="breeze-build-docs-title" fill="#c5c8c6" text-anchor="middle" x="740" 
y="27">Command:&#160;build-docs</text>
+    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" 
x="1" y="1" width="1480" height="975.2" rx="8"/><text 
class="breeze-build-docs-title" fill="#c5c8c6" text-anchor="middle" x="740" 
y="27">Command:&#160;build-docs</text>
             <g transform="translate(26,22)">
             <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
             <circle cx="22" cy="0" r="7" fill="#febc2e"/>
@@ -195,22 +191,21 @@
 </text><text class="breeze-build-docs-r5" x="0" y="508" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-20)">│</text><text 
class="breeze-build-docs-r1" x="451.4" y="508" textLength="988.2" 
clip-path="url(#breeze-build-docs-line-20)">artifacts&#160;before&#160;the&#160;build&#160;-&#160;useful&#160;for&#160;a&#160;clean&#160;build.&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&
 [...]
 </text><text class="breeze-build-docs-r5" x="0" y="532.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-21)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="532.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-21)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="532.4" textLength="48.8" 
clip-path="url(#breeze-build-docs-line-21)">-one</text><text 
class="breeze-build-docs-r4" x="85.4" y="532.4" textLength="122" 
clip-path="url(#breeze-build-docs-line-21) [...]
 </text><text class="breeze-build-docs-r5" x="0" y="556.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-22)">│</text><text 
class="breeze-build-docs-r1" x="451.4" y="556.8" textLength="988.2" 
clip-path="url(#breeze-build-docs-line-22)">errors.&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160
 [...]
-</text><text class="breeze-build-docs-r5" x="0" y="581.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-23)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="581.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-23)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="581.2" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-23)">-package</text><text 
class="breeze-build-docs-r4" x="134.2" y="581.2" textLength="85.4" 
clip-path="url(#breeze-build-docs-li [...]
-</text><text class="breeze-build-docs-r5" x="0" y="605.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-24)">│</text><text 
class="breeze-build-docs-r1" x="451.4" y="605.6" textLength="305" 
clip-path="url(#breeze-build-docs-line-24)">apache-airflow-providers-</text><text
 class="breeze-build-docs-r7" x="756.4" y="605.6" textLength="122" 
clip-path="url(#breeze-build-docs-line-24)">&lt;provider&gt;</text><text 
class="breeze-build-docs-r1" x="878.4" y="605.6" textLength="561.2" cli [...]
-</text><text class="breeze-build-docs-r5" x="0" y="630" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-25)">│</text><text 
class="breeze-build-docs-r1" x="451.4" y="630" textLength="988.2" 
clip-path="url(#breeze-build-docs-line-25)">matching&#160;the&#160;full&#160;package&#160;name.&#160;The&#160;list&#160;of&#160;short&#160;hand&#160;names&#160;can&#160;be&#160;found&#160;in&#160;&#160;&#160;&#160;&#160;</text><text
 class="breeze-build-docs-r5" x="1451.8" y="630" textLength="1 [...]
-</text><text class="breeze-build-docs-r5" x="0" y="654.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-26)">│</text><text 
class="breeze-build-docs-r4" x="451.4" y="654.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-26)">-</text><text 
class="breeze-build-docs-r4" x="463.6" y="654.4" textLength="61" 
clip-path="url(#breeze-build-docs-line-26)">-help</text><text 
class="breeze-build-docs-r1" x="524.6" y="654.4" textLength="915" 
clip-path="url(#breeze-build-docs-line-2 [...]
-</text><text class="breeze-build-docs-r5" x="0" y="678.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-27)">│</text><text 
class="breeze-build-docs-r8" x="451.4" y="678.8" textLength="988.2" 
clip-path="url(#breeze-build-docs-line-27)">(TEXT)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;
 [...]
-</text><text class="breeze-build-docs-r5" x="0" y="703.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-28)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="703.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-28)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="703.2" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-28)">-include</text><text 
class="breeze-build-docs-r4" x="134.2" y="703.2" textLength="244" 
clip-path="url(#breeze-build-docs-lin [...]
-</text><text class="breeze-build-docs-r5" x="0" y="727.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-29)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="727.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-29)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="727.6" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-29)">-include</text><text 
class="breeze-build-docs-r4" x="134.2" y="727.6" textLength="219.6" 
clip-path="url(#breeze-build-docs-l [...]
-</text><text class="breeze-build-docs-r5" x="0" y="752" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-30)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="752" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-30)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="752" textLength="85.4" 
clip-path="url(#breeze-build-docs-line-30)">-github</text><text 
class="breeze-build-docs-r4" x="122" y="752" textLength="134.2" 
clip-path="url(#breeze-build-docs-line-30)">-r [...]
-</text><text class="breeze-build-docs-r5" x="0" y="776.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-31)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="776.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-31)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="776.4" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-31)">-builder</text><text 
class="breeze-build-docs-r1" x="451.4" y="776.4" textLength="756.4" 
clip-path="url(#breeze-build-docs-l [...]
-</text><text class="breeze-build-docs-r5" x="0" y="800.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-32)">│</text><text 
class="breeze-build-docs-r5" x="451.4" y="800.8" textLength="756.4" 
clip-path="url(#breeze-build-docs-line-32)">[default:&#160;autodetect]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16
 [...]
-</text><text class="breeze-build-docs-r5" x="0" y="825.2" textLength="1464" 
clip-path="url(#breeze-build-docs-line-33)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-build-docs-r1" x="1464" y="825.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-33)">
-</text><text class="breeze-build-docs-r5" x="0" y="849.6" textLength="24.4" 
clip-path="url(#breeze-build-docs-line-34)">╭─</text><text 
class="breeze-build-docs-r5" x="24.4" y="849.6" textLength="195.2" 
clip-path="url(#breeze-build-docs-line-34)">&#160;Common&#160;options&#160;</text><text
 class="breeze-build-docs-r5" x="219.6" y="849.6" textLength="1220" 
clip-path="url(#breeze-build-docs-line-34)">───────────────────────────────────────────────────────────────────────────────────────────
 [...]
-</text><text class="breeze-build-docs-r5" x="0" y="874" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-35)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="874" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-35)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="874" textLength="48.8" 
clip-path="url(#breeze-build-docs-line-35)">-dry</text><text 
class="breeze-build-docs-r4" x="85.4" y="874" textLength="48.8" 
clip-path="url(#breeze-build-docs-line-35)">-run< [...]
-</text><text class="breeze-build-docs-r5" x="0" y="898.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-36)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="898.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-36)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="898.4" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-36)">-verbose</text><text 
class="breeze-build-docs-r6" x="158.6" y="898.4" textLength="24.4" 
clip-path="url(#breeze-build-docs-li [...]
-</text><text class="breeze-build-docs-r5" x="0" y="922.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-37)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="922.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-37)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="922.8" textLength="61" 
clip-path="url(#breeze-build-docs-line-37)">-help</text><text 
class="breeze-build-docs-r6" x="158.6" y="922.8" textLength="24.4" 
clip-path="url(#breeze-build-docs-line-37 [...]
-</text><text class="breeze-build-docs-r5" x="0" y="947.2" textLength="1464" 
clip-path="url(#breeze-build-docs-line-38)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-build-docs-r1" x="1464" y="947.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-38)">
+</text><text class="breeze-build-docs-r5" x="0" y="581.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-23)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="581.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-23)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="581.2" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-23)">-package</text><text 
class="breeze-build-docs-r4" x="134.2" y="581.2" textLength="85.4" 
clip-path="url(#breeze-build-docs-li [...]
+</text><text class="breeze-build-docs-r5" x="0" y="605.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-24)">│</text><text 
class="breeze-build-docs-r1" x="451.4" y="605.6" textLength="988.2" 
clip-path="url(#breeze-build-docs-line-24)">matching&#160;the&#160;full&#160;package&#160;name,&#160;for&#160;example&#160;`apache-airflow-providers-*`.&#160;Useful&#160;</text><text
 class="breeze-build-docs-r5" x="1451.8" y="605.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line- [...]
+</text><text class="breeze-build-docs-r5" x="0" y="630" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-25)">│</text><text 
class="breeze-build-docs-r1" x="451.4" y="630" textLength="988.2" 
clip-path="url(#breeze-build-docs-line-25)">when&#160;you&#160;want&#160;to&#160;selectseveral&#160;similarly&#160;named&#160;packages&#160;together.&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text
 class="breeze-build-docs-r5" x="1451 [...]
+</text><text class="breeze-build-docs-r5" x="0" y="654.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-26)">│</text><text 
class="breeze-build-docs-r7" x="451.4" y="654.4" textLength="988.2" 
clip-path="url(#breeze-build-docs-line-26)">(TEXT)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;
 [...]
+</text><text class="breeze-build-docs-r5" x="0" y="678.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-27)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="678.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-27)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="678.8" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-27)">-include</text><text 
class="breeze-build-docs-r4" x="134.2" y="678.8" textLength="244" 
clip-path="url(#breeze-build-docs-lin [...]
+</text><text class="breeze-build-docs-r5" x="0" y="703.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-28)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="703.2" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-28)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="703.2" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-28)">-include</text><text 
class="breeze-build-docs-r4" x="134.2" y="703.2" textLength="219.6" 
clip-path="url(#breeze-build-docs-l [...]
+</text><text class="breeze-build-docs-r5" x="0" y="727.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-29)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="727.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-29)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="727.6" textLength="85.4" 
clip-path="url(#breeze-build-docs-line-29)">-github</text><text 
class="breeze-build-docs-r4" x="122" y="727.6" textLength="134.2" 
clip-path="url(#breeze-build-docs-line [...]
+</text><text class="breeze-build-docs-r5" x="0" y="752" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-30)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="752" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-30)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="752" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-30)">-builder</text><text 
class="breeze-build-docs-r1" x="451.4" y="752" textLength="756.4" 
clip-path="url(#breeze-build-docs-line-30)" [...]
+</text><text class="breeze-build-docs-r5" x="0" y="776.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-31)">│</text><text 
class="breeze-build-docs-r5" x="451.4" y="776.4" textLength="756.4" 
clip-path="url(#breeze-build-docs-line-31)">[default:&#160;autodetect]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16
 [...]
+</text><text class="breeze-build-docs-r5" x="0" y="800.8" textLength="1464" 
clip-path="url(#breeze-build-docs-line-32)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-build-docs-r1" x="1464" y="800.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-32)">
+</text><text class="breeze-build-docs-r5" x="0" y="825.2" textLength="24.4" 
clip-path="url(#breeze-build-docs-line-33)">╭─</text><text 
class="breeze-build-docs-r5" x="24.4" y="825.2" textLength="195.2" 
clip-path="url(#breeze-build-docs-line-33)">&#160;Common&#160;options&#160;</text><text
 class="breeze-build-docs-r5" x="219.6" y="825.2" textLength="1220" 
clip-path="url(#breeze-build-docs-line-33)">───────────────────────────────────────────────────────────────────────────────────────────
 [...]
+</text><text class="breeze-build-docs-r5" x="0" y="849.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-34)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="849.6" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-34)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="849.6" textLength="48.8" 
clip-path="url(#breeze-build-docs-line-34)">-dry</text><text 
class="breeze-build-docs-r4" x="85.4" y="849.6" textLength="48.8" 
clip-path="url(#breeze-build-docs-line-34 [...]
+</text><text class="breeze-build-docs-r5" x="0" y="874" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-35)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="874" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-35)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="874" textLength="97.6" 
clip-path="url(#breeze-build-docs-line-35)">-verbose</text><text 
class="breeze-build-docs-r6" x="158.6" y="874" textLength="24.4" 
clip-path="url(#breeze-build-docs-line-35)"> [...]
+</text><text class="breeze-build-docs-r5" x="0" y="898.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-36)">│</text><text 
class="breeze-build-docs-r4" x="24.4" y="898.4" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-36)">-</text><text 
class="breeze-build-docs-r4" x="36.6" y="898.4" textLength="61" 
clip-path="url(#breeze-build-docs-line-36)">-help</text><text 
class="breeze-build-docs-r6" x="158.6" y="898.4" textLength="24.4" 
clip-path="url(#breeze-build-docs-line-36 [...]
+</text><text class="breeze-build-docs-r5" x="0" y="922.8" textLength="1464" 
clip-path="url(#breeze-build-docs-line-37)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-build-docs-r1" x="1464" y="922.8" textLength="12.2" 
clip-path="url(#breeze-build-docs-line-37)">
 </text>
     </g>
     </g>
diff --git a/dev/breeze/doc/images/output_build-docs.txt 
b/dev/breeze/doc/images/output_build-docs.txt
index 97e1953458..4736d130e0 100644
--- a/dev/breeze/doc/images/output_build-docs.txt
+++ b/dev/breeze/doc/images/output_build-docs.txt
@@ -1 +1 @@
-5608a53ff88385abb3598d42dd5784b0
+1cb32a1a46342e8b32a8824548a26b70
diff --git a/dev/breeze/doc/images/output_release-management_publish-docs.svg 
b/dev/breeze/doc/images/output_release-management_publish-docs.svg
index bd1dd3fd48..dfde37c168 100644
--- a/dev/breeze/doc/images/output_release-management_publish-docs.svg
+++ b/dev/breeze/doc/images/output_release-management_publish-docs.svg
@@ -1,4 +1,4 @@
-<svg class="rich-terminal" viewBox="0 0 1482 1050.4" 
xmlns="http://www.w3.org/2000/svg";>
+<svg class="rich-terminal" viewBox="0 0 1482 1026.0" 
xmlns="http://www.w3.org/2000/svg";>
     <!-- Generated with Rich https://www.textualize.io -->
     <style>
 
@@ -41,12 +41,11 @@
 .breeze-release-management-publish-docs-r7 { fill: #98a84b;font-weight: bold }
 .breeze-release-management-publish-docs-r8 { fill: #8d7b39 }
 .breeze-release-management-publish-docs-r9 { fill: #8a4346 }
-.breeze-release-management-publish-docs-r10 { fill: #d0b344;font-weight: bold }
     </style>
 
     <defs>
     <clipPath id="breeze-release-management-publish-docs-clip-terminal">
-      <rect x="0" y="0" width="1463.0" height="999.4" />
+      <rect x="0" y="0" width="1463.0" height="975.0" />
     </clipPath>
     <clipPath id="breeze-release-management-publish-docs-line-0">
     <rect x="0" y="1.5" width="1464" height="24.65"/>
@@ -165,12 +164,9 @@
 <clipPath id="breeze-release-management-publish-docs-line-38">
     <rect x="0" y="928.7" width="1464" height="24.65"/>
             </clipPath>
-<clipPath id="breeze-release-management-publish-docs-line-39">
-    <rect x="0" y="953.1" width="1464" height="24.65"/>
-            </clipPath>
     </defs>
 
-    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" 
x="1" y="1" width="1480" height="1048.4" rx="8"/><text 
class="breeze-release-management-publish-docs-title" fill="#c5c8c6" 
text-anchor="middle" x="740" 
y="27">Command:&#160;release-management&#160;publish-docs</text>
+    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" 
x="1" y="1" width="1480" height="1024" rx="8"/><text 
class="breeze-release-management-publish-docs-title" fill="#c5c8c6" 
text-anchor="middle" x="740" 
y="27">Command:&#160;release-management&#160;publish-docs</text>
             <g transform="translate(26,22)">
             <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
             <circle cx="22" cy="0" r="7" fill="#febc2e"/>
@@ -201,26 +197,25 @@
 </text><text class="breeze-release-management-publish-docs-r5" x="0" y="459.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-18)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="61" y="459.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-18)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="73.2" y="459.2" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-18)"> [...]
 </text><text class="breeze-release-management-publish-docs-r5" x="0" y="483.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-19)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="61" y="483.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-19)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="73.2" y="483.6" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-19)"> [...]
 </text><text class="breeze-release-management-publish-docs-r5" x="0" y="508" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-20)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="61" y="508" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-20)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="73.2" y="508" 
textLength="109.8" 
clip-path="url(#breeze-release-management-publish-docs-line-20)">-over [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-21)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="61" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-21)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="73.2" y="532.4" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-21)"> [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="556.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-22)">│</text><text 
class="breeze-release-management-publish-docs-r1" x="488" y="556.8" 
textLength="305" 
clip-path="url(#breeze-release-management-publish-docs-line-22)">apache-airflow-providers-</text><text
 class="breeze-release-management-publish-docs-r10" x="793" y="556.8" 
textLength="122" clip-path="url(#breeze-release-management- [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="581.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-23)">│</text><text 
class="breeze-release-management-publish-docs-r1" x="488" y="581.2" 
textLength="951.6" 
clip-path="url(#breeze-release-management-publish-docs-line-23)">matching&#160;the&#160;full&#160;package&#160;name.&#160;The&#160;list&#160;of&#160;short&#160;hand&#160;names&#160;can&#160;be&#160;found&#160;in&#160;&#160;</text
 [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="605.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-24)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="488" y="605.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-24)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="500.2" y="605.6" 
textLength="61" 
clip-path="url(#breeze-release-management-publish-docs-line-24)"> [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="630" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-25)">│</text><text 
class="breeze-release-management-publish-docs-r8" x="488" y="630" 
textLength="951.6" 
clip-path="url(#breeze-release-management-publish-docs-line-25)">(TEXT)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;
 [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="654.4" 
textLength="1464" 
clip-path="url(#breeze-release-management-publish-docs-line-26)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-release-management-publish-docs-r1" x="1464" y="654.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-26)">
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="678.8" 
textLength="24.4" 
clip-path="url(#breeze-release-management-publish-docs-line-27)">╭─</text><text 
class="breeze-release-management-publish-docs-r5" x="24.4" y="678.8" 
textLength="219.6" 
clip-path="url(#breeze-release-management-publish-docs-line-27)">&#160;Parallel&#160;running&#160;</text><text
 class="breeze-release-management-publish-docs-r5" x="244" y="678.8" 
textLength="1195.6" clip-path="url(#breeze-relea [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="703.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-28)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="703.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-28)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="703.2" 
textLength="48.8" 
clip-path="url(#breeze-release-management-publish-docs-line-28) [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="727.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-29)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="727.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-29)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="727.6" 
textLength="146.4" 
clip-path="url(#breeze-release-management-publish-docs-line-29 [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="752" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-30)">│</text><text 
class="breeze-release-management-publish-docs-r8" x="378.2" y="752" 
textLength="915" 
clip-path="url(#breeze-release-management-publish-docs-line-30)">(INTEGER&#160;RANGE)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#16
 [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="776.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-31)">│</text><text 
class="breeze-release-management-publish-docs-r5" x="378.2" y="776.4" 
textLength="915" 
clip-path="url(#breeze-release-management-publish-docs-line-31)">[default:&#160;4;&#160;1&lt;=x&lt;=8]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&
 [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-32)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-32)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="800.8" 
textLength="61" 
clip-path="url(#breeze-release-management-publish-docs-line-32)"> [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="825.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-33)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="825.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-33)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="825.2" 
textLength="73.2" 
clip-path="url(#breeze-release-management-publish-docs-line-33) [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="849.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-34)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="849.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-34)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="849.6" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-34) [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="874" 
textLength="1464" 
clip-path="url(#breeze-release-management-publish-docs-line-35)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-release-management-publish-docs-r1" x="1464" y="874" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-35)">
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="898.4" 
textLength="24.4" 
clip-path="url(#breeze-release-management-publish-docs-line-36)">╭─</text><text 
class="breeze-release-management-publish-docs-r5" x="24.4" y="898.4" 
textLength="195.2" 
clip-path="url(#breeze-release-management-publish-docs-line-36)">&#160;Common&#160;options&#160;</text><text
 class="breeze-release-management-publish-docs-r5" x="219.6" y="898.4" 
textLength="1220" clip-path="url(#breeze-release [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="922.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-37)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="922.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-37)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="922.8" 
textLength="48.8" 
clip-path="url(#breeze-release-management-publish-docs-line-37) [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="947.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-38)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="947.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-38)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="947.2" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-38) [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="971.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-39)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="971.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-39)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="971.6" 
textLength="61" 
clip-path="url(#breeze-release-management-publish-docs-line-39)"> [...]
-</text><text class="breeze-release-management-publish-docs-r5" x="0" y="996" 
textLength="1464" 
clip-path="url(#breeze-release-management-publish-docs-line-40)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-release-management-publish-docs-r1" x="1464" y="996" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-40)">
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-21)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="61" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-21)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="73.2" y="532.4" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-21)"> [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="556.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-22)">│</text><text 
class="breeze-release-management-publish-docs-r1" x="488" y="556.8" 
textLength="951.6" 
clip-path="url(#breeze-release-management-publish-docs-line-22)">matching&#160;the&#160;full&#160;package&#160;name,&#160;for&#160;example&#160;`apache-airflow-providers-*`.&#160;&#160;&#160;&#160;&#160;</text><text
 class="breeze [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="581.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-23)">│</text><text 
class="breeze-release-management-publish-docs-r1" x="488" y="581.2" 
textLength="951.6" 
clip-path="url(#breeze-release-management-publish-docs-line-23)">Useful&#160;when&#160;you&#160;want&#160;to&#160;selectseveral&#160;similarly&#160;named&#160;packages&#160;together.&#160;&#160;&#160;&#160;&#160;&#160;</text><tex
 [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="605.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-24)">│</text><text 
class="breeze-release-management-publish-docs-r8" x="488" y="605.6" 
textLength="951.6" 
clip-path="url(#breeze-release-management-publish-docs-line-24)">(TEXT)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#
 [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="630" 
textLength="1464" 
clip-path="url(#breeze-release-management-publish-docs-line-25)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-release-management-publish-docs-r1" x="1464" y="630" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-25)">
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="654.4" 
textLength="24.4" 
clip-path="url(#breeze-release-management-publish-docs-line-26)">╭─</text><text 
class="breeze-release-management-publish-docs-r5" x="24.4" y="654.4" 
textLength="219.6" 
clip-path="url(#breeze-release-management-publish-docs-line-26)">&#160;Parallel&#160;running&#160;</text><text
 class="breeze-release-management-publish-docs-r5" x="244" y="654.4" 
textLength="1195.6" clip-path="url(#breeze-relea [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="678.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-27)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="678.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-27)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="678.8" 
textLength="48.8" 
clip-path="url(#breeze-release-management-publish-docs-line-27) [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="703.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-28)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="703.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-28)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="703.2" 
textLength="146.4" 
clip-path="url(#breeze-release-management-publish-docs-line-28 [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="727.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-29)">│</text><text 
class="breeze-release-management-publish-docs-r8" x="378.2" y="727.6" 
textLength="915" 
clip-path="url(#breeze-release-management-publish-docs-line-29)">(INTEGER&#160;RANGE)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;
 [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="752" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-30)">│</text><text 
class="breeze-release-management-publish-docs-r5" x="378.2" y="752" 
textLength="915" 
clip-path="url(#breeze-release-management-publish-docs-line-30)">[default:&#160;4;&#160;1&lt;=x&lt;=8]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160
 [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="776.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-31)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="776.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-31)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="776.4" 
textLength="61" 
clip-path="url(#breeze-release-management-publish-docs-line-31)"> [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-32)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-32)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="800.8" 
textLength="73.2" 
clip-path="url(#breeze-release-management-publish-docs-line-32) [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="825.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-33)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="825.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-33)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="825.2" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-33) [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="849.6" 
textLength="1464" 
clip-path="url(#breeze-release-management-publish-docs-line-34)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-release-management-publish-docs-r1" x="1464" y="849.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-34)">
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="874" 
textLength="24.4" 
clip-path="url(#breeze-release-management-publish-docs-line-35)">╭─</text><text 
class="breeze-release-management-publish-docs-r5" x="24.4" y="874" 
textLength="195.2" 
clip-path="url(#breeze-release-management-publish-docs-line-35)">&#160;Common&#160;options&#160;</text><text
 class="breeze-release-management-publish-docs-r5" x="219.6" y="874" 
textLength="1220" clip-path="url(#breeze-release-manag [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="898.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-36)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="898.4" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-36)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="898.4" 
textLength="48.8" 
clip-path="url(#breeze-release-management-publish-docs-line-36) [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="922.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-37)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="922.8" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-37)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="922.8" 
textLength="97.6" 
clip-path="url(#breeze-release-management-publish-docs-line-37) [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="947.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-38)">│</text><text 
class="breeze-release-management-publish-docs-r4" x="24.4" y="947.2" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-38)">-</text><text 
class="breeze-release-management-publish-docs-r4" x="36.6" y="947.2" 
textLength="61" 
clip-path="url(#breeze-release-management-publish-docs-line-38)"> [...]
+</text><text class="breeze-release-management-publish-docs-r5" x="0" y="971.6" 
textLength="1464" 
clip-path="url(#breeze-release-management-publish-docs-line-39)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-release-management-publish-docs-r1" x="1464" y="971.6" 
textLength="12.2" 
clip-path="url(#breeze-release-management-publish-docs-line-39)">
 </text>
     </g>
     </g>
diff --git a/dev/breeze/doc/images/output_release-management_publish-docs.txt 
b/dev/breeze/doc/images/output_release-management_publish-docs.txt
index c52010401a..4c01b130b1 100644
--- a/dev/breeze/doc/images/output_release-management_publish-docs.txt
+++ b/dev/breeze/doc/images/output_release-management_publish-docs.txt
@@ -1 +1 @@
-0221384f98407e9240a82f7f52249ab0
+19b12bd9764014caa3e965bf127d5d09
diff --git a/dev/breeze/doc/images/output_sbom_update-sbom-information.svg 
b/dev/breeze/doc/images/output_sbom_update-sbom-information.svg
index 802927e439..03ef18d7fc 100644
--- a/dev/breeze/doc/images/output_sbom_update-sbom-information.svg
+++ b/dev/breeze/doc/images/output_sbom_update-sbom-information.svg
@@ -1,4 +1,4 @@
-<svg class="rich-terminal" viewBox="0 0 1482 879.5999999999999" 
xmlns="http://www.w3.org/2000/svg";>
+<svg class="rich-terminal" viewBox="0 0 1482 904.0" 
xmlns="http://www.w3.org/2000/svg";>
     <!-- Generated with Rich https://www.textualize.io -->
     <style>
 
@@ -45,7 +45,7 @@
 
     <defs>
     <clipPath id="breeze-sbom-update-sbom-information-clip-terminal">
-      <rect x="0" y="0" width="1463.0" height="828.5999999999999" />
+      <rect x="0" y="0" width="1463.0" height="853.0" />
     </clipPath>
     <clipPath id="breeze-sbom-update-sbom-information-line-0">
     <rect x="0" y="1.5" width="1464" height="24.65"/>
@@ -146,9 +146,12 @@
 <clipPath id="breeze-sbom-update-sbom-information-line-32">
     <rect x="0" y="782.3" width="1464" height="24.65"/>
             </clipPath>
+<clipPath id="breeze-sbom-update-sbom-information-line-33">
+    <rect x="0" y="806.7" width="1464" height="24.65"/>
+            </clipPath>
     </defs>
 
-    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" 
x="1" y="1" width="1480" height="877.6" rx="8"/><text 
class="breeze-sbom-update-sbom-information-title" fill="#c5c8c6" 
text-anchor="middle" x="740" 
y="27">Command:&#160;sbom&#160;update-sbom-information</text>
+    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" 
x="1" y="1" width="1480" height="902" rx="8"/><text 
class="breeze-sbom-update-sbom-information-title" fill="#c5c8c6" 
text-anchor="middle" x="740" 
y="27">Command:&#160;sbom&#160;update-sbom-information</text>
             <g transform="translate(26,22)">
             <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
             <circle cx="22" cy="0" r="7" fill="#febc2e"/>
@@ -172,26 +175,27 @@
 </text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="288.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-11)">│</text><text 
class="breeze-sbom-update-sbom-information-r1" x="488" y="288.4" 
textLength="951.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-11)">versions)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160
 [...]
 </text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="312.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-12)">│</text><text 
class="breeze-sbom-update-sbom-information-r7" x="488" y="312.8" 
textLength="951.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-12)">(3.6&#160;|&#160;3.7&#160;|&#160;3.8&#160;|&#160;3.9&#160;|&#160;3.10&#160;|&#160;3.11)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160
 [...]
 </text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="337.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-13)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="61" y="337.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-13)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="73.2" y="337.2" 
textLength="97.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-13)">-include</text><te
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="361.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-14)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="61" y="361.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-14)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="73.2" y="361.6" 
textLength="97.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-14)">-package</text><te
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="386" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-15)">│</text><text 
class="breeze-sbom-update-sbom-information-r1" x="488" y="386" 
textLength="951.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-15)">`apache-airflow-providers`&#160;to&#160;consider&#160;all&#160;the&#160;providers.&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="410.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-16)">│</text><text 
class="breeze-sbom-update-sbom-information-r7" x="488" y="410.4" 
textLength="951.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-16)">(apache-airflow-providers&#160;|&#160;apache-airflow)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#1
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="434.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-17)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="61" y="434.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-17)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="73.2" y="434.8" 
textLength="73.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-17)">-force</text><text
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="459.2" 
textLength="1464" 
clip-path="url(#breeze-sbom-update-sbom-information-line-18)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-sbom-update-sbom-information-r1" x="1464" y="459.2" 
textLength="12.2" clip-path="url(#breeze-sbom-update-sbom-information-line-18)">
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="483.6" 
textLength="24.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-19)">╭─</text><text 
class="breeze-sbom-update-sbom-information-r5" x="24.4" y="483.6" 
textLength="219.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-19)">&#160;Parallel&#160;running&#160;</text><text
 class="breeze-sbom-update-sbom-information-r5" x="244" y="483.6" 
textLength="1195.6" clip-path="url(#breeze-sbom-update-sbom-inf [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="508" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-20)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="508" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-20)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="508" 
textLength="48.8" 
clip-path="url(#breeze-sbom-update-sbom-information-line-20)">-run</text><text 
class [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-21)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-21)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="532.4" 
textLength="146.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-21)">-parallelism</t 
[...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="556.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-22)">│</text><text 
class="breeze-sbom-update-sbom-information-r7" x="378.2" y="556.8" 
textLength="915" 
clip-path="url(#breeze-sbom-update-sbom-information-line-22)">(INTEGER&#160;RANGE)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="581.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-23)">│</text><text 
class="breeze-sbom-update-sbom-information-r5" x="378.2" y="581.2" 
textLength="915" 
clip-path="url(#breeze-sbom-update-sbom-information-line-23)">[default:&#160;4;&#160;1&lt;=x&lt;=8]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="605.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-24)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="605.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-24)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="605.6" 
textLength="61" 
clip-path="url(#breeze-sbom-update-sbom-information-line-24)">-skip</text><text 
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="630" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-25)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="630" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-25)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="630" 
textLength="73.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-25)">-debug</text><text
 cla [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="654.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-26)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="654.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-26)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="654.4" 
textLength="97.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-26)">-include</text>< 
[...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="678.8" 
textLength="1464" 
clip-path="url(#breeze-sbom-update-sbom-information-line-27)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-sbom-update-sbom-information-r1" x="1464" y="678.8" 
textLength="12.2" clip-path="url(#breeze-sbom-update-sbom-information-line-27)">
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="703.2" 
textLength="24.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-28)">╭─</text><text 
class="breeze-sbom-update-sbom-information-r5" x="24.4" y="703.2" 
textLength="195.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-28)">&#160;Common&#160;options&#160;</text><text
 class="breeze-sbom-update-sbom-information-r5" x="219.6" y="703.2" 
textLength="1220" clip-path="url(#breeze-sbom-update-sbom-infor [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="727.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-29)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="727.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-29)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="727.6" 
textLength="97.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-29)">-verbose</text>< 
[...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="752" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-30)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="752" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-30)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="752" 
textLength="48.8" 
clip-path="url(#breeze-sbom-update-sbom-information-line-30)">-dry</text><text 
class [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="776.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-31)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="776.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-31)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="776.4" 
textLength="85.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-31)">-answer</text><t 
[...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-32)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-32)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="800.8" 
textLength="61" 
clip-path="url(#breeze-sbom-update-sbom-information-line-32)">-help</text><text 
 [...]
-</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="825.2" 
textLength="1464" 
clip-path="url(#breeze-sbom-update-sbom-information-line-33)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-sbom-update-sbom-information-r1" x="1464" y="825.2" 
textLength="12.2" clip-path="url(#breeze-sbom-update-sbom-information-line-33)">
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="361.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-14)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="61" y="361.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-14)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="73.2" y="361.6" 
textLength="97.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-14)">-package</text><te
 [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="386" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-15)">│</text><text 
class="breeze-sbom-update-sbom-information-r1" x="488" y="386" 
textLength="951.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-15)">matching&#160;the&#160;full&#160;package&#160;name,&#160;for&#160;example&#160;`apache-airflow-providers-*`.&#160;&#160;&#160;&#160;&#160;</text><text
 class="breeze-sbom-update-sbo [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="410.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-16)">│</text><text 
class="breeze-sbom-update-sbom-information-r1" x="488" y="410.4" 
textLength="951.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-16)">Useful&#160;when&#160;you&#160;want&#160;to&#160;selectseveral&#160;similarly&#160;named&#160;packages&#160;together.&#160;&#160;&#160;&#160;&#160;&#160;</text><text
 class="bre [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="434.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-17)">│</text><text 
class="breeze-sbom-update-sbom-information-r7" x="488" y="434.8" 
textLength="951.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-17)">(apache-airflow-providers&#160;|&#160;apache-airflow)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#1
 [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="459.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-18)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="61" y="459.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-18)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="73.2" y="459.2" 
textLength="73.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-18)">-force</text><text
 [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="483.6" 
textLength="1464" 
clip-path="url(#breeze-sbom-update-sbom-information-line-19)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-sbom-update-sbom-information-r1" x="1464" y="483.6" 
textLength="12.2" clip-path="url(#breeze-sbom-update-sbom-information-line-19)">
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="508" 
textLength="24.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-20)">╭─</text><text 
class="breeze-sbom-update-sbom-information-r5" x="24.4" y="508" 
textLength="219.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-20)">&#160;Parallel&#160;running&#160;</text><text
 class="breeze-sbom-update-sbom-information-r5" x="244" y="508" 
textLength="1195.6" clip-path="url(#breeze-sbom-update-sbom-informati [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-21)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="532.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-21)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="532.4" 
textLength="48.8" 
clip-path="url(#breeze-sbom-update-sbom-information-line-21)">-run</text><text 
[...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="556.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-22)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="556.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-22)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="556.8" 
textLength="146.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-22)">-parallelism</t 
[...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="581.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-23)">│</text><text 
class="breeze-sbom-update-sbom-information-r7" x="378.2" y="581.2" 
textLength="915" 
clip-path="url(#breeze-sbom-update-sbom-information-line-23)">(INTEGER&#160;RANGE)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;
 [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="605.6" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-24)">│</text><text 
class="breeze-sbom-update-sbom-information-r5" x="378.2" y="605.6" 
textLength="915" 
clip-path="url(#breeze-sbom-update-sbom-information-line-24)">[default:&#160;4;&#160;1&lt;=x&lt;=8]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&
 [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="630" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-25)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="630" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-25)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="630" textLength="61" 
clip-path="url(#breeze-sbom-update-sbom-information-line-25)">-skip</text><text 
class= [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="654.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-26)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="654.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-26)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="654.4" 
textLength="73.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-26)">-debug</text><te 
[...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="678.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-27)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="678.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-27)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="678.8" 
textLength="97.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-27)">-include</text>< 
[...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="703.2" 
textLength="1464" 
clip-path="url(#breeze-sbom-update-sbom-information-line-28)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-sbom-update-sbom-information-r1" x="1464" y="703.2" 
textLength="12.2" clip-path="url(#breeze-sbom-update-sbom-information-line-28)">
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="727.6" 
textLength="24.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-29)">╭─</text><text 
class="breeze-sbom-update-sbom-information-r5" x="24.4" y="727.6" 
textLength="195.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-29)">&#160;Common&#160;options&#160;</text><text
 class="breeze-sbom-update-sbom-information-r5" x="219.6" y="727.6" 
textLength="1220" clip-path="url(#breeze-sbom-update-sbom-infor [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="752" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-30)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="752" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-30)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="752" 
textLength="97.6" 
clip-path="url(#breeze-sbom-update-sbom-information-line-30)">-verbose</text><text
 c [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="776.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-31)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="776.4" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-31)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="776.4" 
textLength="48.8" 
clip-path="url(#breeze-sbom-update-sbom-information-line-31)">-dry</text><text 
[...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-32)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="800.8" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-32)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="800.8" 
textLength="85.4" 
clip-path="url(#breeze-sbom-update-sbom-information-line-32)">-answer</text><t 
[...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="825.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-33)">│</text><text 
class="breeze-sbom-update-sbom-information-r4" x="24.4" y="825.2" 
textLength="12.2" 
clip-path="url(#breeze-sbom-update-sbom-information-line-33)">-</text><text 
class="breeze-sbom-update-sbom-information-r4" x="36.6" y="825.2" 
textLength="61" 
clip-path="url(#breeze-sbom-update-sbom-information-line-33)">-help</text><text 
 [...]
+</text><text class="breeze-sbom-update-sbom-information-r5" x="0" y="849.6" 
textLength="1464" 
clip-path="url(#breeze-sbom-update-sbom-information-line-34)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text
 class="breeze-sbom-update-sbom-information-r1" x="1464" y="849.6" 
textLength="12.2" clip-path="url(#breeze-sbom-update-sbom-information-line-34)">
 </text>
     </g>
     </g>
diff --git a/dev/breeze/doc/images/output_sbom_update-sbom-information.txt 
b/dev/breeze/doc/images/output_sbom_update-sbom-information.txt
index e31da63f35..b85a60f369 100644
--- a/dev/breeze/doc/images/output_sbom_update-sbom-information.txt
+++ b/dev/breeze/doc/images/output_sbom_update-sbom-information.txt
@@ -1 +1 @@
-e49cf33ae18ab7d16af7ef3b73035a10
+cd98b5a1bd72a93ea57831fde5d5d9d6
diff --git a/dev/breeze/src/airflow_breeze/commands/developer_commands.py 
b/dev/breeze/src/airflow_breeze/commands/developer_commands.py
index 27c43fc11b..6ea88f53f0 100644
--- a/dev/breeze/src/airflow_breeze/commands/developer_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/developer_commands.py
@@ -604,9 +604,9 @@ def start_airflow(
 )
 @click.option(
     "--package-filter",
-    help="List of packages to consider. You can use the full names like 
apache-airflow-providers-<provider>, "
-    "the short hand names or the glob pattern matching the full package name. "
-    "The list of short hand names can be found in --help output",
+    help="Filter(s) to use more than one can be specified. You can use glob 
pattern matching the "
+    "full package name, for example `apache-airflow-providers-*`. Useful when 
you want to select"
+    "several similarly named packages together.",
     type=str,
     multiple=True,
 )
diff --git 
a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py 
b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
index bd31a2e518..320c8ec038 100644
--- a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
@@ -1260,9 +1260,9 @@ def run_publish_docs_in_parallel(
 @click.option("-s", "--override-versioned", help="Overrides versioned 
directories.", is_flag=True)
 @click.option(
     "--package-filter",
-    help="List of packages to consider. You can use the full names like 
apache-airflow-providers-<provider>, "
-    "the short hand names or the glob pattern matching the full package name. "
-    "The list of short hand names can be found in --help output",
+    help="Filter(s) to use more than one can be specified. You can use glob 
pattern matching the "
+    "full package name, for example `apache-airflow-providers-*`. Useful when 
you want to select"
+    "several similarly named packages together.",
     type=str,
     multiple=True,
 )
diff --git a/dev/breeze/src/airflow_breeze/commands/sbom_commands.py 
b/dev/breeze/src/airflow_breeze/commands/sbom_commands.py
index 92c3720039..1ffac911f7 100644
--- a/dev/breeze/src/airflow_breeze/commands/sbom_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/sbom_commands.py
@@ -127,8 +127,9 @@ SBOM_INDEX_TEMPLATE = """
 @option_answer
 @click.option(
     "--package-filter",
-    help="List of packages to consider. You can use `apache-airflow` for core "
-    "or `apache-airflow-providers` to consider all the providers.",
+    help="Filter(s) to use more than one can be specified. You can use glob 
pattern matching the "
+    "full package name, for example `apache-airflow-providers-*`. Useful when 
you want to select"
+    "several similarly named packages together.",
     type=BetterChoice(["apache-airflow-providers", "apache-airflow"]),
     required=False,
     default="apache-airflow",
diff --git a/docs/build_docs.py b/docs/build_docs.py
index aaba029b60..ae91c7ec5b 100755
--- a/docs/build_docs.py
+++ b/docs/build_docs.py
@@ -128,7 +128,9 @@ def _get_parser():
         "--package-filter",
         action="append",
         help=(
-            "Filter specifying for which packages the documentation is to be 
built. Wildcard are supported."
+            "Filter(s) to use more than one can be specified. You can use glob 
pattern matching the "
+            "full package name, for example `apache-airflow-providers-*`. 
Useful when you want to select"
+            "several similarly named packages together."
         ),
     )
     parser.add_argument("--docs-only", dest="docs_only", action="store_true", 
help="Only build documentation")

Reply via email to