Merge pull request #3298 from ZaneErebos/patch-2

Clarify situation in which man page and shell completions will be accessible when building from source
This commit is contained in:
Keith Hall 2025-05-19 04:42:28 +03:00 committed by GitHub
commit c32fa662d5
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -468,14 +468,25 @@ binaries are also available: look for archives with `musl` in the file name.
If you want to build `bat` from source, you need Rust 1.74.0 or
higher. You can then use `cargo` to build everything:
#### From local source
```bash
cargo install --path . --locked
```
> [!NOTE]
> The `--path .` above specifies the directory of the source code and NOT where `bat` will be installed.
> For more information see the docs for [`cargo install`](https://doc.rust-lang.org/cargo/commands/cargo-install.html).
#### From `crates.io`
```bash
cargo install --locked bat
```
Note that additional files like the man page or shell completion
files can not be installed in this way. They will be generated by `cargo` and should be available in the cargo target folder (under `build`).
files can not be installed automatically in both these ways.
If installing from a local source, they will be generated by `cargo`
and should be available in the cargo target folder under `build`.
Shell completions are also available by running:
Furthermore, shell completions are also available by running:
```bash
bat --completion <shell>
# see --help for supported shells