Repository navigation
Fix #807: helpmojo flattens nested lists in javadoc - #1259
Open
arturobernalg wants to merge 1 commit into
Open
arturobernalg wants to merge 1 commit into
arturobernalg wants to merge 1 commit into
Conversation
HtmlToPlainTextConverter.FormattingVisitor appended "\n * " for every <li> regardless of nesting depth, and its cleanup step collated any run of spaces -- including indentation meant to show nesting -- down to one. A nested <ul>/<li> structure in a Mojo's or parameter's javadoc always rendered as one flat bullet level in the plain-text output used by mvn <plugin>:help, losing the nesting the javadoc author intended. FormattingVisitor now tracks <ul>/<ol> nesting depth and indents each <li> accordingly, using a placeholder character for the indentation spaces so the existing space-collation cleanup doesn't erase it -- the placeholder is only expanded to real spaces as the last step of toString(). Added tests for a single-level list (unchanged output), a nested list, and a doubly-nested list.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #807.
HtmlToPlainTextConverter.FormattingVisitor appended "\n * " for every
/- structure in a Mojo's or parameter's javadoc always rendered as one flat bullet level in the plain-text output used by mvn :help, losing the nesting the javadoc author intended.
FormattingVisitor now tracks
/
nesting depth and indents each- accordingly, using a placeholder character for the indentation spaces so the existing space-collation cleanup doesn't erase it -- the placeholder is only expanded to real spaces as the last step of toString(). Added tests for a single-level list (unchanged output), a nested list, and a doubly-nested list. Full module suite, checkstyle and spotless pass locally.
- I hereby declare this contribution to be licensed under the Apache License Version 2.0, January 2004
- I hereby declare that I have filed an Apache Individual Contributor License Agreement.
To make clear that you license your contribution under the Apache License Version 2.0, January 2004, check one of the following: