Adds a few examples to the documentation.

message_test.go

@@ -5,10 +5,35 @@
 package irc
 
 import (
+	"fmt"
 	"reflect"
 	"testing"
 )
 
+func ExampleParseMessage() {
+	message := ParseMessage("JOIN #help")
+
+	fmt.Println(message.Params[0])
+
+	// Output: #help
+}
+
+func ExampleMessage_String() {
+	message := &Message{
+		Prefix: &Prefix{
+			Name: "sorcix",
+			User: "sorcix",
+			Host: "myhostname",
+		},
+		Command:  "PRIVMSG",
+		Trailing: "This is an example!",
+	}
+
+	fmt.Println(message.String())
+
+	// Output: :sorcix!sorcix@myhostname PRIVMSG :This is an example!
+}
+
 var messageTests = [...]*struct {
 	parsed     *Message
 	rawMessage string

stream_test.go

@@ -6,12 +6,36 @@ package irc
 
 import (
 	"bytes"
+	"crypto/tls"
 	"io"
+	"log"
 	"reflect"
 	"strings"
 	"testing"
 )
 
+// We use the Dial function as a simple shortcut for connecting to an IRC server using a standard TCP socket.
+func ExampleDial() {
+	conn, err := Dial("irc.quakenet.org:6667")
+	if err != nil {
+		log.Fatalln("Could not connect to IRC server")
+	}
+
+	conn.Close()
+}
+
+// Use NewConn when you want to connect using something else than a standard TCP socket.
+// This example first opens an encrypted TLS connection and then uses that to communicate with the server.
+func ExampleNewConn() {
+	tconn, err := tls.Dial("tcp", "irc.quakenet.org:6667", &tls.Config{})
+	if err != nil {
+		log.Fatalln("Could not connect to IRC server")
+	}
+	conn := NewConn(tconn)
+
+	conn.Close()
+}
+
 var stream = "PING port80a.se.quakenet.org\r\n:port80a.se.quakenet.org PONG port80a.se.quakenet.org :port80a.se.quakenet.org\r\nPING chat.freenode.net\r\n:wilhelm.freenode.net PONG wilhelm.freenode.net :chat.freenode.net\r\n"
 
 var result = [...]*Message{