Updates API documentation for everything.

[Edward Cherlin]

On Jan 1, 2008 3:14 PM, M. Edward (Ed) Borasky <znmeb at cesmail.net> wrote:
> Edward Cherlin wrote:
> > Does anybody know of a documentation tool for Open Firmware, or for
> > FORTH more generally? Exploring using 'words' and 'see'
>
> Are you looking for automated documentation generation, or FORTH coding
> and documentation standards? I don't know about the former, but there is
> a well-established set of the latter, and given adherence, I'm sure the
> former is eminently possible.
>
> "The FORTH community" is fairly small (relative to, say, Python), and as
> a result, most FORTH programmers don't have much trouble reading the
> code of other FORTH programmers.

Reading FORTH code is easy. Knowing which code to read requires experience.

> But I don't know about outsiders coming
> to FORTH from "more traditional" languages. :)

Or no language. The children, in particular.

I have long been of the opinion that you don't understand computing
unless you have some grasp of hardware, and also of languages with
quite different models of computation. At least LISP (well, Scheme or
Logo), FORTH, Smalltalk, APL, and more conventional languages. Python
definitely; C, C++, Java, only later when you won't mistake their
design flaws and political compromises for received wisdom. Basically,
languages that follow the dictum that Einstein apparently didn't say,
but everybody thinks he should have: Everything should be made as
simple as possible, but no simpler.

We are in a good situation on the XO, and it's going to get better.

-- 
Edward Cherlin
Earth Treasury: End Poverty at a Profit
http://www.EarthTreasury.org/
"The best way to predict the future is to invent it."--Alan Kay