(Arne Babenhauserheide)
2014-05-02: srfi: don’t number rules by hand. Make them headlines. srfi: don’t number rules by hand. Make them headlines.
diff --git a/docs/srfi.org b/docs/srfi.org --- a/docs/srfi.org +++ b/docs/srfi.org @@ -233,7 +233,7 @@ The syntax shown here is the minimal syn ** More detailed: Wisp syntax rules -1. *A line without indentation is a function call*, just as if it would start with a bracket. +*** *A line without indentation is a function call*, just as if it would start with a bracket. #+BEGIN_SRC wisp display "Hello World!" ; (display "Hello World!") @@ -241,7 +241,7 @@ 1. *A line without indentation is a f -2. *A line which is more indented than the previous line is a sibling to that line*: It opens a new bracket. +*** *A line which is more indented than the previous line is a sibling to that line*: It opens a new bracket. #+BEGIN_SRC wisp display ; (display @@ -250,7 +250,7 @@ 2. *A line which is more indented tha -3. *A line which is not more indented than previous line(s) closes the brackets of all previous lines which have higher or equal indentation*. You should only reduce the indentation to indentation levels which were already used by parent lines, else the behaviour is undefined. +*** *A line which is not more indented than previous line(s) closes the brackets of all previous lines which have higher or equal indentation*. You should only reduce the indentation to indentation levels which were already used by parent lines, else the behaviour is undefined. #+BEGIN_SRC wisp display ; (display @@ -260,7 +260,7 @@ 3. *A line which is not more indented -4. *To add any of ' , ` #' #, #` or #@, to the first bracket on a line, just prefix the line with that symbol* followed by at least one space. Implementations are free to add more prefix symbols. +*** *To add any of ' , ` #' #, #` or #@, to the first bracket on a line, just prefix the line with that symbol* followed by at least one space. Implementations are free to add more prefix symbols. #+BEGIN_SRC wisp ' "Hello World!" ; '("Hello World!") @@ -268,7 +268,7 @@ 4. *To add any of ' , ` #' #, #` or # -5. *A line whose first non-whitespace characters are a dot followed by a space (". ") does not open a new bracket: it is treated as simple continuation of the first less indented previous line*. In the first line this means that this line does not start with a bracket and does not end with a bracket, just as if you had directly written it in lisp without the leading ". ". +*** *A line whose first non-whitespace characters are a dot followed by a space (". ") does not open a new bracket: it is treated as simple continuation of the first less indented previous line*. In the first line this means that this line does not start with a bracket and does not end with a bracket, just as if you had directly written it in lisp without the leading ". ". #+BEGIN_SRC wisp string-append "Hello" ; (string-append "Hello" @@ -278,7 +278,7 @@ 5. *A line whose first non-whitespace -6. *A line which contains only whitespace and a colon (":") defines an indentation level at the indentation of the colon*. It opens a bracket which gets closed by the next less-indented line. If you need to use a colon by itself. you can escape it as "\:". +*** *A line which contains only whitespace and a colon (":") defines an indentation level at the indentation of the colon*. It opens a bracket which gets closed by the next less-indented line. If you need to use a colon by itself. you can escape it as "\:". #+BEGIN_SRC wisp let ; (let @@ -289,7 +289,7 @@ 6. *A line which contains only whites -7. *A colon sourrounded by whitespace (" : ") starts a bracket which gets closed at the end of the line*. +*** *A colon sourrounded by whitespace (" : ") starts a bracket which gets closed at the end of the line*. #+BEGIN_SRC wisp define : hello who ; (define (hello who) @@ -298,7 +298,7 @@ 7. *A colon sourrounded by whitespace #+END_SRC -8. *You can replace any number of consecutive initial spaces by underscores*, as long as at least one whitespace is left between the underscores and any following character. You can escape initial underscores by prefixing the first one with \ ("\___ a" → "(___ a)"), if you have to use them as function names. +*** *You can replace any number of consecutive initial spaces by underscores*, as long as at least one whitespace is left between the underscores and any following character. You can escape initial underscores by prefixing the first one with \ ("\___ a" → "(___ a)"), if you have to use them as function names. #+BEGIN_SRC wisp define : hello who ; (define (hello who)