Author: lwall
Date: 2009-03-04 17:27:17 +0100 (Wed, 04 Mar 2009)
New Revision: 25684

[S03] deprecate TOP in favor of .parse and .parsefile
[S12] mention restriction on calling class metamethods when there isn't a class

Modified: docs/Perl6/Spec/S03-operators.pod
--- docs/Perl6/Spec/S03-operators.pod   2009-03-04 09:53:11 UTC (rev 25683)
+++ docs/Perl6/Spec/S03-operators.pod   2009-03-04 16:27:17 UTC (rev 25684)
@@ -12,9 +12,9 @@
   Maintainer: Larry Wall <>
   Date: 8 Mar 2004
-  Last Modified: 26 Feb 2009
+  Last Modified: 4 Mar 2009
   Number: 3
-  Version: 155
+  Version: 156
 =head1 Overview
@@ -3142,7 +3142,7 @@
     List Seq                    Array
     KeySet KeyBag KeyHash       Hash
     Class Enum Role             Type
-    Subst Grammar               Regex
+    Subst                       Regex
     Char Cat                    Str
     Int UInt etc.               Num
     Match                       Capture
@@ -3165,15 +3165,9 @@
 to treat the buffer as other than a sequence integers is erroneous,
 and warnings may be generously issued.
-Matching against a C<Grammar> object will call the C<TOP> method
-defined in the grammar.  The C<TOP> method may either be a rule
-itself, or may call the actual top rule automatically.  How the
-C<Grammar> determines the top rule is up to the grammar, but normal
-PerlĀ 6 grammars will default to setting top to the first rule in the
-original base grammar.  Derived grammars then inherit this idea of
-the top rule.  This may be overridden in either the base grammar or a
-derived grammar by explicitly naming a rule C<TOP>, or defining your
-own C<TOP> method to call some other rule.
+Matching against a C<Grammar> treats the grammar as a typename,
+not as a grammar.  You need to use the C<.parse> or C<.parsefile>
+methods to invoke a grammar.
 Matching against a C<Signature> does not actually bind any variables,
 but only tests to see if the signature I<could> bind.  To really bind

Modified: docs/Perl6/Spec/S12-objects.pod
--- docs/Perl6/Spec/S12-objects.pod     2009-03-04 09:53:11 UTC (rev 25683)
+++ docs/Perl6/Spec/S12-objects.pod     2009-03-04 16:27:17 UTC (rev 25684)
@@ -1604,6 +1604,9 @@
+(If you are using prototype-based OO rather than class-based, you must use
+the object form, since every such object functions as its own class.)
 Class traits may include:
     identifier  { :name<Dog> :ver<1.2.1> :auth<> } 

Reply via email to