@@ -2988,6 +2988,18 @@ class DocumentFilter implements ToJsonable {
2988
2988
final String language;
2989
2989
2990
2990
/// A glob pattern, like `*.{ts,js}` .
2991
+ ///
2992
+ /// Glob patterns can have the following syntax:
2993
+ /// - `*` to match one or more characters in a path segment
2994
+ /// - `?` to match on one character in a path segment
2995
+ /// - `**` to match any number of path segments, including none
2996
+ /// - `{}` to group conditions (e.g. `**/*.{ts,js}` matches all TypeScript
2997
+ /// and JavaScript files)
2998
+ /// - `[]` to declare a range of characters to match in a path segment (e.g.,
2999
+ /// `example.[0-9]` to match on `example.0` , `example.1` , …)
3000
+ /// - `[!...]` to negate a range of characters to match in a path segment
3001
+ /// (e.g., `example.[!0-9]` to match on `example.a` , `example.b` , but not
3002
+ /// `example.0` )
2991
3003
final String pattern;
2992
3004
2993
3005
/// A Uri [scheme] (#Uri.scheme), like `file` or `untitled` .
@@ -3770,7 +3782,9 @@ class DocumentSymbol implements ToJsonable {
3770
3782
/// The kind of this symbol.
3771
3783
final SymbolKind kind;
3772
3784
3773
- /// The name of this symbol.
3785
+ /// The name of this symbol. Will be displayed in the user interface and
3786
+ /// therefore must not be an empty string or a string only consisting of white
3787
+ /// spaces.
3774
3788
final String name;
3775
3789
3776
3790
/// The range enclosing this symbol not including leading/trailing whitespace
@@ -4243,7 +4257,19 @@ class FileSystemWatcher implements ToJsonable {
4243
4257
return new FileSystemWatcher (globPattern, kind);
4244
4258
}
4245
4259
4246
- /// The glob pattern to watch
4260
+ /// The glob pattern to watch.
4261
+ ///
4262
+ /// Glob patterns can have the following syntax:
4263
+ /// - `*` to match one or more characters in a path segment
4264
+ /// - `?` to match on one character in a path segment
4265
+ /// - `**` to match any number of path segments, including none
4266
+ /// - `{}` to group conditions (e.g. `**/*.{ts,js}` matches all TypeScript
4267
+ /// and JavaScript files)
4268
+ /// - `[]` to declare a range of characters to match in a path segment (e.g.,
4269
+ /// `example.[0-9]` to match on `example.0` , `example.1` , …)
4270
+ /// - `[!...]` to negate a range of characters to match in a path segment
4271
+ /// (e.g., `example.[!0-9]` to match on `example.a` , `example.b` , but not
4272
+ /// `example.0` )
4247
4273
final String globPattern;
4248
4274
4249
4275
/// The kind of events of interest. If omitted it defaults to WatchKind.Create
@@ -4656,7 +4682,12 @@ class InitializeParams implements ToJsonable {
4656
4682
/// The capabilities provided by the client (editor or tool)
4657
4683
final ClientCapabilities capabilities;
4658
4684
4659
- /// User provided initialization options.
4685
+ /// Client provided initialization options. Usually these are options that
4686
+ /// could equally be command line options passed when starting the server.
4687
+ /// This property shouldn't be used to pass any user configuration to the
4688
+ /// server. If a user configuration is needed the server should use
4689
+ /// `workspace/configuration` requests together with dynamic registration to
4690
+ /// obtain them.
4660
4691
final dynamic initializationOptions;
4661
4692
4662
4693
/// The process Id of the parent process that started the server. Is null if
0 commit comments