This documentation is for Dovecot v2.x, see wiki1 for v1.x documentation.

Why doesn't Dovecot work?

It says password mismatch

If you're using PAM:

For non-PAM set auth_debug_passwords=yes and look at what it says in the logs. If it's trying to use a wrong password scheme, you can change that. See ["Authentication/PasswordSchemes"]