|
@@ -39,7 +39,7 @@
|
|
|
|
|
|
<sect2 role="installation">
|
|
|
<title>Installation of Ninja</title>
|
|
|
-<!--
|
|
|
+
|
|
|
<para>When run, ninja normally runs a maximum number of processes
|
|
|
in parallel. By default this is the number of cores on the system
|
|
|
plus two. In some cases this can overheat a CPU or run a system out
|
|
@@ -47,22 +47,28 @@
|
|
|
will limit the number of parallel processes, but some packages
|
|
|
embed the execution of ninja and do not pass a -j parameter.</para>
|
|
|
|
|
|
- <para>Using the <emphasis>optional</emphasis> patch below allows a user to
|
|
|
+ <para>Using the <emphasis>optional</emphasis> procedure below allows a user to
|
|
|
limit the number of parallel processes via an environment variable,
|
|
|
- NINJAJOBS. <command>For example</command> setting:
|
|
|
+ NINJAJOBS. <command>For example</command>, setting:
|
|
|
|
|
|
- <!- - Using <command> here to make the output bold. We really don't want
|
|
|
+ <!--Using <command> here to make the output bold. We really don't want
|
|
|
users setting this now and experience shows that many users blindly
|
|
|
- copy/paste anything in a box. - ->
|
|
|
+ copy/paste anything in a box. -->
|
|
|
|
|
|
<screen>export NINJAJOBS=4</screen>
|
|
|
|
|
|
will limit ninja to four parallel processes.</para>
|
|
|
|
|
|
- <para>If desired, install the patch by running:</para>
|
|
|
+ <para>If desired, add the capability to use the environment variable
|
|
|
+ NINJAJOBS by running:</para>
|
|
|
+
|
|
|
+<screen><userinput remap="pre">sed -i '/int Guess/a \
|
|
|
+ int j = 0;\
|
|
|
+ char* jobs = getenv( "NINJAJOBS" );\
|
|
|
+ if ( jobs != NULL ) j = atoi( jobs );\
|
|
|
+ if ( j > 0 ) return j;\
|
|
|
+' src/ninja.cc</userinput></screen>
|
|
|
|
|
|
-<screen><userinput remap="pre">patch -Np1 -i ../ninja-1.8.2-add_NINJAJOBS_var-1.patch</userinput></screen>
|
|
|
--->
|
|
|
<para>Build Ninja with:</para>
|
|
|
|
|
|
<screen><userinput remap="configure">python3 configure.py --bootstrap</userinput></screen>
|