Revised multi-line comment example

Already done by @tbrowder in 8a6e2df.

This would close #2035 if it's OK with everyone.

doc/Language/pod.pod6

@@ -384,13 +384,13 @@ Z<Eventually copy everything from tables.pod6 and put it here>
 
 Pod comments are comments that Pod renderers ignore.
 
-Comments are useful for meta-documentation (documenting the documentation):
+Comments are useful for meta-documentation (documenting the documentation). Single-line coments use the C<comment> keyword:
 
 =begin code
 =comment Add more here about the algorithm
 =end code
 
-For multi-line comments use a delimited block:
+For multi-line comments use a delimited C<comment> block:
 
 =begin code
 =begin comment