···

       
317
       
 
       
   </para>

     

       
318
       
 
       


     

       
319
       
 
       
   <qandaset>

     

       
320
       
-
       
    <qandaentry>

     

       
321
       
 
       
     <question>

     

       
322
       
 
       
      <para>

     

       
323
       
 
       
       What if my package's build system needs to build a C program to be run

     
···

       
331
       
 
       
      </para>

     

       
332
       
 
       
     </answer>

     

       
333
       
 
       
    </qandaentry>

     

       
334
       
-
       
    <qandaentry>

     

       
335
       
 
       
     <question>

     

       
336
       
 
       
      <para>

     

       
337
       
 
       
       My package fails to find <command>ar</command>.

     
···

       
347
       
 
       
      </para>

     

       
348
       
 
       
     </answer>

     

       
349
       
 
       
    </qandaentry>

     

       
350
       
-
       
    <qandaentry>

     

       
351
       
 
       
     <question>

     

       
352
       
 
       
      <para>

     

       
353
       
 
       
       My package's testsuite needs to run host platform code.

     

···

       
317
       
 
       
   </para>

     

       
318
       
 
       


     

       
319
       
 
       
   <qandaset>

     

       
320
       
+
       
    <qandaentry xml:id="cross-qa-build-c-program-in-build-environment">

     

       
321
       
 
       
     <question>

     

       
322
       
 
       
      <para>

     

       
323
       
 
       
       What if my package's build system needs to build a C program to be run

     
···

       
331
       
 
       
      </para>

     

       
332
       
 
       
     </answer>

     

       
333
       
 
       
    </qandaentry>

     

       
334
       
+
       
    <qandaentry xml:id="cross-qa-fails-to-find-ar">

     

       
335
       
 
       
     <question>

     

       
336
       
 
       
      <para>

     

       
337
       
 
       
       My package fails to find <command>ar</command>.

     
···

       
347
       
 
       
      </para>

     

       
348
       
 
       
     </answer>

     

       
349
       
 
       
    </qandaentry>

     

       
350
       
+
       
    <qandaentry xml:id="cross-testsuite-runs-host-code">

     

       
351
       
 
       
     <question>

     

       
352
       
 
       
      <para>

     

       
353
       
 
       
       My package's testsuite needs to run host platform code.

     

···

       
6
       
 
       
         xmlns:xlink="http://www.w3.org/1999/xlink"

     

       
7
       
 
       
         xml:id="chap-multiple-output">

     

       
8
       
 
       
 <title>Multiple-output packages</title>

     

       
9
       
-
       
 <section>

     

       
10
       
 
       
  <title>Introduction</title>

     

       
11
       
 
       


     

       
12
       
 
       
  <para>

     
···

       
38
       
 
       
   </para>

     

       
39
       
 
       
  </note>

     

       
40
       
 
       
 </section>

     

       
41
       
-
       
 <section>

     

       
42
       
 
       
  <title>Installing a split package</title>

     

       
43
       
 
       


     

       
44
       
 
       
  <para>

     
···

       
84
       
 
       
   </listitem>

     

       
85
       
 
       
  </itemizedlist>

     

       
86
       
 
       
 </section>

     

       
87
       
-
       
 <section>

     

       
88
       
 
       
  <title>Using a split package</title>

     

       
89
       
 
       


     

       
90
       
 
       
  <para>

     
···

       
102
       
 
       
   also added. (See <xref linkend="multiple-output-file-type-groups" />.)

     

       
103
       
 
       
  </para>

     

       
104
       
 
       
 </section>

     

       
105
       
-
       
 <section>

     

       
106
       
 
       
  <title>Writing a split derivation</title>

     

       
107
       
 
       


     

       
108
       
 
       
  <para>

     
···

       
283
       
 
       
   </variablelist>

     

       
284
       
 
       
  </section>

     

       
285
       
 
       


     

       
286
       
-
       
  <section>

     

       
287
       
 
       
   <title>Common caveats</title>

     

       
288
       
 
       


     

       
289
       
 
       
   <itemizedlist>

     

···

       
6
       
 
       
         xmlns:xlink="http://www.w3.org/1999/xlink"

     

       
7
       
 
       
         xml:id="chap-multiple-output">

     

       
8
       
 
       
 <title>Multiple-output packages</title>

     

       
9
       
+
       
 <section xml:id="sec-multiple-outputs-introduction">

     

       
10
       
 
       
  <title>Introduction</title>

     

       
11
       
 
       


     

       
12
       
 
       
  <para>

     
···

       
38
       
 
       
   </para>

     

       
39
       
 
       
  </note>

     

       
40
       
 
       
 </section>

     

       
41
       
+
       
 <section xml:id="sec-multiple-outputs-installing">

     

       
42
       
 
       
  <title>Installing a split package</title>

     

       
43
       
 
       


     

       
44
       
 
       
  <para>

     
···

       
84
       
 
       
   </listitem>

     

       
85
       
 
       
  </itemizedlist>

     

       
86
       
 
       
 </section>

     

       
87
       
+
       
 <section xml:id="sec-multiple-outputs-using-split-packages">

     

       
88
       
 
       
  <title>Using a split package</title>

     

       
89
       
 
       


     

       
90
       
 
       
  <para>

     
···

       
102
       
 
       
   also added. (See <xref linkend="multiple-output-file-type-groups" />.)

     

       
103
       
 
       
  </para>

     

       
104
       
 
       
 </section>

     

       
105
       
+
       
 <section xml:id="sec-multiple-outputs-">

     

       
106
       
 
       
  <title>Writing a split derivation</title>

     

       
107
       
 
       


     

       
108
       
 
       
  <para>

     
···

       
283
       
 
       
   </variablelist>

     

       
284
       
 
       
  </section>

     

       
285
       
 
       


     

       
286
       
+
       
  <section xml:id="sec-multiple-outputs-caveats">

     

       
287
       
 
       
   <title>Common caveats</title>

     

       
288
       
 
       


     

       
289
       
 
       
   <itemizedlist>

     

···

       
181
       
 
       
 </section>

     

       
182
       
 
       
<!--============================================================-->

     

       
183
       
 
       
<!--

     

       
184
       
-
       
<section>

     

       
185
       
 
       
  <title>Gnome</title>

     

       
186
       
 
       
  <para>* Expression is auto-generated</para>

     

       
187
       
 
       
  <para>* How to update</para>

     
···

       
189
       
 
       
-->

     

       
190
       
 
       
<!--============================================================-->

     

       
191
       
 
       
<!--

     

       
192
       
-
       
<section>

     

       
193
       
 
       
  <title>GCC</title>

     

       
194
       
 
       
  <para>…</para>

     

       
195
       
 
       
</section>

     

···

       
181
       
 
       
 </section>

     

       
182
       
 
       
<!--============================================================-->

     

       
183
       
 
       
<!--

     

       
184
       
+
       
<section xml:id="sec-package-notes-gnome">

     

       
185
       
 
       
  <title>Gnome</title>

     

       
186
       
 
       
  <para>* Expression is auto-generated</para>

     

       
187
       
 
       
  <para>* How to update</para>

     
···

       
189
       
 
       
-->

     

       
190
       
 
       
<!--============================================================-->

     

       
191
       
 
       
<!--

     

       
192
       
+
       
<section xml:id="sec-package-notes-gcc">

     

       
193
       
 
       
  <title>GCC</title>

     

       
194
       
 
       
  <para>…</para>

     

       
195
       
 
       
</section>

     

···

       
2
       
 
       
<article xmlns="http://docbook.org/ns/docbook"

     

       
3
       
 
       
         xmlns:xlink="http://www.w3.org/1999/xlink">

     

       
4
       
 
       
 <title>Nixpkgs Release Notes</title>

     

       
5
       
-
       
 <section>

     

       
6
       
 
       
  <title>Release 0.14 (June 4, 2012)</title>

     

       
7
       
 
       


     

       
8
       
 
       
  <para>

     
···

       
17
       
 
       
   packages by numerous contributors. For details, see the commit logs.

     

       
18
       
 
       
  </para>

     

       
19
       
 
       
 </section>

     

       
20
       
-
       
 <section>

     

       
21
       
 
       
  <title>Release 0.13 (February 5, 2010)</title>

     

       
22
       
 
       


     

       
23
       
 
       
  <para>

     
···

       
51
       
 
       
   </itemizedlist>

     

       
52
       
 
       
  </para>

     

       
53
       
 
       
 </section>

     

       
54
       
-
       
 <section>

     

       
55
       
 
       
  <title>Release 0.12 (April 24, 2009)</title>

     

       
56
       
 
       


     

       
57
       
 
       
  <para>

     
···

       
145
       
 
       
   <literal>nix-dev</literal> mailing list.

     

       
146
       
 
       
  </para>

     

       
147
       
 
       
 </section>

     

       
148
       
-
       
 <section>

     

       
149
       
 
       
  <title>Release 0.11 (September 11, 2007)</title>

     

       
150
       
 
       


     

       
151
       
 
       
  <para>

     
···

       
344
       
 
       
   Bravenboer, Michael Raskin, Wouter den Breejen and Yury G. Kudryashov.

     

       
345
       
 
       
  </para>

     

       
346
       
 
       
 </section>

     

       
347
       
-
       
 <section>

     

       
348
       
 
       
  <title>Release 0.10 (October 12, 2006)</title>

     

       
349
       
 
       


     

       
350
       
 
       
  <note>

     
···

       
547
       
 
       
   Bravenboer, Merijn de Jonge, Rob Vermaas and Roy van den Broek.

     

       
548
       
 
       
  </para>

     

       
549
       
 
       
 </section>

     

       
550
       
-
       
 <section>

     

       
551
       
 
       
  <title>Release 0.9 (January 31, 2006)</title>

     

       
552
       
 
       


     

       
553
       
 
       
  <para>

     
···

       
676
       
 
       
   Martin Bravenboer, Rob Vermaas and Roy van den Broek.

     

       
677
       
 
       
  </para>

     

       
678
       
 
       
 </section>

     

       
679
       
-
       
 <section>

     

       
680
       
 
       
  <title>Release 0.8 (April 11, 2005)</title>

     

       
681
       
 
       


     

       
682
       
 
       
  <para>

     
···

       
700
       
 
       
   </itemizedlist>

     

       
701
       
 
       
  </para>

     

       
702
       
 
       
 </section>

     

       
703
       
-
       
 <section>

     

       
704
       
 
       
  <title>Release 0.7 (March 14, 2005)</title>

     

       
705
       
 
       


     

       
706
       
 
       
  <itemizedlist>

     

···

       
2
       
 
       
<article xmlns="http://docbook.org/ns/docbook"

     

       
3
       
 
       
         xmlns:xlink="http://www.w3.org/1999/xlink">

     

       
4
       
 
       
 <title>Nixpkgs Release Notes</title>

     

       
5
       
+
       
 <section xml:id="release-notes-0.14">

     

       
6
       
 
       
  <title>Release 0.14 (June 4, 2012)</title>

     

       
7
       
 
       


     

       
8
       
 
       
  <para>

     
···

       
17
       
 
       
   packages by numerous contributors. For details, see the commit logs.

     

       
18
       
 
       
  </para>

     

       
19
       
 
       
 </section>

     

       
20
       
+
       
 <section xml:id="release-notes-0.13">

     

       
21
       
 
       
  <title>Release 0.13 (February 5, 2010)</title>

     

       
22
       
 
       


     

       
23
       
 
       
  <para>

     
···

       
51
       
 
       
   </itemizedlist>

     

       
52
       
 
       
  </para>

     

       
53
       
 
       
 </section>

     

       
54
       
+
       
 <section xml:id="release-notes-0.12">

     

       
55
       
 
       
  <title>Release 0.12 (April 24, 2009)</title>

     

       
56
       
 
       


     

       
57
       
 
       
  <para>

     
···

       
145
       
 
       
   <literal>nix-dev</literal> mailing list.

     

       
146
       
 
       
  </para>

     

       
147
       
 
       
 </section>

     

       
148
       
+
       
 <section xml:id="release-notes-0.11">

     

       
149
       
 
       
  <title>Release 0.11 (September 11, 2007)</title>

     

       
150
       
 
       


     

       
151
       
 
       
  <para>

     
···

       
344
       
 
       
   Bravenboer, Michael Raskin, Wouter den Breejen and Yury G. Kudryashov.

     

       
345
       
 
       
  </para>

     

       
346
       
 
       
 </section>

     

       
347
       
+
       
 <section xml:id="release-notes-0.10">

     

       
348
       
 
       
  <title>Release 0.10 (October 12, 2006)</title>

     

       
349
       
 
       


     

       
350
       
 
       
  <note>

     
···

       
547
       
 
       
   Bravenboer, Merijn de Jonge, Rob Vermaas and Roy van den Broek.

     

       
548
       
 
       
  </para>

     

       
549
       
 
       
 </section>

     

       
550
       
+
       
 <section xml:id="release-notes-0.9">

     

       
551
       
 
       
  <title>Release 0.9 (January 31, 2006)</title>

     

       
552
       
 
       


     

       
553
       
 
       
  <para>

     
···

       
676
       
 
       
   Martin Bravenboer, Rob Vermaas and Roy van den Broek.

     

       
677
       
 
       
  </para>

     

       
678
       
 
       
 </section>

     

       
679
       
+
       
 <section xml:id="release-notes-0.8">

     

       
680
       
 
       
  <title>Release 0.8 (April 11, 2005)</title>

     

       
681
       
 
       


     

       
682
       
 
       
  <para>

     
···

       
700
       
 
       
   </itemizedlist>

     

       
701
       
 
       
  </para>

     

       
702
       
 
       
 </section>

     

       
703
       
+
       
 <section xml:id="release-notes-0.7">

     

       
704
       
 
       
  <title>Release 0.7 (March 14, 2005)</title>

     

       
705
       
 
       


     

       
706
       
 
       
  <itemizedlist>

     

···

       
208
       
 
       
   </listitem>

     

       
209
       
 
       
  </itemizedlist>

     

       
210
       
 
       


     

       
211
       
-
       
  <example>

     

       
212
       
 
       
   <title>Sample template for a package update review</title>

     

       
213
       
 
       
<screen>

     

       
214
       
 
       
##### Reviewed points

     
···

       
320
       
 
       
   </listitem>

     

       
321
       
 
       
  </itemizedlist>

     

       
322
       
 
       


     

       
323
       
-
       
  <example>

     

       
324
       
 
       
   <title>Sample template for a new package review</title>

     

       
325
       
 
       
<screen>

     

       
326
       
 
       
##### Reviewed points

     
···

       
443
       
 
       
   </listitem>

     

       
444
       
 
       
  </itemizedlist>

     

       
445
       
 
       


     

       
446
       
-
       
  <example>

     

       
447
       
 
       
   <title>Sample template for a module update review</title>

     

       
448
       
 
       
<screen>

     

       
449
       
 
       
##### Reviewed points

     
···

       
542
       
 
       
   </listitem>

     

       
543
       
 
       
  </itemizedlist>

     

       
544
       
 
       


     

       
545
       
-
       
  <example>

     

       
546
       
 
       
   <title>Sample template for a new module review</title>

     

       
547
       
 
       
<screen>

     

       
548
       
 
       
##### Reviewed points

     

···

       
208
       
 
       
   </listitem>

     

       
209
       
 
       
  </itemizedlist>

     

       
210
       
 
       


     

       
211
       
+
       
  <example xml:id="reviewing-contributions-sample-package-update">

     

       
212
       
 
       
   <title>Sample template for a package update review</title>

     

       
213
       
 
       
<screen>

     

       
214
       
 
       
##### Reviewed points

     
···

       
320
       
 
       
   </listitem>

     

       
321
       
 
       
  </itemizedlist>

     

       
322
       
 
       


     

       
323
       
+
       
  <example xml:id="reviewing-contributions-sample-new-package">

     

       
324
       
 
       
   <title>Sample template for a new package review</title>

     

       
325
       
 
       
<screen>

     

       
326
       
 
       
##### Reviewed points

     
···

       
443
       
 
       
   </listitem>

     

       
444
       
 
       
  </itemizedlist>

     

       
445
       
 
       


     

       
446
       
+
       
  <example xml:id="reviewing-contributions-sample-module-update">

     

       
447
       
 
       
   <title>Sample template for a module update review</title>

     

       
448
       
 
       
<screen>

     

       
449
       
 
       
##### Reviewed points

     
···

       
542
       
 
       
   </listitem>

     

       
543
       
 
       
  </itemizedlist>

     

       
544
       
 
       


     

       
545
       
+
       
  <example xml:id="reviewing-contributions-sample-new-module">

     

       
546
       
 
       
   <title>Sample template for a new module review</title>

     

       
547
       
 
       
<screen>

     

       
548
       
 
       
##### Reviewed points

     

···

       
212
       
 
       
   platforms relative to the new derivation's, and whether they are propagated.

     

       
213
       
 
       
   The platform distinctions are motivated by cross compilation; see

     

       
214
       
 
       
   <xref linkend="chap-cross"/> for exactly what each platform means.

     

       
215
       
-
       
   <footnote>

     

       
216
       
 
       
    <para>

     

       
217
       
 
       
     The build platform is ignored because it is a mere implementation detail

     

       
218
       
 
       
     of the package satisfying the dependency: As a general programming

     
···

       
233
       
 
       
   out only for dependencies whose host platform matches the new derivation's

     

       
234
       
 
       
   build platform–i.e. which run on the platform where the new derivation

     

       
235
       
 
       
   will be built.

     

       
236
       
-
       
   <footnote>

     

       
237
       
 
       
    <para>

     

       
238
       
 
       
     Currently, that means for native builds all dependencies are put on the

     

       
239
       
 
       
     <envar>PATH</envar>. But in the future that may not be the case for sake

     
···

       
280
       
 
       
   <link xlink:href="https://en.wikipedia.org/wiki/Natural_deduction">Natural

     

       
281
       
 
       
   Deduction</link> using the inference rules. This probably seems a bit

     

       
282
       
 
       
   obtuse, but so is the bash code that actually implements it!

     

       
283
       
-
       
   <footnote>

     

       
284
       
 
       
    <para>

     

       
285
       
 
       
     The <function>findInputs</function> function, currently residing in

     

       
286
       
 
       
     <filename>pkgs/stdenv/generic/setup.sh</filename>, implements the

     
···

       
1112
       
 
       
       By default, the configure phase applies some special hackery to all

     

       
1113
       
 
       
       files called <filename>ltmain.sh</filename> before running the configure

     

       
1114
       
 
       
       script in order to improve the purity of Libtool-based packages

     

       
1115
       
-
       
       <footnote>

     

       
1116
       
 
       
        <para>

     

       
1117
       
 
       
         It clears the

     

       
1118
       
 
       
         <varname>sys_lib_<replaceable>*</replaceable>search_path</varname>

     
···

       
1151
       
 
       
       or a subset to control exactly which platform flags are passed.

     

       
1152
       
 
       
       Compilers and other tools should use this to also pass the target

     

       
1153
       
 
       
       platform, for example.

     

       
1154
       
-
       
       <footnote>

     

       
1155
       
 
       
        <para>

     

       
1156
       
 
       
         Eventually these will be passed when in native builds too, to improve

     

       
1157
       
 
       
         determinism: build-time guessing, as is done today, is a risk of

     
···

       
1732
       
 
       
       Controls whether the installCheck phase is executed. By default it is

     

       
1733
       
 
       
       skipped, but if <varname>doInstallCheck</varname> is set to true, the

     

       
1734
       
 
       
       installCheck phase is usually executed. Thus you should set

     

       
1735
       
-
       
       <programlisting>doInstallCheck = true;</programlisting>

     

       
1736
       
 
       
       in the derivation to enable install checks. The exception is cross

     

       
1737
       
 
       
       compilation. Cross compiled builds never run tests, no matter how

     

       
1738
       
 
       
       <varname>doInstallCheck</varname> is set, as the newly-built program

     
···

       
2213
       
 
       
       <command>clang</command> is to be used. Secondly, this helps packages

     

       
2214
       
 
       
       not get confused when cross-compiling, in which case multiple Bintools

     

       
2215
       
 
       
       Wrappers may simultaneously be in use.

     

       
2216
       
-
       
       <footnote>

     

       
2217
       
 
       
        <para>

     

       
2218
       
 
       
         Each wrapper targets a single platform, so if binaries for multiple

     

       
2219
       
 
       
         platforms are needed, the underlying binaries must be wrapped multiple

     

···

       
212
       
 
       
   platforms relative to the new derivation's, and whether they are propagated.

     

       
213
       
 
       
   The platform distinctions are motivated by cross compilation; see

     

       
214
       
 
       
   <xref linkend="chap-cross"/> for exactly what each platform means.

     

       
215
       
+
       
   <footnote xml:id="footnote-stdenv-ignored-build-platform">

     

       
216
       
 
       
    <para>

     

       
217
       
 
       
     The build platform is ignored because it is a mere implementation detail

     

       
218
       
 
       
     of the package satisfying the dependency: As a general programming

     
···

       
233
       
 
       
   out only for dependencies whose host platform matches the new derivation's

     

       
234
       
 
       
   build platform–i.e. which run on the platform where the new derivation

     

       
235
       
 
       
   will be built.

     

       
236
       
+
       
   <footnote xml:id="footnote-stdenv-native-dependencies-in-path">

     

       
237
       
 
       
    <para>

     

       
238
       
 
       
     Currently, that means for native builds all dependencies are put on the

     

       
239
       
 
       
     <envar>PATH</envar>. But in the future that may not be the case for sake

     
···

       
280
       
 
       
   <link xlink:href="https://en.wikipedia.org/wiki/Natural_deduction">Natural

     

       
281
       
 
       
   Deduction</link> using the inference rules. This probably seems a bit

     

       
282
       
 
       
   obtuse, but so is the bash code that actually implements it!

     

       
283
       
+
       
   <footnote xml:id="footnote-stdenv-find-inputs-location">

     

       
284
       
 
       
    <para>

     

       
285
       
 
       
     The <function>findInputs</function> function, currently residing in

     

       
286
       
 
       
     <filename>pkgs/stdenv/generic/setup.sh</filename>, implements the

     
···

       
1112
       
 
       
       By default, the configure phase applies some special hackery to all

     

       
1113
       
 
       
       files called <filename>ltmain.sh</filename> before running the configure

     

       
1114
       
 
       
       script in order to improve the purity of Libtool-based packages

     

       
1115
       
+
       
       <footnote xml:id="footnote-stdenv-sys-lib-search-path">

     

       
1116
       
 
       
        <para>

     

       
1117
       
 
       
         It clears the

     

       
1118
       
 
       
         <varname>sys_lib_<replaceable>*</replaceable>search_path</varname>

     
···

       
1151
       
 
       
       or a subset to control exactly which platform flags are passed.

     

       
1152
       
 
       
       Compilers and other tools should use this to also pass the target

     

       
1153
       
 
       
       platform, for example.

     

       
1154
       
+
       
       <footnote xml:id="footnote-stdenv-build-time-guessing-impurity">

     

       
1155
       
 
       
        <para>

     

       
1156
       
 
       
         Eventually these will be passed when in native builds too, to improve

     

       
1157
       
 
       
         determinism: build-time guessing, as is done today, is a risk of

     
···

       
1732
       
 
       
       Controls whether the installCheck phase is executed. By default it is

     

       
1733
       
 
       
       skipped, but if <varname>doInstallCheck</varname> is set to true, the

     

       
1734
       
 
       
       installCheck phase is usually executed. Thus you should set

     

       
1735
       
+
       
<programlisting>doInstallCheck = true;</programlisting>

     

       
1736
       
 
       
       in the derivation to enable install checks. The exception is cross

     

       
1737
       
 
       
       compilation. Cross compiled builds never run tests, no matter how

     

       
1738
       
 
       
       <varname>doInstallCheck</varname> is set, as the newly-built program

     
···

       
2213
       
 
       
       <command>clang</command> is to be used. Secondly, this helps packages

     

       
2214
       
 
       
       not get confused when cross-compiling, in which case multiple Bintools

     

       
2215
       
 
       
       Wrappers may simultaneously be in use.

     

       
2216
       
+
       
       <footnote xml:id="footnote-stdenv-per-platform-wrapper">

     

       
2217
       
 
       
        <para>

     

       
2218
       
 
       
         Each wrapper targets a single platform, so if binaries for multiple

     

       
2219
       
 
       
         platforms are needed, the underlying binaries must be wrapped multiple