[MERGE] (updated NEWS entry and record_entry_contents docstring tweaked)

[Robert Collins]

As per the bb:tweak I was give I've added a NEWS entry, and the
record_entry_contents docstring wasn't quite clear enough, so I've
tweaked it more.

-Rob
-- 
GPG key available at: <http://www.robertcollins.net/keys.txt>.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: commit-dirstate-3712.patch
Type: text/x-patch
Size: 46548 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20080924/4d27d529/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/20080924/4d27d529/attachment-0001.pgp