i2c: Fix documentation ifdefry

The docs should be viewable if doxygen is being run, and that
requires checking for the __DOXYGEN__ define. This should fix
the missing I2C callback, k_poll_signal, and rtio API sections
not being shown in the built documentation.

Signed-off-by: Tom Burdick <thomas.burdick@intel.com>