- # Ensures that lrref() is what is actually in the archive,
- # one way or another. If there is nothing in the archive,
- # leaves lrref alone and returns 0.
+ # Ensures that lrref() is what is actually in the archive, one way
+ # or another, according to us - ie this client's
+ # appropritaely-updated archive view. Also returns the commit id.
+ # If there is nothing in the archive, leaves lrref alone and
+ # returns undef.