Merge pull request #10370 from looeee/docs/camera/addCopy

Updated Camera doc

docs/api/cameras/Camera.html

@@ -12,7 +12,9 @@
 
 		<h1>[name]</h1>
 
-		<div class="desc">Abstract base class for cameras. This class should always be inherited when you build a new camera.</div>
+		<div class="desc">
+			Abstract base class for cameras. This class should always be inherited when you build a new camera.
+		</div>
 
 
 		<h2>Constructor</h2>
@@ -20,9 +22,8 @@
 
 		<h3>[name]()</h3>
 		<div>
-			This constructor sets the following properties to the correct type:
-			[page:Camera.matrixWorldInverse matrixWorldInverse] and [page:Camera.projectionMatrix projectionMatrix].
-
+			Creates a new [name]. Note that this class is not intended to be called directly;
+			you probably want a [page:PerspectiveCamera] or [page:OrthographicCamera] instead.
 		</div>
 
 
@@ -36,6 +37,15 @@
 			You should not change this, as it used internally by the renderer for optimisation.
 		</div>
 
+		<h3>[property:Layers layers]</h3>
+		<div>
+		The [page:Layers layers] that the camera is a member of. This is an inherited
+		property from [page:Object3D].<br /><br />
+
+		Objects must share at least one layer with the camera to be seen
+		when the camera's viewpoint is rendered.
+		</div>
+
 		<h3>[property:Matrix4 matrixWorldInverse]</h3>
 		<div>
 			This is the inverse of matrixWorld. MatrixWorld contains the Matrix which has
@@ -45,17 +55,19 @@
 		<h3>[property:Matrix4 projectionMatrix]</h3>
 		<div>This is the matrix which contains the projection.</div>
 
-		<h3>[property:Layers layers]</h3>
-		<div>
-		The [page:Layers layers] that the camera is a member of. This is an inherited
-		property from [page:Object3D].<br /><br />
 
-		Objects must share at least one layer with the camera to be seen
-		when the camera's viewpoint is rendered.
+		<h2>Methods</h2>
+		<div>See the base [page:Object3D] class for common methods.</div>
+
+		<h3>[method:Camera clone]( )</h3>
+		<div>
+			Return a new camera with the same properties as this one.
 		</div>
 
-		<h2>Methods</h2>
-		<div>See the base [page:Objct3D] class for common methods.</div>
+		<h3>[method:Camera copy]( [page:Camera source] )</h3>
+		<div>
+		Copy the properties from the source camera into this one.
+		</div>
 
 		<h3>[method:Vector3 getWorldDirection]( [page:Vector3 optionalTarget] )</h3>
 		<div>
@@ -64,7 +76,6 @@
 		from the camera's position to the [page:Vector3 optionalTarget].
 		</div>
 
-
 		<h3>[method:null lookAt]( [page:Vector3 target] )</h3>
 		<div>
 		target — position in 3D space for the camera to point towards<br /><br />
@@ -73,14 +84,6 @@
 		the parent of this camera is the scene or at position (0,0,0).
 		</div>
 
-		<h3>[method:Camera clone]( [page:Camera camera] )</h3>
-		<div>
-		camera — camera to clone<br /><br />
-
-		Returns a clone of camera.
-		</div>
-
-
 		<h2>Source</h2>
 
 		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]