diff --git a/lib/buffer.js b/lib/buffer.js
index <HASH>..<HASH> 100644
--- a/lib/buffer.js
+++ b/lib/buffer.js
@@ -6,11 +6,12 @@
 module.exports = {
   
   /**
-   * [indexOf description]
+   * Returns the index of the first occurrence of the specified byte sequence,
+   * returns -1 if the value is not found.
    * 
-   * @param  {[type]} needle   [description]
-   * @param  {[type]} haystack [description]
-   * @return {[type]}          [description]
+   * @param  {[type]} needle
+   * @param  {[type]} haystack
+   * @return {[type]} 
    */
   indexOf: function( needle, haystack ) {
     
@@ -39,11 +40,12 @@ module.exports = {
   },
   
   /**
-   * [split description]
+   * Splits a Buffer object into an array of buffers
+   * by separating the Buffer into subbuffers.
    * 
-   * @param  {[type]} needle   [description]
-   * @param  {[type]} haystack [description]
-   * @return {[type]}          [description]
+   * @param  {[type]} needle
+   * @param  {[type]} haystack
+   * @return {[type]} 
    */
   split: function( needle, haystack ) {
Updated doc blocks in lib/buffer.js