diff --git a/stan.go b/stan.go
index c3d01dd..7bafc67 100644
--- a/stan.go
+++ b/stan.go
@@ -132,6 +132,8 @@ var DefaultOptions = Options{
 type Option func(*Options) error
 
 // NatsURL is an Option to set the URL the client should connect to.
+// The url can contain username/password semantics. e.g. nats://derek:pass@localhost:4222
+// Comma separated arrays are also supported, e.g. urlA, urlB.
 func NatsURL(u string) Option {
 	return func(o *Options) error {
 		o.NatsURL = u