Math: doc++

src/Math/DualQuaternion.h

@@ -218,7 +218,7 @@ template<class T> class DualQuaternion: public Dual<Quaternion<T>> {
          * Expects that the dual quaternion is normalized. @f[
          *      v' = qv \overline{\hat q^*} = q ([\boldsymbol 0, 1] + \epsilon [\boldsymbol v, 0]) \overline{\hat q^*}
          * @f]
-         * @see Matrix4::transformPoint(), Quaternion::rotateVectorNormalized()
+         * @see DualQuaternion(const Vector3&), Matrix4::transformPoint(), Quaternion::rotateVectorNormalized()
          */
         inline Vector3<T> transformPointNormalized(const Vector3<T>& vector) const {
             CORRADE_ASSERT(MathTypeTraits<Dual<T>>::equals(norm(), Dual<T>(1)),

src/Math/Quaternion.h

@@ -344,10 +344,10 @@ template<class T> class Quaternion {
         /**
          * @brief %Quaternion length
          *
-         * @f[
+         * See also dot() const which is faster for comparing length with other
+         * values. @f[
          *      |q| = \sqrt{q \cdot q}
          * @f]
-         * @see dot() const
          */
         inline T length() const {
             return std::sqrt(dot());
@@ -403,7 +403,7 @@ template<class T> class Quaternion {
          * quaternions. @f[
          *      v' = qvq^{-1} = q [\boldsymbol v, 0] q^{-1}
          * @f]
-         * @see Matrix4::transformVector(), DualQuaternion::transformPointNormalized()
+         * @see Quaternion(const Vector3&), Matrix4::transformVector(), DualQuaternion::transformPointNormalized()
          */
         inline Vector3<T> rotateVector(const Vector3<T>& vector) const {
             return ((*this)*Quaternion<T>(vector)*inverted()).vector();
@@ -416,7 +416,7 @@ template<class T> class Quaternion {
          * normalized. @f[
          *      v' = qvq^{-1} = qvq^* = q [\boldsymbol v, 0] q^*
          * @f]
-         * @see Matrix4::transformVector(), DualQuaternion::transformPointNormalized()
+         * @see Quaternion(const Vector3&), Matrix4::transformVector(), DualQuaternion::transformPointNormalized()
          */
         inline Vector3<T> rotateVectorNormalized(const Vector3<T>& vector) const {
             CORRADE_ASSERT(MathTypeTraits<T>::equals(dot(), T(1)),

src/Math/Vector.h

@@ -395,10 +395,10 @@ template<std::size_t size, class T> class Vector {
         /**
          * @brief %Vector length
          *
-         * @f[
+         * See also dot() const which is faster for comparing length with other
+         * values. @f[
          *      |\boldsymbol a| = \sqrt{\boldsymbol a \cdot \boldsymbol a}
          * @f]
-         * @see dot() const
          */
         inline T length() const {
             return std::sqrt(dot());