[MERGE] Review feedback, making things more clear, adding documentation on what is used where.

[Robert Collins]

This improves the VersionedFiles patch by doing various identified fixes
in reviews-to-date, adding some useful comments, and documenting more of
the ideas behind and uses for the tuple namespace.

-Rob
-- 
GPG key available at: <http://www.robertcollins.net/keys.txt>.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: VersionedFiles-add_api-3378.patch
Type: text/x-patch
Size: 91585 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20080617/d903f97c/attachment-0001.bin 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20080617/d903f97c/attachment-0001.pgp