From: Dave Thomas <Dave@...>
Date: 2000-05-22T16:30:07-05:00
Subject: [ruby-talk:02933] What to document?


OK folks, the book is getting down to the wire, and we're running into 
a page-count crunch. Basically, we've already blown past our initial
page estimate by a hundred pages, and we're desperately trying to stop
it becoming 200 pages over.

We're getting close, though. One of the few things left is deciding
what things in /ext to document. The problem is, they're all
HUGE. Doing tcltk or socket justice would take at least 50 pages,
probably more.

So, my questions:

1. Do we need to document them?
2. If so, which ones?
3. Can we get away with just showing function signatures and listing
   constants?

All ideas very gratefully received.


Dave