jyapayne/Nim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

add back discard as a way to do multiline comments, see #12352 (#20688)

Browse source
This commit is contained in:
Pietro Peterlongo 2022-10-28 22:24:51 +02:00 • committed by GitHub
commit 9c3faa449b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 12 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

12
doc/manual.md
View file

@ -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 Identifiers & Keywords
---------------------- ----------------------