diff --git a/docs/api/materials/Material.html b/docs/api/materials/Material.html
index 195f2e6300eb187c7acddc6c21dc7232b14ee5a9..cd83d098988bf9b67a0e9ce0dc4d8d93ae558dea 100644
--- a/docs/api/materials/Material.html
+++ b/docs/api/materials/Material.html
@@ -102,12 +102,15 @@
 
 		<h3>[property:Material customDepthMaterial]</h3>
 		<div>
-		Custom depth material to be used by this material in depth based computation. If a material uses any custom logic to position the vertices (animation, displacement other than the default texture based, instancing...) the depth material should also include that logic in order to make effects like shadows and SSAO work. Defining this property allows the WebGLRenderer to use this instance of the material instead of the internal cache. Default is *undefined*.
+		Custom depth material to be used by this material when rendering to the depth map.
+		When shadow-casting with a [page:DirectionalLight] or [page:SpotLight], if you are (a) modifying vertex positions in the vertex shader,
+		(b) using a displacement map, (c) using an alpha map with alphaTest, or (d) using a transparent texture with alphaTest,
+		you must specify a customDepthMaterial for proper shadows. Default is *undefined*.
 		</div>
 		
 		<h3>[property:Material customDistanceMaterial]</h3>
 		<div>
-		Same as customDepthMaterial but used for specific computation (point lights for example). Default is *undefined*
+		Same as customDepthMaterial, but used with [page:PointLight]. Default is *undefined*.
 		</div>
 		
 		<h3>[property:Object defines]</h3>