go/scanner: document implicit semicolon in multiline comments

Updates #54941

Change-Id: I62406c53b5b27742003098c77cfba0a96a6a6964
Reviewed-on: https://go-review.googlesource.com/c/go/+/738720
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Alan Donovan <adonovan@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
This commit is contained in:
Mateusz Poliwczak 2026-01-23 11:15:19 +01:00
parent 74c909b2c5
commit 2bd7f15dd7

View file

@ -800,7 +800,9 @@ func (s *Scanner) End() token.Pos {
// If the returned token is [token.SEMICOLON], the corresponding
// literal string is ";" if the semicolon was present in the source,
// and "\n" if the semicolon was inserted because of a newline or
// at EOF.
// at EOF. If the newline is within a /*...*/ comment, the SEMICOLON token
// is synthesized immediately after the COMMENT token; its position is that
// of the actual newline within the comment.
//
// If the returned token is [token.ILLEGAL], the literal string is the
// offending character.