Adding examples of multi-line pod declarator blocks.

This would close #2035

Author: JJ

doc/Language/pod.pod6

@@ -139,32 +139,26 @@ say &duel.WHY.leading; # OUTPUT: «Fight mechanics␤»
 say &duel.WHY.trailing; # OUTPUT: «Magicians only, no mortals.␤»
 =end code
 
-=head2 Embedded and multi-line comment blocks
+These declarations can extend multiple blocks:
 
-You can embed comments in code by using a hash followed by a backtick C<#`> and any bracketing construct. Although these constructs are similar in syntax to the ones above, they will produce no output when run through C<perl6 --doc>, so they are simply comments.
-
-=begin code
-my $this-is-true = True;
-say "Yay" if #`[ wait for it ] $this-is-true; # OUTPUT: «Yay␤»
-=end code
-
-You can embed these comments in expressions, as long as you don't insert them in the middle of keywords or identifiers.
-
-These comments can extend multiple lines
 =begin code
-with (^33).grep( /^2/ ) { #`( This is an example of stringification:
+#|( This is an example of stringification:
     * Numbers turn into strings
     * Regexes operate on said strings
     * C<with> topicalizes and places result into $_
-) my @results = $_<>; #`« Uses
+)
+sub search-in-seq( Int $end, Int $number ) {
+    with (^$end).grep( /^$number/ ) {
+        .say for $_<>;
+    }
+}
+#=« Uses
     * topic
     * decont operator
 »
-  .say for @results;
-}
 =end code
 
-In the examples above, we are using C<()> and C<«»> as delimiters in a multi-line comment block.
+By using a matched pair of parentesis constructs such as C<()> or C<«»> the comments can extend multiple lines. This format, however, will not translate to a multi-line display by C<perl6 -doc>.
 
 =head1 Block types
 

doc/Language/syntax.pod6

@@ -194,7 +194,7 @@ say "No more";
 Brackets inside the comment can be nested, so in C<#`{ a { b } c }>, the
 comment goes until the very end of the string. You may also use more complex
 brackets, such as C<#`{{ double-curly-brace }}>, which might help disambiguate
-from nested brackets.
+from nested brackets. You can embed these comments in expressions, as long as you don't insert them in the middle of keywords or identifiers.
 
 =head3 Pod comments
 

xt/words.pws

@@ -1,4 +1,6 @@
+FQN
 LHS
+NewType
 Procs
 RHS
 Worthington
@@ -255,6 +257,7 @@ deallocation
 declarator
 declarators
 decodable
+decont
 decontainerization
 decontainerize
 decrement
@@ -284,6 +287,7 @@ dev
 devel
 devnull
 devs
+dex
 diag
 diffy
 dirhandle
@@ -664,6 +668,7 @@ mixins
 mixy
 mjd
 mkdir
+mmk
 moar
 moarvm
 moarvm's
@@ -767,6 +772,7 @@ nsw
 nswap
 nul
 num
+numified
 numify
 nums
 numstr
@@ -811,6 +817,7 @@ outliers
 outofrange
 ov
 overridable
+oðin
 pairup
 parallelize
 param
@@ -1373,9 +1380,3 @@ yyyy
 zef
 zoffixznet
 zwj
-mmk
-FQN
-NewType
-dex
-oðin
-numified