Better documentation for `createLanguage` and `lazy`

I’d like to create a parameterized parser, much like many of the built in parser combinators (eg seq or string). I was a little confused as to why I couldn’t call the parser functions I defined with createLanguage as functions (I found out they’re not functions).

It would be nice to be able to do something like:

var L = Parsimmon.createLanguage({
   oneThenAnother: function(a,b) {
       return Parsimmon.seq(a,b)
   },
   something: function() {
       return L.oneThenAnother(string("a"),string("b"))
   }
})

But it seems the only parameter that parser functions created by createLanguage get is the language namespace that I already have access to via L. So it makes me wonder, why am I using createLangauge at all? I don’t quite understand the importance of the Lazy and createLanguage functions, which would help clarify this situation: https://github.com/jneen/parsimmon/issues/202.

[wavebeem]

Ah, I see. In that case you’d need something like this:

something: function() {
  return this.whitespace().chain(() => {
       const x = withState({line: this.line, this.column})
        return P.seq(
          x.statement(),
          x.whitespace()
       )
 })
}

Since withState returns a new Language you would have to chain off of the new object.

[wavebeem]

I should probably have some time tonight to make a branch with an example of what I mean for a (optionally) stateful and consistent replacement for createLanguage.