The reader is not documented

[veqqq]

janet-lang/janet#495 should be mentioned in https://janet-lang.org/docs/syntax.html

[sogaiu]

I think what's being referred to is mentioned in this comment:

There is also the ability to bypass the parsing mechanism and [...] just pass in a read closure.

I believe it has a bit of documentation here on the core api page:

• :read -- optional function to get the next form, called like (read env source). Overrides all parsing.

I haven't seen it in use much (I tried it out a bit once) and am not sure how robust it is.

It feels more like it's at an experimental exploration stage ATM...may be until it has been shown to be working well in some actual use cases it's better to leave it not-so-advertised?

If anyone knows of it being exercised more though, I'd be interested in seeing!