Document and various fixes for Particle and Spring

Author: Antoine Cailliau

Physics/Particle.cs

@@ -88,7 +88,7 @@ public double YForce  {
 		/// </summary>
 		public double Mass  {
 			get;
-			set;
+			private set;
 		}
 
 		/// <summary>
@@ -116,7 +116,7 @@ public Particle ()
 		/// 	and the given mass.
 		/// </summary>
 		/// <param name="mass">
-		/// 	A <see cref="System.Double"/> representing the mass.
+		/// 	A <see cref="T:System.Double"/> representing the mass.
 		/// </param>
 		public Particle (double mass)
 		{
@@ -128,10 +128,10 @@ public Particle (double mass)
 		///   null speed and the given mass.
 		/// </summary>
 		/// <param name="x">
-		/// 	A <see cref="System.Double"/> representing the x-coordinate
+		/// 	A <see cref="T:System.Double"/> representing the x-coordinate
 		/// </param>
 		/// <param name="y">
-		/// 	A <see cref="System.Double"/> representing the y-coordinate
+		/// 	A <see cref="T:System.Double"/> representing the y-coordinate
 		/// </param>
 		public Particle (double x, double y)
 			: this()
@@ -145,13 +145,13 @@ public Particle (double x, double y)
 		/// 	of null speed and with given mass.
 		/// </summary>
 		/// <param name="x">
-		/// 	A <see cref="System.Double"/> representing the x-coordinate
+		/// 	A <see cref="T:System.Double"/> representing the x-coordinate
 		/// </param>
 		/// <param name="y">
-		/// 	A <see cref="System.Double"/> representing the y-coordinate
+		/// 	A <see cref="T:System.Double"/> representing the y-coordinate
 		/// </param>
 		/// <param name="mass">
-		/// 	A <see cref="System.Double"/> representing the mass
+		/// 	A <see cref="T:System.Double"/> representing the mass
 		/// </param>
 		public Particle (double x, double y, double mass)
 			: this(x, y)
@@ -164,16 +164,16 @@ public Particle (double x, double y, double mass)
 		/// 	of given speed and of unitary mass.
 		/// </summary>
 		/// <param name="x">
-		/// 	A <see cref="System.Double"/> representing the x-coordinate.
+		/// 	A <see cref="T:System.Double"/> representing the x-coordinate.
 		/// </param>
 		/// <param name="y">
-		/// 	A <see cref="System.Double"/> representing the y-coordinate.
+		/// 	A <see cref="T:System.Double"/> representing the y-coordinate.
 		/// </param>
 		/// <param name="xSpeed">
-		/// 	A <see cref="System.Double"/> representing the speed along the x-axis.
+		/// 	A <see cref="T:System.Double"/> representing the speed along the x-axis.
 		/// </param>
 		/// <param name="ySpeed">
-		/// 	A <see cref="System.Double"/> representing the speed along the y-axis.
+		/// 	A <see cref="T:System.Double"/> representing the speed along the y-axis.
 		/// </param>
 		public Particle (double x, double y, double xSpeed, double ySpeed)
 			: this(x, y)
@@ -187,21 +187,21 @@ public Particle (double x, double y, double xSpeed, double ySpeed)
 		/// 	speed given and of given mass.
 		/// </summary>
 		/// <param name="x">
-		/// 	A <see cref="System.Double"/> representing the x-coordinate.
+		/// 	A <see cref="T:System.Double"/> representing the x-coordinate.
 		/// </param>
 		/// <param name="y">
-		/// 	A <see cref="System.Double"/> representing the y-coordinate.
+		/// 	A <see cref="T:System.Double"/> representing the y-coordinate.
 		/// </param>
 		/// <param name="xSpeed">
-		/// 	A <see cref="System.Double"/> representing the speed along the 
+		/// 	A <see cref="T:System.Double"/> representing the speed along the 
 		/// 	x-axis.
 		/// </param>
 		/// <param name="ySpeed">
-		/// 	A <see cref="System.Double"/> representing the speed along the
+		/// 	A <see cref="T:System.Double"/> representing the speed along the
 		/// 	y-axis.
 		/// </param>
 		/// <param name="mass">
-		/// 	A <see cref="System.Double"/> representing the mass of the
+		/// 	A <see cref="T:System.Double"/> representing the mass of the
 		/// 	particle.
 		/// </param>
 		public Particle (double x, double y, double xSpeed, double ySpeed, double mass)

Physics/Spring.cs

@@ -88,32 +88,32 @@ public T Value  {
 		/// 	unitary length and strenght.
 		/// </summary>
 		/// <param name="p1">
-		/// A <see cref="Particle"/> representing one particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing one particle.
 		/// </param>
 		/// <param name="p2">
-		/// A <see cref="Particle"/> representing the other particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing the other particle.
 		/// </param>
 		public Spring (Particle<S> p1, Particle<S> p2)
 		{
 			Particle1 = p1;
 			Particle2 = p2;
 			Strenght = 1;
 			Length = 1;
-			Damping = Length / 10;
+			Damping = 1;//Length / 10;
 		}
 
 		/// <summary>
 		///		Creates a new spring between the two given particles, of unitary
 		///		length and given strenght.
 		/// </summary>
 		/// <param name="particle1">
-		/// 	A <see cref="Particle"/> representing one particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing one particle.
 		/// </param>
 		/// <param name="particle2">
-		/// 	A <see cref="Particle"/> representing the other particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing the other particle.
 		/// </param>
 		/// <param name="strenght">
-		/// 	A <see cref="System.Double"/> representing the strenght of the
+		/// 	A <see cref="T:System.Double"/> representing the strenght of the
 		/// 	spring.
 		/// </param>
 		public Spring (Particle<S> particle1, Particle<S> particle2, double strenght)
@@ -127,17 +127,17 @@ public Spring (Particle<S> particle1, Particle<S> particle2, double strenght)
 		/// 	and strenght.
 		/// </summary>
 		/// <param name="particle1">
-		/// 	A <see cref="Particle"/> representing one particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing one particle.
 		/// </param>
 		/// <param name="particle2">
-		/// 	A <see cref="Particle"/> representing the other particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing the other particle.
 		/// </param>
 		/// <param name="strenght">
-		/// 	A <see cref="System.Double"/> representing the strenght of the
+		/// 	A <see cref="T:System.Double"/> representing the strenght of the
 		/// 	spring.
 		/// </param>
 		/// <param name="length">
-		/// 	A <see cref="System.Double"/> representing the length of the
+		/// 	A <see cref="T:System.Double"/> representing the length of the
 		/// 	spring.
 		/// </param>
 		public Spring (Particle<S> particle1, Particle<S> particle2, double strenght, double length)
@@ -152,21 +152,21 @@ public Spring (Particle<S> particle1, Particle<S> particle2, double strenght, do
 		/// 	and strenght. The damping factor is equal to the given one.
 		/// </summary>
 		/// <param name="particle1">
-		/// 	A <see cref="Particle"/> representing one particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing one particle.
 		/// </param>
 		/// <param name="particle2">
-		/// 	A <see cref="Particle"/> representing the other particle.
+		/// 	A <see cref="T:Smog.Particle"/> representing the other particle.
 		/// </param>
 		/// <param name="strenght">
-		/// 	A <see cref="System.Double"/> representing the strenght of the
+		/// 	A <see cref="T:System.Double"/> representing the strenght of the
 		/// 	spring.
 		/// </param>
 		/// <param name="length">
-		/// 	A <see cref="System.Double"/> representing the length of the
+		/// 	A <see cref="T:System.Double"/> representing the length of the
 		/// 	spring.
 		/// </param>
 		/// <param name="damping">
-		/// 	A <see cref="System.Double"/> representing the damping factor of
+		/// 	A <see cref="T:System.Double"/> representing the damping factor of
 		/// 	the spring.
 		/// </param>
 		public Spring (Particle<S> particle1, Particle<S> particle2, double strenght, double length, double damping)