added match object methods

Author: lichtkind

docs/appendix-a-index.txt

@@ -420,11 +420,11 @@ divides numbers, forces numeric context
 inside round brackets (for example `(3/7)`), gives you a
 [rational number](#Rat-type) that keeps track of its numerator and denominator
 
-<a id="slash-var"/><a id="match-var"/>
+<a id="slash-var"/><a id="match-var"/><a id="match-object"/>
 **$/** 
 *[«special var»](appendix-b-grouped.html#match-variables)* &mdash;
-last created match object of this
-*[block](appendix-g-glossary.html#block)*
+last created match object of this [*block*](appendix-g-glossary.html#block)
+with the [following methods](appendix-b-grouped.html#match-object-methods)
 
 <a id="slash-slash-op"/><a id="defined-or"/>
 **//**
@@ -3053,8 +3053,8 @@ see also: [**numerator**](#numerator) and [**denominator**](#denominator)
 Perl number (approximate "real", generally via floating point)
 
 <a id="numerator"/>
-( [--\>](#minus-minus-greater-signature) [Int](#Int-type))
 **numerator**
+( [--\>](#minus-minus-greater-signature) [Int](#Int-type))
 *[«rat method»](tablet-2-basic-syntax.html#rational-number)* &mdash;
 returns the numerator of a rational number (value type **[Rat](#Rat-type)**
 and **[FatRat](#FatRat-type)**),

docs/appendix-b-grouped.txt

@@ -55,7 +55,7 @@ Special Variables
 ### Match Variables ###
 
 -----------------------------------------------------  -----------------------------------------------------------------------------
-[`$/`](appendix-a-index.html#slash-var)                last created match object of this block
+[`$/`](appendix-a-index.html#slash-var)                last created match object of this [block](appendix-g-glossary.html#block)
 [`$<...>`](appendix-a-index.html#angle-brackets-var)   alias to named capture, see Twigils above
 [`$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
@@ -845,6 +845,20 @@ regex. They can have prefixes: . (dot) marks a non-capturing subrule,
 [`<!>`](#exclamation-subrule)                    always false
 -----------------------------------------------  -------------------------------------------------
 
+Match Object Methods
+--------------------
+
+    $/.from      # the initial match position
+    $/.to        # the final match position
+    $/.chars     # $/.to - $/.from
+    $/.orig      # the original match string
+    $/.Str       # substr($/.orig, $/.from, $/.chars)
+    $/.ast       # the abstract result associated with this node
+    $/.caps      # sequential captures
+    $/.chunks    # sequential tokenization
+    $/.prematch  # $/.orig.substr(0, $/.from)
+    $/.postmatch # $/.orig.substr($/.to)
+
 
 Flow Control
 ============