dweiss commented on issue #13766:
URL: https://github.com/apache/lucene/issues/13766#issuecomment-2345552152
So I just double checked and block-level comments are treated as
preformatted within code. This:
```
/*
* fba sdifhopi hweifh swehf doish dsopih ewfpoih efwspoihb wepihb apin
wef. spedfih [wefph wepfih wqefdpoi qp[hjfaph we.
* bar bar
*/
// fba sdifhopi hweifh swehf doish dsopih ewfpoih efwspoihb wepihb apin
wef. spedfih [wefph wepfih wqefdpoi qp[hjfaph we.
// bar bar
```
is tidied up to this:
```
/*
* fba sdifhopi hweifh swehf doish dsopih ewfpoih efwspoihb wepihb apin
wef. spedfih [wefph wepfih wqefdpoi qp[hjfaph we.
* bar bar
*/
// fba sdifhopi hweifh swehf doish dsopih ewfpoih efwspoihb wepihb apin
wef. spedfih [wefph
// wepfih wqefdpoi qp[hjfaph we.
// bar bar
```
I personally think this is the right choice by gjf - breaks long lines into
visibility but does not break any other line comments (and potentially damage
them). Block comments ```/* */``` can be used to preserve any formatting that
should not be touched at all.
I think this issue can be closed, sorry if it bothers you, but it's an
operator's error. :)
There are more headaches coming with the markdown comments spec [1]. It'll
be fun.
[1] https://openjdk.org/jeps/467
--
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]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
