From 581ee1a9e887d33fbb813fbb46d0ced30ffebcba Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Mon, 10 Feb 2025 21:29:48 +0800
Subject: [PATCH] ninja: Add --verbose

Some user using a slow system complained (off-list) to me that the long
no-output period seemed like a hang (esp. combined with the warning
about missing re2c).

Also explain the "basic functionality test" is already done, so no need
to run "./ninja" again for testing.
---
 chapter08/ninja.xml | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/chapter08/ninja.xml b/chapter08/ninja.xml
index 5bccea1ea..6850d06a0 100644
--- a/chapter08/ninja.xml
+++ b/chapter08/ninja.xml
@@ -67,7 +67,7 @@
 
     <para>Build Ninja with:</para>
 
-<screen><userinput remap="configure">python3 configure.py --bootstrap</userinput></screen>
+<screen><userinput remap="configure">python3 configure.py --bootstrap --verbose</userinput></screen>
 
     <variablelist>
       <title>The meaning of the build option:</title>
@@ -80,10 +80,20 @@
         </listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><parameter>--verbose</parameter></term>
+        <listitem>
+          <para>This parameter makes <command>configure.py</command> show
+          the progress building Ninja.</para>
+        </listitem>
+      </varlistentry>
+
     </variablelist>
 
     <para>The package tests cannot run in the chroot environment. They require 
-    <ulink url="&blfs-book;general/cmake.html">cmake</ulink>.</para>
+    <ulink url="&blfs-book;general/cmake.html">cmake</ulink>.  But the basic
+    function of this package is already tested by rebuilding itself
+    (with the <parameter>--bootstrap</parameter> option) anyway.</para>
 <!--
     <para>To test the results, issue:</para>