From 67dd48aae7b8b21566e0735f2285fe0ddbcf2725 Mon Sep 17 00:00:00 2001
From: "sha..rd" <shadowislord@gmail.com>
Date: Wed, 20 Apr 2011 13:53:16 +0000
Subject: [PATCH]  * Camera.setDirection() now deprecated since it doesn't do
 the thing most people expect it

git-svn-id: https://jmonkeyengine.googlecode.com/svn/trunk@7266 75d07b2b-3a1a-0410-a2c5-0572b91ccdca
---
 engine/src/core/com/jme3/renderer/Camera.java | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/engine/src/core/com/jme3/renderer/Camera.java b/engine/src/core/com/jme3/renderer/Camera.java
index 5d354fe0d..31db9753d 100644
--- a/engine/src/core/com/jme3/renderer/Camera.java
+++ b/engine/src/core/com/jme3/renderer/Camera.java
@@ -616,14 +616,18 @@ public class Camera implements Savable, Cloneable {
     }
 
     /**
-     * <code>setDirection</code> sets the direction this camera is facing. In
-     * most cases, this changes the up and left vectors of the camera. If your
-     * left or up vectors change, you must updates those as well for correct
-     * culling.
+     * <code>setDirection</code> sets the direction vector of the camera.
+     * This operation doesn't change the left and up vectors of the camera,
+     * which must change if the camera is to actually face the given
+     * direction. In most cases the method {@link Camera#lookAt(com.jme3.math.Vector3f, com.jme3.math.Vector3f) }
+     * should be used instead.
      *
      * @param direction the direction this camera is facing.
-     * @see Camera#setDirection(com.jme.math.Vector3f)
+     * @see Camera#set
+     * @deprecated Manipulate the quaternion rotation instead: 
+     * {@link Camera#setRotation(com.jme3.math.Quaternion) }.
      */
+    @Deprecated
     public void setDirection(Vector3f direction) {
         //this.rotation.lookAt(direction, getUp());
         Vector3f left = getLeft();