diff --git a/block-cache/block_cache.h b/block-cache/block_cache.h
index d6cd1c9..33f3fe5 100644
--- a/block-cache/block_cache.h
+++ b/block-cache/block_cache.h
@@ -266,6 +266,9 @@ namespace bcache {
 		block_list dirty_;
 		block_list clean_;
 
+		// Because the block_list type doesn't have a constant time
+		// size() method, we have to manually keep track of the list
+		// sizes (tedious and error prone).
 		unsigned nr_locked_;
 		unsigned nr_dirty_;