From 7b5b6f1d576e17b89a56435c04b93caba53eb911 Mon Sep 17 00:00:00 2001
From: "Jeffrey T. Palmer" <jeffrey.t.palmer@gmail.com>
Date: Wed, 28 Sep 2011 19:45:22 -0400
Subject: [PATCH] Updated b2ContactImpulse docs

---
 lib/pods/Box2D/b2ContactImpulse.pod | 40 ++++++++++++++---------------
 1 file changed, 19 insertions(+), 21 deletions(-)

diff --git a/lib/pods/Box2D/b2ContactImpulse.pod b/lib/pods/Box2D/b2ContactImpulse.pod
index 49f7f0d..ac9121a 100644
--- a/lib/pods/Box2D/b2ContactImpulse.pod
+++ b/lib/pods/Box2D/b2ContactImpulse.pod
@@ -1,51 +1,49 @@
 
 =head1 NAME
 
-Box2D::b2ContactImpulse - TODO
+Box2D::b2ContactImpulse - Contact impulses for reporting.
 
 =head1 SYNOPSIS
 
-  # TODO
-
-=head1 DESCRIPTION
+  for my $i ( 0 .. $contact->GetManifold()->pointCount() - 1 ) {
 
+      my $impulse = $contactImpulse->normalImpulses( $i );
 
+      # Do something
+  }
 
-=head1 METHODS
-
-=head2 new()
+=head1 DESCRIPTION
 
-Default constructor.
+Contact impulses for reporting. Impulses are used instead of forces
+because sub-step forces may approach infinity for rigid body
+collisions. These match up one-to-one with the contact points in
+C<Box2D::b2Manifold>.
 
-=head2 float32 b2ContactImpulse::normalImpulses[b2_maxManifoldPoints]()
+=head1 METHODS
 
-=head2 float32 b2ContactImpulse::normalImpulses[b2_maxManifoldPoints]( $float32 b2ContactImpulse::normalImpulses[b2_maxManifoldPoints] )
+=head2 normalImpulses( $index )
 
 Parameters:
 
 =over 4
 
-=item *  C<$float32 b2ContactImpulse::normalImpulses[b2_maxManifoldPoints]> (optional)
+=item * C<int> C<$index>
 
 =back
 
-=head2 float32 b2ContactImpulse::tangentImpulses[b2_maxManifoldPoints]()
+Returns a C<float32>
 
-=head2 float32 b2ContactImpulse::tangentImpulses[b2_maxManifoldPoints]( $float32 b2ContactImpulse::tangentImpulses[b2_maxManifoldPoints] )
-
-Parameters:
+=head1 SEE ALSO
 
 =over 4
 
-=item *  C<$float32 b2ContactImpulse::tangentImpulses[b2_maxManifoldPoints]> (optional)
+=item * L<Box2D>
 
-=back
+=item * L<Box2D::b2ContactListener>
 
-=head1 SEE ALSO
+=item * L<Box2D::b2Contact>
 
-=over 4
-
-=item * L<Box2D>
+=item * L<Box2D::b2Manifold>
 
 =back