@@ -198,11 +198,10 @@ some_call(x)
198
198
## ` WithElement `
199
199
This component restricts the set of elements that are included in the preceding
200
200
access path to to those at a specific set of indices. The specifiers are the
201
- same as those for ` Element ` .
201
+ same as those for ` Element ` . It is only valid in an input path.
202
202
203
- When used in an input path this component has the effect of copying
204
- all relevant elements from the input to the output. For example, in the
205
- following summary:
203
+ This component has the effect of copying all relevant elements from the input to
204
+ the output. For example, in the following summary:
206
205
207
206
``` ql
208
207
input = "Argument[0].WithElement[1, 2]" and
@@ -220,17 +219,13 @@ output = "ReturnValue" and
220
219
preservesValue = true
221
220
```
222
221
223
- TODO: I've not seen this component used in an output path; I don't know if it makes
224
- sense to do so, or what meaning it would have.
225
-
226
222
## ` WithoutElement `
227
223
This component is used to exclude certain elements from the set included in the
228
224
preceding access path. It takes the same specifiers as ` WithElement ` and
229
- ` Element ` .
225
+ ` Element ` . It is only valid in an input path.
230
226
231
- When used in an input path this component has the effect of excluding the
232
- relevant elements when copying from input to output. For example in the
233
- following summary:
227
+ This component has the effect of excluding the relevant elements when copying
228
+ from input to output. For example in the following summary:
234
229
235
230
``` ql
236
231
input = "Argument[0].WithoutElement[0]" and
@@ -240,7 +235,4 @@ output = "ReturnValue"
240
235
any data in any index of the first argument will be copied to the return value,
241
236
with the exception of data at index 0.
242
237
243
- TODO: I've not seen this component used in an output path; I don't know if it makes
244
- sense to do so, or what meaning it would have.
245
-
246
238
[ ^ 1 ] : I've chosen this name to avoid overloading the word "argument".
0 commit comments