Merge branch 'master' of github.com:perl6/doc

Author: paultcochrane

META.info

@@ -2,7 +2,7 @@
     "name"        : "p6doc",
     "version"     : "*",
     "description" : "Perl 6 documentation (tools and docs)",
-    "depends"     : [ "URI" ],
+    "depends"     : [ "URI", "File::Temp" ],
     "provides"    : {
         "Perl6::Type"                   : "lib/Perl6/Type.pm",
         "Perl6::TypeGraph"              : "lib/Perl6/TypeGraph.pm",

htmlify.p6

@@ -114,7 +114,7 @@ sub MAIN(
     $*DEBUG = $debug;
 
     say 'Creating html/ subdirectories ...';
-    for '', <type language routine images syntax> {
+    for flat '', <type language routine images syntax> {
         mkdir "html/$_" unless "html/$_".IO ~~ :e;
     }
 

lib/Language/classtut.pod

@@ -166,6 +166,17 @@ X<|traits, is rw>
 The C<is rw> trait causes the generated accessor method to return something
 external code can modify to change the value of the attribute.
 
+You can also supply default values to attributes (which works equally for
+those with and without accessors):
+
+    has Bool $.done = False;
+
+The assignment is carried out at object build time. The right-hand side is
+evaluated at that time, and can even reference earlier attributes:
+
+    has Task @!dependencies;
+    has $.ready = not @!dependencies;
+
 =head1 Static fields?
 
 Perl 6 has no B<static> keyword. Nevertheless any class may declare anything
@@ -304,6 +315,22 @@ as the bind targets for C<BUILD>'s parameters. Zero-boilerplate
 initialization! See L<objects|/language/objects#Object Construction> for
 more information.
 
+The C<BUILD> method is responsible for initializing all attributes, it must
+handle default values too:
+
+    has &!callback;
+    has @!dependencies;
+    has Bool ($.done, $.ready);
+    submethod BUILD(
+            :@!callback,
+            :@!dependencies,
+            :$!done = False,
+            :$!ready = not @!dependencies
+        ) { }
+
+See L<Object Construction|/language/objects#Object Construction> for more
+options to influence object construction and attribute initialization.
+
 =head1 Consuming our class
 
 After creating a class, you can create instances of the class.  Declaring a

lib/Language/grammars.pod

@@ -70,107 +70,12 @@ into effect for the Regex:
 
 =SUBTITLE Group of named regexes that form a formal grammar
 
-    class Grammar is Cursor { }
-
-C<Grammar> is the superclass that classes automatically get when they are
-declared with the C<grammar> keyword instead of C<class>. Grammars should
-only be used to parse text; if you wish to extract complex data, an L<action
-object|/language/grammars#Action_Objects> is recommended to be used in
+L<Grammar|/type/Grammar> is the superclass that classes automatically get when
+they are declared with the C<grammar> keyword instead of C<class>. Grammars
+should only be used to parse text; if you wish to extract complex data, an
+L<action object|/language/grammars#Action_Objects> is recommended to be used in
 conjunction with the grammar.
 
-    =begin code :allow<B L>
-    B<grammar> CSV {
-        token TOP { [ <line> \n? ]+ }
-        token line {
-            ^^            # Beginning of a line
-            <value>* % \, # Any number of <value>s with commas in between them
-            $$            # End of a line
-        }
-        token value {
-            [
-            | <-[",\n]>     # Anything not a double quote, comma or newline
-            | <quoted-text> # Or some quoted text
-            ]*              # Any number of times
-        }
-        token quoted-text {
-            \"
-            [
-            | <-["\\]> # Anything not a " or \
-            | '\"'     # Or \", an escaped quotation mark
-            ]*         # Any number of times
-            \"
-        }
-    }
-
-    say "Valid CSV file!" if CSV.L<parse>( q:to/EOCSV/ );
-        Year,Make,Model,Length
-        1997,Ford,E350,2.34
-        2000,Mercury,Cougar,2.38
-        EOCSV
-    =end code
-
-=head2 Methods
-
-=head3 method parse
-
-    method parse($str, :$rule = 'TOP', :$actions) returns Match:D
-
-Matches the grammar against C<$str>, using C<$rule> as the starting rule,
-optionally applying C<$actions> as its actions object.
-
-This will fail if the grammar does not parse the I<entire> string. If a
-parse of only a part of the string is desired, use L<subparse>.
-
-The method returns the resulting L<Match> object and also sets the caller's
-C<$/> variable to the Match object.
-
-    =begin code :allow<B>
-    say CSVB<.parse>( q:to/EOCSV/ );
-        Year,Make,Model,Length
-        1997,Ford,E350,2.34
-        2000,Mercury,Cougar,2.38
-        EOCSV
-    =end code
-
-This outputs:
-
-    ｢Year,Make,Model,Length
-    1997,Ford,E350,2.34
-    2000,Mercury,Cougar,2.38
-    ｣
-     line => ｢Year,Make,Model,Length｣
-      value => ｢Year｣
-      value => ｢Make｣
-      value => ｢Model｣
-      value => ｢Length｣
-     line => ｢1997,Ford,E350,2.34｣
-      value => ｢1997｣
-      value => ｢Ford｣
-      value => ｢E350｣
-      value => ｢2.34｣
-     line => ｢2000,Mercury,Cougar,2.38 ｣
-      value => ｢2000｣
-      value => ｢Mercury｣
-      value => ｢Cougar｣
-      value => ｢2.38 ｣
-
-=head3 method subparse
-
-    method subparse($str, :$rule = 'TOP', :$actions) returns Match:D
-
-Matches the grammar against C<$str>, using C<$rule> as the starting rule,
-optionally applying C<$actions> as its actions object.
-
-Unlike L<parse>, C<subparse> will allow the grammar to match only part of
-the supplied string.
-
-=head3 method parsefile
-
-    method parsefile(Str(Cool) $filename, *%opts) returns Match:D
-
-Parses the contents of the file C<$filename> with the L<parse> method,
-passing any named options in C<%opts>.
-
 =head1 Action Objects
 
 A successful grammar match gives you a parse tree of L<Match|/type/Match>

lib/Language/variables.pod

@@ -157,7 +157,7 @@ accessed via C<$!x> and C<$!y>. This is because in Perl 6 all attributes are
 private and can be directly accessed within the class by using
 C<$!attribute-name>. Perl 6 may automatically generate accessor methods for
 you though. For more details on objects, classes and their attributes see
-L<objects>.
+L<object orientation|/language/objects>.
 
 =head2 The C<?> Twigil
 
@@ -210,7 +210,7 @@ following is possible too:
     =end code
 
 For more details on objects, classes and their attributes and methods see
-L<objects>.
+L<object orientation|/language/objects>.
 
 =head2 The C«<» Twigil
 

lib/Type/Grammar.pod

@@ -27,7 +27,7 @@ More L<documentation on grammars|/language/grammars> is available.
 
 =head2 method parse
 
-    method parse($target, :$rule = 'TOP', Parcel :$args = (), Mu :$actions, *%opts)
+    method parse($target, :$rule = 'TOP',  Parcel :$args = (), Mu :$actions = Mu, *%opt) {
 
 Parses the C<$target> (which will be coerced to L<Str|/type/Str> if it isn't
 one), using C<$rule> as the starting rule. Additional C<$args> will be given
@@ -49,9 +49,58 @@ if you want to be able to stop in the middle.
 Returns a L<Match object|/type/Match> on success, and L<Nil|/type/Nil> on
 failure.
 
+    grammar CSV {
+        token TOP { [ <line> \n? ]+ }
+        token line {
+            ^^            # Beginning of a line
+            <value>* % \, # Any number of <value>s with commas in between them
+            $$            # End of a line
+        }
+        token value {
+            [
+            | <-[",\n]>     # Anything not a double quote, comma or newline
+            | <quoted-text> # Or some quoted text
+            ]*              # Any number of times
+        }
+        token quoted-text {
+            \"
+            [
+            | <-["\\]> # Anything not a " or \
+            | '\"'     # Or \", an escaped quotation mark
+            ]*         # Any number of times
+            \"
+        }
+    }.parse( q:to/EOCSV/ ).say;
+        Year,Make,Model,Length
+        1997,Ford,E350,2.34
+        2000,Mercury,Cougar,2.38
+        EOCSV
+
+This outputs:
+
+    ｢Year,Make,Model,Length
+    1997,Ford,E350,2.34
+    2000,Mercury,Cougar,2.38
+    ｣
+     line => ｢Year,Make,Model,Length｣
+      value => ｢Year｣
+      value => ｢Make｣
+      value => ｢Model｣
+      value => ｢Length｣
+     line => ｢1997,Ford,E350,2.34｣
+      value => ｢1997｣
+      value => ｢Ford｣
+      value => ｢E350｣
+      value => ｢2.34｣
+     line => ｢2000,Mercury,Cougar,2.38 ｣
+      value => ｢2000｣
+      value => ｢Mercury｣
+      value => ｢Cougar｣
+      value => ｢2.38 ｣
+
 =head2 method subparse
 
-    method subparse($target, :$rule = 'TOP', Parcel :$args = (), Mu :$actions, *%opts)
+    method subparse($target, :$rule = 'TOP', Parcel :$args = (),  Mu :$actions = Mu, *%opt) {
 
 Does exactly the same as L<method parse|/routine/parse>, except that cursor
 doesn't have to reach the end of the string to succeed. (That is, it doesn't
@@ -66,9 +115,9 @@ have to match the whole string).
 
 =head2 method parsefile
 
-    method parsefile(Cool $filename, *%opts);
+    method parsefile(Str(Cool) $filename, :$enc, *%opts) {
 
-Reads file C<$filename>, and parses it. All named arguments are passsed on to
+Reads file C<$filename>, and parses it. All named arguments are passed on to
 L<method parse|/routine/parse>.
 
 =end pod