[cperciva]

I generally don't trust external documentation, but I do trust in-line comments.

[catwell]

You're probably wrong. Look at the comment above "stretches" here: https://github.com/binarylogic/authlogic/blob/master/lib/aut...

This is crypto-related code in of the most popular Rails authentication gems. And this is one among many examples. I'm sure you've already come across something like that more than once.

I trust code rather than comments. At least it doesn't lie.

[vijaydev]

Fixed :-) https://github.com/binarylogic/authlogic/commit/f52a699bbc9e...

[catwell]

Incorrectly, see my comment on your link. But thanks for trying :) If you want my PoV on this, the right way to fix it is delete the comment.