From 5749f9181480dc69c8e4b1d4755d50b8d9af56c7 Mon Sep 17 00:00:00 2001
From: Marco Rogers <marco.rogers@gmail.com>
Date: Sun, 21 Nov 2010 00:28:19 -0500
Subject: [PATCH] Docs for util.inherits

---
 doc/api/util.markdown | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/doc/api/util.markdown b/doc/api/util.markdown
index 1c077f6ef2..6076239658 100644
--- a/doc/api/util.markdown
+++ b/doc/api/util.markdown
@@ -48,3 +48,37 @@ When `writeableStream.write(data)` returns `false` `readableStream` will be
 paused until the `drain` event occurs on the `writableStream`. `callback` gets
 an error as its only argument and is called when `writableStream` is closed or
 when an error occurs.
+
+
+### util.inherits(constructor, superConstructor)
+
+Inherit the prototype methods from one
+[constructor](https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Object/constructor)
+into another.  The prototype of `constructor` will be set to a new
+object created from `superConstructor`.
+
+As an additional convenience, `superConstructor` will be accessible
+through the `constructor.super_` property.
+
+    var util = require("util");
+    var events = require("events");
+
+    function MyStream() {
+        events.EventEmitter.call(this);
+    }
+
+    util.inherits(MyStream, events.EventEmitter);
+
+    MyStream.prototype.write = function(data) {
+        this.emit("data", data);
+    }
+
+    var stream = new MyStream();
+
+    console.log(stream instanceof events.EventEmitter); // true
+    console.log(MyStream.super_ === events.EventEmitter); // true
+
+    stream.on("data", function(data) {
+        console.log('Received data: "' + data + '"');
+    })
+    stream.write("It works!"); // Received data: "It works!"