database/sql: improve the documentation of Conn.Raw

Fixes #47500

Change-Id: Ibd44e4db15ea45bb53a6651a6567edfe6104d3d6
GitHub-Last-Rev: 61b8abbc28908fc807af7188e19089ac454b4817
GitHub-Pull-Request: golang/go#47503
Reviewed-on: https://go-review.googlesource.com/c/go/+/338970
Reviewed-by: Daniel Theophanes <kardianos@gmail.com>
Trust: Cherry Mui <cherryyz@google.com>

diff --git a/src/database/sql/sql.go b/src/database/sql/sql.go
index 68fb392e0dbb45f5f4246fa8f95797250dee0735..b40b5c8fe46349d7b1955b531bfbf260c20b126b 100644 (file)
--- a/src/database/sql/sql.go
+++ b/src/database/sql/sql.go
@@ -2002,8 +2002,8 @@ func (c *Conn) PrepareContext(ctx context.Context, query string) (*Stmt, error)
 // Raw executes f exposing the underlying driver connection for the
 // duration of f. The driverConn must not be used outside of f.
 //
-// Once f returns and err is nil, the Conn will continue to be usable
-// until Conn.Close is called.
+// Once f returns and err is not equal to driver.ErrBadConn, the Conn will
+// continue to be usable until Conn.Close is called.
 func (c *Conn) Raw(f func(driverConn interface{}) error) (err error) {
        var dc *driverConn
        var release releaseConn