RFR: 8271186: Add UL option to replace newline char [v6]

[Yasumasa Suenaga]

On Wed, 25 Aug 2021 05:56:18 GMT, Ioi Lam <iklam at openjdk.org> wrote:

>> Yasumasa Suenaga has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Remove initialize function from LogFileStreamOutput
>
> src/java.base/share/man/java.1 line 4426:
> 
>> 4424: .PP
>> 4425: When \f[I]foldmultilines\f[R] is true, a log event that consists of multiple lines will be folded into a single line by replacing newline characters with the sequence '\\' and 'n' in the output. Existing single backslash characters will also be replaced with a sequence of two backslashes so that the conversion can be reversed. This option is safe to use with UTF-8 character encodings, but other encodings may not work. For example, it may happen inadvertently conversion in multi-byte sequences in Shift JIS and BIG5.
>> 4426: This option is available only for file outputs.
> 
> How about: "For example, it may incorrectly convert multi-byte sequences in Shift JIS and BIG5."

Thanks Ioi! I updated manpage, and also I formatted the description - it was too long than other lines!

-------------

PR: https://git.openjdk.java.net/jdk/pull/4885