From aaa359f3b07e5e37cfb228a34aa45bee1de91ac1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Crozet?= <developer@crozet.re>
Date: Mon, 7 Aug 2017 21:09:21 +0200
Subject: [PATCH] Remove hand-written rustdoc doc for quaternon and
 unit_complex.

Those are now generated automatically by rustdoc.
---
 src/geometry/quaternion.rs   | 115 -----------------------------------
 src/geometry/unit_complex.rs |  94 ----------------------------
 2 files changed, 209 deletions(-)

diff --git a/src/geometry/quaternion.rs b/src/geometry/quaternion.rs
index 6bc0db2f..125164ea 100644
--- a/src/geometry/quaternion.rs
+++ b/src/geometry/quaternion.rs
@@ -286,121 +286,6 @@ impl<N: Real + fmt::Display> fmt::Display for Quaternion<N> {
 }
 
 /// A unit quaternions. May be used to represent a rotation.
-///
-///
-/// <center>
-/// <big><b>
-/// Due to a [bug](https://github.com/rust-lang/rust/issues/32077) in rustdoc, the documentation
-/// below has been written manually lists only method signatures.<br>
-/// Trait implementations are not listed either.
-/// </b></big>
-/// </center>
-///
-/// Please refer directly to the documentation written above each function definition on the source
-/// code for more details.
-///
-/// <h2 id="methods">Methods</h2>
-///
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">angle</a>(&self) -> N</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">angle_to</a>(&self, other: &UnitQuaternion) -> N</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">axis</a>(&self) -> Option&lt;Unit&lt;Vector3&gt;&gt;</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">clone_owned</a>(&self) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">conjugate_mut</a>(&mut self)</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">conjugate</a>(&self) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">exp</a>(&self) -> Quaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_axis_angle</a>(axis: &Unit&lt;Vector&gt;, angle: N) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_euler_angles</a>(roll: N, pitch: N, yaw: N) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_quaternion</a>(q: Quaternion) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_rotation_matrix</a>(rotmat: &Rotation) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_scaled_axis</a>(axisangle: Vector) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">identity</a>() -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">into_owned</a>(self) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">inverse_mut</a>(&mut self)</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">inverse</a>(&self) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">lerp</a>(&self, other: &UnitQuaternion, t: N) -> Quaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">ln</a>(&self) -> Quaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">look_at_lh</a>(dir: &Vector, up: &Vector) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">look_at_rh</a>(dir: &Vector, up: &Vector) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">new</a>(axisangle: Vector) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">new_observer_frame</a>(dir: &Vector, up: &Vector) -> Self</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">nlerp</a>(&self, other: &UnitQuaternion, t: N) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">powf</a>(&self, n: N) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">quaternion</a>(&self) -> &Quaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">rotation_between</a>(a: &Vector, b: &Vector) -> Option&lt;Self&gt;</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">rotation_to</a>(&self, other: &UnitQuaternion) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">scaled_axis</a>(&self) -> Vector3</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">scaled_rotation_between</a>(a: &Vector, b: &Vector, s: N) -> Option&lt;Self&gt;</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">slerp</a>(&self, other: &UnitQuaternion, t: N) -> UnitQuaternion</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">to_homogeneous</a>(&self) -> MatrixN</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">to_rotation_matrix</a>(&self) -> Rotation</code>
-/// </h4>
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">try_slerp</a>(&self, other: &UnitQuaternion, t: N, epsilon: N) -> Option&lt;UnitQuaternion&gt;</code>
-/// </h4>
 pub type UnitQuaternion<N> = Unit<Quaternion<N>>;
 
 
diff --git a/src/geometry/unit_complex.rs b/src/geometry/unit_complex.rs
index 9d44ab2f..61400e21 100644
--- a/src/geometry/unit_complex.rs
+++ b/src/geometry/unit_complex.rs
@@ -7,100 +7,6 @@ use core::{Unit, Vector1, Matrix2, Matrix3};
 use geometry::Rotation2;
 
 /// A complex number with a norm equal to 1.
-///
-/// <center>
-/// <big><b>
-/// Due to a [bug](https://github.com/rust-lang/rust/issues/32077) in rustdoc, the documentation
-/// below has been written manually lists only method signatures.<br>
-/// Trait implementations are not listed either.
-/// </b></big>
-/// </center>
-///
-/// Please refer directly to the documentation written above each function definition on the source
-/// code for more details.
-///
-///
-/// <h2 id="methods">Methods</h2>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">angle</a>(&self) -> N</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">angle_to</a>(&self, other: &Self) -> N</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">complex</a>(&self) -> &Complex</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">conjugate</a>(&self) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">conjugate_mut</a>(&mut self)</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_angle</a>(angle: N) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_complex</a>(q: Complex) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_rotation_matrix</a>(rotmat: &Rotation) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">from_scaled_axis</a>(axisangle: Vector) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">identity</a>() -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">inverse</a>(&self) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">inverse_mut</a>(&mut self)</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">new</a>(angle: N) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">powf</a>(&self, n: N) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">rotation_between</a>(a: &Vector<N, U2, SB>, b: &Vector) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">rotation_to</a>(&self, other: &Self) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">scaled_axis</a>(&self) -> Vector1</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">scaled_rotation_between</a>(a: &Vector<N, U2, SB>, b: &Vector, s: N) -> Self</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">to_homogeneous</a>(&self) -> Matrix3</code>
-/// </h4>
-///
-/// <h4 class="method"><span class="invisible">
-/// <code>fn <a class="fnname">to_rotation_matrix</a>(&self) -> Rotation2</code>
-/// </h4>
 pub type UnitComplex<N> = Unit<Complex<N>>;
 
 impl<N: Real> UnitComplex<N> {