documentation to block.cc