rusty-man 0.4.2

Command-line viewer for rustdoc documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

<!---
SPDX-FileCopyrightText: 2020-2021 Robin Krahl <robin.krahl@ireas.org>
SPDX-License-Identifier: MIT
-->

# Installing rusty-man

## Installing a package

rusty-man packages are available for these distributions:
- Arch Linux: [`rusty-man`][pkg-aur] in the Arch User Repository

[pkg-aur]: https://aur.archlinux.org/packages/rusty-man/

## Installing from source

### Build Requirements

To compile rusty-man, you need Rust 1.40 or later.

### Installing from Git

1. Clone the rusty-man Git repository:
   ```
   $ git clone https://git.sr.ht/~ireas/rusty-man && cd rusty-man
   ```
2. Optional:  Checkout the latest release:
   ```
   $ git checkout v0.4.2
   ```
3. Optional:  Verify the signature of the latest commit:
   ```
   $ curl -s "https://pgp.ireas.org/0x6D533958F070C57C.txt" | gpg --import
   $ git verify-commit HEAD
   ```
4. Compile rusty-man:
   ```
   $ cargo build --release --locked
   ```
5. Optional:  Install the rusty-man binary:
   ```
   $ sudo cp ./target/release/rusty-man /usr/local/bin/rusty-man
   ```

### Installing from a tarball

1. Download the tarball for the latest rusty-man release (see the [release
   list][]) and optionally its signature:
   ```
   $ curl -OJ "https://git.sr.ht/~ireas/rusty-man/archive/v0.4.2.tar.gz"
   ```
2. Optional:  Download and verify the signature of the tarball:
   ```
   $ curl -O "https://git.sr.ht/~ireas/rusty-man/refs/v0.4.2/rusty-man-v0.4.2.tar.gz.asc"
   $ curl -s "https://pgp.ireas.org/0x6D533958F070C57C.txt" | gpg --import
   $ gpg --verify rusty-man-v0.4.2.tar.gz.asc
   ```
3. Extract the tarball:
   ```
   $ tar -xf rusty-man-v0.4.2.tar.gz
   $ cd rusty-man-v0.4.2
   ```
4. Compile rusty-man:
   ```
   $ cargo build --release --locked
   ```
5. Optional:  Install the rusty-man binary:
   ```
   $ sudo cp ./target/release/rusty-man /usr/local/bin/rusty-man
   ```

[release list]: https://git.sr.ht/~ireas/rusty-man/refs

### Installing from crates.io

```
cargo install rusty-man --locked
```

You can omit the `--locked` option to use the latest dependency versions
available.  Note that this might cause issues if a dependency breaks semantic
versioning.