Add operator explanation to docs

Co-Authored-By: tpdickso <tpdickso@uwaterloo.ca>

src/geometry/isometry.rs

@@ -257,6 +257,8 @@ where DefaultAllocator: Allocator<N, D>
 
     /// Transform the given point by this isometry.
     ///
+    /// This is the same as the multiplication `self * pt`.
+    ///
     /// # Example
     ///
     /// ```
@@ -278,6 +280,8 @@ where DefaultAllocator: Allocator<N, D>
     /// Transform the given vector by this isometry, ignoring the translation
     /// component of the isometry.
     ///
+    /// This is the same as the multiplication `self * v`.
+    ///
     /// # Example
     ///
     /// ```

src/geometry/quaternion.rs

@@ -1008,6 +1008,8 @@ impl<N: Real> UnitQuaternion<N> {
 
     /// Rotate a point by this unit quaternion.
     ///
+    /// This is the same as the multiplication `self * pt`.
+    ///
     /// # Example
     ///
     /// ```
@@ -1026,6 +1028,8 @@ impl<N: Real> UnitQuaternion<N> {
 
     /// Rotate a vector by this unit quaternion.
     ///
+    /// This is the same as the multiplication `self * v`.
+    ///
     /// # Example
     ///
     /// ```

src/geometry/rotation.rs

@@ -358,6 +358,8 @@ where DefaultAllocator: Allocator<N, D, D> + Allocator<N, D>
 {
     /// Rotate the given point.
     ///
+    /// This is the same as the multiplication `self * pt`.
+    ///
     /// # Example
     /// ```
     /// # #[macro_use] extern crate approx;
@@ -375,6 +377,8 @@ where DefaultAllocator: Allocator<N, D, D> + Allocator<N, D>
 
     /// Rotate the given vector.
     ///
+    /// This is the same as the multiplication `self * v`.
+    ///
     /// # Example
     /// ```
     /// # #[macro_use] extern crate approx;

src/geometry/similarity.rs

@@ -241,6 +241,8 @@ where
 
     /// Transform the given point by this similarity.
     ///
+    /// This is the same as the multiplication `self * pt`.
+    ///
     /// # Example
     /// ```
     /// # #[macro_use] extern crate approx;
@@ -260,6 +262,8 @@ where
     /// Transform the given vector by this similarity, ignoring the translational
     /// component.
     ///
+    /// This is the same as the multiplication `self * t`.
+    ///
     /// # Example
     /// ```
     /// # #[macro_use] extern crate approx;

src/geometry/transform.rs

@@ -464,6 +464,8 @@ where
         + Allocator<N, D>,
 {
     /// Transform the given point by this transformation.
+    ///
+    /// This is the same as the multiplication `self * pt`.
     #[inline]
     pub fn transform_point(&self, pt: &Point<N, D>) -> Point<N, D> {
         self * pt
@@ -471,6 +473,8 @@ where
 
     /// Transform the given vector by this transformation, ignoring the
     /// translational component of the transformation.
+    ///
+    /// This is the same as the multiplication `self * v`.
     #[inline]
     pub fn transform_vector(&self, v: &VectorN<N, D>) -> VectorN<N, D> {
         self * v

src/geometry/translation.rs

@@ -197,6 +197,8 @@ where DefaultAllocator: Allocator<N, D>
 {
     /// Translate the given point.
     ///
+    /// This is the same as the multiplication `self * pt`.
+    ///
     /// # Example
     /// ```
     /// # use nalgebra::{Translation3, Point3};

src/geometry/unit_complex.rs

@@ -254,6 +254,8 @@ impl<N: Real> UnitComplex<N> {
 
     /// Rotate the given point by this unit complex number.
     ///
+    /// This is the same as the multiplication `self * pt`.
+    ///
     /// # Example
     /// ```
     /// # #[macro_use] extern crate approx;
@@ -270,6 +272,8 @@ impl<N: Real> UnitComplex<N> {
 
     /// Rotate the given vector by this unit complex number.
     ///
+    /// This is the same as the multiplication `self * v`.
+    ///
     /// # Example
     /// ```
     /// # #[macro_use] extern crate approx;