CXX-919 Fix doxygen deprecation markers for BSON types

Several types had doxygen warning markers that didn't need it.  Some had
warning markers that needed to be changed to deprecation markers.  And
one type (Symbol) had the wrong documentation title.