================
@@ -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:

Ok, I would propose to introduce the `CommentFormat` option with the following 
behaviour:

- `Plaintext` (default): the old escaping behaviour and no doxygen command 
parsing. The only thing I would still change is the paragraph termination with 
2 newlines instead of 1.
- `Markdown`: this disables the escaping as implemented with this patch, but 
still does not enable doxygen comment parsing.
- `Doxygen`: same as `Markdown` but also enables doxygen comment parsing.

Do you agree @emaxx-google?

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