first pass at sphinx docs

Author: wraithan

.gitignore

@@ -1 +1,2 @@
 node_modules/
+_build/

README.md README.rst

@@ -1,77 +1,81 @@
-NodeJS IRC client library
-=========================
+`node-irc`_ is an IRC client library written in JavaScript_ for Node_.
 
-How to get it
+.. _`node-irc`: http://node-irc.readthedocs.org/
+.. _JavaScript: http://en.wikipedia.org/wiki/JavaScript
+.. _Node: http://nodejs.org/
+
+Installation
 -------------
 
-The easiest way to get it is via [npm][]
+The easiest way to get it is via npm_::
 
     npm install irc
 
-If you want to run the latest version (i.e. later than the version available
-via [npm][]) you can clone this repo, then use [npm][] to link-install it:
+If you want to run the latest version (i.e. later than the version available via
+npm_) you can clone this repo, then use npm_ to link-install it::
 
     npm link /path/to/your/clone
 
 Of course, you can just clone this, and manually point at the library itself,
-but I really recommend using [npm][]!
+but I really recommend using npm_!
 
-How to use it
+Basic Usage
 -------------
 
 This library provides basic IRC client functionality. In the simplest case you
-can connect to an IRC server like so:
+can connect to an IRC server like so::
 
     var irc = require('irc');
     var client = new irc.Client('irc.dollyfish.net.nz', 'myNick', {
-        channels: ['#blah'],
+	channels: ['#blah'],
     });
 
 Of course it's not much use once it's connected if that's all you have!
 
 The client emits a large number of events that correlate to things you'd
-normally see in your favourite IRC client. Most likely the first one you'll
-want to use is:
+normally see in your favourite IRC client. Most likely the first one you'll want
+to use is::
 
     client.addListener('message', function (from, to, message) {
-        console.log(from + ' => ' + to + ': ' + message);
+	console.log(from + ' => ' + to + ': ' + message);
     });
 
-or if you're only interested in messages to the bot itself:
+or if you're only interested in messages to the bot itself::
 
     client.addListener('pm', function (from, message) {
-        console.log(from + ' => ME: ' + message);
+	console.log(from + ' => ME: ' + message);
     });
 
-or to a particular channel:
+or to a particular channel::
 
     client.addListener('message#yourchannel', function (from, message) {
-        console.log(from + ' => #yourchannel: ' + message);
+	console.log(from + ' => #yourchannel: ' + message);
     });
 
-At the moment there are functions for joining:
+At the moment there are functions for joining::
 
     client.join('#yourchannel');
 
-parting:
+parting::
 
     client.part('#yourchannel');
 
-talking:
+talking::
 
     client.say('#yourchannel', "I'm a bot!");
     client.say('nonbeliever', "SRSLY, I AM!");
 
 and many others. Check out the API documentation for a complete reference.
 
 For any commands that there aren't methods for you can use the send() method
-which sends raw messages to the server:
+which sends raw messages to the server::
 
     client.send('MODE', '#yourchannel', '+o', 'yournick');
 
-All commands and events are documented in `API.md` (hopefully). If you find any
-methods/events missing that you'd really like to have included feel free to
-send me a pull request (preferred) or file an issue and I'll try get around to
+All commands and events are documented here_ (hopefully). If you find any
+methods/events missing that you'd really like to have included feel free to send
+me a pull request (preferred) or file an issue and I'll try get around to
 writing it.
 
-[npm]: http://github.com/isaacs/npm
+.. _npm: http://github.com/isaacs/npm
+.. _here: http://node-irc.readthedocs.org/en/latest/API.html