---

yaml
---
r: 139791
b: refs/heads/try2
c: 27a0269
h: refs/heads/master
i:
  139789: 0892972
  139787: 24ee62a
  139783: 934ef13
  139775: 2db0e9c
v: v3

Author: astrieanna

[refs]

@@ -5,7 +5,7 @@ refs/heads/snap-stage3: 78a7676898d9f80ab540c6df5d4c9ce35bb50463
 refs/heads/try: 519addf6277dbafccbb4159db4b710c37eaa2ec5
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
-refs/heads/try2: 2ec2d99bbd1a15a8f278b3cb82ddfa9ebafa96b3
+refs/heads/try2: 27a0269501637d7fa27356caa9c13ab66fe5c8b0
 refs/heads/dist-snap: ba4081a5a8573875fed17545846f6f6902c8ba8d
 refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596
 refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503

branches/try2/src/libstd/base64.rs

@@ -26,6 +26,21 @@ static CHARS: [char, ..64] = [
     '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '+', '/'
 ];
 
+/**
+ * Turn a vector of `u8` bytes into a string representing them in base64.
+ *
+ * *Example*:
+ *
+ * ~~~~
+ * extern mod std;
+ * use std::base64::ToBase64;
+ *
+ * fn main () {
+ *   let str = [52,32].to_base64();
+ *   println(fmt!("%s", str));
+ * }
+ * ~~~~
+ */
 impl<'self> ToBase64 for &'self [u8] {
     fn to_base64(&self) -> ~str {
         let mut s = ~"";
@@ -102,6 +117,25 @@ pub trait FromBase64 {
     fn from_base64(&self) -> ~[u8];
 }
 
+/**
+ * Turn a vector of `u8`s representing characters
+ * encoding byte values in base64 into the vector of `u8` byte values.
+ *
+ * *Example*:
+ *
+ * ~~~~
+ * extern mod std;
+ * use std::base64::ToBase64;
+ * use std::base64::FromBase64;
+ *
+ * fn main () {
+ *   let str = [52,32].to_base64();
+ *   println(fmt!("%s", str));
+ *   let bytes = str.from_base64();
+ *   println(fmt!("%?",bytes));
+ * }
+ * ~~~~
+ */
 impl FromBase64 for ~[u8] {
     fn from_base64(&self) -> ~[u8] {
         if self.len() % 4u != 0u { fail!(~"invalid base64 length"); }