From 9c3faa449b5ff4856106792f0fa8aa80a7cb5708 Mon Sep 17 00:00:00 2001
From: Pietro Peterlongo <pietro.peterlongo@gmail.com>
Date: Fri, 28 Oct 2022 22:24:51 +0200
Subject: add back discard as a way to do multiline comments, see #12352
 (#20688)

---
 doc/manual.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/manual.md b/doc/manual.md
index 8431eba3d..bd5307003 100644
--- a/doc/manual.md
+++ b/doc/manual.md
@@ -257,6 +257,18 @@ Multiline documentation comments also exist and support nesting too:
     ]##
   ```
 
+You can also use the [discard statement](#statements-and-expressions-discard-statement) together with
+[triple quoted string literals](#lexical-analysis-triple-quoted-string-literals) to create multiline comments:
+
+  ```nim
+  discard """ You can have any Nim code text commented
+  out inside this with no indentation restrictions.
+        yes("May I ask a pointless question?") """
+  ```
+
+This was how multiline comments were done before version 0.13.0,
+and it is used to provide specifications to [testament](testament.html#writing-unitests) test framework.
+
 
 Identifiers & Keywords
 ----------------------
-- 
cgit 1.4.1-2-gfad0