Re: Really a reserved checkout?

[Brandon Craig Rhodes]

Donald Sharp <address@hidden> writes:

> The cvs documentation is obtuse and hard to read.

It might be more useful to say that the documentation is designed as a
reference - it will tell you everything there is to know about one
aspect of CVS, then progress to another.  This is useful if you
already know how CVS works, but far less tractable a resource to
actually learn CVS from.

The same problem occurs with man pages on Unix; trying to learn Perl
programming or shell scripting from their man pages, for example, is
generally not possible without expending lots of imagination and time.

The Python project solves this by having a wonderful and thorough
Tutoral, as well as guides for different programming topics, that
supplement the pure reference material in the Library Reference and
Language Reference.  The references are very useful once you know
Python but it is really the Tutorial that gets you there.

-- 
Brandon Craig Rhodes                         http://www.rhodesmill.org/brandon
Georgia Tech                                            address@hidden