list assignment, stubby listops

lib/operators.pod

@@ -1045,4 +1045,45 @@ This allows you to write
 
 To generate all Fibonacci numbers up to but excluding 100.
 
+=head1 List Prefix Precedence
+
+=head2 item = (list assignment)
+
+List assignment. Its exact semantics are left to the container type on the
+left-hand side. See L<Array> and L<Hash> for common cases.
+
+The distinction between item assignment and list assignment is determined by
+the parser depending on the syntax of the left-hand side.
+
+=head2 listop ...
+
+The I<yada, yada, yada> operator or I<stub> operator. If it is the only
+statement in a routine or type, it marks that routine or type as a stub
+(which is significant in the context of pre-declaring types and composing
+roles).
+
+If the C<...> statement is executed, it calls L<&fail>, with the default
+message C<stub code executed>.
+
+=head2 listop !!!
+
+If it is the only
+statement in a routine or type, it marks that routine or type as a stub
+(which is significant in the context of pre-declaring types and composing
+roles).
+
+If the C<...> statement is executed, it calls L<&die>, with the default
+message C<stub code executed>.
+
+=head2 listop ???
+
+If it is the only
+statement in a routine or type, it marks that routine or type as a stub
+(which is significant in the context of pre-declaring types and composing
+roles).
+
+If the C<...> statement is executed, it calls L<&warn>, with the default
+message C<stub code executed>.
+
+
 =end pod