[#3006] mismatched quotation — "stevan apter" <apter@...>

ruby documentation uses a punctuation convention i've never seen

13 messages 2000/05/27

[ruby-talk:02933] What to document?

From: Dave Thomas <Dave@...>
Date: 2000-05-22 21:30:07 UTC
List: ruby-talk #2933
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

In This Thread

Prev Next