From 99c9a35982f2cf5522bc8f3eb95d5d29c8ccefaf Mon Sep 17 00:00:00 2001
From: Anton Kaliaev <anton.kalyaev@gmail.com>
Date: Tue, 4 Jun 2019 10:05:22 +0900
Subject: [PATCH] docs: update RPC docs for /subscribe & /unsubscribe (#3705)

Fixes #3678

Co-Authored-By: Ethan Buchman <ethan@coinculture.info>
---
 rpc/core/events.go | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/rpc/core/events.go b/rpc/core/events.go
index 6bc5ecc7a..4b05e5ce1 100644
--- a/rpc/core/events.go
+++ b/rpc/core/events.go
@@ -50,7 +50,6 @@ import (
 // https://godoc.org/github.com/tendermint/tendermint/libs/pubsub/query.
 //
 // ```go
-// import "github.com/tendermint/tendermint/libs/pubsub/query"
 // import "github.com/tendermint/tendermint/types"
 //
 // client := client.NewHTTP("tcp://0.0.0.0:26657", "/websocket")
@@ -59,15 +58,17 @@ import (
 //   // handle error
 // }
 // defer client.Stop()
-// ctx, cancel := context.WithTimeout(context.Background(), timeout)
+// ctx, cancel := context.WithTimeout(context.Background(), 1 * time.Second)
 // defer cancel()
-// query := query.MustParse("tm.event = 'Tx' AND tx.height = 3")
-// txs := make(chan interface{})
-// err = client.Subscribe(ctx, "test-client", query, txs)
+// query := "tm.event = 'Tx' AND tx.height = 3"
+// txs, err := client.Subscribe(ctx, "test-client", query)
+// if err != nil {
+//   // handle error
+// }
 //
 // go func() {
 //   for e := range txs {
-//     fmt.Println("got ", e.(types.EventDataTx))
+//     fmt.Println("got ", e.Data.(types.EventDataTx))
 //	 }
 // }()
 // ```
@@ -154,7 +155,11 @@ func Subscribe(ctx *rpctypes.Context, query string) (*ctypes.ResultSubscribe, er
 //   // handle error
 // }
 // defer client.Stop()
-// err = client.Unsubscribe("test-client", query)
+// query := "tm.event = 'Tx' AND tx.height = 3"
+// err = client.Unsubscribe(context.Background(), "test-client", query)
+// if err != nil {
+//   // handle error
+// }
 // ```
 //
 // > The above command returns JSON structured like this:
@@ -198,7 +203,10 @@ func Unsubscribe(ctx *rpctypes.Context, query string) (*ctypes.ResultUnsubscribe
 //   // handle error
 // }
 // defer client.Stop()
-// err = client.UnsubscribeAll("test-client")
+// err = client.UnsubscribeAll(context.Background(), "test-client")
+// if err != nil {
+//   // handle error
+// }
 // ```
 //
 // > The above command returns JSON structured like this: