doc: periph: various fixes and cleanup

- unify file/module @brief
- distinct @file section more visibly in source
- provide missing @brief's
- move module details/notes from file to module sections
- provide missing macro definition for building
Merge pull request #2132 from LudwigOrtmann/doxygen-periph

doc: periph: various fixes and cleanup