py2rpm: Fix packaging of correctly installed man pages

This change handles the case when python package installs man page
to /usr/share/man/*/ (as specified by FHS).

We also package man pages as %docs from now on.

Change-Id: I8a96d2844a82765523a70e2f143d6845cf3398e9