summary refs log tree commit diff
path: root/doc/stdenv.xml
diff options
context:
space:
mode:
authorJohn Ericson <Ericson2314@Yahoo.com>2017-04-26 00:06:11 -0400
committerJohn Ericson <John.Ericson@Obsidian.Systems>2017-06-22 17:52:28 -0400
commit594d26420594acf458e5a8ab75229a2147d9194f (patch)
tree9211ca90764bdb1810aa4c2a5fb0e5fd51f78a76 /doc/stdenv.xml
parent9bfd03eff78aa37bff9a7f4cb12c6bed1f04e764 (diff)
downloadnixlib-594d26420594acf458e5a8ab75229a2147d9194f.tar
nixlib-594d26420594acf458e5a8ab75229a2147d9194f.tar.gz
nixlib-594d26420594acf458e5a8ab75229a2147d9194f.tar.bz2
nixlib-594d26420594acf458e5a8ab75229a2147d9194f.tar.lz
nixlib-594d26420594acf458e5a8ab75229a2147d9194f.tar.xz
nixlib-594d26420594acf458e5a8ab75229a2147d9194f.tar.zst
nixlib-594d26420594acf458e5a8ab75229a2147d9194f.zip
cross stdenv adaptor: Support --host --build --target across the board
Packages get --host and --target by default, but can explicitly request
any subset to be passed as needed. See docs for more info.

rustc: Avoid hash breakage by using the old (ignored)
dontSetConfigureCross when not cross building
Diffstat (limited to 'doc/stdenv.xml')
-rw-r--r--doc/stdenv.xml10
1 files changed, 10 insertions, 0 deletions
diff --git a/doc/stdenv.xml b/doc/stdenv.xml
index 9ec14d5a7828..e637962fbb7d 100644
--- a/doc/stdenv.xml
+++ b/doc/stdenv.xml
@@ -641,6 +641,16 @@ script) if it exists.</para>
   </varlistentry>
 
   <varlistentry>
+    <term><varname>configurePlatforms</varname></term>
+    <listitem><para>
+      By default, when cross compiling, the configure script has <option>--build=...</option> and <option>--host=...</option> passed.
+      Packages can instead pass <literal>[ "build" "host" "target" ]</literal> or a subset to control exactly which platform flags are passed.
+      Compilers and other tools should use this to also pass the target platform, for example.
+      Note eventually these will be passed when in native builds too, to improve determinism: build-time guessing, as is done today, is a risk of impurity.
+    </para></listitem>
+  </varlistentry>
+
+  <varlistentry>
     <term><varname>preConfigure</varname></term>
     <listitem><para>Hook executed at the start of the configure
     phase.</para></listitem>