Skip to content

Commit

Permalink
doc: mark range-over-func as documented
Browse files Browse the repository at this point in the history
The language change for the accepted range-over-func proposal #61405
was documented in CL 590616. Remove the corresponding 'TODO' entry.

Also improve formatting slightly, and switch to preferred relative
links. They'll work better in the long term and in more contexts.

While here, also simplify the suggested line to preview release notes
locally: setting the -content='' flag explicitly is no longer required
as of CL 589936.

For #65614.

Change-Id: I6cee951b9ede33900bca48c9f709e3b2c5e87337
Reviewed-on: https://go-review.googlesource.com/c/go/+/590756
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Robert Griesemer <gri@google.com>
  • Loading branch information
dmitshur authored and gopherbot committed Jun 5, 2024
1 parent b658265 commit e53d10d
Show file tree
Hide file tree
Showing 3 changed files with 8 additions and 11 deletions.
2 changes: 1 addition & 1 deletion doc/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ Use the following forms in your markdown:
To preview `next` content in merged form using a local instance of the website, run:

```
go run golang.org/x/website/cmd/golangorg@latest -content='' -goroot=..
go run golang.org/x/website/cmd/golangorg@latest -goroot=..
```

Then open http://localhost:6060/doc/next. Refresh the page to see your latest edits.
Expand Down
14 changes: 7 additions & 7 deletions doc/next/2-language.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
## Changes to the language {#language}

<!-- go.dev/issue/61405, CL 557835, CL 584596 -->
Go 1.23 makes the (Go 1.22) ["range-over-func" experiment](https://tip.golang.org/wiki/RangefuncExperiment) a part of the language.
Go 1.23 makes the (Go 1.22) ["range-over-func" experiment](/wiki/RangefuncExperiment) a part of the language.
The "range" clause in a "for-range" loop now accepts iterator functions of the following types

func(func() bool)
func(func(K) bool)
func(func(K, V) bool)
func(func() bool)
func(func(K) bool)
func(func(K, V) bool)

as range expressions.
Calls of the iterator argument function produce the iteration values for the "for-range" loop.
For details see the [language spec](https://tip.golang.org/ref/spec#For_statements).
as range expressions.
Calls of the iterator argument function produce the iteration values for the "for-range" loop.
For details see the [language spec](/ref/spec#For_statements).

<!-- go.dev/issue/46477, CL 566856, CL 586955, CL 586956 -->
Go 1.23 includes preview support for [generic type aliases](/issue/46477).
Expand Down
3 changes: 0 additions & 3 deletions doc/next/9-todo.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
<!-- These items need to be completed and moved to an appropriate location in the release notes. -->

<!-- go.dev/issue/61405, CL 557835, CL 584596 -->
TODO: Document that range-over-func is enabled (and that GOEXPERIMENT=rangefunc is relevant) in Go 1.23. This note should be moved to an appropriate location in the release notes.

<!-- go.dev/issue/60905, CL 559555 -->
TODO: The new `GOARM64` environment variable needs to be documented. This note should be moved to an appropriate location in the release notes.

Expand Down

0 comments on commit e53d10d

Please sign in to comment.