Skip to content
This repository
Browse code

tidy appendix b

  • Loading branch information...
commit acbaea6556a3f274e154d599b6cef0f92e05cf6b 1 parent afcb9bc
Herbert Breunung authored April 20, 2012

Showing 1 changed file with 22 additions and 53 deletions. Show diff stats Hide diff stats

  1. 75  docs/appendix-b-grouped.txt
75  docs/appendix-b-grouped.txt
@@ -8,8 +8,8 @@ Sigils
8 8
 ------
9 9
 
10 10
 All variables in Perl begin with a sigil. They mark the 3 primary var
11  
-types. The 4th sigil is for callables (routines) and the 5th is for
12  
-layers (namespaces) that organize the previous 4.
  11
+types. The 4th sigil is for callables ([routines](appendix-g-glossary.html#routine))
  12
+and the 5th is for layers (namespaces) that organize the previous 4.
13 13
 
14 14
 ------------------------------------------------  --------------------------------------------------------------------------------------------------------
15 15
 [`$`](appendix-a-index.html#dollar-sigil)         scalar, single value, can be of any data type
@@ -20,8 +20,8 @@ layers (namespaces) that organize the previous 4.
20 20
 ------------------------------------------------  --------------------------------------------------------------------------------------------------------
21 21
 
22 22
 The first 4 can also be used as prefix operators, called
23  
-contextualizers, that force different contexts, but there are much
24  
-more different contexts then 4.
  23
+[contextualizers](#Contextualizers), that force different contexts,
  24
+but there are much more different contexts then 4.
25 25
 
26 26
 Twigils
27 27
 -------
@@ -964,17 +964,11 @@ type \[name\] \[trait\] (signature) { block }
964 964
 
965 965
 ### Routine Modifier ###
966 966
 
967  
--------------------------------------------------------  ---------------------------------------------------
968  
-[multi](appendix-a-index.html#multi-routine-modifier)    marks routines, witch can have siblings with same
969  
-                                                         name but different signature; when called, the
970  
-                                                         one with matching sig is executed
971  
-
972  
-[only](appendix-a-index.html#only-routine-modifier)      routines which dont' allow to have an multi
973  
-                                                         sibling (is default, you may leave it out)
974  
-
975  
-[proto](appendix-a-index.html#proto-routine-modifier)    fallback for multi, if no multi signature matches
976  
-                                                         the caller, a proto with same name is executed
977  
--------------------------------------------------------  ---------------------------------------------------
  967
+-----------------------------------------------------  ---------------------------------------------------
  968
+[multi](appendix-a-index.html#multi-routine-modifier)  marks routines, witch can have siblings with same name but different signature; when called, the one with matching sig is executed
  969
+[only](appendix-a-index.html#only-routine-modifier)    routines which dont' allow to have an multi sibling (is default, you may leave it out)
  970
+[proto](appendix-a-index.html#proto-routine-modifier)  fallback for multi, if no multi signature matches the caller, a proto with same name is executed
  971
+-----------------------------------------------------  ---------------------------------------------------
978 972
 
979 973
 
980 974
 ### Routine Traits ###
@@ -984,32 +978,17 @@ routine traits.
984 978
 
985 979
 ----------------------------------------------------------  -------------------------------------------------------------------------------------
986 980
 [export](appendix-a-index.html#export-routine-trait)        this routine will be exported my the current module by default
987  
-
988  
-[will do](appendix-a-index.html#will-do-routine-trait)      block of code executed when the subroutine is called.
989  
-                                                            Normally declared implicitly, by providing a block after
990  
-                                                            the subroutine's signature definition
991  
-
992  
-[signature](appendix-a-index.html#signature-routine-trait)  signature of a subroutine. Normally declared implicitly,
993  
-                                                            by providing a parameter list and/or return type
994  
-
  981
+[will do](appendix-a-index.html#will-do-routine-trait)      block of code executed when the subroutine is called. Normally declared implicitly, by providing a block after the subroutine's signature definition
  982
+[signature](appendix-a-index.html#signature-routine-trait)  signature of a subroutine. Normally declared implicitly, by providing a parameter list and/or return type
995 983
 [as](appendix-a-index.html#as-routine-trait)                inner type constraint that a routine imposes on its return value
996  
-
997 984
 [of](appendix-a-index.html#of-routine-trait)                official return type of the routine
998  
-
999 985
 [cached](appendix-a-index.html#cached-routine-trait)        marks a subroutine as being memoized
1000  
-
1001 986
 [rw](appendix-a-index.html#rw-routine-trait)                marks a subroutine as returning an lvalue
1002  
-
1003 987
 [parsed](appendix-a-index.html#parsed-routine-trait)        macro is parsed once, is hygienic, only parsed can be used
1004  
-
1005 988
 [reparsed](appendix-a-index.html#reparsed-routine-trait)    macro parsed twice, not hygienic, later parsed can be used
1006  
-
1007 989
 [tighter](appendix-a-index.html#tighter-routine-trait)      specifies the precedence of an operator higher than an existing operator as seen here
1008  
-
1009 990
 [looser](appendix-a-index.html#looser-routine-trait)        specifies the precedence of an operator lower than an existing operator as seen here
1010  
-
1011 991
 [equiv](appendix-a-index.html#equiv-routine-trait)          specifies the precedence of an operator same as an existing operator as seen here
1012  
-
1013 992
 [assoc](appendix-a-index.html#assoc-routine-trait)          specifies the associativity of an operator explicitly as seen here
1014 993
 ----------------------------------------------------------  -------------------------------------------------------------------------------------
1015 994
 
@@ -1031,27 +1010,17 @@ routine traits.
1031 1010
 
1032 1011
 In routine and block definitions can be also some character with special meaning
1033 1012
 
1034  
-------------------------------------------------------------  -----------------------------------------------------------------------
1035  
-[`!`](appendix-a-index.html#exclamation-mark-signature)       suffix of required parameter (default when named, not positional)
1036  
-
1037  
-[`*`](appendix-a-index.html#asterisk-signature)               prefix of slurpy arrays
1038  
-
1039  
-`-->`                                                         [prefix of return type](appendix-a-index.html#minus-minus-greater-signature)
1040  
-                                                              (couldn't link the arrow due wiki syntax)
1041  
-
1042  
-[`->`](appendix-a-index.html#minus-greater-signature)         prefix of named readonly parameters for a block (pointy block syntax)
1043  
-
1044  
-[`:`](appendix-a-index.html#colon-signature)                  prefix of named parameter, positional when without
1045  
-
1046  
-[`::`](appendix-a-index.html#double-colon-signature)          prefix of a variable type introduced in a signature
1047  
-
1048  
-[`<->`](appendix-a-index.html#lower-minus-greater-signature)  prefix of named writeable parameters for a block (double pointy block syntax)
1049  
-
1050  
-[`?`](appendix-a-index.html#question-mark-signature)          suffix of optional parameter (default when positional, not named)
1051  
-
1052  
-[`^`](appendix-a-index.html#caret-signature)                  prefix of metaclass methods, `$obj.^methods();` is shortcut for
1053  
-                                                              [`$obj.HOW.methods($obj);`](ap-b-lookup.html#object-introspection)
1054  
-------------------------------------------------------------  -----------------------------------------------------------------------
  1013
+-------------------------------------------------------------  ------------------------------------------------------------------------------------------------------------------
  1014
+[`!`](appendix-a-index.html#exclamation-mark-signature)        suffix of required parameter (default when named, not positional)
  1015
+[`*`](appendix-a-index.html#asterisk-signature)                prefix of slurpy arrays
  1016
+[`-->`](appendix-a-index.html#double-minus-greater-signature)  prefix of return type
  1017
+[`->`](appendix-a-index.html#minus-greater-signature)          prefix of named readonly parameters for a block (pointy block syntax)
  1018
+[`:`](appendix-a-index.html#colon-signature)                   prefix of named parameter, positional when without
  1019
+[`::`](appendix-a-index.html#double-colon-signature)           prefix of a variable type introduced in a signature
  1020
+[`<->`](appendix-a-index.html#lower-minus-greater-signature)   prefix of named writeable parameters for a block (double pointy block syntax)
  1021
+[`?`](appendix-a-index.html#question-mark-signature)           suffix of optional parameter (default when positional, not named)
  1022
+[`^`](appendix-a-index.html#caret-signature)                   prefix of metaclass methods, `$obj.^methods();` is shortcut for [`$obj.HOW.methods($obj);`](#object-introspection)
  1023
+-------------------------------------------------------------  ------------------------------------------------------------------------------------------------------------------
1055 1024
 
1056 1025
 ### Callframe Methods ###
1057 1026
 

0 notes on commit acbaea6

Please sign in to comment.
Something went wrong with that request. Please try again.