Arc Forumnew | comments | leaders | submitlogin
In case anyone finds first impressions interesting
2 points by metamemetics 5450 days ago | 1 comment
Completely new to lisp and arc. Since I have used python for the last few projects, the first thing I tried to do was figure out if there was a builtin "help" operator that maps all the other builtin operators to docstrings. So I could learn the language from the terminal without having to look for separate documentation on the web. Like the help() built-in function in python.

Ex. (help +) or (? +). Maybe (help car) or (? car) evaluates to "returns the first element of a list". Maybe (? nil) returns a list of all scoped procedures, so you know what to investigate.

Also, if I create procedures I want to distribute and others to reuse, I would want to use the same built-in help operator to comment my docstrings in the same manner as the core. So bots and humans already know the exact heuristic to use for mining how-to info.



2 points by fallintothis 5449 days ago | link

http://github.com/nex3/arc/blob/master/help/arc.arc is from Anarki, a community-maintained branch of "vanilla" Arc. They wrote such a help function, but there are also other extensions and differences that are reflected in said help.

If you're new to Lisp, http://ycombinator.com/arc/tut.txt isn't a bad start. But there are countless Lisp tutorials out there.

As for online documentation: http://files.arcfn.com/doc/ + http://www.arcfn.com/2009/06/whats-new-in-arc3.html; see also http://arclanguage.org/item?id=12228, wherein I technically have another suggestion for learning Arc without the web ;).

-----