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: 171792 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:bcd1:0:b0:403:3b70:6f57 with SMTP id r17csp266560vqy; Thu, 30 Nov 2023 01:46:57 -0800 (PST) X-Google-Smtp-Source: AGHT+IF4Umoi5px+l8vgnkRLQHjRqlfGaQugsgThL5bdy9qjNUPvGZTutVUhEGfdhrddzgbVf+Bj X-Received: by 2002:a05:620a:6844:b0:77d:ce6a:87aa with SMTP id ru4-20020a05620a684400b0077dce6a87aamr5134631qkn.77.1701337617661; Thu, 30 Nov 2023 01:46:57 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1701337617; cv=pass; d=google.com; s=arc-20160816; b=dHuDXdjg+f3la2i9Od5YZeYJbJtcv5sdjbXg18WP0Q3tDts5M516EC9YS+f4x+GDU0 PTqxVJvt/A/E/U99bjbMB3RRt5BbBPX3qv8Fl7g/2vz8zfUyBiaNS0NXoG53geeQVWbI 7wJxvRMZbB+kHxjHdV57KDbOTEjX/h1fWSQ+zpMjDXGPTG+SO5bA9kKurhmoXEymtNwz oTk7A4Qcy15pNm8HM6taVFU4XNL/w93ssozZoyJ3v4kUSlkIAh2eD0oPAhGFXrTj5Fjh +HTca7iLHrMgR0pYtQwzfkewDsPq6dDM2ype+X8Ry5600VDjfJ192iuZJYCv+jJnUPCC VGoA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:message-id:date:subject:cc:to:from:dkim-signature :arc-filter:dmarc-filter:delivered-to; bh=2p6K9DzT+c5sA3pF3WYzLC8RRBEiiLo3rVwqktT7WaM=; fh=+inUqHb1KWMYZpOwBALIQPFNbgi25kPUPhpTg+F0E5A=; b=r0235g3y1t8/F/pYUo82odt5BOPQIbHX5HS89gBqviluZZKH2tCo8m6Aq2LXoQzgYy CuiPhs8bMEWdXOceGJvxZe6PwXL4+fnV1QZ1kPPhkCtU0hueKar6qBinOl6hDTt17I3E AGguW7JiR+hhHWN+dijxCKTqohay/xLMQzz0CvYCD6lwxXvP4yJk5gNu0T7fM8a1nEYE AjY0ZYPyCSrCWWrKUeNkoNkq7zhA2m+PI46k4ApZxx/wBXdNrQbfqKJmCDrF1+qqiyaK RFCPdaI0z3lxA/Y9nyFDwtBc5YwAa027N5vRsixyx6Xkkyrm77yuT9m0BsZDalVtdhZu h2jA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@xry111.site header.s=default header.b=HnzXr2n4; arc=pass (i=1); spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=xry111.site Received: from server2.sourceware.org (server2.sourceware.org. [2620:52:3:1:0:246e:9693:128c]) by mx.google.com with ESMTPS id m6-20020a05620a290600b0077d86012810si710236qkp.367.2023.11.30.01.46.57 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 30 Nov 2023 01:46:57 -0800 (PST) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) client-ip=2620:52:3:1:0:246e:9693:128c; Authentication-Results: mx.google.com; dkim=pass header.i=@xry111.site header.s=default header.b=HnzXr2n4; arc=pass (i=1); spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=xry111.site Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 6C3AD3858017 for ; Thu, 30 Nov 2023 09:46:57 +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+ouuuleilei=gmail.com@gcc.gnu.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1783981793751357342 X-GMAIL-MSGID: 1783981793751357342 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