drivers/rtc: mark as legacy

* rename interface
* add `@note` saying it's deprecated
* also: fix missing `@author` and `@file`