another pass at the readme (closes #1)
fix line number reporting