Skip to content

Commit 7c18705

Browse files
committed
Scale back; remove the ability to update
1 parent 3214bb3 commit 7c18705

File tree

1 file changed

+5
-31
lines changed

1 file changed

+5
-31
lines changed

text/0000-cargo-install.md

+5-31
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,7 @@ Fundamentally, however, Cargo is a ubiquitous tool among the Rust community and
2121
implementing `cargo install` would facilitate sharing Rust code among its
2222
developers. Simple tasks like installing a new cargo subcommand, installing an
2323
editor plugin, etc, would be just a `cargo install` away. Cargo can manage
24-
dependencies, versions, updates, etc, itself to make the process as seamless as
25-
possible.
24+
dependencies and versions itself to make the process as seamless as possible.
2625

2726
Put another way, enabling easily sharing code is one of Cargo's fundamental
2827
design goals, and expanding into binaries is simply an extension of Cargo's core
@@ -43,7 +42,6 @@ Installing new crates:
4342
4443
Managing installed crates:
4544
cargo install [options] --list
46-
cargo install [options] --update [SPEC | --all]
4745
4846
Options:
4947
-h, --help Print this message
@@ -76,9 +74,7 @@ crate has multiple binaries, the `--bin` argument can selectively install only
7674
one of them, and if you'd rather install examples the `--example` argument can
7775
be used as well.
7876
79-
The `--list` option will list all installed packages (and their versions). The
80-
`--update` option will update either the crate specified or all installed
81-
crates.
77+
The `--list` option will list all installed packages (and their versions).
8278
```
8379

8480
## Installing Crates
@@ -162,31 +158,9 @@ binaries belong to which package.
162158

163159
If Cargo gives access to installing packages, it should surely provide the
164160
ability to manage what's installed! The first part of this is just discovering
165-
what's installed, and this is provided via `cargo install --list`. A more
166-
interesting aspect is the `cargo install --update` command.
167-
168-
#### Updating Crates
169-
170-
Once a crate is installed new versions can be released or perhaps the build
171-
configuration wants to be tweaked, so Cargo will provide the ability to update
172-
crates in-place. By default *something* needs to be specified to the `--update`
173-
flag, either a specific crate that's been installed or the `--all` flag to
174-
update all crates. Because multiple crates of the same name can come from
175-
different sources, the argument to the `--update` flag will be a package id
176-
specification instead of just the name of a crate.
177-
178-
When updating a crate, it will first attempt to update the source code for the
179-
crate. For crates.io sources this means that it will download the most recent
180-
version. For git sources it means the git repo will be updated, but the same
181-
branch/tag will be used (if original specified when installed). Git sources
182-
installed via `--rev` won't be updated.
183-
184-
After the source code has been updated, the crate will be rebuilt according to
185-
the flags specified on the command line. This will override the flags that were
186-
previously used to install a crate, for example activated features are not
187-
remembered.
188-
189-
#### Removing Crates
161+
what's installed, and this is provided via `cargo install --list`.
162+
163+
## Removing Crates
190164

191165
To remove an installed crate, another subcommand will be added to Cargo:
192166

0 commit comments

Comments
 (0)