[tools] gopls/doc/release: include server side file watching in release note
0 views
Skip to first unread message
Gopher Robot (Gerrit)
May 11, 2026, 4:51:03 PM (7 hours ago) May 11
to Hongxiang Jiang, goph...@pubsubhelper.golang.org, golang-...@googlegroups.com, golang...@luci-project-accounts.iam.gserviceaccount.com, Alan Donovan, golang-co...@googlegroups.com
Gopher Robot submitted the change with unreviewed changes![]( "Open in Gerrit")
Unreviewed changes
1 is the latest approved patch-set.
The change was submitted with unreviewed changes in the following files:
```
The name of the file: gopls/doc/release/v0.22.0.md
Insertions: 4, Deletions: 6.
@@ -122,11 +122,9 @@
## Server-side file watching
-Gopls introduces an experimental server-side file watching mechanism to monitor file system events directly. This feature supplements standard LSP file change notifications in environments or editor clients where client-side events may be unreliable or dropped. Because server-side watching operates alongside the language client's notifications, gopls may receive duplicate events for a single file system change.
+Gopls introduces an experimental server-side file watching mechanism to monitor file system events directly. This feature supplements standard LSP file change notifications in environments or editor clients where client-side events may be unreliable or dropped.
This feature is configured via the internal setting `fileWatcher`, which supports three strategies:
-- `"off"` for default client-driven watching
-- `"poll"` for periodic directory scanning
-- `"fsnotify"` for OS-level event notifications
-
-Users should note that the `"fsnotify"` strategy requires system file descriptors to watch the workspace in macOS or all BSD systems; when used against large workspaces, this can lead to [exhaust file descriptors issue](https://github.com/fsnotify/fsnotify#kqueue-macos-all-bsd-systems).
+- `"off"` (default): the client is solely responsible for change notification
+- `"poll"`: the server periodically scans workspace directories, using optimizations similar to `git status`
+- `"fsnotify"`: the server uses kernel support for file-change notification. This strategy is system dependent and may need to open many directories to watch a large workspace, risking [file descriptor exhaustion](https://github.com/fsnotify/fsnotify#kqueue-macos-all-bsd-systems)
```
Change information
Commit message:
gopls/doc/release: include server side file watching in release note
For golang/go#67995
Change-Id: I07ba89eeb8d2e59b707b85cdd099548942e44e07
Reviewed-on: https://go-review.googlesource.com/c/tools/+/776881
Reviewed-by: Alan Donovan <adon...@google.com>
Auto-Submit: Hongxiang Jiang <hxj...@golang.org>
LUCI-TryBot-Result: golang...@luci-project-accounts.iam.gserviceaccount.com <golang...@luci-project-accounts.iam.gserviceaccount.com>
Files:
- M gopls/doc/release/v0.22.0.md
Change size: XS
Delta: 1 file changed, 9 insertions(+), 0 deletions(-)
Branch: refs/heads/master
Submit Requirements:
Code-Review: +2 by Alan Donovan
TryBots-Pass: LUCI-TryBot-Result+1 by golang...@luci-project-accounts.iam.gserviceaccount.com
| Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. |
Reply all
Reply to author
Forward
0 new messages