Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Expand docs on Parser #14

Open
skybrian opened this issue Oct 5, 2014 · 3 comments
Open

Expand docs on Parser #14

skybrian opened this issue Oct 5, 2014 · 3 comments

Comments

@skybrian
Copy link

skybrian commented Oct 5, 2014

Most of the operators and methods on Parser have cryptic comments. For example:

/// Applicative <*>
Parser operator *(Parser p) => this >> (f) => p >> (x) {
Function ff = f;
return success(ff(x));
};

I think most Dart developers will be entirely mystified by this comment. It would be more user-friendly explain what this operator does without assuming you know Haskell or have read the research papers.

@polux
Copy link
Owner

polux commented Oct 6, 2014

Sure, this comment was mainly here for myself, It's almost a private method. I know the doc sucks currently, it's my plan to do something about it someday :)

@atebitftw
Copy link

The guide you have here is a great start http://polux.github.io/parsers/. Would you completing the section on recursion when you get a chance? :)

@polux
Copy link
Owner

polux commented Oct 23, 2014

@prujohn see issue #13 .

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants