improving documentation

explain semicolons with an inline comment for anybody who actually
looks at the code so they don’t think I’m crazy