================
@@ -118,8 +138,8 @@ class Document {
   BulletList &addBulletList();
 
   /// Doesn't contain any trailing newlines.
-  /// We try to make the markdown human-readable, e.g. avoid extra escaping.
-  /// At least one client (coc.nvim) displays the markdown verbatim!
----------------
tcottin wrote:

>A single blank line between paragraphs sounds OK. Or do you mean adding 
>another blank line in between, or a trailing blank line at the end? - that 
>might look extraneous. In any case, that sounds like a relatively minor 
>implementation detail that we can discuss further as the PR goes.

I mean in between.

Multiple newlines in a comment used to be "collapsed" to a single newline, 
resulting in removed paragraph separation in Markdown:

```c
/**
 * paragraph1 line1
 * paragraph1 line2
 *
 * paragraph2 line1
 */
```

Hover looked like this:

```
paragraph1 line1 paragraph1 line2
paragraph2 line1
```

With the change, paragraphs are now seperated by an empty line (as per Markdown 
specification).

```
paragraph1 line1 paragraph1 line2

paragraph2 line1
```

Trailing newlines are always trimmed. This did not change.

https://github.com/llvm/llvm-project/pull/140498
_______________________________________________
cfe-commits mailing list
cfe-commits@lists.llvm.org
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to