From d2419c840e221c6bf6d7b493f26db861f591d5c6 Mon Sep 17 00:00:00 2001
From: William Taylor <williamt@rebelfactions.com>
Date: Sat, 16 Sep 2017 21:06:58 -0700
Subject: [DOCS] added member descriptions to various shapes

---
 doc/classes/CapsuleShape.xml     | 6 ++++--
 doc/classes/CapsuleShape2D.xml   | 6 ++++--
 doc/classes/CircleShape2D.xml    | 5 +++--
 doc/classes/LineShape2D.xml      | 6 ++++--
 doc/classes/RayShape2D.xml       | 5 +++--
 doc/classes/RectangleShape2D.xml | 5 +++--
 doc/classes/SegmentShape2D.xml   | 6 ++++--
 7 files changed, 25 insertions(+), 14 deletions(-)

diff --git a/doc/classes/CapsuleShape.xml b/doc/classes/CapsuleShape.xml
index 29072203ea..db075a504c 100644
--- a/doc/classes/CapsuleShape.xml
+++ b/doc/classes/CapsuleShape.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="CapsuleShape" inherits="Shape" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
-		Capsule shape resource.
+		Capsule shape for collisions.
 	</brief_description>
 	<description>
-		Capsule shape resource, which can be set into a [PhysicsBody] or area.
+		Capsule shape for collisions.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -46,8 +46,10 @@
 	</methods>
 	<members>
 		<member name="height" type="float" setter="set_height" getter="get_height">
+			The capsule's height.
 		</member>
 		<member name="radius" type="float" setter="set_radius" getter="get_radius">
+			The capsule's radius.
 		</member>
 	</members>
 	<constants>
diff --git a/doc/classes/CapsuleShape2D.xml b/doc/classes/CapsuleShape2D.xml
index 9c2b1c4a3d..df833e0582 100644
--- a/doc/classes/CapsuleShape2D.xml
+++ b/doc/classes/CapsuleShape2D.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="CapsuleShape2D" inherits="Shape2D" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
-		Capsule 2D shape resource for physics.
+		Capsule shape for 2D collisions.
 	</brief_description>
 	<description>
-		Capsule 2D shape resource for physics. A capsule (or sometimes called "pill") is like a line grown in all directions. It has a radius and a height, and is often useful for modeling biped characters.
+		Capsule shape for 2D collisions.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -46,8 +46,10 @@
 	</methods>
 	<members>
 		<member name="height" type="float" setter="set_height" getter="get_height">
+			The capsule's height.
 		</member>
 		<member name="radius" type="float" setter="set_radius" getter="get_radius">
+			The capsules's radius.
 		</member>
 	</members>
 	<constants>
diff --git a/doc/classes/CircleShape2D.xml b/doc/classes/CircleShape2D.xml
index c3d4bdae03..1ed54f0705 100644
--- a/doc/classes/CircleShape2D.xml
+++ b/doc/classes/CircleShape2D.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="CircleShape2D" inherits="Shape2D" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
-		Circular Shape for 2D Physics.
+		Circular shape for 2D collisions.
 	</brief_description>
 	<description>
-		Circular Shape for 2D Physics. This shape is useful for modeling balls or small characters and its collision detection with everything else is very fast.
+		Circular shape for 2D collisions. This shape is useful for modeling balls or small characters and its collision detection with everything else is very fast.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -30,6 +30,7 @@
 	</methods>
 	<members>
 		<member name="radius" type="float" setter="set_radius" getter="get_radius">
+			The circle's radius.
 		</member>
 	</members>
 	<constants>
diff --git a/doc/classes/LineShape2D.xml b/doc/classes/LineShape2D.xml
index 3346c46a19..5596c48162 100644
--- a/doc/classes/LineShape2D.xml
+++ b/doc/classes/LineShape2D.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="LineShape2D" inherits="Shape2D" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
-		Line shape for 2D collision objects.
+		Line shape for 2D collisions.
 	</brief_description>
 	<description>
-		Line shape for 2D collision objects. It works like a 2D plane and will not allow any body to go to the negative side. Not recommended for rigid bodies, and usually not recommended for static bodies either because it forces checks against it on every frame.
+		Line shape for 2D collisions. It works like a 2D plane and will not allow any body to go to the negative side. Not recommended for rigid bodies, and usually not recommended for static bodies either because it forces checks against it on every frame.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -46,8 +46,10 @@
 	</methods>
 	<members>
 		<member name="d" type="float" setter="set_d" getter="get_d">
+			The line's distance from the origin.
 		</member>
 		<member name="normal" type="Vector2" setter="set_normal" getter="get_normal">
+			The line's normal.
 		</member>
 	</members>
 	<constants>
diff --git a/doc/classes/RayShape2D.xml b/doc/classes/RayShape2D.xml
index 8414ee2348..4f6313a1d2 100644
--- a/doc/classes/RayShape2D.xml
+++ b/doc/classes/RayShape2D.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="RayShape2D" inherits="Shape2D" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
-		Ray 2D shape resource for physics.
+		Ray shape for 2D collisions.
 	</brief_description>
 	<description>
-		Ray 2D shape resource for physics. A ray is not really a collision body, instead it tries to separate itself from whatever is touching its far endpoint. It's often useful for characters.
+		Ray shape for 2D collisions. A ray is not really a collision body, instead it tries to separate itself from whatever is touching its far endpoint. It's often useful for characters.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -30,6 +30,7 @@
 	</methods>
 	<members>
 		<member name="length" type="float" setter="set_length" getter="get_length">
+			The ray's length.
 		</member>
 	</members>
 	<constants>
diff --git a/doc/classes/RectangleShape2D.xml b/doc/classes/RectangleShape2D.xml
index 9c18df970b..7a1aec2021 100644
--- a/doc/classes/RectangleShape2D.xml
+++ b/doc/classes/RectangleShape2D.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="RectangleShape2D" inherits="Shape2D" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
-		Rectangle Shape for 2D Physics.
+		Rectangle shape for 2D collisions.
 	</brief_description>
 	<description>
-		Rectangle Shape for 2D Physics. This shape is useful for modeling box-like 2D objects.
+		Rectangle shape for 2D collisions. This shape is useful for modeling box-like 2D objects.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -30,6 +30,7 @@
 	</methods>
 	<members>
 		<member name="extents" type="Vector2" setter="set_extents" getter="get_extents">
+			The rectangle's half extents. The width and height of this shape is twice the half extents.
 		</member>
 	</members>
 	<constants>
diff --git a/doc/classes/SegmentShape2D.xml b/doc/classes/SegmentShape2D.xml
index 0e2c5c86f3..3b7a747bcb 100644
--- a/doc/classes/SegmentShape2D.xml
+++ b/doc/classes/SegmentShape2D.xml
@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="SegmentShape2D" inherits="Shape2D" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
-		Segment Shape for 2D Collision Detection.
+		Segment shape for 2D collisions.
 	</brief_description>
 	<description>
-		Segment Shape for 2D Collision Detection, consists of two points, 'a' and 'b'.
+		Segment shape for 2D collisions. Consists of two points, [code]a[/code] and [code]b[/code].
 	</description>
 	<tutorials>
 	</tutorials>
@@ -46,8 +46,10 @@
 	</methods>
 	<members>
 		<member name="a" type="Vector2" setter="set_a" getter="get_a">
+			The segment's first point position.
 		</member>
 		<member name="b" type="Vector2" setter="set_b" getter="get_b">
+			The segment's second point position.
 		</member>
 	</members>
 	<constants>
-- 
cgit v1.2.3