periph/rtc: move struct tm note to the top

The remark is valid for the whole interface, not just `rtc_get_time`.
Merge pull request #2205 from LudwigOrtmann/periph-rtc-doc

periph/rtc: move struct tm note to the top