From: Brad Fitzpatrick <bradfitz@golang.org>
Date: Wed, 30 Oct 2013 00:38:43 +0000 (-0700)
Subject: database/sql: document Result methods
X-Git-Tag: go1.3beta1~1369
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=7307ffa7cd97bb6a290914efd856a8ae4076e6e5;p=gostls13.git

database/sql: document Result methods

Fixes #5110

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/19280046
---

diff --git a/src/pkg/database/sql/sql.go b/src/pkg/database/sql/sql.go
index b24b2a8a55..dddf5a3f25 100644
--- a/src/pkg/database/sql/sql.go
+++ b/src/pkg/database/sql/sql.go
@@ -1637,7 +1637,16 @@ func (r *Row) Scan(dest ...interface{}) error {
 
 // A Result summarizes an executed SQL command.
 type Result interface {
+	// LastInsertId returns the integer generated by the database
+	// in response to a command. Typically this will be from an
+	// "auto increment" column when inserting a new row. Not all
+	// databases support this feature, and the syntax of such
+	// statements varies.
 	LastInsertId() (int64, error)
+
+	// RowsAffected returns the number of rows affected by an
+	// update, insert, or delete. Not every database or database
+	// driver may support this.
 	RowsAffected() (int64, error)
 }