SERVER-3364,SERVER-5650 Move documenation of MONGO_COMPILER macros to compiler.h.

This deduplicates documentation, hopefully preventing the documentation from diverging.