On 12/2/05, Greg Hudson <ghudson@mit.edu> wrote:
> On Fri, 2005-12-02 at 10:12 -0500, Michael Sinz wrote:
> > Now, maybe this could be "figured out" if one of the arguments is
> > within a WC and the other is within a repository.
>
> Hm.
>
> My initial reaction (having been through endless debates about the diff
> syntax in the past) was "no, no, that's too ambiguous." But apparently
> we decided to "figure that out" for the case of "svn diff url1 url2".
>
> One of the helpful factors here is that -r has no meaning if you want to
> specify an old and new, whereas -r is necessary if you're passing a URL
> in case 1 (otherwise you'd be comparing HEAD against HEAD and there'd be
> no diff).
>
> So I think it would be okay to expand "svn diff url1 url2" to encompass
> "svn diff wcpath url" and "svn diff url wcpath". My only reservation is
> that it's a little tough to explain that in "svn --help diff" without
> implying that you can "svn diff wcpath1 wcpath2" and have them compared
> against each other.
My initial response to this would be not to try to document this
behavior in the help output, just in the more detailed documentation.
This is a shortcut that is useful because people seem to expect it to
work that way. Thus, it reduces the "surprise" element that it does not
work.
(Plus, you could document it in a relatively short albeit more cryptic
form than all of the words needed to fully explain it.)
--
Michael Sinz Technology and Engineering Director/Consultant
"Starting Startups" mailto:Michael.Sinz@sinz.org
My place on the web http://www.sinz.org/Michael.Sinz
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Dec 2 19:34:40 2005