Changeset a747ea2 for chapter08/ninja.xml

Timestamp:

12/09/2022 07:53:09 AM (17 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

xry111/arm64, xry111/arm64-12.0

Children:

ca4faad

Parents:

dfe9593 (diff), 4640b37d (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge remote-tracking branch 'origin/trunk' into xry111/arm64

File:

• chapter08/ninja.xml (modified) (4 diffs)

chapter08/ninja.xml

@@ -37 +37 @@
 
     <tip revision="sysv">
-      <para>This section is not strictly required for LFS if not using
-      systemd. On the other hand, ninja associated to meson makes
+      <para>This section is not strictly required when LFS does not use
+      systemd. On the other hand, Ninja, along with Meson, makes
       a powerful build system combination,
-      which is expected to be used more and more often. It is required for
+      which will probably be used more and more often. It is required for
       several packages in <ulink url="&blfs-book;">the BLFS
       book</ulink>.</para>
@@ -50 +50 @@
     <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
-    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>When run, <command>ninja</command> normally utilizes the greatest
+    possible number of processes in parallel.  By default this is the number of cores on the system,
+    plus two.  This may overheat the CPU, or make the system run out
+    of memory.  When <command>ninja</command> is invoked from the command line, passing the -jN parameter
+    will limit the number of parallel processes. Some packages
+    embed the execution of <command>ninja</command>, and do not pass the -j parameter on to it.</para>
 
     <para>Using the <emphasis>optional</emphasis> procedure below allows a user to
@@ -63 +63 @@
     <screen>export NINJAJOBS=4</screen>
 
-    will limit ninja to four parallel processes.</para>
+    will limit <command>ninja</command> to four parallel processes.</para>
 
-    <para>If desired, add the capability to use the environment variable
-    NINJAJOBS by running:</para>
+    <para>If desired, make <command>ninja</command> recognize the environment variable
+    NINJAJOBS by running the stream editor:</para>
 
 <screen><userinput remap="pre">sed -i '/int Guess/a \
@@ -85 +85 @@
         <term><parameter>--bootstrap</parameter></term>
         <listitem>
-          <para>This parameter forces ninja to rebuild itself for the current
+          <para>This parameter forces Ninja to rebuild itself for the current
           system.</para>
         </listitem>