16/17: doc: Recommend building in ‘guix shell -CPW’.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 01361d46b8e0481ad56665d7a06c276b08f59c6d
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Wed Nov 22 12:57:00 2023 +0100

    doc: Recommend building in ‘guix shell -CPW’.
    
    This was prompted by <https://issues.guix.gnu.org/66537>, where someone
    tried to build Guix within ‘guix shell --pure’ on a foreign distro and
    found that ./configure would pick software from the host system.
    
    Suggested by Hiep Pham <hiepph9@proton.me>.
    
    * doc/contributing.texi (Building from Git): Recommend ‘guix shell -CPW’.
    
    Change-Id: I7694b482d982917fef6ec404f68ddacea761f482
---
 doc/contributing.texi | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 9e9b89782c..0833b5d32c 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -76,15 +76,17 @@ all the dependencies and appropriate environment variables 
are set up to
 hack on Guix:
 
 @example
-guix shell -D guix --pure
+guix shell -D guix -CPW
 @end example
 
 or even, from within a Git worktree for Guix:
 
 @example
-guix shell --pure
+guix shell -CPW
 @end example
 
+If @option{-C} (short for @option{--container}) is not supported on your
+system, try @command{--pure} instead of @option{-CPW}.
 @xref{Invoking guix shell}, for more information on that command.
 
 If you are unable to use Guix when building Guix from a checkout, the