close
Skip to content

docs: sync --test_summary description with current behavior#29550

Open
shrey4796 wants to merge 1 commit into
bazelbuild:masterfrom
shrey4796:test-summary-docs
Open

docs: sync --test_summary description with current behavior#29550
shrey4796 wants to merge 1 commit into
bazelbuild:masterfrom
shrey4796:test-summary-docs

Conversation

@shrey4796
Copy link
Copy Markdown

Description

sync --test_summary description with current behavior

Motivation

The user-manual.md description of --test_summary became stale after two upstream changes that updated the @option help= string in ExecutionOptions.java but not this page:

The 'testcase' value has also been a public TestSummaryFormat enum constant for years without ever being documented here.

Resync the prose with the help= string and the TestSummaryFormat javadoc so the documented behavior matches what bazel actually does.

Build API Changes

No

Checklist

  • I have added tests for the new use cases (if any).
  • I have updated the documentation (if applicable).

Release Notes

RELNOTES: None

@google-cla
Copy link
Copy Markdown

google-cla Bot commented May 15, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@github-actions github-actions Bot added team-Documentation Documentation improvements that cannot be directly linked to other team labels awaiting-review PR is awaiting review from an assigned reviewer labels May 15, 2026
The user-manual.md description of --test_summary became stale after two
upstream changes that updated the @option help= string in
ExecutionOptions.java but not this page:

  * c75fda9 / bazelbuild#19099 (cherry-picked to 6.4 as bazelbuild#19505): made
    --test_summary=detailed print passed and skipped test cases in
    addition to failed ones.
  * 42196f5 / bazelbuild#28341 (in 8.6 and 9.1): added the short_uncached and
    detailed_uncached values.

The 'testcase' value has also been a public TestSummaryFormat enum
constant for years without ever being documented here.

Resync the prose with the help= string and the TestSummaryFormat
javadoc so the documented behavior matches what bazel actually does.
@shrey4796 shrey4796 force-pushed the test-summary-docs branch from 54ba8e0 to ba5e8d5 Compare May 15, 2026 18:12
@iancha1992 iancha1992 added the team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website label May 19, 2026
@meteorcloudy meteorcloudy added team-Local-Exec Issues and PRs for the Execution (Local) team and removed team-OSS Issues for the Bazel OSS team: installation, release processBazel packaging, website labels May 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting-review PR is awaiting review from an assigned reviewer team-Documentation Documentation improvements that cannot be directly linked to other team labels team-Local-Exec Issues and PRs for the Execution (Local) team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants