Rename, test, fix, and document the LL(1) parser combinator library (#…

…1063)

std/text/basic-parsers => std/parser/ll1

doc/.vuepress/config.js

@@ -143,6 +143,14 @@ module.exports = {
                         ]
                       },
 
+                      { title: "Text Parser Libraries",
+                        path: "/reference/std/parser/",
+                        children: [
+                            "parser/",
+                            "parser/ll1"
+                        ]
+                      },
+
                       { title: "Text Encoding and Decoding Libraries",
                         path: "/reference/std/text/",
                         children: [

doc/reference/std/misc/decimal.md

@@ -54,14 +54,30 @@ i.e. a rational number that is not a floating-point number.
    exponent-allowed: (exponent-allowed_ #f)) -> decimal
 ```
 
-`parse-decimal` expects and parses a decimal number on an `input`,
+`parse-decimal` parses a decimal number on a `input`
 with the options specifed via keyword arguments.
 
-The `input` will be cast to a `BufferedStringReader` using
+The `input` can be a string, input port, BufferedStringReader, StringReader, or Reader,
+and will be cast to a `BufferedStringReader` using
 [`open-buffered-string-reader`](../stdio.md#open-buffered-string-reader).
 `parse-decimal` will then side-effect this reader as it parses,
 and finally return the decimal number,
-or raises a `parse-error` (from `:std/parser/base`).
+or raise a `parse-error` (from `:std/parser/base`).
+
+The options are as for `ll1-decimal` below.
+
+## ll1-decimal
+```scheme
+(ll1-decimal
+   reader
+   sign-allowed?: (sign-allowed? #t)
+   decimal-mark: (decimal-mark #\.)
+   group-separator: (group-separator_ #f)
+   exponent-allowed: (exponent-allowed_ #f)) -> decimal
+```
+`parse-decimal` parses a decimal number from a `reader` object
+that satisfies the `PeekableStringReader` interface,
+with the options specifed via keyword arguments.
 
 The keyword arguments `decimal-mark` and `group-separator` are each a character or false,
 and specify optional allowed decimal mark and group separator characters,
@@ -87,7 +103,7 @@ before and/or after calling `parse-decimal`.
 
 `: PeekableStringReader sign-allowed?:Bool decimal-mark:Char group-separator:(Or Char Bool) exponent-allowed:(or Bool String) -> Decimal`
 
-You may use utilities from [:std/text/basic-parsers](../text/basic-parsers.md)
+You may use utilities from [:std/parser/ll1](../parser/ll1.md)
 to parse decimals as part of something bigger, or just use `string->decimal` below.
 
 ## string->decimal

doc/reference/std/parser/README.md

@@ -0,0 +1,7 @@
+# The Parser Library
+
+Gerbil comes with a variety of tools for parsing.
+For the main parser interface see [std/parser](../parser).
+
+But for the most simple parsing needs, you may want to use our
+LL(1) parser library [std/parser/ll1](ll1).