Restoring history of a "bzr remove"d file

[Eli Zaretskii]

> Date: Sun, 6 Feb 2011 04:56:40 -0600
> From: "Matthew D. Fuller" <fullermd at over-yonder.net>
> Cc: bazaar at lists.canonical.com
> 
> revert is The Way to resurrect old files, just by revert'ing them to
> revs where they existed.

That part is clear, thanks.  However, what exactly "revert a file"
means is not clearly defined anywhere (AFAIK), and that is what makes
it hard (for me) to reason about the exact effect of "bzr revert".

It is clear that the file's contents and execute bit are restored.
It is now clear, thanks to you, that the file-id is also restored.

It is less clear what exactly happens with the file's history records.
The confusion (probably mine alone) happens because the current
revision of the tree is not rewound by "revert"; the tree as a whole
is still at its last revision.  So the history information is largely
unaltered, but somehow the history of this one file _is_, because I
can again "bzr annotate" it.  (Previously, I thought the history was
not altered at all, but now I realize I was wrong).