A rich comment's closing parenthesis may be on the next line.

- Note an exception to the rule "Gather trailing parentheses"
as discussed in issue #259.

Author: pbwolf

README.adoc

@@ -495,7 +495,7 @@ of commas and line breaks.
 
 === Gather Trailing Parentheses [[gather-trailing-parens]]
 
-Place all trailing parentheses on a single line instead of distinct lines.
+Place trailing parentheses on a single line instead of distinct lines.
 
 [source,clojure]
 ----
@@ -509,6 +509,21 @@ Place all trailing parentheses on a single line instead of distinct lines.
 )
 ----
 
+An exception to the rule is a rich comment for REPL-oriented programming,
+lest gathering the comment's closing parenthesis make the last form in the comment harder to use.
+A rich comment's closing parenthesis may be on the next line.
+
+[source,clojure]
+----
+;; good; rich comment ends on the next line
+(comment
+  (range 5)
+  (interpose '* (range 5))
+  (->> (range 5) (interpose '*))
+  (= *1 *2)
+  )
+----
+
 === Empty Lines Between Top-Level Forms [[empty-lines-between-top-level-forms]]
 
 Use a single empty line between top-level forms.