Fix some comments

Fix some comments:
 * typos,
 * documented empty blocks,
 * shortened some {@link}s,
 * converted some multi-line comments to single-line/javadocs.