I have noticed a few comments today that include multiline comment formatting (for example on this answer), and wondered when this was enabled and where this was announced.
I've searched a bit on meta, but feature-requests like Add syntax highlighting and line breaks to comment formatting still have status: declined. Neither the How do comments work? FAQ nor the editing help mention this.
Also, how does it work? As suggested in the comments: Is this a bug?
They aren't, it was a bug. When making this change, I swear did read the spec to check for side effects of the change, but somehow the phrase "Lines are broken at newline characters" was able to cross my brain unharmed.
Fixed now. Newlines, that is, not my brain.
how does it work?
This at least I figured out. Simply enter line breaks inside the comment (by pressing Shift+Enter, to prevent automatically submitting the form), and use backticks for code formatting as usual:
My very simple sample comment `with (trivial) {
code_formatting()
}` that is going to be indented
becomes
My very simple sample comment
with (trivial) { code_formatting() }that is going to be indented
Technically, the markup will preserve these whitespaces, and the CSS for this is
code {
white-space: pre-wrap;
}
which also applies to the comment sections.
<- that's a sad face
Commented
Feb 24, 2014 at 22:27
When this was enabled and where this was announced?
As @Sinon found, it was introduced to prevent Multiple spaces in code in comments get merged into one
I've added this to our stylesheets:
code { white-space: pre-wrap; /* don't collapse multiple spaces in code */ }– no idea why we never did that; it's an easy enough fix, and these days it's supported by all browsers. This is in the next build.
Is this a bug?
A side effect, at least.
do something with very fancy indentation(inline block?)sealed class QueryProcessor : IQueryProcessor { private readonly Container container; public QueryProcessor(Container container) { this.container = container; } [DebuggerStepThrough] public TResult Process<TResult>(IQuery<TResult> query) { var handlerType = typeof(IQueryHandler<,>) .MakeGenericType(query.GetType(), typeof(TResult)); dynamic handler = container.GetInstance(handlerType); return handler.Handle((dynamic)query); } }Make my day, Punk!