update comments -- things _are_ expected to compile