Improve the library documentation.
Add many comments to the core math library. Fix mulitple errors encountered when running doxygen.
Change-Id: Icbc9d8f5b5353c40b1ed6b04baef3d5c6b5888f1
diff --git a/scriptc/rs_matrix.rsh b/scriptc/rs_matrix.rsh
index 34b9532..6faeca1 100644
--- a/scriptc/rs_matrix.rsh
+++ b/scriptc/rs_matrix.rsh
@@ -34,7 +34,7 @@
* once, multiply the two source matrices, with the first transformation as the
* right argument. E.g. to create a transformation matrix that applies the
* transformation \e s1 followed by \e s2, call
- * </c>rsMatrixLoadMultiply(&combined, &s2, &s1)</c>.
+ * <c>rsMatrixLoadMultiply(&combined, &s2, &s1)</c>.
* This derives from <em>s2 * (s1 * v)</em>, which is <em>(s2 * s1) * v</em>.
*
* \li We have two style of functions to create transformation matrices:
@@ -60,8 +60,6 @@
*
* \warning The order of the column and row parameters may be
* unexpected.
- *
- * @return void
*/
_RS_RUNTIME void __attribute__((overloadable))
rsMatrixSet(rs_matrix4x4 *m, uint32_t col, uint32_t row, float v);
@@ -233,7 +231,7 @@
* To combine two 4x4 transformaton matrices, multiply the second transformation matrix
* by the first transformation matrix. E.g. to create a transformation matrix that applies
* the transformation \e s1 followed by \e s2, call
- * </c>rsMatrixLoadMultiply(&combined, &s2, &s1)</c>.
+ * <c>rsMatrixLoadMultiply(&combined, &s2, &s1)</c>.
*
* \warning Prior to version 21, storing the result back into right matrix is not supported and
* will result in undefined behavior. Use rsMatrixMulitply instead. E.g. instead of doing