rewriting returners/__init__.py : flatten, document, pep8

This branch contains a 100% refactor of the options reading in returners/__init__.py
It's an almost finished work in progress.
Code is mostly ok, I still need to check in some doc and I need the jenkins tests to run.