cleanups of atom macros names and docs

in particular fix use of the word resolution which is used
in a different sense elsewhere and add sentence that
residue indexes must for a connected block
add test of failed selection
fix hierarchy tools to produce connected residue index blocks

close #708