Comment 1 for bug 6391

Brad Bollenbach wrote:
> Public bug reported:
> https://launchpad.net/malone/bugs/6391
>
> Affects: bzr (upstream)
> Severity: Normal
> Priority: (none set)
> Status: New
>
> Description:
>>From bzr help diff:
>
> usage: bzr diff [FILE...]
> aliases: di, dif
>
> Show differences in working tree.
>
> If files are listed, only the changes in those files are listed.
> Otherwise, all changes for the tree are listed.
>
> examples:
> bzr diff
> bzr diff -r1
> bzr diff -r1..2
>
> options:
> --diff-options ARG
> --help, -h show help message
> --revision ARG, -r
>
> This help doesn't tell me, in clear and simple terms, what "bzr diff
> -r1" will tell me about revno 1. I thought I could get the diff of what
> changed only in revno 1 with "bzr diff -r1", but that command appears to
> show something else.
>
> It seemed I had to do "bzr diff -r2934..2935" to see what changed in
> revno 2935, but I should have to specify only the revno I'm interested
> in to get diff information about that revno, not the number of the revno
> before it as well.
>

The documentation does need to be updated.

bzr diff
  - Show the differences between the working tree and the last commit
bzr diff -rX
  - Show the difference between the working tree and revision 1
bzr diff -rX..Y
  - Show the difference between revision Y and revision X

I think this is a fairly common interpretation for a 'diff' command. I
agree it would be nice to have an easier way to show the changes for a
single revision. (with my changeset plugin I had, bzr cset -r 1 which
did exactly that, though it is currently bit-rotted).

John
=:->