route_result must be returned

[vinniefalco]

The documentation must explicitly and consistently explain that the caller of any function which returns route_result must return the value immediately.

[vinniefalco]

this is enforced by the compiler now