Document NormalizeErr func.

mdwhatcott · mdwhatcott · commit 2a93c2ccf5d4 · 2025-09-16T11:04:19.000-06:00
diff --git a/sqldb.go b/sqldb.go
@@ -79,6 +79,10 @@ func RowsAffected(result sql.Result, err error) (uint64, error) {
 	}
 	return uint64(rows), nil
 }
+
+// NormalizeErr attaches a stack trace to non-nil errors and also normalizes errors that are
+// semantically equal to context.Canceled. At present we are unaware whether this is still a
+// commonly encountered scenario.
 func NormalizeErr(err error) error {
 	if err == nil {
 		return nil

Original file line number	Diff line number	Diff line change
`@@ -79,6 +79,10 @@ func RowsAffected(result sql.Result, err error) (uint64, error) {`
`79`	`79`	`}`
`80`	`80`	`return uint64(rows), nil`
`81`	`81`	`}`
	`82`	`+`
	`83`	`+// NormalizeErr attaches a stack trace to non-nil errors and also normalizes errors that are`
	`84`	`+// semantically equal to context.Canceled. At present we are unaware whether this is still a`
	`85`	`+// commonly encountered scenario.`
`82`	`86`	`func NormalizeErr(err error) error {`
`83`	`87`	`if err == nil {`
`84`	`88`	`return nil`