Skip to content

Commit 71eba22

Browse files
lichtkindlichtkind
committed
B nav completed
1 parent 78a2c9d commit 71eba22

File tree

1 file changed

+82
-41
lines changed

1 file changed

+82
-41
lines changed

‎docs/appendix-b-grouped.txt‎

Lines changed: 82 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -7,20 +7,35 @@
77
* [Constants](#constants)
88
* [Scope](#variable-scope): [Declarator](#variable-scope-decalarator)
99
* [Type](#variable-type): [Undefined](#variable-type-undefined), [Immutable](#variable-type-immutable), [Mutable](#variable-type-mutable), [Low Level](#variable-type-low-level), [Introspection](#variable-type-introspection)
10-
* Operators
11-
* Precedence
12-
* Associativity
13-
* Categories: Main, Regex
14-
* Meta
15-
* Unicode
16-
* Contextualizers
17-
* Junctions
18-
* Sets
19-
* Smartmatch
20-
* Files Tests
21-
* Quoting
22-
* Text
23-
* Regex
10+
* [Operators](#operators)
11+
* [Precedence](#operator-precedence)
12+
* [Associativity](#operator-associativity)
13+
* [Categories](#operators-categories): [Main](#operators-categories-main), [Regex](#operators-categories-regex)
14+
* [Meta](#operators-meta)
15+
* [Unicode](#operators-utf)
16+
* [Contextualizers](#operators-context)
17+
* [Junctions](#operators-junctions)
18+
* [Sets](#operators-sets)
19+
* [Smartmatch](#operators-smartmatch)
20+
* [Files Tests](#operators-file-test)
21+
* [Quoting](#operators-quoting)
22+
* [Text Processing](#text-processing)
23+
* [Quoting Adverbs](text-adverb)
24+
* [Regex Modifier](#text-regex-modifier)
25+
* [Metachar](#text-regex-metachar)
26+
* [Quantifier](#text-regex-quantifier)
27+
* [Control Chars](#text-control-char)
28+
* [Escape Sequences](#text-escape-seqences)
29+
* [Zero-Width Boundaries](#text-boundaries)
30+
* [Rules](#text-rules)
31+
* [Match Object Methods](#match-methods)
32+
* [Flow Control](#flow-control)
33+
* [Phaser](#flow-phaser)
34+
* [Jump Commands](#flow-jump)
35+
* [Conditionals](#flow-conditional)
36+
* [Loops](#flow-loop)
37+
* [Routine](#flow-routine): [Types](#flow-routine-type), [Modifier](#flow-routine-modifier), [Trait](#flow-routine-traits), [Parameter Trait](#flow-parameter-traits), [Signature Symbol](#flow-signature-symbols)
38+
* [Callframe Methods](#flow-callframe-methods)
2439

2540
<a id="variables"/>
2641

@@ -451,10 +466,13 @@ X list `infix:<op>($a; $b; $c)`
451466
------ ------ ------------------------------- ------------------------
452467

453468

469+
<a id="operators-categories"/>
454470

455471
[Categories](#nav-top)
456472
----------
457473

474+
<a id="operators-categories-main"/>
475+
458476
### [MAIN](#nav-top) ###
459477

460478
These are the categories of the main language
@@ -495,6 +513,7 @@ that can be used to create new categories.
495513
[`type_declarator:<subset>`](appendix-a-index#type-declarator-category)
496514
-----------------------------------------------------------------------------------------------------------
497515

516+
<a id="operators-categories-regex"/>
498517

499518
### [Regex](#nav-top) ###
500519

@@ -509,6 +528,7 @@ The default [*regex*](appendix-g-glossary#regex) language as stored in
509528
[`quantifier:sym<*>`](appendix-a-index#quantifier-category)
510529
------------------------------------------------------------------------
511530

531+
<a id="operators-meta"/>
512532

513533
[Metaoperators](#nav-top)
514534
-------------
@@ -534,7 +554,7 @@ if followed by `()`.
534554
[`Zop`](appendix-a-index#Z-metaop) [zipwith()](appendix-a-index#zipwith) like hyper, but evaluates lazy, `@result = $L[0] op $R[0], $L[1] op $R[1], ...`
535555
-------------------------------------------- ----------------------------------------- ----------------------------------------------------------
536556

537-
557+
<a id="operators-utf"/>
538558

539559
[Unicode operators](#nav-top)
540560
-----------------
@@ -550,6 +570,7 @@ signs (documented as "Texas Quotes"). [Set ops](#sets) have also UTF-variants.
550570
«» [\<\< \>\>](appendix-a-index#double-angle-brackets) [**qw**](appendix-a-index#qw-op) with [evaluation](appendix-g-glossary#evaluation) and [quote protection](appendix-g-glossary#quote-protection)
551571
--- ---------------------- ---------------------------- -----------------------------------------------
552572

573+
<a id="operators-context"/>
553574

554575
[Contextualizers](#nav-top)
555576
---------------
@@ -573,7 +594,7 @@ that forcing a [context](appendix-g-glossary#context).
573594
[`||`](appendix-a-index#pipe-pipe-context) &nbsp; flatten [capture](appendix-g-glossary#capture) object into semicolon list (positional parameter)
574595
------------------------------------------ ------------------------------- ----------------------------------------------------------------------------------------------
575596

576-
597+
<a id="operators-junctions"/>
577598

578599
[Junctions](#nav-top)
579600
---------
@@ -593,6 +614,7 @@ Junctive Infix Op Prefix Op Operation
593614
&nbsp; [none](appendix-a-index#none) [NOT](appendix-g-glossary#not) any [True](appendix-a-index#True) if none are True
594615
---------------------------------- ----------------------------- ---------------------------------- -----------------------------------------------
595616

617+
<a id="operators-sets"/>
596618

597619
[Sets](#nav-top)
598620
----
@@ -622,6 +644,7 @@ Set Op UTF CPNR Neg. CPNR Short Expl
622644
(.) ⊍ 228D &nbsp; &nbsp; b.mul Bag with elements that are in both bags but weight multiplied
623645
---------------------------------------- ----- ---- ---- ---- ----- -----------------------------------------------------
624646

647+
<a id="operators-smartmatch"/>
625648

626649
[Smartmatch](#nav-top)
627650
----------
@@ -699,6 +722,7 @@ Callable [Hash](appendix-a-index#Hash-
699722
[Any](appendix-a-index#Any-type) [Any](appendix-a-index#Any-type) scalars are identical `$_ === X`
700723
------------------------------------------- -------------------------------------------- ------------------------------------------ --------------------------------------
701724

725+
<a id="operators-file-test"/>
702726

703727
[Test Methods](#nav-top)
704728
------------
@@ -735,6 +759,7 @@ Use it as in `$filename.IO ~~ :X` or `$filename.IO.X`.
735759
[:k](appendix-a-index#k-test) Bool Path has sticky bit set
736760
----------------------------- ---- ----------------------------------------------------------
737761

762+
<a id="operators-quoting"/>
738763

739764
[Quoting Ops](#nav-top)
740765
-----------
@@ -761,13 +786,15 @@ Op Nonealphanumeric Version Tr
761786
[quasi {}](appendix-a-index#quasi) &nbsp; [Q](appendix-a-index#Q-op) [:code](appendix-a-index#code-adverb) // &nbsp; [quasiquoting](appendix-g-glossary#quasiquoting)
762787
--------------------------------- ----------------------------------------- ------------------------------------------------------------------------------------------------------------------------- ---------------------------------- ----------------------------------------------------------
763788

789+
<a id="text-processing"/>
764790

791+
# [Text Processing](#nav-top)
765792

766-
[Text Processing](#nav-top)
767-
===============
768793

769-
[Quoting Adverbs](#nav-top)
770-
---------------
794+
<a id="text-adverbs"/>
795+
796+
## [Quoting Adverbs](#nav-top)
797+
771798

772799
There are a lot more adverbs to
773800
[fine tune your quoting](tablet-2-basic-syntax#interpolation).
@@ -796,7 +823,7 @@ Short Long
796823
&nbsp; [:trans](appendix-a-index#trans-adverb) parse as [transliteration](appendix-g-glossary#transliteration)
797824
--------------------------------- ------------------------------------------------- -------------------------------------------------
798825

799-
826+
<a id="text-regex-modifier"/>
800827

801828
[Regex Modifier](#nav-top)
802829
--------------
@@ -832,6 +859,7 @@ Short Long
832859
[:P5](appendix-a-index#gP5-modifier) [:Perl5](appendix-a-index#Perl5-modifier) use the Perl 5 Regex syntax
833860
---------------------------------------- --------------------------------------------------------------------------------------------------------------------- ---------------------------------------------------------------------------------------------------------
834861

862+
<a id="text-regex-metachar"/>
835863

836864
[Regex Metacharacter](#nav-top)
837865
-------------------
@@ -857,6 +885,7 @@ Short Long
857885
[`:=`](appendix-a-index#colon-equal-op) bind the result of a match to a hypothetical variable
858886
---------------------------------------------------- ----------------------------------------------------------------------------------------------------------
859887

888+
<a id="text-regex-quantifier"/>
860889

861890
[Quantifier](#nav-top)
862891
----------
@@ -872,6 +901,7 @@ Short Long
872901
[`%%`](appendix-a-index#percent-percent-metachar) like %, but allows trailing separator
873902
------------------------------------------------------------------ -------------------------------------------------------------------------------------------
874903

904+
<a id="text-control-char"/>
875905

876906
[Control Chars](#nav-top)
877907
-------------
@@ -891,10 +921,10 @@ and thatswhy also included in the next list.
891921
`\t` TAB
892922
----- -----------------
893923

924+
<a id="text-escape-seqences">
894925

926+
## [Escape Sequences](#nav-top)
895927

896-
[Escape Sequences](#nav-top)
897-
----------------
898928

899929
To be used just inside of regexes (rx/.../, m/.../, s/.../.../ and tr/.../.../).
900930

@@ -929,6 +959,8 @@ To be used just inside of regexes (rx/.../, m/.../, s/.../.../ and tr/.../.../).
929959
[`\X[ ... ]`](appendix-a-index#backslash-X) anything but the character given in hexadecimal (brackets optional)
930960
------------------------------------------- -------------------------------------------------------------------
931961

962+
<a id="text-boundaries"/>
963+
932964
[Zero-Width Boundaries](#nav-top)
933965
---------------------
934966

@@ -941,7 +973,7 @@ To negate put a ! in front of the pipe symbol.
941973
[`<|w>`](appendix-a-index#pipe-w) word boundary aka \<wb\>
942974
--------------------------------- -------------------------------------------------------------------
943975

944-
976+
<a id="text-rules"/>
945977

946978
[Subrules](#nav-top)
947979
--------
@@ -976,6 +1008,8 @@ regex. They can have prefixes: . (dot) marks a non-capturing subrule,
9761008
[`<!>`](appendix-a-index#exclamation-subrule) always false
9771009
--------------------------------------------------------------- -------------------------------------------------
9781010

1011+
<a id="match-methods"/>
1012+
9791013
[Match Object Methods](#nav-top)
9801014
--------------------
9811015

@@ -996,11 +1030,14 @@ submatch
9961030
-------------- ----------------------------------------------
9971031

9981032

999-
[Flow Control](#nav-top)
1000-
============
1033+
<a id="flow-control"/>
1034+
1035+
# [Flow Control](#nav-top)
1036+
1037+
<a id="flow-phaser"/>
1038+
1039+
## [Closure Traits](#nav-top)
10011040

1002-
[Closure Traits](#nav-top)
1003-
--------------
10041041

10051042
aka phasers. Every block can contain special named blocks (some are
10061043
only for loops) that are started at certain times. They are traits
@@ -1031,9 +1068,9 @@ also be used within an expression as in `BEGIN my $x = 3 * 3;`.
10311068
------------------------------------------------- ------------------------------------------------------------------
10321069

10331070

1071+
<a id="flow-jump"/>
10341072

1035-
[Jump Commands](#nav-top)
1036-
-------------
1073+
## [Jump Commands](#nav-top)
10371074

10381075

10391076
----------------------------------- --------------------------------------------------------------
@@ -1048,9 +1085,9 @@ also be used within an expression as in `BEGIN my $x = 3 * 3;`.
10481085
----------------------------------- --------------------------------------------------------------
10491086

10501087

1088+
<a id="flow-conditional"/>
10511089

1052-
[Conditionals](#nav-top)
1053-
------------
1090+
## [Conditionals](#nav-top)
10541091

10551092
--------------------------------------- --------------------------------------------------------------------------------------
10561093
[if](appendix-a-index#if) when following expression evals in boolean context to True, the block that following after that will be executed
@@ -1065,9 +1102,9 @@ also be used within an expression as in `BEGIN my $x = 3 * 3;`.
10651102
[default](appendix-a-index#default) following block will be executed, when no "when" clause was executed
10661103
--------------------------------------- --------------------------------------------------------------------------------------
10671104

1105+
<a id="flow-loop"/>
10681106

1069-
[Loops](#nav-top)
1070-
-----
1107+
## [Loops](#nav-top)
10711108

10721109
--------------------------------- -----------------------------------------------------------
10731110
[loop](appendix-a-index#loop) general (endless) loop, unless used as an C-style-loop, evals following expression into void context
@@ -1078,14 +1115,14 @@ also be used within an expression as in `BEGIN my $x = 3 * 3;`.
10781115
[for](appendix-a-index#for ) evals expression into lazy list context and iterates over that list from first to last value, sets each time `$_` (can be combined with **when** as well),
10791116
--------------------------------- -----------------------------------------------------------
10801117

1118+
<a id="flow-routine"/>
10811119

1082-
1083-
[Routines](#nav-top)
1084-
--------
1120+
## [Routines](#nav-top)
10851121

10861122
routine definition: \[[scope](ap-b-lookup#scopes)\] \[modifier\]
10871123
type \[name\] \[trait\] ([signature](appendix-g-glossary#signature)) { block }
10881124

1125+
<a id="flow-routine-type"/>
10891126

10901127
### [Routine Types](#nav-top) ###
10911128

@@ -1100,7 +1137,7 @@ type \[name\] \[trait\] ([signature](appendix-g-glossary#signature)) { block }
11001137
[quasi](appendix-a-index#quasi) block that is compiled to an [AST](appendix-g-glossary#AST) at runtime
11011138
----------------------------------------- -------------------------------------------------------------------------------------------------------
11021139

1103-
1140+
<a id="flow-routine-modifier"/>
11041141

11051142
### [Routine Modifier](#nav-top) ###
11061143

@@ -1110,6 +1147,7 @@ type \[name\] \[trait\] ([signature](appendix-g-glossary#signature)) { block }
11101147
[proto](appendix-a-index#proto-routine-modifier) fallback for multi, if no multi signature matches the caller, a proto with same name is executed
11111148
------------------------------------------------ -------------------------------------------------------------------------------------------------------
11121149

1150+
<a id="flow-routine-traits"/>
11131151

11141152
### [Routine Traits](#nav-top) ###
11151153

@@ -1131,6 +1169,7 @@ type \[name\] \[trait\] ([signature](appendix-g-glossary#signature)) { block }
11311169
[assoc](appendix-a-index#assoc-routine-trait) specifies the [associativity](#operator-associativity) of an operator explicitly as seen here
11321170
----------------------------------------------------- -------------------------------------------------------------------------------------
11331171

1172+
<a id="flow-parameter-traits"/>
11341173

11351174
### [Parameter Traits](#nav-top) ###
11361175

@@ -1143,7 +1182,7 @@ type \[name\] \[trait\] ([signature](appendix-g-glossary#signature)) { block }
11431182
[parcel](appendix-a-index#parcel-parameter-trait) raw reference, will not be contextualized
11441183
------------------------------------------------------ -----------------------------------------------------------------------------
11451184

1146-
1185+
<a id="flow-signature-symbols"/>
11471186

11481187
### [Signature Symbols](#nav-top) ###
11491188

@@ -1161,8 +1200,10 @@ In routine and block definitions can be also some character with special meaning
11611200
[`^`](appendix-a-index#caret-signature) prefix of metaclass methods, `$obj.^methods();` is shortcut for [`$obj.HOW.methods($obj);`](#object-introspection)
11621201
-------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------
11631202

1164-
[Callframe Methods](#nav-top)
1165-
-----------------
1203+
<a id="flow-callframe-methods"/>
1204+
1205+
## [Callframe Methods](#nav-top)
1206+
11661207

11671208
A callframe object is generated at run-time for each call of a block of code.
11681209
If a block of code includes a [**callframe()**](appendix-a-index#callframe) call,

0 commit comments

Comments
 (0)