updating docs

_examples/connect_creds.html

@@ -29,7 +29,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="connect_creds_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_creds/main.go#L10-19"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;localhost&#34;, nats.UserCredentials(&#34;path_to_creds_file&#34;))
+	<pre id="connect_creds_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_creds/main.go#L10-19"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;127.0.0.1&#34;, nats.UserCredentials(&#34;path_to_creds_file&#34;))
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_multiple.html

@@ -34,10 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="connect_multiple_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_multiple/main.go#L11-25"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">servers := []string{&#34;nats://localhost:1222&#34;,
-	&#34;nats://localhost:1223&#34;,
-	&#34;nats://localhost:1224&#34;,
-}
+	<pre id="connect_multiple_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_multiple/main.go#L11-22"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">servers := []string{&#34;nats://127.0.0.1:1222&#34;, &#34;nats://127.0.0.1:1223&#34;, &#34;nats://127.0.0.1:1224&#34;}
 
 nc, err := nats.Connect(strings.Join(servers, &#34;,&#34;))
 if err != nil {

_examples/connect_name.html

@@ -35,7 +35,7 @@
   	
 	<div class="tab__content">
 	<pre id="connect_name_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_name/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set a connection name
-nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;my-connection&#34;))
+nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;API Name Example&#34;))
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_nkey.html

@@ -33,7 +33,7 @@
 if err != nil {
 	log.Fatal(err)
 }
-nc, err := nats.Connect("localhost", opt)
+nc, err := nats.Connect("127.0.0.1", opt)
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_options.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="connect_options_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_options/main.go#L11-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(nats.DefaultURL, nats.Timeout(10*time.Second))
+	<pre id="connect_options_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_options/main.go#L11-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;API Options Example&#34;), nats.Timeout(10*time.Second))
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_status.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="connect_status_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_status/main.go#L10-33"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="connect_status_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_status/main.go#L10-33"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;API Example&#34;))
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_tls_url.html

@@ -34,9 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="connect_tls_url_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_tls_url/main.go#L10-21"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;localhost&#34;,
-	nats.Secure(),
-	nats.RootCAs(&#34;resources/certs/ca.pem&#34;)) // May need this if server is using self-signed certificate
+	<pre id="connect_tls_url_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_tls_url/main.go#L10-19"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;tls://localhost&#34;, nats.RootCAs(&#34;resources/certs/ca.pem&#34;)) // May need this if server is using self-signed certificate
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_token.html

@@ -35,7 +35,7 @@
   	
 	<div class="tab__content">
 	<pre id="connect_token_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_token/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set a token
-nc, err := nats.Connect(&#34;localhost&#34;, nats.Token(&#34;mytoken&#34;))
+nc, err := nats.Connect(&#34;127.0.0.1&#34;, nats.Name(&#34;API Token Example&#34;), nats.Token(&#34;mytoken&#34;))
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_userpass.html

@@ -35,7 +35,7 @@
   	
 	<div class="tab__content">
 	<pre id="connect_userpass_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_userpass/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set a user and plain text password
-nc, err := nats.Connect(&#34;localhost&#34;, nats.UserInfo(&#34;myname&#34;, &#34;password&#34;))
+nc, err := nats.Connect(&#34;127.0.0.1&#34;, nats.UserInfo(&#34;myname&#34;, &#34;password&#34;))
 if err != nil {
 	log.Fatal(err)
 }

_examples/connect_userpass_url.html

@@ -35,7 +35,7 @@
   	
 	<div class="tab__content">
 	<pre id="connect_userpass_url_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/connect_userpass_url/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set a user and plain text password
-nc, err := nats.Connect(&#34;myname:password@localhost&#34;)
+nc, err := nats.Connect(&#34;myname:password@127.0.0.1&#34;)
 if err != nil {
 	log.Fatal(err)
 }

_examples/drain_conn.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="drain_conn_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/drain_conn/main.go#L12-61"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">wg := sync.WaitGroup{}
+	<pre id="drain_conn_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/drain_conn/main.go#L12-64"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">wg := sync.WaitGroup{}
 wg.Add(1)
 
 errCh := make(chan error, 1)
@@ -55,15 +55,18 @@ if err != nil {
 	log.Fatal(err)
 }
 
+// Just to not collide using the demo server with other users.
+subject := nats.NewInbox()
+
 // Subscribe, but add some delay while processing.
-if _, err := nc.Subscribe(&#34;foo&#34;, func(_ *nats.Msg) {
+if _, err := nc.Subscribe(subject, func(_ *nats.Msg) {
 	time.Sleep(200 * time.Millisecond)
 }); err != nil {
 	log.Fatal(err)
 }
 
 // Publish a message
-if err := nc.Publish(&#34;foo&#34;, []byte(&#34;hello&#34;)); err != nil {
+if err := nc.Publish(subject, []byte(&#34;hello&#34;)); err != nil {
 	log.Fatal(err)
 }
 

_examples/drain_sub.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="drain_sub_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/drain_sub/main.go#L13-67"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">
+	<pre id="drain_sub_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/drain_sub/main.go#L13-70"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">
 	nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 	if err != nil {
 		log.Fatal(err)
@@ -49,8 +49,11 @@
 
 	msgAfterDrain := &#34;not this one&#34;
 
+	// Just to not collide using the demo server with other users.
+	subject := nats.NewInbox()
+
 	// This callback will process each message slowly
-	sub, err := nc.Subscribe(&#34;updates&#34;, func(m *nats.Msg) {
+	sub, err := nc.Subscribe(subject, func(m *nats.Msg) {
 		if string(m.Data) == msgAfterDrain {
 			errCh &lt;- fmt.Errorf(&#34;Should not have received this message&#34;)
 			return
@@ -64,7 +67,7 @@
 
 	// Send 2 messages
 	for i := 0; i &lt; 2; i&#43;&#43; {
-		nc.Publish(&#34;updates&#34;, []byte(&#34;hello&#34;))
+		nc.Publish(subject, []byte(&#34;hello&#34;))
 	}
 
 	// Call Drain on the subscription. It unsubscribes but
@@ -74,7 +77,7 @@
 	}
 
 	// Send one more message, this message should not be received
-	nc.Publish(&#34;updates&#34;, []byte(msgAfterDrain))
+	nc.Publish(subject, []byte(msgAfterDrain))
 
 	// Wait for the subscription to have processed the 2 messages.
 	done.Wait()

_examples/error_listener.html

@@ -36,7 +36,7 @@
 	<div class="tab__content">
 	<pre id="error_listener_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/error_listener/main.go#L10-23"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set the callback that will be invoked when an asynchronous error occurs.
 nc, err := nats.Connect(&#34;demo.nats.io&#34;,
-	nats.ErrorHandler(func(nc *nats.Conn, sub *nats.Subscription, err error) {
+	nats.ErrorHandler(func(_ *nats.Conn, _ *nats.Subscription, err error) {
 		log.Printf(&#34;Error: %v&#34;, err)
 	}))
 if err != nil {

_examples/flush.html

@@ -34,17 +34,20 @@
 
   	
 	<div class="tab__content">
-	<pre id="flush_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/flush/main.go#L11-26"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="flush_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/flush/main.go#L11-29"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
 defer nc.Close()
 
-if err := nc.Publish(&#34;updates&#34;, []byte(&#34;All is Well&#34;)); err != nil {
+// Just to not collide using the demo server with other users.
+subject := nats.NewInbox()
+
+if err := nc.Publish(subject, []byte(&#34;All is Well&#34;)); err != nil {
 	log.Fatal(err)
 }
 // Sends a PING and wait for a PONG from the server, up to the given timeout.
-// This gives guarantee that the server has processed above message.
+// This gives guarantee that the server has processed the above message.
 if err := nc.FlushTimeout(time.Second); err != nil {
 	log.Fatal(err)
 }

_examples/no_echo.html

@@ -35,7 +35,7 @@
   	
 	<div class="tab__content">
 	<pre id="no_echo_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/no_echo/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Turn off echo
-nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.NoEcho())
+nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;API NoEcho Example&#34;), nats.NoEcho())
 if err != nil {
 	log.Fatal(err)
 }

_examples/ping_20s.html

@@ -35,7 +35,7 @@
   	
 	<div class="tab__content">
 	<pre id="ping_20s_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/ping_20s/main.go#L11-21"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set Ping Interval to 20 seconds
-nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.PingInterval(20*time.Second))
+nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;API Ping Example&#34;), nats.PingInterval(20*time.Second))
 if err != nil {
 	log.Fatal(err)
 }

_examples/ping_5.html

@@ -34,19 +34,16 @@
 
   	
 	<div class="tab__content">
-	<pre id="ping_5_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/ping_5/main.go#L10-25"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">opts := nats.GetDefaultOptions()
-opts.Url = &#34;demo.nats.io&#34;
-// Set maximum number of PINGs out without getting a PONG back
-// before the connection will be disconnected as a stale connection.
-opts.MaxPingsOut = 5
+	<pre id="ping_5_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/ping_5/main.go#L10-22"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">
+	// Set maximum number of PINGs out without getting a PONG back
+	// before the connection will be disconnected as a stale connection.
+	nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;API MaxPing Example&#34;), nats.MaxPingsOutstanding(5))
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer nc.Close()
 
-nc, err := opts.Connect()
-if err != nil {
-	log.Fatal(err)
-}
-defer nc.Close()
-
-// Do something with the connection
+	// Do something with the connection
 
 </code></pre>
 	</div>

_examples/publish_bytes.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="publish_bytes_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/publish_bytes/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="publish_bytes_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/publish_bytes/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.Name(&#34;API PublishBytes Example&#34;))
 if err != nil {
 	log.Fatal(err)
 }

_examples/publish_json.html

@@ -34,13 +34,14 @@
 
   	
 	<div class="tab__content">
-	<pre id="publish_json_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/publish_json/main.go#L10-34"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="publish_json_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/publish_json/main.go#L10-33"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
+defer nc.Close()
+
 ec, err := nats.NewEncodedConn(nc, nats.JSON_ENCODER)
 if err != nil {
-	nc.Close()
 	log.Fatal(err)
 }
 defer ec.Close()
@@ -55,8 +56,6 @@ type stock struct {
 if err := ec.Publish(&#34;updates&#34;, &amp;stock{Symbol: &#34;GOOG&#34;, Price: 1200}); err != nil {
 	log.Fatal(err)
 }
-// Make sure the message goes through before we close
-ec.Flush()
 </code></pre>
 	</div>
 	

_examples/publish_with_reply.html

@@ -34,13 +34,13 @@
 
   	
 	<div class="tab__content">
-	<pre id="publish_with_reply_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/publish_with_reply/main.go#L11-43"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="publish_with_reply_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/publish_with_reply/main.go#L11-42"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
 defer nc.Close()
 
-// Create a unique subject name
+// Create a unique subject name for replies.
 uniqueReplyTo := nats.NewInbox()
 
 // Listen for a single response
@@ -49,7 +49,8 @@ if err != nil {
 	log.Fatal(err)
 }
 
-// Send the request
+// Send the request.
+// If processing is synchronous, use Request() which returns the response message.
 if err := nc.PublishRequest(&#34;time&#34;, uniqueReplyTo, nil); err != nil {
 	log.Fatal(err)
 }
@@ -63,8 +64,6 @@ if err != nil {
 // Use the response
 log.Printf(&#34;Reply: %s&#34;, msg.Data)
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>
 	

_examples/reconnect_no_random.html

@@ -34,9 +34,9 @@
 
   	
 	<div class="tab__content">
-	<pre id="reconnect_no_random_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/reconnect_no_random/main.go#L11-25"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">servers := []string{&#34;nats://localhost:1222&#34;,
-	&#34;nats://localhost:1223&#34;,
-	&#34;nats://localhost:1224&#34;,
+	<pre id="reconnect_no_random_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/reconnect_no_random/main.go#L11-25"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">servers := []string{&#34;nats://127.0.0.1:1222&#34;,
+	&#34;nats://127.0.0.1:1223&#34;,
+	&#34;nats://127.0.0.1:1224&#34;,
 }
 
 nc, err := nats.Connect(strings.Join(servers, &#34;,&#34;), nats.DontRandomize())

_examples/slow_listener.html

@@ -34,15 +34,8 @@
 
   	
 	<div class="tab__content">
-	<pre id="slow_listener_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/slow_listener/main.go#L10-27"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set the callback that will be invoked when an asynchronous error occurs.
-nc, err := nats.Connect(&#34;demo.nats.io&#34;,
-	nats.ErrorHandler(func(nc *nats.Conn, sub *nats.Subscription, err error) {
-		if err == nats.ErrSlowConsumer {
-			dropped, _ := sub.Dropped()
-			log.Printf(&#34;Slow consumer on subject %s dropped %d messages\n&#34;,
-				sub.Subject, dropped)
-		}
-	}))
+	<pre id="slow_listener_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/slow_listener/main.go#L10-20"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">// Set the callback that will be invoked when an asynchronous error occurs.
+nc, err := nats.Connect(&#34;demo.nats.io&#34;, nats.ErrorHandler(logSlowConsumer))
 if err != nil {
 	log.Fatal(err)
 }

_examples/subscribe_async.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="subscribe_async_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_async/main.go#L11-34"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="subscribe_async_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_async/main.go#L11-32"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -54,8 +54,6 @@ if _, err := nc.Subscribe(&#34;updates&#34;, func(m *nats.Msg) {
 // Wait for a message to come in
 wg.Wait()
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>
 	

_examples/subscribe_json.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="subscribe_json_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_json/main.go#L11-45"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="subscribe_json_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_json/main.go#L11-43"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -65,8 +65,6 @@ if _, err := ec.Subscribe(&#34;updates&#34;, func(s *stock) {
 // Wait for a message to come in
 wg.Wait()
 
-// Close the connection
-ec.Close()
 </code></pre>
 	</div>
 	

_examples/subscribe_queue.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="subscribe_queue_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_queue/main.go#L11-34"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="subscribe_queue_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_queue/main.go#L11-32"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -54,8 +54,6 @@ if _, err := nc.QueueSubscribe(&#34;updates&#34;, &#34;worker&#34;, func(m *nats
 // Wait for messages to come in
 wg.Wait()
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>
 	

_examples/subscribe_star.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="subscribe_star_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_star/main.go#L11-35"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="subscribe_star_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_star/main.go#L11-33"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -55,8 +55,6 @@ if _, err := nc.Subscribe(&#34;time.*.east&#34;, func(m *nats.Msg) {
 // Wait for the 2 messages to come in
 wg.Wait()
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>
 	

_examples/subscribe_sync.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="subscribe_sync_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_sync/main.go#L11-35"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="subscribe_sync_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_sync/main.go#L11-33"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -55,8 +55,6 @@ if err != nil {
 // Use the response
 log.Printf(&#34;Reply: %s&#34;, msg.Data)
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>
 	

_examples/subscribe_w_reply.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="subscribe_w_reply_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_w_reply/main.go#L11-35"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="subscribe_w_reply_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/subscribe_w_reply/main.go#L11-36"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -55,8 +55,9 @@ if err != nil {
 // Get the time
 timeAsBytes := []byte(time.Now().String())
 
-// Send the time
-nc.Publish(msg.Reply, timeAsBytes)
+// Send the time as the response.
+msg.Respond(timeAsBytes)
+
 </code></pre>
 	</div>
 	

_examples/unsubscribe.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="unsubscribe_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/unsubscribe/main.go#L10-37"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="unsubscribe_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/unsubscribe/main.go#L10-35"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -58,8 +58,6 @@ if err := sub.Unsubscribe(); err != nil {
 	log.Fatal(err)
 }
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>
 	

_examples/unsubscribe_auto.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="unsubscribe_auto_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/unsubscribe_auto/main.go#L10-37"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="unsubscribe_auto_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/unsubscribe_auto/main.go#L10-35"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -58,8 +58,6 @@ if err := sub.AutoUnsubscribe(1); err != nil {
 	log.Fatal(err)
 }
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>
 	

_examples/wildcard_tester.html

@@ -34,7 +34,7 @@
 
   	
 	<div class="tab__content">
-	<pre id="wildcard_tester_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/wildcard_tester/main.go#L11-41"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
+	<pre id="wildcard_tester_go_content"><a class="toolbar-icons pull-right" target="_blank" href="https://github.com/nats-io/go-nats-examples/blob/master/api-examples/wildcard_tester/main.go#L11-39"><i class="mdi mdi-github-circle" title="View on GitHub"></i></a><a class="toolbar-icons pull-right"><i class="mdi mdi-content-copy js-copy" title="Copy to Clipboard"></i></a><span class="copy-msg pull-right"></span><code class="language-go">nc, err := nats.Connect(&#34;demo.nats.io&#34;)
 if err != nil {
 	log.Fatal(err)
 }
@@ -61,8 +61,6 @@ formatted = zoneDateTime.String()
 nc.Publish(&#34;time.eu.east&#34;, []byte(formatted))
 nc.Publish(&#34;time.eu.east.warsaw&#34;, []byte(formatted))
 
-// Close the connection
-nc.Close()
 </code></pre>
 	</div>