From 56e75295bea66c03a92a752cb6cdc7993c43d4f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vladim=C3=ADr=20Vondru=C5=A1?= <mosra@centrum.cz>
Date: Sat, 15 Oct 2016 15:34:23 +0200
Subject: [PATCH] Math: mention more useful dot product and determinant
 properties.

---
 src/Magnum/Math/Matrix.h | 3 ++-
 src/Magnum/Math/Vector.h | 6 ++++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/Magnum/Math/Matrix.h b/src/Magnum/Math/Matrix.h
index b2b391aa7..8d204b59f 100644
--- a/src/Magnum/Math/Matrix.h
+++ b/src/Magnum/Math/Matrix.h
@@ -163,7 +163,8 @@ template<std::size_t size, class T> class Matrix: public RectangularMatrix<size,
         /**
          * @brief Determinant
          *
-         * Computed recursively using Laplace's formula: @f[
+         * Returns `0` if the matrix is noninvertible and `1` if the matrix is
+         * orthogonal. Computed recursively using Laplace's formula: @f[
          *      \det(A) = \sum_{j=1}^n (-1)^{i+j} a_{i,j} \det(A^{i,j})
          * @f] @f$ A^{i, j} @f$ is matrix without i-th row and j-th column, see
          * @ref ij(). The formula is expanded down to 2x2 matrix, where the
diff --git a/src/Magnum/Math/Vector.h b/src/Magnum/Math/Vector.h
index 7f40e1d65..938e3c786 100644
--- a/src/Magnum/Math/Vector.h
+++ b/src/Magnum/Math/Vector.h
@@ -73,8 +73,10 @@ namespace Implementation {
 /** @relatesalso Vector
 @brief Dot product of two vectors
 
-Returns `0` when two vectors are perpendicular, `1` when two *normalized*
-vectors are parallel and `-1` when two *normalized* vectors are antiparallel. @f[
+Returns `0` when two vectors are perpendicular, `> 0` when two vectors are in
+the same general direction, `1` when two *normalized* vectors are parallel,
+`< 0` when two vectors are in opposite general direction and `-1` when two
+*normalized* vectors are antiparallel. @f[
     \boldsymbol a \cdot \boldsymbol b = \sum_{i=0}^{n-1} \boldsymbol a_i \boldsymbol b_i
 @f]
 @see @ref Vector::dot() const, @ref Vector::operator-(), @ref Vector2::perpendicular()