I pulled this merge request and added a couple comments in this area.  @michaelcahill @agorrod see if they are clear for you.