@@ -179,7 +179,8 @@ If the name of a base path is specified in both the manifest and configuration,
179
179
then the value in the manifest is preferred.
180
180
181
181
The name of a base path must use only [ alphanumeric] ( https://doc.rust-lang.org/std/primitive.char.html#method.is_alphanumeric )
182
- characters or ` - ` or ` _ ` , and cannot be empty.
182
+ characters or ` - ` or ` _ ` , must start with an [ alphabetic] ( https://doc.rust-lang.org/std/primitive.char.html#method.is_alphabetic )
183
+ character, and must not be empty.
183
184
184
185
#### Built-in base paths
185
186
@@ -191,7 +192,9 @@ then this base path is defined as the path to the directory containing the root
191
192
Cargo.toml of the workspace.
192
193
193
194
If one of these built-in base paths is also specified in the manifest or
194
- configuration, then that value is preferred over the built-in value.
195
+ configuration, then that value is preferred over the built-in value. This allows
196
+ Cargo to introduce additional built-in paths in the future without compatibility
197
+ issues, as any existing uses will shadow Cargo's built-in name.
195
198
196
199
## The Manifest Format
197
200
@@ -361,7 +364,7 @@ could help.
361
364
[ unresolved-questions ] : #unresolved-questions
362
365
363
366
- What should the Cargo configuration table and dependency key be called? This
364
- RFC calls the configuration table ` base_path ` to be explicit that it is
367
+ RFC calls the configuration table ` base-paths ` to be explicit that it is
365
368
dealing with paths (as ` base ` would be ambiguous) but calls the key ` base ` to
366
369
keep it concise.
367
370
- Is there other reasonable behavior we could fall back to if a ` base `
@@ -377,7 +380,7 @@ It seems reasonable to extend `base` to `git` dependencies, with
377
380
something like:
378
381
379
382
``` toml
380
- [base_path ]
383
+ [base-paths ]
381
384
gh = " https://github.com/jonhoo"
382
385
```
383
386
0 commit comments