further explain angles

diff --git a/qcsrc/common/physics/player.qh b/qcsrc/common/physics/player.qh
index b5b016c7e4075922635c24d60aec0d61ade354c3..cbd746085f2e42b6df72ed0a9eb2702d9bd99a56 100644 (file)
--- a/qcsrc/common/physics/player.qh
+++ b/qcsrc/common/physics/player.qh
@@ -191,8 +191,11 @@ STATIC_INIT(PHYS_INPUT_BUTTON_DODGE)
 
        .vector movement;
 
-       // angles of the player's view (as opposed to his model which uses `.vector angles;`)
-       // x is pitch, y is yaw, z is roll
+       // angles of the player's view (as opposed to his model which uses `.vector angles;`) in degrees
+       // x is pitch: positive means down (unlike .angles)
+       // y is yaw: between -180 and 180, increases when turning left
+       // z is roll: positive means tilted clockwise, usually is 0
+       // when .fixangle is set, .v_angle will be set to .angles in the next frame
        .vector v_angle;
 
        .entity hook;

diff --git a/qcsrc/lib/angle.qc b/qcsrc/lib/angle.qc
index 09e267fe4b6146e60b841ec0f69864c7074d39fe..2f71cb3fbd3efb88ee585dca88b17a739d44e1ea 100644 (file)
--- a/qcsrc/lib/angle.qc
+++ b/qcsrc/lib/angle.qc
@@ -1,7 +1,9 @@
 .vector origin;
 
-// angles of the player's model (as opposed to his view which uses `.vector v_angle;`)
-// x is pitch, y is yaw, z is roll
+// angles of the player's model (as opposed to his view which uses `.vector v_angle;`) in degrees
+// x is pitch: positive means up (unlike .v_angle), usually is 0
+// y is yaw: between -180 and 180, increases when turning left
+// z is roll: positive means tilted clockwise, usually is 0
 .vector angles;
 
 /*