From 3f2235c907b373df5ae9512e1e9ada97443d9427 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Sat, 8 Feb 2025 09:17:21 +0800
Subject: [PATCH] coreutils: Better explain the autoreconf and automake
 commands

---
 chapter08/coreutils.xml | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/chapter08/coreutils.xml b/chapter08/coreutils.xml
index 70eb1e318..1acad31ca 100644
--- a/chapter08/coreutils.xml
+++ b/chapter08/coreutils.xml
@@ -62,22 +62,28 @@ FORCE_UNSAFE_CONFIGURE=1 ./configure \
             --enable-no-install-program=kill,uptime</userinput></screen>
 
     <variablelist>
-      <title>The meaning of the configure options:</title>
+      <title>The meaning of the commands and configure options:</title>
 
       <varlistentry>
-        <term><command>autoreconf</command></term>
+        <term><command>autoreconf -fv</command></term>
         <listitem>
           <para>The patch for internationalization has modified the
           build system, so the configuration files must
-          be regenerated.</para>
+          be regenerated.  Normally we would use the
+          <parameter>-i</parameter> option to update the standard
+          auxilary files, but for this package it does not work because
+          <filename>configure.ac</filename> specified an old gettext
+          version.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry>
-        <term><command>automake</command></term>
+        <term><command>automake -af</command></term>
         <listitem>
-          <para>Work around a problem with an older versions of autotools.
-          </para>
+	  <para>The automake auxilary files were not updated by
+	  <command>autoreconf</command> due to the missing
+	  <parameter>-i</parameter> option.  This command updates them
+	  to prevent a build failure.</para>
         </listitem>
       </varlistentry>