[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: [PATCH] make "svn help import" explain its DWIMness better

From: Julian Foad <julianfoad_at_btopenworld.com>
Date: 2005-01-13 16:13:21 CET

Branden Robinson wrote:
> Maybe I am just brain-damaged or stupid, but I always do imports wrong, and
> have to revert them. Moreover, I do this even after reading "svn help
> import".

Same here. I agree that the behaviour is often difficult to remember and that
it needs (at least) a better description.

> + "If PATH is not a directory, it is added to the repository at URL. If "
> + "URL is a\n"
> + "directory, the basename of PATH is added to it. If URL does not "
> + "exist, the\n"
> + "basename of PATH is added to the repository with the name URL (any "
> + "parent\n"
> + "directories in the repository must already exist).\n"
> + "\n"
> + "If PATH is a directory, it is recursed into and added to the "
> + "repository at URL.\n"
> + "The basename of PATH itself is not added. If URL already exists, it "
> + "must be a\n"
> + "directory. Directory structure within PATH is created as necessary "
> + "in the repository.\n"
> + "\n"
> + "If PATH is omitted, '.' is assumed.\n"
> + "\n"
> + " Examples:\n"
> + " svn import foo.c http://www.example.com/repo/project/\n"
> + " svn import foo.c http://www.example.com/repo/project/bar.c\n"
> + " svn import ../projects/foo/ http://www.example.com/repo/project/\n"
> + " svn import http://www.example.com/repo/project/\n"),

The examples are not very useful without saying what the reult of each one is.
  For instance, in your first example, what happens if "project" does not
exist? (I don't know the answer.)

Also, I think the normal usage is to import directories, so I think that should
come first in the description and in the examples.

- Julian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Thu Jan 13 16:14:43 2005

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.