[librsvg] COMPILING.md - describe the RUSTC and CARGO environment variables



commit 391bd9cdfb901f374919913abe1d9d1e13f9d225
Author: Federico Mena Quintero <federico gnome org>
Date:   Fri Jan 18 07:55:08 2019 -0600

    COMPILING.md - describe the RUSTC and CARGO environment variables

 COMPILING.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
---
diff --git a/COMPILING.md b/COMPILING.md
index 43fe7e5f..690da92b 100644
--- a/COMPILING.md
+++ b/COMPILING.md
@@ -19,6 +19,7 @@ explains librsvg's peculiarities.
 * [Basic compilation instructions](#basic-compilation-instructions)
 * [Verbosity](#verbosity)
 * [Debug or release builds](#debug-or-release-builds)
+* [Selecting a Rust toolchain](#selecting-a-rust-toolchain)
 * [Cross-compilation](#cross-compilation)
 * [Building with no network access](#building-with-no-network-access)
 * [Running `make distcheck`](#running-make-distcheck)
@@ -185,6 +186,24 @@ build the Rust sub-library in debug mode.
 In case both the environment variable and the command-line option are
 specified, the command-line option overrides the env var.
 
+# Selecting a Rust toolchain
+
+By default, the configure/make steps will use the `cargo` binary that
+is found in your `$PATH`.  If you have a system installation of Rust
+and one in your home directory, or for special build systems, you may
+need to override the locations of `cargo` and/or `rustc`.  In this
+case, you can set any of these environment variables before running
+`configure` or `autogen.sh`:
+
+* `RUSTC` - path to the `rustc` compiler
+* `CARGO` - path to `cargo`
+
+Note that `$RUSTC` only gets used in the `configure` script to ensure
+that there is a Rust compiler installed with an appropriate version.
+The actual compilation process just uses `$CARGO`, and assumes that
+that `cargo` binary will use the same Rust compiler as the other
+variable.
+
 # Cross-compilation
 
 If you need to cross-compile librsvg, specify the `--host=TRIPLE` to


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]