Skip to content

fix(tooling): use LinkedHashSet for deterministic option ordering in help generation#2306

Merged
jbonofre merged 2 commits intoapache:mainfrom
jbonofre:fix/deterministic-option-ordering
Mar 12, 2026
Merged

fix(tooling): use LinkedHashSet for deterministic option ordering in help generation#2306
jbonofre merged 2 commits intoapache:mainfrom
jbonofre:fix/deterministic-option-ordering

Conversation

@jbonofre
Copy link
Member

No description provided.

…help generation

Replace HashSet with LinkedHashSet in all CommandHelpPrinter
implementations (Markdown, AsciiDoctor, DocBook, UserConf) to
preserve insertion order of options.

HashSet provides no ordering guarantee, causing non-deterministic
output that breaks the test-commands-generate-help invoker test
when dependencies change (e.g. jline upgrade from 3.30.6 to 3.30.8).
@jbonofre jbonofre changed the title Fix/deterministic option ordering fix(tooling): use LinkedHashSet for deterministic option ordering in help generation Mar 11, 2026
@jbonofre jbonofre merged commit b6f42b0 into apache:main Mar 12, 2026
3 of 4 checks passed
@jbonofre jbonofre deleted the fix/deterministic-option-ordering branch March 12, 2026 08:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant