[nodelist.c] tidy up nodelist module

tidy node_set_last_reachability, fix names of predicate functions, few
misc bug fixes and documentation updates
s/tor_addr_compare/tor_addr_eq where appropriate