Doc tweaks

Author: AndrewBurian

client.go

@@ -6,6 +6,8 @@ import (
 	"sync"
 )
 
+// Client wraps an http connection and converts it to an
+// event stream.
 type Client struct {
 	flush  http.Flusher
 	write  io.Writer
@@ -15,6 +17,10 @@ type Client struct {
 	waiter sync.WaitGroup
 }
 
+// Creates a client wrapping a response writer.
+// The response writer must support http.Flusher and http.CloseNotifier
+// interfaces.
+// Returns nil on error.
 func NewClient(w http.ResponseWriter) *Client {
 	c := &Client{
 		events: make(chan *Event, 1),

stream.go

@@ -175,7 +175,8 @@ func (s *Stream) TopicHandler(topics []string) http.HandlerFunc {
 }
 
 // Register a function to be called when a client connects to this stream's
-// HTTP handler
+// HTTP handler.
+// Only one handler may be registered. Further calls overwrite the previous.
 func (s *Stream) ClientConnectHook(fn func(*http.Request, *Client)) {
 	s.clientConnectHook = fn
 }