Skip to content

Commit ecc175e

Browse files
committed
Remove trailing spaces.
1 parent d41f4af commit ecc175e

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

src/doc/src/guide/cargo-home.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
## Cargo Home
22

33
The cargo home functions as a download and source cache.
4-
When building a crate, cargo stores downloaded build dependencies in the cargo home.
5-
You can alter the location of the cargo home by setting the `CARGO_HOME` [environmental variable](../reference/environment-variables.html).
4+
When building a crate, cargo stores downloaded build dependencies in the cargo home.
5+
You can alter the location of the cargo home by setting the `CARGO_HOME` [environmental variable](../reference/environment-variables.html).
66
The [home](https://crates.io/crates/home) crate provides an api for getting this location if you need this information inside your rust crate.
77
By default, the cargo home is located in `${HOME}/.cargo/`.
88

@@ -12,48 +12,48 @@ The cargo home consists of following components:
1212

1313
## Files:
1414

15-
* `config`
15+
* `config`
1616
Cargos global configuration file, see the [config entry in the reference](../reference/config.html).
1717

18-
* `credentials`
18+
* `credentials`
1919
Private login credentials from [`cargo login`](../commands/cargo-login.html) in order to login into a registry.
2020

2121
* `.crates.toml`
2222
This hidden file contains package information of crates installed via [cargo install](../commands/cargo-install.html). Do NOT edit by hand!
2323

2424
## Directories:
2525

26-
* `bin`
26+
* `bin`
2727
The bin directory contains executables of crates that were installed via "cargo install" or `rustup`.
2828
To be able to make these binaries accessible, add the path of the directory to your `${PATH}`.
2929

30-
* `git`
30+
* `git`
3131
Git sources are stored here:
32-
33-
* `git/db`
32+
33+
* `git/db`
3434
When a crate depends on a git repository, cargo clones the repo as a bare repo into this directory and updates it if neccessary.
35-
36-
* `git/checkouts`
35+
36+
* `git/checkouts`
3737
If a git source is used, the required commit of the repo is checked out from the bare repo inside `git/db` into this directory.
3838
This provides the compiler with the actual files contained in the repo of the commit specified for that dependency.
3939
Multiple checkouts of different commits of the same repo are possible.
4040

41-
* `registry`
41+
* `registry`
4242
Packages and metadata of crate registries (such as crates.io) are located here.
43-
44-
* `registry/index`
43+
44+
* `registry/index`
4545
The index is a bare git repository which contains the metadata (versions, dependencies etc) of all available crates of a registry.
4646

47-
* `registry/cache`
47+
* `registry/cache`
4848
Downloaded dependencies are stored in the cache. The crates are compressed gzip archives named with a `.crate` extension.
49-
50-
* `registry/src`
49+
50+
* `registry/src`
5151
If a downloaded `.crate` archive is required by a package, it is unpacked into `registry/src` folder where rustc will find the `.rs` files.
5252

5353

5454
## Caching the cargo home in CI
5555

56-
To avoid redownloading all crate dependencies during continuous integration, you can cache the `$CARGO_HOME` directory.
56+
To avoid redownloading all crate dependencies during continuous integration, you can cache the `$CARGO_HOME` directory.
5757
However, caching the entire directory as is is often inefficient as it will contain downloaded sources twice.
5858
If we depend on `cargo 0.38.0` and cache the entire `$CARGO_HOME` we would actually cache the sources twice, the `cargo-0.38.0.crate` inside `registry/cache` and the extracted `.rs` files of cargoinside `registry/src`.
5959
The can unneccessarily slow down the build as downloading, extracting, recompressing and reuploading the cache ot the CI servers can take some time.
@@ -77,4 +77,4 @@ See the [cargo vendor](commands/cargo-vendor.md) subcommand.
7777

7878
In theory, you can always remove any part of the cache and cargo will do its best to restore sources if a crate needs them either by reextracting an archive or checking out a bare repo or by simply redownloading the sources from the web.
7979

80-
Alternatively, the [cargo-cache](https://crates.io/crates/cargo-cache) crate provides a simple CLI tool to only clear selected parts of the cache or show sizes of its components in your commandline.
80+
Alternatively, the [cargo-cache](https://crates.io/crates/cargo-cache) crate provides a simple CLI tool to only clear selected parts of the cache or show sizes of its components in your commandline.

0 commit comments

Comments
 (0)