resolves #172 cleans up the block summary in the user manual