@@ -11,7 +11,7 @@ representation of source, and facilities for *structured editing*.
11
11
What is structured editing? It's an editing strategy that is keenly aware of the
12
12
* structure* of source code, not necessarily its * representation* (i.e.
13
13
characters or bytes). This can be achieved at different granularities: replacing
14
- an identifier, changing a call to global function to a method call, or indenting
14
+ an identifier, changing a global function call to a method call, or indenting
15
15
and formatting an entire source file based on declarative rules. These kinds of
16
16
diverse operations are critical to the Swift Migrator, which is the immediate
17
17
client for this library, now developed in the open. Along with that, the library
@@ -163,7 +163,7 @@ struct YourStruct {}
163
163
At any point in the building process, you can call ` build() ` and get a
164
164
reasonably formed Syntax node (i.e. with no raw ` nullptr ` s) using what you've
165
165
provided to the builder so far. Anything that you haven't supplied is marked as
166
- * missing* . This is essentially what the parser does so, looking forward to
166
+ * missing* . This is essentially what the parser does; so, looking forward to
167
167
future adoption, the builders are designed with the parser in mind, with the
168
168
hope that we can better specify recovery behavior and incremental (re-)parsing.
169
169
@@ -390,7 +390,8 @@ Beyond this, `SyntaxData` nodes have *no significant public API*.
390
390
391
391
- `SyntaxData` are immutable.
392
392
However, they may mutate themselves in order to implement lazy instantiation
393
- of children and caching. That caching operation transparent and thread-safe.
393
+ of children and caching. That caching operation is transparent and
394
+ thread-safe.
394
395
- `SyntaxData` have identity, i.e. they can be compared with "pointer equality".
395
396
- `SyntaxData` are implementation detail have no public API.
396
397
0 commit comments