[boost] Document python::handle behavior

To allow handle to work with various PyObject compatible types, handle relies on specializations of base_type_traits. I don't think that's mentioned in the reference docs, and leads to mysterious compile errors to the un-initiated.