From 30aadb44dcbab33e70d09497533e0a0f8cb3706a Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Fri, 29 Dec 2006 02:17:07 +0000
Subject: [PATCH] Add some docs for the blockers cache format.

svn path=/main/trunk/; revision=5412
---
 bin/emerge | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/bin/emerge b/bin/emerge
index 9a3819505..92832317e 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:
-- 
2.26.2