Add optional patch to ninja.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@11311 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

1 files changed, 28 insertions, 8 deletions

diff --git a/chapter06/ninja.xml b/chapter06/ninja.xml
index 28db9df21..92c05301a 100644
--- a/chapter06/ninja.xml
+++ b/chapter06/ninja.xml
@@ -40,12 +40,35 @@
   <sect2 role="installation">
     <title>Installation of Ninja</title>
 
-    <para>Prepare Ninja for compilation:</para>
+    <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
+    of memory.  If run from the command line, passing a -jN parameter
+    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
+    limit the number of parallel processes via an environment variable, 
+    NINJAJOBS.  <command>For example</command> setting:
+
+     <!-- 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. -->
+
+    <screen>export NINJAJOBS=4</screen>
+
+    will limit ninja to four parallel processes.</para>
+
+    <para>If desired, install the patch by running:</para>
+
+<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>
 
     <variablelist>
-      <title>The meaning of the configure options:</title>
+      <title>The meaning of the build option:</title>
 
       <varlistentry>
         <term><parameter>--bootstrap</parameter></term>
@@ -66,12 +89,9 @@
     <para>Install the package:</para>
 
 <screen><userinput remap="install">install -vm755 ninja /usr/bin/
-install -vDm644 misc/ninja.vim \
-                /usr/share/vim/vim&vim-majmin;/syntax/ninja.vim
-install -vDm644 misc/bash-completion \
-                /usr/share/bash-completion/completions/ninja
-install -vDm644 misc/zsh-completion \
-                /usr/share/zsh/site-functions/_ninja</userinput></screen>
+install -vDm644 misc/ninja.vim       /usr/share/vim/vim&vim-majmin;/syntax/ninja.vim
+install -vDm644 misc/bash-completion /usr/share/bash-completion/completions/ninja
+install -vDm644 misc/zsh-completion  /usr/share/zsh/site-functions/_ninja</userinput></screen>
 
   </sect2>