break on codebook and minor correction to readme