Auto merge of #466 - nical:perspective-doc, r=kvark

Improve the documentation of Transform3D::perspective

There was a bit of confusion about the formulation of the perspective transform in #465. This clarifies things.

Author: bors-servo

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "euclid"
-version = "0.22.0"
+version = "0.22.1"
 authors = ["The Servo Project Developers"]
 edition = "2018"
 description = "Geometry primitives"

src/transform3d.rs

@@ -425,14 +425,16 @@ where
         )
     }
 
-    /// Create a simple perspective projection transform:
+    /// Create a simple perspective transform, projecting to the plane `z = -d`.
     ///
     /// ```text
     /// 1   0   0   0
     /// 0   1   0   0
     /// 0   0   1 -1/d
     /// 0   0   0   1
     /// ```
+    ///
+    /// See <https://drafts.csswg.org/css-transforms-2/#PerspectiveDefined>.
     pub fn perspective(d: T) -> Self
     where
         T: Neg<Output = T> + Div<Output = T>,