From patchwork Thu Nov 30 09:46:18 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Xi Ruoyao X-Patchwork-Id: 81004 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id E186F385803E for ; Thu, 30 Nov 2023 09:46:47 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from xry111.site (xry111.site [89.208.246.23]) by sourceware.org (Postfix) with ESMTPS id 9BF403858C66 for ; Thu, 30 Nov 2023 09:46:30 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 9BF403858C66 Authentication-Results: sourceware.org; dmarc=pass (p=reject dis=none) header.from=xry111.site Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=xry111.site ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 9BF403858C66 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=89.208.246.23 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701337592; cv=none; b=fRjMKbuXntVWYWob2fzY6Sf70xWo5pMYefOUzA+sCue/E4Bsoevc1v7qVt2wfZWwhSxKwHQEi7gJrK4LPkkVLgWugmNHSyu9gsCBD2oMiptSYHG9Eq2U4AWZ+LoZRH1CeqJwBybQENzB5MdzV5uIcpGKI4HhkID3qM4F2iYQ6SQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701337592; c=relaxed/simple; bh=aR2NtQF8qdYlDz7C7ER6Pr+nFpG+wF0PoSs5hGNf+0Q=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=N423BmQv6RIyXddQkXJ2uOcgCMhU18JRNhyTViffwbCeXEIww1JxrlLfESr4qJNf1dRo/OkqusiPT5l80PuZs1fXaJrj3bhqxbsufT8+xt9GHgZ0LE4Cwx788q6StLMjYkuGE6DqZnmZ8t1PJsy8i7DPmlwqL4NKtmAQAc56r58= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=xry111.site; s=default; t=1701337589; bh=aR2NtQF8qdYlDz7C7ER6Pr+nFpG+wF0PoSs5hGNf+0Q=; h=From:To:Cc:Subject:Date:From; b=HnzXr2n4ZvP9sN6pIl7+J88VEWTe1ws8TL72B1ijPXhE5A6NlkMpN3zKbj8Q+l3Ye hiqRmwr71MkXSnGsT0BBTR6UDzEZ3FWEM1f9uwINJY+z+5JBVslXL5IJoRSYZvgB34 gepKJQJi/CQm6U8HyyqtHV3ozjzVwrXdwWuZzVAw= Received: from stargazer.. (unknown [113.200.174.122]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-384) server-digest SHA384) (Client did not present a certificate) (Authenticated sender: xry111@xry111.site) by xry111.site (Postfix) with ESMTPSA id C81AD66990; Thu, 30 Nov 2023 04:46:28 -0500 (EST) From: Xi Ruoyao To: gcc-patches@gcc.gnu.org Cc: Xi Ruoyao Subject: [PATCH] doc: Update the status of build directory not fully separated Date: Thu, 30 Nov 2023 17:46:18 +0800 Message-ID: <20231130094623.14211-1-xry111@xry111.site> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 X-Spam-Status: No, score=-9.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_SHORT, LIKELY_SPAM_FROM, SPF_HELO_PASS, SPF_PASS, TXREP, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org Recently there are some people building GCC with srcdir == objdir and the attempts just failed [1]. So stop to say "it should work". OTOH objdir as a subdirectory of srcdir works (at least for LFS [2] and BLFS [3]). [1]: https://gcc.gnu.org/pipermail/gcc-help/2023-November/143068.html [2]: https://www.linuxfromscratch.org/lfs/view/12.0/chapter08/gcc.html [3]: https://www.linuxfromscratch.org/blfs/view/12.0/general/gcc.html gcc/ChangeLog: * doc/install.texi: Deem srcdir == objdir as broken, and objdir as a subdirectory of srcdir is slightly better. --- Ok for trunk? gcc/doc/install.texi | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index c1ccb8ba02d..0b43f3dce75 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -697,9 +697,9 @@ phases. First, we @strong{highly} recommend that GCC be built into a separate directory from the sources which does @strong{not} reside within the source tree. This is how we generally build GCC; building -where @var{srcdir} == @var{objdir} should still work, but doesn't -get extensive testing; building where @var{objdir} is a subdirectory -of @var{srcdir} is unsupported. +where @var{objdir} is a subdirectory of @var{srcdir} should still work, +but doesn't get extensive testing; building where @var{objdir} == +@var{srcdir} won't work. If you have previously built GCC in the same directory for a different target machine, do @samp{make distclean} to delete all files