document route returns

Signed-off-by: Adam Stokes <adam.stokes@ubuntu.com>