I see there's a lot of embedded documentation going into the core, and 
that's a good thing. That brings up a question, though--what exactly should 
we document, and where should it be seen?

For an example, the opcode functions should *never* be used outside the 
interpreter core itself, but documenting them's still a good thing.

Maybe we need a way to tag the type of documentation for each function--the 
module it belongs to and how exposed it should be, or something.

                                        Dan

--------------------------------------"it's like this"-------------------
Dan Sugalski                          even samurai
[EMAIL PROTECTED]                         have teddy bears and even
                                      teddy bears get drunk

Reply via email to