Skip to content

Commit b1e9656

Browse files
committed
Features/2/3 information added
1 parent a0f6b0a commit b1e9656

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

text/3416-feature-metadata.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -257,21 +257,21 @@ attempt to present them in the following way:
257257
For features that require new information in the index, it should be possible to
258258
add this information under a `features3` key. Older versions of Cargo will
259259
ignore this key, newer Cargo would be able to merge `features`, `features2`, and
260-
`features3`. `features3` should mirror the most complete syntax of the
261-
`[features]` table, i.e.:
260+
`features3`. `features3` should mirror the most complete syntax of the relevant
261+
keys from the `[features]` table. Currently this is only `deprecated`, i.e.:
262262

263263
```json5
264264
"features3": {
265265
"bar": {
266-
enables: ["foo"],
267266
deprecated = { since = "1.2.3", note = "don't use this" }
268267
}
269268
}
270269
```
271270

272271
In order to conserve index space, default keys should be omitted. `Cargo` should
273272
ignore unrecognized keys within a feature, to allow for future additions without
274-
needing a new `features` section.
273+
needing a new `features` section. `enables` may be specified in this section,
274+
but is preferred to use `features` or `features2` to avoid duplication.
275275

276276
# Drawbacks
277277

0 commit comments

Comments
 (0)