[Book] Comment & suggestion

Hello Subversion book authors,

here are some comments & suggestions for the book by a subversion
newbie.

At the end of Chapter 1, there is a nice 'Quick start' section. In
short, it gives the following example:

   $ svnadmin create /path/to/repos

   /tmp/project/branches
   /tmp/project/tags
   /tmp/project/trunk
   /tmp/project/trunk/foo.c

   $ svn import /tmp/project file:///path/to/repos -m "initial import"
   Adding /tmp/project/trunk
   Adding /tmp/project/branches
   Adding /tmp/project/tags

   $ svn checkout file:///path/to/repos/trunk project
   A project/foo.c
   ...

So far, so good. Now, as a naive reader assuming that a repository is
a storage for multiple projects, I though it would be nice to add a
second project. So I set up a second tree like this ...

   /tmp/project2/branches
   /tmp/project2/tags
   /tmp/project2/trunk

... and tried to import, but all of a sudden ...

    $ svn import /tmp/project2 file:///path/to/repos -m "initial import"
    svn: File already exists: filesystem '/path/to/repos/db',
    transaction '2', path 'trunk'

Oops!

Thus, I believe it would be a better idea to change the example to
something like

   /tmp/project/branches
   /tmp/project/tags
   /tmp/project/trunk
   /tmp/project/trunk/foo.c

   /tmp/project2/branches
   /tmp/project2/tags
   /tmp/project2/trunk
   /tmp/project/trunk/bar.c

   $ svnadmin create /path/to/repos
   $ svn import /tmp/project file:///path/to/repos/project -m "initial import"
   Adding /tmp/project/trunk
   Adding /tmp/project/branches
   Adding /tmp/project/tags

   Committed revision 1.
   $ svn import /tmp/project2 file:///path/to/repos/project2 -m "initial import"
   Adding /tmp/project2/trunk
   Adding /tmp/project2/branches
   Adding /tmp/project2/tags

   Committed revision 2.
   $ svn checkout file:///path/to/repos/project/trunk project
   A project/foo.c

   $ svn checkout file:///path/to/repos/project2/trunk project2
   A project2/bar.c

unless you insist on having exactly one repository for each project.
At least a hint should be present, that the first method cannot deal
with multiple projects.

Best regards,

Guido

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Thu Aug 12 23:44:16 2004