From c9136a79414c9c4e0da0c44ed72deb597003ac7e Mon Sep 17 00:00:00 2001 From: innocentzero Date: Tue, 2 Apr 2024 19:42:29 +0530 Subject: [PATCH 1/2] chore(README): Update README with rustup Update the README with information about rustup support, in particular the different group file syntax. Signed-off-by: innocentzero --- README.md | 42 ++++++++++++++++++++++++++++++++++-------- 1 file changed, 34 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index d064b75..08dec43 100644 --- a/README.md +++ b/README.md @@ -79,19 +79,19 @@ Pacdef will make sure you have the following packages installed for each package Note that the name of the section corresponds to the ecosystem it relates to, rather than the package manager it uses. - ## Supported backends At the moment, supported backends are the following. Pull requests for additional backends are welcome! -| Application | Package Manager | Section | feature flag | Notes | -|-------------|-----------------|-------------|--------------|-----------------------------------------------------------------------------------------------------------| -| Arch Linux | `pacman` | `[arch]` | `arch` | includes pacman-wrapping AUR helpers (configurable) | -| Debian | `apt` | `[debian]` | `debian` | minimum supported apt-version 2.0.2 ([see upstream](https://gitlab.com/volian/rust-apt)) | -| Flatpak | `flatpak` | `[flatpak]` | built-in | can manage either system-wide or per-user installation (configurable) | -| Python | `pip` | `[python]` | built-in | | -| Rust | `cargo` | `[rust]` | built-in | | +| Application | Package Manager | Section | feature flag | Notes | +| ----------- | --------------- | ----------- | ------------ | ---------------------------------------------------------------------------------------- | +| Arch Linux | `pacman` | `[arch]` | `arch` | includes pacman-wrapping AUR helpers (configurable) | +| Debian | `apt` | `[debian]` | `debian` | minimum supported apt-version 2.0.2 ([see upstream](https://gitlab.com/volian/rust-apt)) | +| Flatpak | `flatpak` | `[flatpak]` | built-in | can manage either system-wide or per-user installation (configurable) | +| Python | `pip` | `[python]` | built-in | | +| Rust | `cargo` | `[rust]` | built-in | | +| Rust | `rustup` | `[rustup]` | built-in | See the comments below about the syntax of the packages in the group file. | Backends that have a `feature flag` require setting the respective flag for the build process. The appropriate system libraries and their header files must be present on the machine and be detectable by `pkg-config`. @@ -204,6 +204,32 @@ cargo-update topgrade ``` +### Rustup + +Rustup packages are managed quite differently. For referring to the syntax, have a look [below](#group-file-syntax). +In contrast to other package managers, rustup handles package naming very differently. +These packages are either of the form `toolchain/` or `component//`, where can be stable, nightly, or any explicit rust version. +The `` field has to be substituted with the name of the component you want installed. + +Example: + +```ini +[rustup] +component/stable/rust-analyzer +toolchain/stable +component/stable/cargo +component/stable/rust-src +component/stable/rustc +toolchain/1.70.0 +component/1.70.0/cargo +component/1.70.0/clippy +component/1.70.0/rust-docs +component/1.70.0/rust-src +component/1.70.0/rust-std +component/1.70.0/rustc +component/1.70.0/rustfmt +``` + ## Misc. ### Automation From cddb47171964fe00ddffea3e5de68850976db8c5 Mon Sep 17 00:00:00 2001 From: innocentzero Date: Wed, 3 Apr 2024 06:35:40 +0530 Subject: [PATCH 2/2] chore(README): Update README with Rustup details Signed-off-by: innocentzero --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 08dec43..0a7ee44 100644 --- a/README.md +++ b/README.md @@ -91,7 +91,7 @@ Pull requests for additional backends are welcome! | Flatpak | `flatpak` | `[flatpak]` | built-in | can manage either system-wide or per-user installation (configurable) | | Python | `pip` | `[python]` | built-in | | | Rust | `cargo` | `[rust]` | built-in | | -| Rust | `rustup` | `[rustup]` | built-in | See the comments below about the syntax of the packages in the group file. | +| Rustup | `rustup` | `[rustup]` | built-in | See the comments [below](#rustup) about the syntax of the packages in the group file. | Backends that have a `feature flag` require setting the respective flag for the build process. The appropriate system libraries and their header files must be present on the machine and be detectable by `pkg-config`.