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