slachiewicz opened a new pull request, #87:
URL: https://github.com/apache/maven-jdeprscan-plugin/pull/87

   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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to