From 25dc9a8cfa7687a40a5e4c3467b32bc0f2d89b77 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@mengyan1223.wang>
Date: Tue, 22 Feb 2022 13:34:36 +0800
Subject: [PATCH] part 3 intro: warn that don't copy source tree with cp -R

---
 part3intro/generalinstructions.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/part3intro/generalinstructions.xml b/part3intro/generalinstructions.xml
index 0739f79cc..d8e280e0d 100644
--- a/part3intro/generalinstructions.xml
+++ b/part3intro/generalinstructions.xml
@@ -97,6 +97,12 @@
               to be built.  In <xref linkend="chapter-cross-tools"/> and
               <xref linkend="chapter-temporary-tools"/>, ensure you are
               the <emphasis>lfs</emphasis> user when extracting the package.</para>
+              <para>All methods to get the source code tree being built
+              in-position, except extracting the package tarball, are not
+              supported. Notably, using <command>cp -R</command> to copy the
+              source code tree somewhere else can destroy links and
+              timestamps in the sources tree and cause building
+              failure.</para>
             </listitem>
             <listitem>
               <para>Change to the directory created when the package was