Update comments in a couple of places.

Nothing spectacular, just trying to understand code we've written a long time ago (and providing better error messages).