#303987 by CitizenKane, jhodgdon, rdrh555: improve documentation of url() and l(), so usage of different path types and arguments is more clear