document whitespace wrangling rules around password handling
sop decrypttries and fails to use a supplied
PASSWORD, and it observes that there is trailing
UTF-8whitespace at the end of the
PASSWORD, 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.