Throw errors for doxygen warnings

[samfreund]

Throw errors for any warnings we find generating the C++ docs for photonlib. Also fixes some out of date docs

[samfreund]

@mcm001 we're hitting the below error since WPILIB isn't within our project. It seems like we can link it? But I'm not quite sure how, and was wondering if you knew the best way to do it. We can also just not link it.

/home/runner/work/photonvision/photonvision/photon-lib/src/main/native/include/photon/PhotonUtils.h:118: error: unable to resolve reference to 'wpi::math::Transform2d' for \ref command
/home/runner/work/photonvision/photonvision/photon-lib/src/main/native/include/photon/PhotonCamera.h:63: error: unable to resolve reference to 'NetworkTableInstance::getDefault' for \ref command
/home/runner/work/photonvision/photonvision/photon-lib/src/main/native/include/photon/PhotonUtils.h:118: error: unable to resolve reference to 'wpi::math::Transform2d' for \ref command
/home/runner/work/photonvision/photonvision/photon-lib/src/main/native/include/photon/PhotonUtils.h:118: error: unable to resolve reference to 'wpi::math::Transform2d' for \ref command