Moves op declaration to new page closes #2162

doc/Language/00-POD6-CONTROL

@@ -36,6 +36,7 @@ Iterating FILE: iterating
 Module development utilities FILE: modules-extra
 Module packages FILE: module-packages
 Modules FILE: modules
+Operators FILE: optut
 Regexes best practices and gotchas FILE: regexes-best-practices
 
 section: General reference

doc/Language/optut.pod6

@@ -0,0 +1,35 @@
+=begin pod
+
+=TITLE Creating operators
+
+=SUBTITLE A short tutorial on how to declare operators and create new ones.
+
+Operators are declared by C<sub>
+followed by C<prefix>, C<infix>, C<postfix>, C<circumfix>, or C<postcircumfix>;
+then a colon and the operator name in a quote construct. For (post-)circumfix
+operators separate the two parts by white space.
+
+    sub hello {
+        say "Hello, world!";
+    }
+    say &hello.^name;   # OUTPUT: «Sub␤»
+    hello;              # OUTPUT: «Hello, world!␤»
+
+    my $s = sub ($a, $b) { $a + $b };
+    say $s.^name;       # OUTPUT: «Sub␤»
+    say $s(2, 5);       # OUTPUT: «7␤»
+
+    sub postfix:<♥>($a){ say „I love $a!“ }
+    42♥;
+    # OUTPUT: «I love 42!␤»
+    sub postcircumfix:<⸨ ⸩>(Positional $a, Whatever){ say $a[0], '…', $a[*-1] }
+    [1,2,3,4]⸨*⸩;
+    # OUTPUT: «1…4␤»
+    constant term:<♥> = "♥"; # We don't want to quote "love", do we?
+    sub circumfix:<α ω>($a){ say „$a is the beginning and the end.“ };
+    α♥ω;
+    # OUTPUT: «♥ is the beginning and the end.␤»
+
+=end pod
+
+# vim: expandtab softtabstop=4 shiftwidth=4 ft=perl6

doc/Type/Sub.pod6

@@ -7,32 +7,9 @@
     class Sub is Routine { }
 
 A type for subroutines and operators. Subs are created with the C<sub>
-declarator keyword followed by an optional L<identifier|/language/syntax#Identifiers>. Operators are declared by C<sub>
-followed by C<prefix>, C<infix>, C<postfix>, C<circumfix>, or C<postcircumfix>;
-then a colon and the operator name in a quote construct. For (post-)circumfix
-operators separate the two parts by white space.
-
-    sub hello {
-        say "Hello, world!";
-    }
-    say &hello.^name;   # OUTPUT: «Sub␤»
-    hello;              # OUTPUT: «Hello, world!␤»
-
-    my $s = sub ($a, $b) { $a + $b };
-    say $s.^name;       # OUTPUT: «Sub␤»
-    say $s(2, 5);       # OUTPUT: «7␤»
-
-    sub postfix:<♥>($a){ say „I love $a!“ }
-    42♥;
-    # OUTPUT: «I love 42!␤»
-    sub postcircumfix:<⸨ ⸩>(Positional $a, Whatever){ say $a[0], '…', $a[*-1] }
-    [1,2,3,4]⸨*⸩;
-    # OUTPUT: «1…4␤»
-    constant term:<♥> = "♥"; # We don't want to quote "love", do we?
-    sub circumfix:<α ω>($a){ say „$a is the beginning and the end.“ };
-    α♥ω;
-    # OUTPUT: «♥ is the beginning and the end.␤»
-
+declarator keyword followed by an optional
+L<identifier|/language/syntax#Identifiers>. This
+L<short tutorial explains how operators are declared|/language/optut>.
 
 Note that subs that go by the same name as
 L<coercers|/language/typesystem#Coercion> will not take precedence over