From 0fe3bb04a7aea4fa162af5840026c672393354f7 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Wed, 21 Jun 2023 14:35:58 +0800
Subject: [PATCH] Create man page symlinks for awk, cc, pkg-config, and lex

---
 chapter08/flex.xml    |  6 ++++--
 chapter08/gawk.xml    |  6 ++++++
 chapter08/gcc.xml     | 12 +++++++-----
 chapter08/pkgconf.xml |  7 ++++---
 4 files changed, 21 insertions(+), 10 deletions(-)

diff --git a/chapter08/flex.xml b/chapter08/flex.xml
index d05474f03..478637adc 100644
--- a/chapter08/flex.xml
+++ b/chapter08/flex.xml
@@ -73,9 +73,11 @@
     try to run its predecessor, <command>lex</command>. To support those
     programs, create a symbolic link named <filename>lex</filename> that
     runs <filename>flex</filename> in <command>lex</command> emulation
-    mode:</para>
+    mode, and also create the man page of <command>lex</command> as a
+    symlink:</para>
 
-<screen><userinput remap="install">ln -sv flex /usr/bin/lex</userinput></screen>
+<screen><userinput remap="install">ln -sv flex   /usr/bin/lex
+ln -sv flex.1 /usr/share/man/man1/lex.1</userinput></screen>
 
   </sect2>
 
diff --git a/chapter08/gawk.xml b/chapter08/gawk.xml
index 3e177948e..a6b74460b 100644
--- a/chapter08/gawk.xml
+++ b/chapter08/gawk.xml
@@ -61,6 +61,12 @@ su tester -c "PATH=$PATH make check"</userinput></screen>
 
 <screen><userinput remap="install">make LN='ln -f' install</userinput></screen>
 
+    <para>The installation process already created <command>awk</command>
+    as a symlink to <command>gawk</command>, create its man page as a
+    symlink as well:</para>
+
+<screen><userinput remap="install">ln -sv gawk.1 /usr/share/man/man1/awk.1</userinput></screen>
+
     <variablelist>
       <title>The meaning of the overridden make variable:</title>
 
diff --git a/chapter08/gcc.xml b/chapter08/gcc.xml
index 482b588db..43f699689 100644
--- a/chapter08/gcc.xml
+++ b/chapter08/gcc.xml
@@ -215,12 +215,14 @@ su tester -c "PATH=$PATH make -k check"</userinput></screen>
     for "historical" reasons.</para>
 
 <screen><userinput remap="install">ln -svr /usr/bin/cpp /usr/lib</userinput></screen>
-  <!-- already done earlier
-    <para>Many packages use the name <command>cc</command> to call the C
-    compiler. To satisfy those packages, create a symlink:</para>
 
-<screen><userinput remap="install">ln -sv gcc /usr/bin/cc</userinput></screen>
-  -->
+    <para>Many packages use the name <command>cc</command> to call the C
+    compiler.  We've already created <command>cc</command> as a symlink in
+    <xref linkend='ch-tools-gcc-pass2'/>, create its man page as a symlink
+    as well:</para>
+
+<screen><userinput remap="install">ln -sv gcc.1 /usr/share/man/man1/cc.1</userinput></screen>
+
     <para>Add a compatibility symlink to enable building programs with
     Link Time Optimization (LTO):</para>
 
diff --git a/chapter08/pkgconf.xml b/chapter08/pkgconf.xml
index 73630f817..724a1ff24 100644
--- a/chapter08/pkgconf.xml
+++ b/chapter08/pkgconf.xml
@@ -57,10 +57,11 @@
 
 <screen><userinput remap="install">make install</userinput></screen>
 
-    <para>To maintain compatibility with the original Pkg-config create a
-    symlink:</para>
+    <para>To maintain compatibility with the original Pkg-config create two
+    symlinks:</para>
 
-<screen><userinput remap="install">ln -sfv pkgconf /usr/bin/pkg-config</userinput></screen>
+<screen><userinput remap="install">ln -sv pkgconf   /usr/bin/pkg-config
+ln -sv pkgconf.1 /usr/share/man/man1/pkg-config.1</userinput></screen>
 
   </sect2>