From 665805a88a3617e95dce68fcbbf40ba44dfd9e92 Mon Sep 17 00:00:00 2001
From: Manuel Kraemer <mkraemer@pixar.com>
Date: Thu, 4 Jul 2013 19:19:52 -0700
Subject: [PATCH] fix some doxygen comments in FarPatchParam

replacing ASCII formatting which breaks with an HTML table (markdown would be nice but not until doxy 1.9)

fixes #138
---
 opensubdiv/far/patchParam.h | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/opensubdiv/far/patchParam.h b/opensubdiv/far/patchParam.h
index e96f3ca8..9a5ed6da 100644
--- a/opensubdiv/far/patchParam.h
+++ b/opensubdiv/far/patchParam.h
@@ -74,14 +74,15 @@ namespace OPENSUBDIV_VERSION {
 /// but has to be remapped to a specific layout for uv textures.
 ///
 /// Bitfield layout :
-///
-///   level:4      - the subdivision level of the patch
-///   nonquad:1;   - whether the patch is the child of a non-quad face
-///   rotation:2;  - patch rotations necessary to match CCW face-winding
-///   v:10;        - log2 value of u parameter at first patch corner
-///   u:10;        - log2 value of v parameter at first patch corner
-///   reserved1:5; - padding
-///
+///   <table>
+///   <tr> <th> Field      </th> <th> Bits </th> <th> Content                                             </th> </tr>
+///   <tr> <td> level      </td> <td>  4   </td> <td> the subdivision level of the patch                  </td> </tr>
+///   <tr> <td> nonquad    </td> <td>  1   </td> <td> whether the patch is the child of a non-quad face   </td> </tr>
+///   <tr> <td> rotation   </td> <td>  2   </td> <td> patch rotations necessary to match CCW face-winding </td> </tr>
+///   <tr> <td> v          </td> <td> 10   </td> <td> log2 value of u parameter at first patch corner     </td> </tr>
+///   <tr> <td> u          </td> <td> 10   </td> <td> log2 value of v parameter at first patch corner     </td> </tr>
+///   <tr> <td> reserved1  </td> <td>  5   </td> <td> padding                                             </td> </tr>
+///   </table>
 /// Note : the bitfield is not expanded in the struct due to differences in how
 ///        GPU & CPU compilers pack bit-fields and endian-ness.
 ///