[ruby-talk:02700] Re: The reference manual is now online

hipster <[e-mail]> writes:

> This reference is most definitely a Good Thing[tm]! Thanks a lot.
> 
> Minor suggestion: could you please include a revision number on the
> reference pages so we (and you ;) can keep track of the changes? Putting
> up a ChangeLog (or cvs log, whatever you're using) can be useful too.

The revision number is a great idea, and I'll look at adding it on the 
next upload. The changelog is more difficult -- these pages are
generated from the LaTeX source of the book (via XML and XSLT). The
book stuff is changing constantly - perhaps 5-10 checkins per day -
and to be honest we don't  have time to log every single change we
make. In a typical set of changes, we might add a target for a cross 
reference link, fix up a formatting bug or correct a typo.

However, the API descriptions themselves only change (1) when we find
a mistake or (2) when we get a fresh download of the development tree
and discover what matz has hacked^H^H^H^H^H^Hthoughfully changed. So,
once 1.5 becomes the stable 1.6 release, we're not anticipating any
changes at all for a while. At that point, we _will_ start a proper
list of changes, not just to the API but also to the language, as
we'll need it to keep the book up to date.

I don't know if that made any sense - it's early after a very late
night ;-)



Dave