[PR] Drop backslash escapes that Markdown does not need [maven-doxia]

["slachiewicz (via GitHub)" <gi...@apache.org>]

slachiewicz opened a new pull request, #1071:
URL: https://github.com/apache/maven-doxia/pull/1071

   Pages converted from APT with an older `doxia-converter` carry a backslash in front of
   punctuation that is not markup where it stands, for example `maven\-source\-plugin`,
   `\(default\)` and `required\.`. The backslash renders as nothing; it only makes the source
   harder to read and to edit, which was the point of moving to Markdown.
   
   Only positions where the bare character can never be markup are touched: a hyphen,
   underscore or asterisk between two word characters, a parenthesis, a full stop that
   does not follow a digit, and an exclamation mark not followed by `[`.
   
   Left alone deliberately:
   
   * angle brackets, since `<escapeString>` really would be read as an HTML tag
   * a full stop after a digit, so an ordered list marker cannot appear by accident
   * a run of dots, because bare `...` is rendered as a single ellipsis character
   * code spans, fenced blocks and link destinations
   
   Verified by building the site before and after: every generated page is identical in
   its visible text and in every link target.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@maven.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] Drop backslash escapes that Markdown does not need [maven-doxia]

["slachiewicz (via GitHub)" <gi...@apache.org>]

slachiewicz merged PR #1071:
URL: https://github.com/apache/maven-doxia/pull/1071


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@maven.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org