documentation updated; interface updated with prototypes for missing
(not-yet-implemented) routes