add_xref now takes a hash instead  of a list for easy maintainance. Lots of docs and removal of old subroutines. perlcritic fixes.