From nobody Sun Mar 19 16:31:15 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Pfjzl2W5vz40Nqy for ; Sun, 19 Mar 2023 16:31:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Pfjzl2530z4Sq4; Sun, 19 Mar 2023 16:31:15 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1679243475; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=BYy/cRfqLLe72JDJZ06c2Vuw+fTmbfphLIL2Lmngl2o=; b=YLs4PE8CXTDhodyp2P87tAEVEAZBRqPeQ+8NpyRxCAEgxIdoNXhbQgStyreEtIDmOK/8AL J25iRxr2tW0dpyomFR71/q7uLDeaIRg0TYSjXvTEDd35fCE7apFz5AWzlffGaotOB+gyK6 qgVBjP9Wiq3tnUiuOmE6+j9ZW/5xyVtvSJoc7iVy4BZGjU1/OLHov+RtNcr4Lsm+nHnwCQ SlRZbuj2OY3qNrS4zF170aEJtljybZ9FrLfbH1o+w4ZzPmMjZmqaKtoW2jKNSdmF23ni68 zpDZBNgnN7fgF7GFY5x7XxszBnWPTpPXfXj4YrfMTDOcoWwaETgbxaIsoKm0Sg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1679243475; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=BYy/cRfqLLe72JDJZ06c2Vuw+fTmbfphLIL2Lmngl2o=; b=Hvq1Cz0613E/Jvmx2aXM9zeWh28u7Rfr/VOdgcPg8YbNsQUiWg3Jjz1A9LliXCB0emoBp6 SBIm52PLCzKQX617GtcCMU2hwgLZGNj2twX1zFVWV570aqCjlzqjseaAvfOlG7vcdG49Hu Ssq5u+eDw16pTaCtmpIhi8Yq5z/9HM17IdkLhdj1uUUtB8vJW877eyS8xqYQ+6vc1Y6GO2 hV13d7JxwNPt0EkI5CR6e5KDJiH7CDmEBbdOvjY3HwOuENLqZxvyimlMgISVvHQYDFFaFB 0WihBMnU8hG89r0qTj9ioIlXgmLCg9C5iYUS62P0EeX6q/sotYcbiIixryCC/Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1679243475; a=rsa-sha256; cv=none; b=jxXziyRXAVVYWpUF7CjgIo0tDJYeHfY7fNJLnAutcOptFZeSAolCnQ7bJSjXAXOy3lc3Mg hE3SlpC9t3xkWlxJRVGn3fcErjqY4rMe3UczbA2I3t7nst8IkxT5zpiRzaduU0ipOK3j80 uNKlAqae/73celSZn8XlnGCBTuun94+MOoNE+XDuQNLUWkxbwivDaYELuycRw/TG4jJUta 55CiD5JSp74y4A8Le3YfrnihA+pauOJoDok0ToumPZ2/IoUCNfsLtN4f8ZCxxsTGkvXlVE DtDrDDcb3k4g9K47oyemgM9eyTtOxa9wyRVljIQ6DMb10YbRmLVoUIZ4hqlJ5A== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Pfjzl18sczvwM; Sun, 19 Mar 2023 16:31:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 32JGVFQv001847; Sun, 19 Mar 2023 16:31:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 32JGVFoT001846; Sun, 19 Mar 2023 16:31:15 GMT (envelope-from git) Date: Sun, 19 Mar 2023 16:31:15 GMT Message-Id: <202303191631.32JGVFoT001846@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Li-Wen Hsu Subject: git: c6fe067434 - main - Committer guide: Correct the pacakge names of GCC12 for cross compiling List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: lwhsu X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c6fe067434f732318bf4fc431338b64959307ffe Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by lwhsu: URL: https://cgit.FreeBSD.org/doc/commit/?id=c6fe067434f732318bf4fc431338b64959307ffe commit c6fe067434f732318bf4fc431338b64959307ffe Author: Li-Wen Hsu AuthorDate: 2023-03-19 16:30:48 +0000 Commit: Li-Wen Hsu CommitDate: 2023-03-19 16:30:48 +0000 Committer guide: Correct the pacakge names of GCC12 for cross compiling Use the newly added syntax of the pacakge macro (in 1d899c1c6fc6). While here, fix some wording and typo spotted by Pau Amma. Differential Revision: https://reviews.freebsd.org/D39068 --- documentation/content/en/articles/committers-guide/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index ef1091bc5a..efdd1d18b0 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -3144,12 +3144,12 @@ Complete testing, as appropriate for the change, should be done with this compil At any moment in time, the FreeBSD project also supports one or more out-of-tree compilers. At present, this is GCC 12.x. Ideally, committers should test compile with this compiler, especially for large or risky changes. -This compiler is available as the ${TARGET_ARCH}-gcc package, such as package:aarch64-gcc[] or package:riscv64-gcc[]. +This compiler is available as the `${TARGET_ARCH}-gcc${VERSION}` package, such as package:devel/freebsd-gcc12@aarch64[aarch64-gcc12] or package:devel/freebsd-gcc12@riscv64[riscv64-gcc12]. The project runs automated CI jobs to build everything with these compilers. Committers are expected to fix the jobs they break with their changes. -Committers may test build with, for example `CROSS_TOOLCHAIN=arm64-gcc12` or `CROSS_TOOLCHAIN=llvm15` where necessary. +Committers may test build with, for example `CROSS_TOOLCHAIN=aarch64-gcc12` or `CROSS_TOOLCHAIN=llvm15` where necessary. -The FreeBSD also has some CI pipelines on github. +The FreeBSD project also has some CI pipelines on github. For pull requests on github and some branches pushed to the github forks, a number of cross compilation jobs run. These test FreeBSD building using a version of Clang that sometimes lags the in-tree compiler by a major version for a time.