Jim Blandy <jimb@red-bean.com> writes:
> Ben Collins-Sussman <sussman@collab.net> writes:
> > Yes, it's in the status output, already cached in the entries file.
> >
> > Try 'svn st -v', and 'svn help st'.
>
> Okay, this works because when I see something like this:
>
> zenia:subversion$ svn status -v CHANGES
> _ 2711 2667 kfogel CHANGES
>
> the second number is guaranteed to be no greater than the first
> number. Thus the recent fix to the docs.
Right.
> However, in your conversation with Alexis Huxley, you pondered the
> possibility of changing this so that the second number might be
> greater than the first, if you passed `svn status' the `-u' flag, to
> allow it to consult the repository and see the latest revision.
>
> I understand that was just idle discussion, but if it does happen, I'd
> like to request that there remain *some* way to find the most recent
> change that produced the text the user has in hand. Running `svn
> status -u' really shouldn't drop that older number in favor of the
> newer number.
OK, then maybe put a 'future' rev number next to the asterisk, or
something, should we decide to implement this feature.
>
> > Alternately, 'svn diff -rPREV' will show you the last change to the
> > file. :-)
>
> The `-rPREV' part should appear in the `diff' command's help,
> shouldn't it?
Yeah. I guess so. It's fully documented in the Handbook (nudge,
nudge...), but it sort of begs the general question: how much
information is in the handbook, and how much can be built into 'svn
help'?
I mean, it already seems like pretty extreme to me that 'svn help
propset' now documents *every* special svn:property. What if we add
new svn: props? Are we going to remember to keep the Handbook and
help text in sync?
I'm of the opinion that the built-in help should document syntax, and
be changed when syntax changes. But the existence of special props,
or special revision names... that kind of stuff can change all the
time. That's Handbook material.
The Handbook covers a wide array of topics: Modules, Vendor branches,
special props and revision names... things we could never fit into the
help system. I'd rather the help system give a pointer to the
Handbook.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Jul 26 20:08:48 2002