[philderbeast]

A follow on from #10608 but for adding help to the doc/Makefile, fixing #10596.

I'll squash commits before applying the merge label if this pull request is approved.

---

• 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).

[leana8959]

I think these ? quantifiers are redundant, otherwise lgtm :)

[philderbeast]

I think these ? quantifiers are redundant, otherwise lgtm :)

Thanks @leana8959. Both grep -E and awk use POSIX extended regular expressions, so the ? works like optional rather than non-greedy.

Note, I copied the regex from the main Makefile into doc/Makefile but there we have rules with digits so had to account for that. I felt it better to have the same regex in both files so copied those changes back.

cabal/Makefile

Lines 343 to 346 in aca9bd4

	.PHONY: help
	help: ## Show the commented targets.
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
	sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'