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

docs/appendix-a-index.txt

@@ -641,12 +641,15 @@ evaluation of variables like [\<\< \>\>](#double-angle-brackets),
 alias to [**qw/.../**](#qw-op) or
 [**Q**](#Q-op) **:q** [**:ww**](#ww-adverb) **/.../**
 
-<a id="angle-brackets-twigil"/><a id="angle-brackets-var"/>
-**\< \>**
-[*«twigil»*](appendix-b-grouped.html#twigils) &mdash;
-[circumfix](#circumfix-category)
-[*twigil*](appendix-g-glossary.html#twigil) of named captures, **`$<...>`**
-is alias to [**`$/<...>`**](#match-var), in Perl 5: *$&* and *$MATCH*
+<a id="postcircumfix-angle-brackets-op"/><a id="slice-op"/>
+<span class="you-provide">var</span>**\[ \]** &mdash;
+[*postcircumfix*](#postcircumfix-category)
+[*operator*](appendix-g-glossary.html#operator) 
+appended on a [*hash*](appendix-g-glossary.html#hash)
+[*var*](appendix-g-glossary.html#variable)(no more spaces in between allowed),
+returns a slice [*slice*](appendix-g-glossary.html#slice) with values which
+keys was inside the brackets &mdash;
+example: `%h = {a=>1, b=>2, c=>3}; say %h<c a>` returns '3 1'
 
 <a id="angle-brackets-metachar"/>
 **\< \>**
@@ -656,6 +659,8 @@ if it doesn't start wit a **.**, **?** or **!** findings will stored under the
 name of the subrule as [*named capures*](appendix-g-glossary.html#named-capure)
 into [`$/<name>`](#match-var) and [`$<name>`](#angle-brackets-var)
 
+# [=](#nav-top)
+
 <a id="equal"/><a id="equal-op"/>
 [**=**](tablet-3-variables#assignment)
 *«Op»* &mdash;
@@ -891,7 +896,7 @@ see also: [**|**](#pipe-escape)
 [*«junctive op»*](appendix-b-grouped.html#junctions) &mdash;
 [*infix*](#infix-category) [*junctive*](appendix-g-glossary.html#junction)
 [*XOR*](appendix-g-glossary.html#xor),
-requires that exactly one of both operands is [**True**](#True) in 
+requires that exactly one of operands is [**True**](#True) in 
 [*bool context*](appendix-g-glossary.html#bool-context) to return **True** &mdash;
 see also [**one**](#one)
 
@@ -5115,4 +5120,4 @@ example: `@a Z @b = (@a; @b).zip`
 alias method to [**Z** *«metaop»*](#Z-metaop) &mdash;
 example: `@a Z~ @b` aka `(@a; @b).zipwith(&[~])` aka `(@a; @b).zip.lol.map { .reduce(&[~]) }`
 
-***
+***

docs/appendix-b-grouped.txt

@@ -38,7 +38,6 @@ Twigil is short for secondary sigil. They follow after a primary sigil and mark
 [`$*foo`](appendix-a-index.html#asterisk-twigil)         contextualizable global variable
 [`$?foo`](appendix-a-index.html#question-twigil)         compiler hint variable
 [`$=foo`](appendix-a-index.html#equal-twigil)            pod variable
-[`$<foo>`](appendix-a-index.html#angle-brackets-twigil)  match variable, short for `$/<foo>` or even `$/{'foo'}`
 [`$~foo`](appendix-a-index.html#tilde-twigil)            the foo sublanguage seen by the parser at this lexical spot
 -------------------------------------------------------  ------------------------------------------------------------
 
@@ -56,7 +55,7 @@ Special Variables
 
 -----------------------------------------------------  ------------------------------------------------------------------------------------
 [`$/`](appendix-a-index.html#slash-var)                last created match object of this [scope](appendix-g-glossary.html#scope) with [these methods](#match-object-methods)
-[`$<...>`](appendix-a-index.html#angle-brackets-var)   alias to named capture, see Twigils above
+[`$<...>`](appendix-a-index.html#angle-brackets-var)   alias to named capture, i.e., $/<...> or $/{'...'}
 [`$0 ...`](appendix-a-index.html#0-var)                alias to positional capture, like in P5 - `$1 .. $9` but doesn't stop at `$9`
 [`@()`](appendix-a-index.html#round-brackets-var)      array that holds $0 .. $9 and rest and positional submatches
 -----------------------------------------------------  ------------------------------------------------------------------------------------

docs/index.txt

@@ -3,9 +3,10 @@
 These are the Perl 6 Tablets, a comprehensive manual, aiming to support
 many different ways of learning. The content is nicely sorted and
 indexed and many links allow you to follow your interest freely. For a
-lightweight introduction, try [my Perl 6 Tutorial](#) or the Book
-[Using Perl
-6](http://www.perlfoundation.org/perl6/index.cgi?perl_6_tutorial) or
+lightweight introduction, try
+[the Perl 6 Tutorial written by Herbert Breunung](http://www.perlfoundation.org/perl6/index.cgi?perl_6_tutorial)
+or the community Book [Using Perl
+6](https://github.com/perl6/book) or
 [Learning Perl 6](http://www.learningperl6.com/Chapters/). If that is
 too easy, read [the specs](http://perlcabal.org/syn/).
 
@@ -79,4 +80,4 @@ Tablets 1-4 have some substance, but most complete are Appendices A, B, D, G, H.
 (complicated words explained)
 
 [Appendix H: Href](appendix-h-href.html)
-(links to other resources)
+(links to other resources)

docs/report.pl

@@ -1,6 +1,7 @@
 #!/usr/bin/perl
 use strict;
 use warnings;
+use autodie;
 use v5.10;
 
 my (%file, %data, %sum, $FH, $content, @fn_parts);
@@ -20,7 +21,7 @@
 	next unless @fn_parts > 1;
 	$file{ ucfirst ($fn_parts[0]) . '-' . uc($fn_parts[1]) } = $md_file;
 }
-
+die "No .txt file found. Are you in the docs/ directory?\n" if not %file;
 
 # and sniff through them
 print "$head \n", '-' x length $head,"\n";
@@ -54,4 +55,4 @@
 	open $FH, '<', 'appendix-g-glossary.txt';
 	$content = do {local $/; <$FH>};
 	$nr =()= $content =~ /\&mdash;\n\n|&mdash; /g;
-	print " empty glossary terms: $nr\n";
+	print " empty glossary terms: $nr\n";