fix doxygen warning
fix compilation warning
suppress compilation warning
suppress compilation warning
provide backwards compatibility residue_indexes support in Selection

and patch doc.

close #409, close #407