comments about one bit of code spotted by @aledsage in code review