Skip to content

Commit 5ce14f3

Browse files
committed
Typos and such
1 parent e247a63 commit 5ce14f3

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

text/0000-cargo-workspace.md

+10-7
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ workspace = "../foo"
6565

6666
The root of a workspace, indicated by the presence of `[workspace]`, is
6767
responsible for defining the entire workspace (listing all members).
68-
This example here means that two extra crates will members of the workspace
68+
This example here means that two extra crates will be members of the workspace
6969
(which also includes the root).
7070

7171
The `package.workspace` key is used to point at a workspace root. For
@@ -75,7 +75,7 @@ workspace root that this package is a member of.
7575
These keys are mutually exclusive when applied in `Cargo.toml`. A crate may
7676
*either* specify `package.workspace` or specify `[workspace]`. That is, a
7777
crate cannot both be a root in a workspace (contain `[workspace]`) and also be
78-
member of another workspace (contain `package.workspace`).
78+
a member of another workspace (contain `package.workspace`).
7979

8080
### "Virtual" `Cargo.toml`
8181

@@ -105,17 +105,17 @@ While the restriction of one-root-per workspace may make sense, the restriction
105105
of crates pointing back to the root may not. If, however, this restriction were
106106
not in place then the set of crates in a workspace may differ depending on
107107
which crate it was viewed from. For example if workspace root A includes B then
108-
it will think B is in A's workspace. If, however, B does ont point back to A,
108+
it will think B is in A's workspace. If, however, B does not point back to A,
109109
then B would not think that A was in its workspace. This would in turn cause the
110-
set of crates in each workspace to be different, futher causing `Cargo.lock` to
110+
set of crates in each workspace to be different, further causing `Cargo.lock` to
111111
get out of sync if it were allowed. By ensuring that all crates have edges to
112112
each other in a workspace Cargo can prevent this situation and guarantee robust
113113
builds no matter where they're executed in the workspace.
114114

115115
To alleviate misconfiguration Cargo will emit an error if the two properties
116-
above hold for any crate attempting to be part of a workspace. For example, if
117-
the `package.workspace` key is specified, but the crate is not a workspace root
118-
or doesn't point back to the original crate an error is emitted.
116+
above do not hold for any crate attempting to be part of a workspace. For
117+
example, if the `package.workspace` key is specified, but the crate is not a
118+
workspace root or doesn't point back to the original crate an error is emitted.
119119

120120
### Implicit relations
121121

@@ -308,6 +308,9 @@ subcommands with a `--all` flag to perform tasks such as:
308308
* Build all binaries for a set of crates within a workspace
309309
* Publish all crates in a workspace if necessary to crates.io
310310

311+
Furthermore, workspaces could start to deduplicate metadata among crates like
312+
version numbers, URL information, authorship, etc.
313+
311314
This support isn't proposed to be added in this RFC specifically, but simply to
312315
show that workspaces can be used to solve other existing issues in Cargo.
313316

0 commit comments

Comments
 (0)