[skip ci]

output/index.html

@@ -655,6 +655,13 @@
     Commands for showing output destinations
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#about-stdout-in-the-repl-window" class="md-nav__link">
+    About stdout in the REPL Window
+  </a>
+
 </li>
 
         <li class="md-nav__item">
@@ -1424,6 +1431,13 @@
     Commands for showing output destinations
   </a>
 
+</li>
+
+        <li class="md-nav__item">
+  <a href="#about-stdout-in-the-repl-window" class="md-nav__link">
+    About stdout in the REPL Window
+  </a>
+
 </li>
 
         <li class="md-nav__item">
@@ -1473,6 +1487,10 @@ <h2 id="commands-for-showing-output-destinations">Commands for showing output de
 <li><strong>Calva: Show/Open the Calva Output Terminal</strong> - <code>ctrl+alt+o t</code></li>
 <li><strong>Calva: Show/Open REPL Window</strong> - <code>ctrl+alt+o r</code></li>
 </ul>
+<h2 id="about-stdout-in-the-repl-window">About stdout in the REPL Window<a class="headerlink" href="#about-stdout-in-the-repl-window" title="Permanent link">#</a></h2>
+<p>Since Calva v2.0.423 the REPL Window prints <code>stdout</code> prepended with <code>;</code> to make it into line comments. This is because stdout output easily breaks the Clojure structure of the REPL Window, making it misbehave in various ways. We made this change because as maintainers of Calva we have seen all too often how this hits users, and it is also taking too much of our Calva time to try mitigate the problem, which is fundamentally not fixable.</p>
+<p>There are now other output destinations that do not have this limitation.</p>
+<p>All that said. If you want to keep using the REPL Window for stdout output, and need the old behavior, you can enable the setting: <code>calva.legacyPrintBareReplWindowOutput</code>. Please note that at some point after we have created a dedicated Output Window, the REPL Window will be retired as a destination for output.</p>
 <h2 id="repl-process-output-stdout-and-stderr">REPL process output (stdout and stderr)<a class="headerlink" href="#repl-process-output-stdout-and-stderr" title="Permanent link">#</a></h2>
 <p>When Calva is connected to the REPL, the Output window will by default print not only results of evaluations, but also:</p>
 <ol>