Commit 805755f49b0db5bc884f8929621ac61238b2c30e

Russell Belfer 2013-08-22T15:44:34

Fix sortedcache docs and other feedback This converts an internal lock from a write lock to a read lock where write isn't needed, and also clarifies some doc things about where various locks are acquired and how various APIs are intended to be used.