[IMPROV] Made multiple files pep257 compatible

Those files usually only needed a few changes (<= 3) to be
compatible. Made some epydoc compatible.

There was also a small error in the description of the rotating
file handler. The condition for one of the options was identical
for a completely different procedure.

Change-Id: I60417587c65711974f5a3ef3096cf6faa005cb2e