Well, the top part of the comment suggests that this is just an
optimization (don't bother to write out a file that you know is
unchanged), when it's actually necessary for correctness (since we don't
know if the working tree matches the old index).
Ahh, that part. Yeah, maybe we could expand/clarify it. I don't think the
comment is wrong per se, but yes, I'm sure it could be improved.
Linus