Document the semantics of the new radio API
Merge pull request #2 from g-oikonomou/radio-extended-api

Document the semantics of the new radio API