From: Russ Cox Date: Mon, 28 Nov 2022 16:02:52 +0000 (-0500) Subject: encoding/csv: use proper doc comment for Deprecated notes X-Git-Tag: go1.20rc1~38 X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=db4be8f510f0c4cddd45f51bcb24168414d9e2b2;p=gostls13.git encoding/csv: use proper doc comment for Deprecated notes End-of-line comments are not doc comments, so Deprecated notes in them are not recognized as deprecation notices. Rewrite the comments. Change-Id: I275fa9aec403132fda45853e52daa22bc06fcd36 Reviewed-on: https://go-review.googlesource.com/c/go/+/453617 Reviewed-by: Bryan Mills TryBot-Result: Gopher Robot Auto-Submit: Russ Cox Run-TryBot: Russ Cox Reviewed-by: Joseph Tsai Reviewed-by: Ian Lance Taylor --- diff --git a/api/go1.16.txt b/api/go1.16.txt index b06d64c3d3..084f592e18 100644 --- a/api/go1.16.txt +++ b/api/go1.16.txt @@ -531,6 +531,8 @@ pkg database/sql/driver, type Stmt interface, Exec //deprecated pkg database/sql/driver, type Stmt interface, Query //deprecated pkg debug/gosym, method (*LineTable) LineToPC //deprecated pkg debug/gosym, method (*LineTable) PCToLine //deprecated +pkg encoding/csv, type Reader struct, TrailingComma //deprecated +pkg encoding/csv, var ErrTrailingComma //deprecated pkg encoding/json, type InvalidUTF8Error //deprecated pkg encoding/json, type UnmarshalFieldError //deprecated pkg go/build, const AllowBinary //deprecated diff --git a/src/encoding/csv/reader.go b/src/encoding/csv/reader.go index 90a37e6074..b83208eb3a 100644 --- a/src/encoding/csv/reader.go +++ b/src/encoding/csv/reader.go @@ -84,10 +84,12 @@ func (e *ParseError) Unwrap() error { return e.Err } // These are the errors that can be returned in ParseError.Err. var ( - ErrTrailingComma = errors.New("extra delimiter at end of line") // Deprecated: No longer used. - ErrBareQuote = errors.New("bare \" in non-quoted-field") - ErrQuote = errors.New("extraneous or missing \" in quoted-field") - ErrFieldCount = errors.New("wrong number of fields") + ErrBareQuote = errors.New("bare \" in non-quoted-field") + ErrQuote = errors.New("extraneous or missing \" in quoted-field") + ErrFieldCount = errors.New("wrong number of fields") + + // Deprecated: ErrTrailingComma is no longer used. + ErrTrailingComma = errors.New("extra delimiter at end of line") ) var errInvalidDelim = errors.New("csv: invalid field or comment delimiter") @@ -142,7 +144,8 @@ type Reader struct { // By default, each call to Read returns newly allocated memory owned by the caller. ReuseRecord bool - TrailingComma bool // Deprecated: No longer used. + // Deprecated: TrailingComma is no longer used. + TrailingComma bool r *bufio.Reader