Pavel Rappo

> Also have you looked at the output documentation? Without the `@inheritDoc` tags the content will only have a since tag, which is definitely wrong. This is not how I...

> would be nice if you can share more about these (also about the behaviors of inheriting `@throws` etc. I hope this document explains it well; if it doesn't, we...

@jonathan-gibbons, please sync this PR with mainline. As for Skara bots, this comment will hopefully deter them for another 4 weeks.

Jon, please sync this PR with mainline to resolve conflicts.

I have a test case to report. The following results in no `@param` information being rendered, which I think is a bug: /// Hello, _Markdown_ world! /// /// /// @param...

> I have a test case to report. The following results in no `@param` information being rendered, which I think is a bug: > > ``` > /// Hello, _Markdown_...

I think we should add a test to verify that if `--disable-line-doc-comments` is specified, no `///` dangling comments are reported.

> There are a few builder style APIs for immutable objects that have `withXXX` methods that return an instance with the change requested. A `withExtension(String ext)` could handle the common...

> Hm, I don't think we want to add any synchronized blocks within a shutdown hook. If a thread is blocked reading from the console, it will hold readLock; if...

> I thought of the same scenario that is certainly possible. Now I am tempted to avoid this race condition altogether by removing checking restoreEcho and always issue echo(true). What...