update readme

diff --git a/README.md b/README.md
index d061cc73516f0e96af33a980a8ff860337cf522a..df1ca47abb0f1f5778632dadae47c50fedaf8b83 100644 (file)
--- a/README.md
+++ b/README.md
@@ -70,8 +70,13 @@ instead of the **node.js core** module named `buffer`!
 
 ## how does it work?
 
-`Buffer` is a subclass of `Uint8Array` augmented with all the `Buffer` API methods.
-The `Uint8Array` prototype is not modified.
+The Buffer constructor returns instances of `Uint8Array` that have their prototype
+changed to `Buffer.prototype`. Furthermore, `Buffer` is a subclass of `Uint8Array`,
+so the returned instances will have all the node `Buffer` methods and the
+`Uint8Array` methods. Square bracket notation works as expected -- it returns a
+single octet.
+
+The `Uint8Array` prototype remains unmodified.
 
 
 ## one minor difference

diff --git a/index.js b/index.js
index 1d2286890466b82321b5f35083f6f36846d7dc71..15d7c50f8e30de4f0eb8b2fc7afa57440a466ce6 100644 (file)
--- a/index.js
+++ b/index.js
@@ -66,16 +66,13 @@ function kMaxLength () {
 }
 
 /**
- * Class: Buffer
- * =============
+ * The Buffer constructor returns instances of `Uint8Array` that have their
+ * prototype changed to `Buffer.prototype`. Furthermore, `Buffer` is a subclass of
+ * `Uint8Array`, so the returned instances will have all the node `Buffer` methods
+ * and the `Uint8Array` methods. Square bracket notation works as expected -- it
+ * returns a single octet.
  *
- * The Buffer constructor returns instances of `Uint8Array` that are augmented
- * with function properties for all the node `Buffer` API functions. We use
- * `Uint8Array` so that square bracket notation works as expected -- it returns
- * a single octet.
- *
- * By augmenting the instances, we can avoid modifying the `Uint8Array`
- * prototype.
+ * The `Uint8Array` prototype remains unmodified.
  */
 function Buffer (arg) {
   if (!(this instanceof Buffer)) {