Revision plus removal of :skip-tests

Author: threadless-screw

doc/Language/syntax.pod6

@@ -249,7 +249,7 @@ characters with the Unicode General Category value I<Letter> (L), and the
 underscore C<_>. Alphanumeric characters additionally include characters with
 the Unicode General Category value I<Number, Decimal Digit> (Nd).
 
-=begin code :skip-test
+=begin code
 # valid ordinary identifiers:
 x
 _snake_oil
@@ -260,12 +260,12 @@ piece_of_π
 駱駝道                 # "Rakuda-dō", Japanese for "Way of the camel"
 =end code
 
-=begin code :skip-test
+=begin code
 # invalid ordinary identifiers:
-42                    # Identifier does not start with alphabetic character
-with-numbers1234-5    # Embedded hyphen not followed by alphabetic character
-is-prime?             # Question mark is not alphanumeric
-x²                    # Superscript 2 is not alphanumeric (in the sense explained above)
+42                    # identifier does not start with alphabetic character
+with-numbers1234-5    # embedded hyphen not followed by alphabetic character
+is-prime?             # question mark is not alphanumeric
+x²                    # superscript 2 is not alphanumeric (in the sense explained above)
 =end code
 
 =head3 Extended identifiers
@@ -276,8 +276,8 @@ a common "short" name, but still needs for each of its elements to be identifiab
 individually. For example, you might use a module whose short name is C<Dog>, while
 its long name includes its naming authority and version:
 
-=begin code :skip-test
-Dog:auth<Somebody>:ver<1.0>         # Long module names including author and version
+=begin code
+Dog:auth<Somebody>:ver<1.0>         # long module names including author and version
 Dog:auth<Somebody>:ver<2.0>
 
 ------------------------------------
@@ -292,7 +292,7 @@ Similarly, sets of operators work together in various syntactic categories with
 like C<prefix>, C<infix>, C<postfix>, etc. The long, official names of these operators
 often contain characters that are excluded from ordinary identifiers:
 
-=begin code :skip-test
+=begin code
     infix:<+>                       # the official name of the operator in $a + $b
     infix:<*>                       # the official name of the operator in $a * $b
     infix:«<=»                      # the official name of the operator in $a <= $b
@@ -308,7 +308,7 @@ followed by an ordinary identifier C<key> and/or a quoting bracketing construct
 such as C«< >», C<« »> or C<[' ']> which quotes one or more arbitrary characters
 C<value>:
 
-=begin code :skip-test
+=begin code
 # exemplary valid extended identifiers:
 postfix:<²>                         # the official long name of the operator in $x²
 WOW:That'sAwesome
@@ -329,7 +329,7 @@ so C<infix:<+>> and C<infix:<->> are two different operators. The bracketing
 characters used, however, do not count as part of the name; only the quoted data
 matters. So these are all the same name:
 
-=begin code :skip-test
+=begin code
     infix:<+>
     infix:<<+>>
     infix:«+»
@@ -339,7 +339,7 @@ matters. So these are all the same name:
 
 Similarly, all of this works:
 
-=begin code :skip-test
+=begin code
     my $foo:bar<baz> = 'quux';
     say $foo:bar«baz»;                                  # OUTPUT: «quux␤»
     my $take-me:<home> = 'When the glory has no end';
@@ -351,7 +351,7 @@ Similarly, all of this works:
 Where an extended identifier comprises two or more colon pairs, their order
 is generally significant:
 
-=begin code :skip-test
+=begin code
     my $a:b<c>:d<e> = 100;
     my $a:d<e>:b<c> = 200;
     say $a:b<c>:d<e>;               # OUTPUT: «100␤», NOT: «200␤»
@@ -360,16 +360,16 @@ is generally significant:
 An exception to this rule is I<module versioning>; so these identifiers
 effectively name the same module:
 
-=begin code :skip-test
+=begin code
     use ThatModule:auth<Somebody>:ver<2.7.18.28.18>
     use ThatModule:ver<2.7.18.28.18>:auth<Somebody>
 =end code
 
-Furthermore, the adverbial form in extended identifiers supports
-compile-time interpolation, which mandates the use of
+Furthermore, colon pairs in extended identifiers support
+compile-time interpolation; this requires the use of
 L<constants|/language/terms#Constants> for the interpolation values:
 
-=begin code :skip-test
+=begin code
     constant $c = 42;               # Constant binds to Int; $-sigil enables interpolation
     my $a:foo<42> = "answer";
     say $a:foo«$c»;                 # OUTPUT: «answer␤»
@@ -381,7 +381,7 @@ angle brackets C«< >» (which mimic single quote interpolation
 characteristics) cannot be used for the interpolation of constant
 names.
 
-=begin code :skip-test
+=begin code
     constant $what = 'are';
     my @we:<are>= <the champions>;
     say @we:«$what»;                # OUTPUT: «[the champions]␤»