docs for pass, xref, and url