Add some docs for the blockers cache format.

svn path=/main/trunk/; revision=5412

1 files changed, 9 insertions, 1 deletions

diff --git a/bin/emerge b/bin/emerge
index 9a381950..92832317 100755
--- a/bin/emerge
+++ b/bin/emerge
@@ -865,7 +865,15 @@ class BlockerCache(DictMixin):
 		Currently, the cache is only written if the user has superuser
 		privileges (since that's required to obtain a lock), but all users
 		have read access and benefit from faster blocker lookups (as long as
-		the entire cache is still valid)."""
+		the entire cache is still valid).  The cache is stored as a pickled
+		dict object with the following format:
+
+		{
+			version : "1",
+			"blockers" : {cpv1:(counter,(atom1, atom2...)), cpv2...},
+			"virtuals" : vardb.settings.getvirtuals()
+		}
+		"""
 		if self._modified and \
 			secpass >= 2:
 			try: