a little more documentation
lots of updates to identification routines