On Wednesday 10 Feb 2016 11:39:25 David Sterba wrote:

The explanations and the table would be good in the changelog and as
comments. I think we'll need to consider the smaller blocks more often
so some examples and locking rules would be useful, eg. documented in
this file.

David, I agree.  As suggested, I will add the documentation to the commit
message and as comments in the code.

-- 
chandan