add docs for uri_new, warn on unused result.
doc: use <p> for uri examples.