System:
1. Leap 42.3 KDE Desktop default install with a static IP.
2. Fully patched.
3. reboot
4. Install dovecot and let the packaging system install dependencies.
5. systemctl enable dovecot.service
6. Reboot and dovecot is happy


Here is where things break and /usr/share/doc/packages/dovecot/README.SUSE
seems to be incorrect.
1. Instructed to edit /usr/share/doc/packages/dovecot/dovecot-openssl.cnf -
Completed.
2. Instructed to run /usr/share/doc/packages/dovecot/mkcert.sh - This is
suppose to generate two files according to the README:
/etc/ssl/private/dovecot.crt
/etc/ssl/private/dovecot.pem

Instead, only the .pem is generated. I did not take the time to actually
determine if the .pem certificate was actually a self-contained entire
certificate chain.

3. Instructed to edit /etc/dovecot/dovecot.conf and set ssl_disable = no. The
actual file to edit is /etc/dovecot/conf.d/10-ssl.conf

Here are the flaws:

a) Having to edit a file in /usr/share/doc/packages/dovecot/ doesn't sound like
the best idea.

b) README.SUSE says two files (.crt and .pem) are generated when only one is
generated.

c) README.SUSE instructs to edit the incorrect configuration file and the
incorrect values:

Actual values to edit/uncomment are in /etc/dovecot/conf.d/10-ssl.conf are:
ssl = yes
ssl_cert = </etc/ssl/private/dovecot.crt
ssl_key = </etc/ssl/private/dovecot.pem

Of course you only uncomment the .crt line if you have that file.