Clean up InDetalignDBTool

Nicholas Stylesrequested to merge
nstyles/athena:dBToolCleanUp into main

As title; remove some dead code in comments, add some documentation comments, improve error messages

Merge request reports