From 327a92b4781563f42a6b0fd2410468ac9a01adbc Mon Sep 17 00:00:00 2001
From: Martin Taibr <taibr.martin@gmail.com>
Date: Sat, 17 Jun 2017 02:51:41 +0200
Subject: [PATCH] further explain angles

---
 qcsrc/common/physics/player.qh | 7 +++++--
 qcsrc/lib/angle.qc             | 6 ++++--
 2 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/qcsrc/common/physics/player.qh b/qcsrc/common/physics/player.qh
index b5b016c7e4..cbd746085f 100644
--- 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 09e267fe4b..2f71cb3fbd 100644
--- 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;
 
 /*
-- 
2.39.5