Perl 6 Deep Dive

Multiline comments

Although one-line comments may be used to provide big chunks of documentation, having to place the # character in each line makes the comments themselves difficult to maintain. For example, if you modify the text of a comment, you may also want to reflow the whole paragraph so that all the lines are more or less the same length and the whole comment is more attractive visually.

In Perl 6, multi-line comments are supported. The syntax for a multi-line comment is the following. It starts with the #` sequence (the # character, same as in one-line comments, followed by a backtick symbol). Then, the part with the body of the comment goes in. It must be enclosed into a pair of brackets.

For example, curly braces may be used like ...