It mainly confuses things when you are searching for code.

I also removed a few instances of 'well, this would be nice, but is
not possible' and 'this code is obviously broken because X' etc.

We do, after all, have a revision control system. With history. :)