Use usageAlternatives with v2-clean

[philderbeast]

Fixes #12148.

---

• Patches conform to the coding conventions.
• Is this a PR that fixes CI? If so, it will need to be backported to older cabal release branches (ask maintainers for directions).

[ffaf1]

Should this be erased?

cabal/cabal-install/src/Distribution/Client/Setup.hs

Line 316 in 4907eec

, "new-clean"

[philderbeast]

Should this be erased?

I don't think so with such a narrow pull request. Perhaps we need an issue to remove the lot of them, if not already covered by #9109?

cabal/cabal-install/src/Distribution/Client/Setup.hs

Lines 304 to 318 in 4907eec

	, "new-build"
	, "new-configure"
	, "new-target"
	, "new-repl"
	, "new-freeze"
	, "new-run"
	, "new-test"
	, "new-bench"
	, "new-haddock"
	, "new-exec"
	, "new-update"
	, "new-install"
	, "new-clean"
	, "new-sdist"
	, "new-haddock-project"

[Mikolaj]

OH, these were the times!

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-07-25 17:47 UTC · Rule: default · triggered by rule Put pull requests in the rebase+merge queue
• ✅ Checks passed · on draft merge queue: checking master (7ecb16b) and [#12057 + #12149 + #12143] together #12159
• ✅ Merged — 2026-07-26 06:11 UTC · at f3bf3e24a714ea740cfc6fd6be34bb3b76d5527e · merge

This pull request spent 12 hours 23 minutes 51 seconds in the queue, including 1 hour 52 minutes 14 seconds running CI.

Required conditions to merge

• #review-threads-unresolved = 0 [🛡 GitHub branch protection]
  • refactor: make Graph.broken return NonEmpty missing deps #12057
  • Show debug-info can be a boolean #12143
  • Use usageAlternatives with v2-clean #12149
• github-review-approved [🛡 GitHub branch protection] (documentation)
  • refactor: make Graph.broken return NonEmpty missing deps #12057
  • Show debug-info can be a boolean #12143
  • Use usageAlternatives with v2-clean #12149
• any of [🛡 GitHub branch protection]:
  • check-success = Doctest Cabal
  • check-neutral = Doctest Cabal
  • check-skipped = Doctest Cabal
• any of [🛡 GitHub branch protection]:
  • check-success = Meta checks
  • check-neutral = Meta checks
  • check-skipped = Meta checks
• any of [🛡 GitHub branch protection]:
  • check-success = docs/readthedocs.org:cabal
  • check-neutral = docs/readthedocs.org:cabal
  • check-skipped = docs/readthedocs.org:cabal
• any of [🛡 GitHub branch protection]:
  • check-success = Validate post job
  • check-neutral = Validate post job
  • check-skipped = Validate post job
• any of [🛡 GitHub branch protection]:
  • check-success = fourmolu
  • check-neutral = fourmolu
  • check-skipped = fourmolu
• any of [🛡 GitHub branch protection]:
  • check-success = hlint
  • check-neutral = hlint
  • check-skipped = hlint
• any of [🛡 GitHub branch protection]:
  • check-success = Bootstrap post job
  • check-neutral = Bootstrap post job
  • check-skipped = Bootstrap post job
• any of [🛡 GitHub branch protection]:
  • check-success = whitespace
  • check-neutral = whitespace
  • check-skipped = whitespace
• any of [🛡 GitHub branch protection]:
  • check-success = Check sdist post job
  • check-neutral = Check sdist post job
  • check-skipped = Check sdist post job
• any of [🛡 GitHub branch protection]:
  • check-success = Changelogs
  • check-neutral = Changelogs
  • check-skipped = Changelogs