doc: make peripheral interfaces modules

also remove `@file` parameters
Merge pull request #1875 from LudwigOrtmann/doxygen-periph-modules

doc: make peripheral interfaces modules
core: refactor sched_run

`sched_run()` was cluttered. Many individual changes were done without a
proper refactoring.
tests: use -DSCHEDSTATISTICS in tests/shell