document whitespace wrangling rules around password handling
@anarcat writes:
If
sop decrypt
tries and fails to use a suppliedPASSWORD
, and it observes that there is trailingUTF-8
whitespace at the end of thePASSWORD
, it will retry with the trailing whitespace stripped.Explain why we do magic things with whitespace. Consider not doing magic at all as magic can be evil.
I expect the following use case to be common:
echo correct horse battery staple > password.txt
sop decrypt --with-password=password.txt < ciphertext > cleartext
If we don't strip whitespace, it will fail.
perhaps we need a (sub-sub)section explaining the rationale here.