Updated documentation for dns_rbt_findnode to describe more what
happens with various return values, and that the chain points to the
DNSSEC predecessor for all non-error returns.

New documentation for dns_rbtnodechain_{prev,next}.

Updated documentation for other dns_rbtnodechain_*.