improve comments

I had hopes of relying on existing processing, but someone decided that
self.path should mean different things at different times.  It takes all
kinds.