vscode api - document file watcher behaviour for deletes (microsoft#262105)

bpasero · web-flow · commit 62bab672d73d · 2025-08-18T08:27:52.000-07:00
diff --git a/src/vscode-dts/vscode.d.ts b/src/vscode-dts/vscode.d.ts
@@ -13883,6 +13883,9 @@ declare module 'vscode' {
 		 * In the same way, symbolic links are preserved, i.e. the file event will report the path of the
 		 * symbolic link as it was provided for watching and not the target.
 		 *
+		 * *Note* that file events from deleting a folder may not include events for contained files. If possible
+		 * events will be aggregated to reduce the overal number of emitted events.
+		 *
 		 * ### Examples
 		 *
 		 * The basic anatomy of a file watcher is as follows:

Original file line number	Diff line number	Diff line change
`@@ -13883,6 +13883,9 @@ declare module 'vscode' {`
`13883`	`13883`	`* In the same way, symbolic links are preserved, i.e. the file event will report the path of the`
`13884`	`13884`	`* symbolic link as it was provided for watching and not the target.`
`13885`	`13885`	`*`
	`13886`	`+ * Note that file events from deleting a folder may not include events for contained files. If possible`
	`13887`	`+ * events will be aggregated to reduce the overal number of emitted events.`
	`13888`	`+ *`
`13886`	`13889`	`* ### Examples`
`13887`	`13890`	`*`
`13888`	`13891`	`* The basic anatomy of a file watcher is as follows:`