[ 
https://issues.apache.org/jira/browse/LUCENE-9570?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17251617#comment-17251617
 ] 

Dawid Weiss commented on LUCENE-9570:
-------------------------------------

Very long comments explaining things are hard.
{code}
     // 
999999900000000001111111111222222222233333333334444444444555555555566666666667777777777888888888899999999990000000000111111111122
     // 
345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901
-    // The most search engines use only one of these methods. Even the search 
engines that says they can use the both methods basically
-    // 12  13  (14)   (15)     16  17   18  19 20    21       22   23 (24)   
(25)     26   27   28   29  30  31  32   33      34
+    // The most search engines use only one of these methods. Even the search 
engines that says they
+    // can use the both methods basically
+    // 12  13  (14)   (15)     16  17   18  19 20    21       22   23 (24)   
(25)     26   27   28
+    // 29  30  31  32   33      34
{code}

I managed to get around this by replacing white spaces with underscores - 
forces those long lines to stay intact. You could try 
put non-breakable whitespace character there but this seems like a hack that 
will make someone wonder what's going on later on.
{code}
    // 
_______1___________________________________________________________________________________________________2
    // 
999999900000000001111111111222222222233333333334444444444555555555566666666667777777777888888888899999999990000000000111111111122
    // 
345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901
    // 
The_most_search_engines_use_only_one_of_these_methods._Even_the_search_engines_that_says_they_can_use_the_both_methods_basically
    // 
12__13__(14)___(15)_____16__17___18__19_20____21_______22___23_(24)___(25)_____26___27___28___29__30__31__32___33______34
{code}

> Review code diffs after automatic formatting and correct problems before it 
> is applied
> --------------------------------------------------------------------------------------
>
>                 Key: LUCENE-9570
>                 URL: https://issues.apache.org/jira/browse/LUCENE-9570
>             Project: Lucene - Core
>          Issue Type: Sub-task
>            Reporter: Dawid Weiss
>            Assignee: Dawid Weiss
>            Priority: Blocker
>
> Review and correct all the javadocs before they're messed up by automatic 
> formatting. Apply project-by-project, review diff, correct. Lots of diffs but 
> it should be relatively quick.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org
For additional commands, e-mail: issues-h...@lucene.apache.org

Reply via email to