comments can end up being very good at _hiding_ bugs
comments can end up being very good at _hiding_ bugs
Posted Sep 17, 2024 23:00 UTC (Tue) by viro (subscriber, #7872)Parent article: A discussion of Rust safety documentation
IME the combination of comment saying the right thing with opaque chunk of code being almost, but not quite matching it is one hell of a way to prime that kind of trap. And what I've seen of safety comments in Rust patches raises all kinds of red flags of that sort...
Basically, a reaction along the lines of "that looks tricky; is it even correct?" is inhibited by assertion "this is correct for <incomprehensible prose, presumably containing reasons>". And then there's https://www.tuhs.org/PUPS/Usenet/notunderstand.txt ...
Posted Sep 21, 2024 6:21 UTC (Sat)
by ralfj (subscriber, #172874)
[Link]
comments can end up being very good at _hiding_ bugs