readme: move description of options to inline comment

Part of #123

Author: ligurio

README.md

@@ -26,7 +26,6 @@ faster than other packages according to public benchmarks.
 * [API reference](#api-reference)
 * [Walking\-through example in Go](#walking-through-example-in-go)
 * [Help](#help)
-* [Options](#options)
 * [Tests](#tests)
 * [Alternative connectors](#alternative-connectors)
 
@@ -172,17 +171,6 @@ To contact `go-tarantool` developers on any problems, create an issue at
 The developers of the [Tarantool server](http://github.com/tarantool/tarantool)
 will also be happy to provide advice or receive feedback.
 
-## Options
-
-* `Timeout` - timeout for any particular request. If `Timeout` is zero request,
-  any request may block infinitely.
-* `Reconnect` - timeout between reconnect attempts. If `Reconnect` is zero, no
-  reconnects will be performed.
-* `MaxReconnects` - maximal number of reconnect failures; after that we give it
-  up. If `MaxReconnects` is zero, the client will try to reconnect endlessly.
-* `User` - user name to log into Tarantool.
-* `Pass` - user password to log into Tarantool.
-
 ## Multi connections
 
 You can use multiple connections config with tarantool/multi. 

connection.go

@@ -158,21 +158,25 @@ type Greeting struct {
 
 // Opts is a way to configure Connection
 type Opts struct {
-	// Timeout is requests timeout.
-	// Also used to setup net.TCPConn.Set(Read|Write)Deadline.
+	// Timeout is a timeout for any particular request. If Timeout is
+	// zero request, any request may block infinitely.
+	// Also used to setup net.TCPConn.Set(Read|Write)Deadline
 	Timeout time.Duration
-	// Reconnect is a pause between reconnection attempts.
+	// Reconnect is a timeout between reconnect attempts. If Reconnect is
+	// zero, no reconnects will be performed.
 	// If specified, then when Tarantool is not reachable or disconnected,
 	// new connect attempt is performed after pause.
 	// By default, no reconnection attempts are performed,
 	// so once disconnected, connection becomes Closed.
 	Reconnect time.Duration
-	// MaxReconnects is a maximum reconnect attempts.
+	// MaxReconnects is a maximal number of reconnect failures; after that
+	// we give it up. If MaxReconnects is zero, the client will try to
+	// reconnect endlessly.
 	// After MaxReconnects attempts Connection becomes closed.
 	MaxReconnects uint
-	// User name for authorization.
+	// User is user name to log into Tarantool.
 	User string
-	// Pass is password for authorization.
+	// Pass is a user password to log into Tarantool.
 	Pass string
 	// RateLimit limits number of 'in-fly' request, i.e. already put into
 	// requests queue, but not yet answered by server or timeouted.