one more example of unclear terminology in SVN book

on p. 23 (PDF version), section "Initial Checkout", here's a perfect
example of vague terminology:

"Most of the time, you will start using a Subversion repository by
doing a checkout of your project. Checking out a repository creates a
copy of it on your local machine. This copy contains the HEAD (latest
revision) of the Subversion repository that you specify on the command
line:

  $ svn checkout http://svn.collab.net/repos/svn/trunk"

  in the space of just a few lines, there are at least two thoroughly
confusing uses of terminology.

  first, are we doing a "checkout of your project" or are we "Checking
out a repository"? does a repo contain one project, or possibly
multiple projects?

  and as for the actual checkout command:

  $ svn checkout http://svn.collab.net/repos/svn/trunk

what part of that URL represents the "repository" itself? the text
clearly refers to the "Subversion repository that you specify on the
command line". but from earlier, one would have concluded that the
repo is represented by just "http://svn.collab.net/repos". after all,
that was the argument to the "svnadmin create" command.

  but now, it appears to be "http://svn.collab.net/repos/svn/trunk".
so which one represents the repository? and which one the project?
or what?

rday

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Sun Dec 19 18:20:14 2004