How to disable autoformating of comments?

[atengberg]

Motokodoc will create a new line if there are two empty trailing characters of the last line, however now I've noticed the formatter trims any trailing empty space breaking intentional formatting of Motokodoc. Is there a way to disable this for Motokodoc?

If that's not clear, in code:

Legend: ∅ -> a white space

/** Some Method's Motokodoc Title...∅∅
More info such as params etc and finally end of Motokodoc. */
public func aFunMethod() : async Text { debug_show(this) }; 

Previously this would generate a tooltip like: ----------------------------------------------------------------------------------	() -> Text	Some Method's Motokdoc Title..	More info such as params etc and finally end of Motokodoc.

But now it's all one run on line.

[rvanasa]

I see what you're saying and will look into it. Since Motoko doc comments render using standard Markdown, you could also include an additional newline in between the two lines:

/** Some Method's Motokodoc Title...

More info such as params etc and finally end of Motokodoc. */
public func aFunMethod() : async Text { debug_show(this) }; 

Alternatively:

/// Some Method's Motokodoc Title...
///
/// More info such as params etc and finally end of Motokodoc.
public func aFunMethod() : async Text { debug_show(this) }; 

[atengberg]

Ah, thanks--that'll work for the time being. Should I close this for now?

[rvanasa]

Sure, and I will keep this in mind for the formatter. Cheers!