Add std documentation for float and u8 functions

Author: mbrubeck

src/lib/float.rs

@@ -223,34 +223,49 @@ fn neg_infinity() -> float {
    ret -1./0.;
 }
 
+/* Function: add */
 pure fn add(x: float, y: float) -> float { ret x + y; }
 
+/* Function: sub */
 pure fn sub(x: float, y: float) -> float { ret x - y; }
 
+/* Function: mul */
 pure fn mul(x: float, y: float) -> float { ret x * y; }
 
+/* Function: div */
 pure fn div(x: float, y: float) -> float { ret x / y; }
 
+/* Function: rem */
 pure fn rem(x: float, y: float) -> float { ret x % y; }
 
+/* Predicate: lt */
 pure fn lt(x: float, y: float) -> bool { ret x < y; }
 
+/* Predicate: le */
 pure fn le(x: float, y: float) -> bool { ret x <= y; }
 
+/* Predicate: eq */
 pure fn eq(x: float, y: float) -> bool { ret x == y; }
 
+/* Predicate: ne */
 pure fn ne(x: float, y: float) -> bool { ret x != y; }
 
+/* Predicate: ge */
 pure fn ge(x: float, y: float) -> bool { ret x >= y; }
 
+/* Predicate: gt */
 pure fn gt(x: float, y: float) -> bool { ret x > y; }
 
+/* Predicate: positive */
 pure fn positive(x: float) -> bool { ret x > 0.; }
 
+/* Predicate: negative */
 pure fn negative(x: float) -> bool { ret x < 0.; }
 
+/* Predicate: nonpositive */
 pure fn nonpositive(x: float) -> bool { ret x <= 0.; }
 
+/* Predicate: nonnegative */
 pure fn nonnegative(x: float) -> bool { ret x >= 0.; }
 
 //

src/lib/u8.rs

@@ -1,26 +1,52 @@
+/*
+Module: u8
+*/
+
+/*
+Function: max_value
+
+The maximum value of a u8.
+*/
 pure fn max_value() -> u8 { ret 255u8; }
+
+/*
+Function: min_value
+
+The minumum value of a u8.
+*/
 pure fn min_value() -> u8 { ret 0u8; }
 
+/* Function: add */
 pure fn add(x: u8, y: u8) -> u8 { ret x + y; }
 
+/* Function: sub */
 pure fn sub(x: u8, y: u8) -> u8 { ret x - y; }
 
+/* Function: mul */
 pure fn mul(x: u8, y: u8) -> u8 { ret x * y; }
 
+/* Function: div */
 pure fn div(x: u8, y: u8) -> u8 { ret x / y; }
 
+/* Function: rem */
 pure fn rem(x: u8, y: u8) -> u8 { ret x % y; }
 
+/* Predicate: lt */
 pure fn lt(x: u8, y: u8) -> bool { ret x < y; }
 
+/* Predicate: le */
 pure fn le(x: u8, y: u8) -> bool { ret x <= y; }
 
+/* Predicate: eq */
 pure fn eq(x: u8, y: u8) -> bool { ret x == y; }
 
+/* Predicate: ne */
 pure fn ne(x: u8, y: u8) -> bool { ret x != y; }
 
+/* Predicate: ge */
 pure fn ge(x: u8, y: u8) -> bool { ret x >= y; }
 
+/* Predicate: gt */
 pure fn gt(x: u8, y: u8) -> bool { ret x > y; }
 
 fn range(lo: u8, hi: u8, it: block(u8)) {