Skip to content

Commit c04480f

Browse files
authored
several grammar fixes (#2123)
Mostly verbs agreeing with the closest noun instead of agreeing with the head of the noun phrase.
1 parent a2028be commit c04480f

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

_specifications/lsp/3.17/specification.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ separated by a '\r\n'.
3232

3333
### <a href="#headerPart" name="headerPart" class="anchor"> Header Part a>
3434

35-
The header part consists of header fields. Each header field is comprised of a name and a value, separated by ': ' (a colon and a space). The structure of header fields conform to the [HTTP semantic](https://tools.ietf.org/html/rfc7230#section-3.2). Each header field is terminated by '\r\n'. Considering the last header field and the overall header itself are each terminated with '\r\n', and that at least one header is mandatory, this means that two '\r\n' sequences always immediately precede the content part of a message.
35+
The header part consists of header fields. Each header field is comprised of a name and a value, separated by ': ' (a colon and a space). The structure of header fields conforms to the [HTTP semantic](https://tools.ietf.org/html/rfc7230#section-3.2). Each header field is terminated by '\r\n'. Considering the last header field and the overall header itself are each terminated with '\r\n', and that at least one header is mandatory, this means that two '\r\n' sequences always immediately precede the content part of a message.
3636

3737
Currently the following header fields are supported:
3838

@@ -48,7 +48,7 @@ The header part is encoded using the 'ascii' encoding. This includes the '\r\n'
4848

4949
Contains the actual content of the message. The content part of a message uses [JSON-RPC](http://www.jsonrpc.org/) to describe requests, responses and notifications. The content part is encoded using the charset provided in the Content-Type field. It defaults to `utf-8`, which is the only encoding supported right now. If a server or client receives a header with a different encoding than `utf-8` it should respond with an error.
5050

51-
(Prior versions of the protocol used the string constant `utf8` which is not a correct encoding constant according to [specification](http://www.iana.org/assignments/character-sets/character-sets.xhtml).) For backwards compatibility it is highly recommended that a client and a server treats the string `utf8` as `utf-8`.
51+
(Prior versions of the protocol used the string constant `utf8` which is not a correct encoding constant according to [specification](http://www.iana.org/assignments/character-sets/character-sets.xhtml).) For backwards compatibility it is highly recommended that a client and a server treat the string `utf8` as `utf-8`.
5252

5353
### Example:
5454

@@ -70,7 +70,7 @@ The following TypeScript definitions describe the base [JSON-RPC protocol](http:
7070

7171
#### <a href="#baseTypes" name="baseTypes" class="anchor"> Base Types a>
7272

73-
The protocol use the following definitions for integers, unsigned integers, decimal numbers, objects and arrays:
73+
The protocol uses the following definitions for integers, unsigned integers, decimal numbers, objects and arrays:
7474

7575
<div class="anchorHolder"><a href="#integer" name="integer" class="linkableAnchor">a>div>
7676

@@ -244,7 +244,7 @@ export namespace ErrorCodes {
244244

245245
/**
246246
* Error code indicating that a server received a notification or
247-
* request before the server has received the `initialize` request.
247+
* request before the server received the `initialize` request.
248248
*/
249249
export const ServerNotInitialized: integer = -32002;
250250
export const UnknownErrorCode: integer = -32001;
@@ -290,7 +290,7 @@ export namespace ErrorCodes {
290290
* The server detected that the content of a document got
291291
* modified outside normal conditions. A server should
292292
* NOT send this error code if it detects a content change
293-
* in it unprocessed messages. The result even computed
293+
* in its unprocessed messages. The result even computed
294294
* on an older state might still be useful for the client.
295295
*
296296
* If a client decides that a result is not of any use anymore
@@ -333,7 +333,7 @@ interface NotificationMessage extends Message {
333333

334334
#### <a href="#dollarRequests" name="dollarRequests" class="anchor"> $ Notifications and Requests a>
335335

336-
Notification and requests whose methods start with '\$/' are messages which are protocol implementation dependent and might not be implementable in all clients or servers. For example if the server implementation uses a single threaded synchronous programming language then there is little a server can do to react to a `$/cancelRequest` notification. If a server or client receives notifications starting with '\$/' it is free to ignore the notification. If a server or client receives a request starting with '\$/' it must error the request with error code `MethodNotFound` (e.g. `-32601`).
336+
Notifications and requests whose methods start with '\$/' are messages which are protocol implementation dependent and might not be implementable in all clients or servers. For example if the server implementation uses a single threaded synchronous programming language then there is little a server can do to react to a `$/cancelRequest` notification. If a server or client receives notifications starting with '\$/' it is free to ignore the notification. If a server or client receives a request starting with '\$/' it must error the request with error code `MethodNotFound` (e.g. `-32601`).
337337

338338
#### <a href="#cancelRequest" name="cancelRequest" class="anchor"> Cancellation Support (:arrow_right: :arrow_left:)a>
339339

@@ -388,9 +388,9 @@ Progress is reported against a token. The token is different than the request ID
388388

389389
## <a href="#languageServerProtocol" name="languageServerProtocol" class="anchor"> Language Server Protocol a>
390390

391-
The language server protocol defines a set of JSON-RPC request, response and notification messages which are exchanged using the above base protocol. This section starts describing the basic JSON structures used in the protocol. The document uses TypeScript interfaces in strict mode to describe these. This means for example that a `null` value has to be explicitly listed and that a mandatory property must be listed even if a falsify value might exist. Based on the basic JSON structures, the actual requests with their responses and the notifications are described.
391+
The language server protocol defines a set of JSON-RPC request, response and notification messages which are exchanged using the above base protocol. This section starts describing the basic JSON structures used in the protocol. The document uses TypeScript interfaces in strict mode to describe these. This means for example that a `null` value has to be explicitly listed and that a mandatory property must be listed even if a falsy value might exist. Based on the basic JSON structures, the actual requests with their responses and the notifications are described.
392392

393-
An example would be a request send from the client to the server to request a hover value for a symbol at a certain position in a text document. The request's method would be `textDocument/hover` with a parameter like this:
393+
An example would be a request sent from the client to the server to request a hover value for a symbol at a certain position in a text document. The request's method would be `textDocument/hover` with a parameter like this:
394394

395395
```typescript
396396
interface HoverParams {
@@ -411,7 +411,7 @@ Please also note that a response return value of `null` indicates no result. It
411411

412412
In general, the language server protocol supports JSON-RPC messages, however the base protocol defined here uses a convention such that the parameters passed to request/notification messages should be of `object` type (if passed at all). However, this does not disallow using `Array` parameter types in custom messages.
413413

414-
The protocol currently assumes that one server serves one tool. There is currently no support in the protocol to share one server between different tools. Such a sharing would require additional protocol e.g. to lock a document to support concurrent editing.
414+
The protocol currently assumes that one server serves one tool. There is currently no support in the protocol to share one server between different tools. Such sharing would require additional protocol e.g. to lock a document to support concurrent editing.
415415

416416
### <a href="#capabilities" name= "capabilities" class="anchor"> Capabilities a>
417417

0 commit comments

Comments
 (0)