Add missing comments

Author: DerekBum

response.go

@@ -10,17 +10,27 @@ import (
 )
 
 type Response interface {
+	// Header returns a response header.
 	Header() Header
+	// Decode decodes a response.
+	// After a first Decode call,
+	// all next calls will return the result of a first one
+	// and no decoding will be done.
 	Decode() ([]interface{}, error)
+	// DecodeTyped decodes a response into a given container res.
+	// This method could be called multiple times.
 	DecodeTyped(res interface{}) error
 }
 
 type baseResponse struct {
+	// header is a response header.
 	header Header
 	// data contains deserialized data for untyped requests.
-	data         []interface{}
-	buf          smallBuf
-	decoded      bool
+	data []interface{}
+	buf  smallBuf
+	// Was the Decode() func called for this response.
+	decoded bool
+	// Was the DecodeTyped() func called for this response.
 	decodedTyped bool
 	err          error
 }
@@ -39,6 +49,7 @@ func createBaseResponse(header Header, body io.Reader) (baseResponse, error) {
 	return baseResponse{header: header, buf: smallBuf{b: data}}, nil
 }
 
+// PushResponse is used for push requests for the Future.
 type PushResponse struct {
 	baseResponse
 }
@@ -51,18 +62,24 @@ func createPushResponse(header Header, body io.Reader) (Response, error) {
 	return &PushResponse{resp}, nil
 }
 
+// SelectResponse is used for the select requests.
+// It might contain a position descriptor of the last selected tuple.
 type SelectResponse struct {
 	baseResponse
 	// pos contains a position descriptor of last selected tuple.
 	pos []byte
 }
 
+// PrepareResponse is used for the prepare requests.
+// It might contain meta-data and sql info.
 type PrepareResponse struct {
 	baseResponse
 	metaData []ColumnMetaData
 	sqlInfo  SQLInfo
 }
 
+// ExecuteResponse is used for the execute requests.
+// It might contain meta-data and sql info.
 type ExecuteResponse struct {
 	baseResponse
 	metaData []ColumnMetaData
@@ -83,9 +100,12 @@ type SQLInfo struct {
 	InfoAutoincrementIds []uint64
 }
 
+// Header is a response header.
 type Header struct {
+	// RequestId is an id of a corresponding request.
 	RequestId uint32
-	Code      int
+	// Code is a response code.
+	Code int
 }
 
 func (meta *ColumnMetaData) DecodeMsgpack(d *msgpack.Decoder) error {
@@ -786,41 +806,52 @@ func (resp *baseResponse) Header() Header {
 	return resp.header
 }
 
+// Pos returns a position descriptor of the last selected tuple for the SelectResponse.
+// If the response was not decoded, this method will call Decode().
 func (resp *SelectResponse) Pos() ([]byte, error) {
 	if !resp.decoded && !resp.decodedTyped {
 		resp.Decode()
 	}
 	return resp.pos, resp.err
 }
 
+// MetaData returns PrepareResponse meta-data.
+// If the response was not decoded, this method will call Decode().
 func (resp *PrepareResponse) MetaData() ([]ColumnMetaData, error) {
 	if !resp.decoded && !resp.decodedTyped {
 		resp.Decode()
 	}
 	return resp.metaData, resp.err
 }
 
+// SQLInfo returns PrepareResponse sql info.
+// If the response was not decoded, this method will call Decode().
 func (resp *PrepareResponse) SQLInfo() (SQLInfo, error) {
 	if !resp.decoded && !resp.decodedTyped {
 		resp.Decode()
 	}
 	return resp.sqlInfo, resp.err
 }
 
+// MetaData returns ExecuteResponse meta-data.
+// If the response was not decoded, this method will call Decode().
 func (resp *ExecuteResponse) MetaData() ([]ColumnMetaData, error) {
 	if !resp.decoded && !resp.decodedTyped {
 		resp.Decode()
 	}
 	return resp.metaData, resp.err
 }
 
+// SQLInfo returns ExecuteResponse sql info.
+// If the response was not decoded, this method will call Decode().
 func (resp *ExecuteResponse) SQLInfo() (SQLInfo, error) {
 	if !resp.decoded && !resp.decodedTyped {
 		resp.Decode()
 	}
 	return resp.sqlInfo, resp.err
 }
 
+// String implements Stringer interface.
 func (resp *baseResponse) String() (str string) {
 	if resp.header.Code == OkCode {
 		return fmt.Sprintf("<%d OK %v>", resp.header.RequestId, resp.data)