From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 09:32:30 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C15625EB005 for ; Mon, 19 Apr 2021 09:32:30 +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 4FP1nB58G1z3hW6; Mon, 19 Apr 2021 09:32:30 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 A39061CCB6; Mon, 19 Apr 2021 09:32:30 +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 13J9WUpq024503; Mon, 19 Apr 2021 09:32:30 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13J9WUSQ024502; Mon, 19 Apr 2021 09:32:30 GMT (envelope-from git) Date: Mon, 19 Apr 2021 09:32:30 GMT Message-Id: <202104190932.13J9WUSQ024502@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: e233d63695 - main - Use sysrc instead of echo to modify rc.conf MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e233d6369554edc1fba0b03c895c566889f038a6 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 09:32:30 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=e233d6369554edc1fba0b03c895c566889f038a6 commit e233d6369554edc1fba0b03c895c566889f038a6 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 09:32:15 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 09:32:41 +0000 Use sysrc instead of echo to modify rc.conf --- documentation/content/en/articles/remote-install/_index.adoc | 2 +- documentation/content/en/books/handbook/config/_index.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/articles/remote-install/_index.adoc b/documentation/content/en/articles/remote-install/_index.adoc index 8f72ae0cc1..bf97ed25e6 100644 --- a/documentation/content/en/articles/remote-install/_index.adoc +++ b/documentation/content/en/articles/remote-install/_index.adoc @@ -337,7 +337,7 @@ zfs_load="YES" + [source,shell] .... -# echo 'zfs_enable="YES"' >> /etc/rc.conf +# sysrc zfs_enable="YES" .... * Add additional users to the system using the man:adduser[8] tool. Do not forget to add a user to the `wheel` group so you may obtain root access after the reboot. diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc index 364df797f9..23640b3584 100644 --- a/documentation/content/en/books/handbook/config/_index.adoc +++ b/documentation/content/en/books/handbook/config/_index.adoc @@ -509,7 +509,7 @@ If there is no DHCP server and access to the Internet is needed, manually config [source,shell] .... -# echo 'defaultrouter="your_default_router"' >> /etc/rc.conf +# sysrc defaultrouter="your_default_router" # echo 'nameserver your_DNS_server' >> /etc/resolv.conf .... From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:08:22 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 5FEBA5EBDCA for ; Mon, 19 Apr 2021 10:08:22 +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 4FP2ZZ2JJTz3k6n; Mon, 19 Apr 2021 10:08:22 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 41F071CFE3; Mon, 19 Apr 2021 10:08:22 +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 13JA8M9k066208; Mon, 19 Apr 2021 10:08:22 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JA8MZC066207; Mon, 19 Apr 2021 10:08:22 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:08:22 GMT Message-Id: <202104191008.13JA8MZC066207@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: dbde991014 - main - Replace named with sshd in an example MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: dbde9910146157cd33559c36a866542f2c3b73cd Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:08:22 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=dbde9910146157cd33559c36a866542f2c3b73cd commit dbde9910146157cd33559c36a866542f2c3b73cd Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 09:38:28 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 09:38:28 +0000 Replace named with sshd in an example Also, mention the existence of the sysrc(8) tool. --- documentation/content/en/books/faq/_index.adoc | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index a5fdb454d1..a1044ab155 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -1336,11 +1336,18 @@ ZFS TRIM support was added to GELI as of link:https://svnweb.freebsd.org/changes The primary configuration file is [.filename]#/etc/defaults/rc.conf# which is described in man:rc.conf[5]. System startup scripts such as [.filename]#/etc/rc# and [.filename]#/etc/rc.d#, which are described in man:rc[8], include this file. _Do not edit this file!_ Instead, to edit an entry in [.filename]#/etc/defaults/rc.conf#, copy the line into [.filename]#/etc/rc.conf# and change it there. -For example, if to start man:named[8], the included DNS server: +For example, to start man:sshd[8], the included OpenSSH daemon: [source,shell] .... -# echo 'named_enable="YES"' >> /etc/rc.conf +# echo 'sshd_enable="YES"' >> /etc/rc.conf +.... + +Alternatively, use man:sysrc[8] to modify [.filename]#/etc/rc.conf#: + +[source,shell] +.... +# sysrc sshd_enable="YES" .... To start up local services, place shell scripts in the [.filename]#/usr/local/etc/rc.d# directory. These shell scripts should be set executable, the default file mode is `555`. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:08:23 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 8BAEE5EC20E for ; Mon, 19 Apr 2021 10:08:23 +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 4FP2Zb3c1Wz3k6r; Mon, 19 Apr 2021 10:08:23 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 6E1A91CF78; Mon, 19 Apr 2021 10:08:23 +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 13JA8N7b066229; Mon, 19 Apr 2021 10:08:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JA8NoZ066228; Mon, 19 Apr 2021 10:08:23 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:08:23 GMT Message-Id: <202104191008.13JA8NoZ066228@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 25f9b4641d - main - Remove unnecessary whitespace from an example MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 25f9b4641d5e1558f6fd0d6ff6e97ee53b9770d5 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:08:23 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=25f9b4641d5e1558f6fd0d6ff6e97ee53b9770d5 commit 25f9b4641d5e1558f6fd0d6ff6e97ee53b9770d5 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 09:42:24 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 09:42:24 +0000 Remove unnecessary whitespace from an example --- documentation/content/en/books/faq/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index a1044ab155..c5101850fe 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -1630,7 +1630,7 @@ Install Xorg from FreeBSD packages: [source,shell] .... - # pkg install xorg +# pkg install xorg .... After the installation of Xorg, follow the instructions from the link:{handbook}#x-config/[X11 Configuration] section of the FreeBSD Handbook. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:08:24 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id B33D65EC0A6 for ; Mon, 19 Apr 2021 10:08:24 +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 4FP2Zc4hWcz3k1q; Mon, 19 Apr 2021 10:08:24 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 933F41CF79; Mon, 19 Apr 2021 10:08:24 +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 13JA8Oh4066255; Mon, 19 Apr 2021 10:08:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JA8OPa066254; Mon, 19 Apr 2021 10:08:24 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:08:24 GMT Message-Id: <202104191008.13JA8OPa066254@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 8aa58e89c5 - main - Update the title of the FAQ book for FreeBSD 13 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8aa58e89c5c6b895ddb473c3871df3f9199b4273 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:08:24 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=8aa58e89c5c6b895ddb473c3871df3f9199b4273 commit 8aa58e89c5c6b895ddb473c3871df3f9199b4273 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 09:51:31 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 09:51:31 +0000 Update the title of the FAQ book for FreeBSD 13 We should probably change the title as it's prone to bit rot. --- documentation/content/en/books/faq/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index c5101850fe..d5126a76c5 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -1,5 +1,5 @@ --- -title: Frequently Asked Questions for FreeBSD 11.X and 12.X +title: Frequently Asked Questions for FreeBSD 11.X, 12.X, and 13.X authors: - author: The FreeBSD Documentation Project copyright: 1995-2020 The FreeBSD Documentation Project From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:08:25 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id CFF145EC1B5 for ; Mon, 19 Apr 2021 10:08:25 +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 4FP2Zd5PmZz3kFk; Mon, 19 Apr 2021 10:08:25 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 AA1131D25C; Mon, 19 Apr 2021 10:08:25 +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 13JA8Pqi066278; Mon, 19 Apr 2021 10:08:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JA8PuY066277; Mon, 19 Apr 2021 10:08:25 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:08:25 GMT Message-Id: <202104191008.13JA8PuY066277@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: f8030676a5 - main - FAQ: Document support for ext4fs MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f8030676a59034416488d620992e19787e7f7f3d Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:08:25 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=f8030676a59034416488d620992e19787e7f7f3d commit f8030676a59034416488d620992e19787e7f7f3d Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 09:52:39 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 09:52:39 +0000 FAQ: Document support for ext4fs --- documentation/content/en/books/faq/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index d5126a76c5..87be76950a 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -1056,7 +1056,7 @@ UFS:: UFS CD-ROMs can be mounted directly on FreeBSD. Mounting disk partitions from Digital UNIX and other systems that support UFS may be more complex, depending on the details of the disk partitioning for the operating system in question. ext2/ext3:: -FreeBSD supports `ext2fs` and `ext3fs` partitions. See man:ext2fs[5] for more information. +FreeBSD supports `ext2fs`, `ext3fs`, and `ext4fs` partitions. See man:ext2fs[5] for more information. NTFS:: FUSE based NTFS support is available as a port (package:sysutils/fusefs-ntfs[]). For more information see http://www.tuxera.com/community/ntfs-3g-manual/[ntfs-3g]. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:08:26 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id F2EE35EC075 for ; Mon, 19 Apr 2021 10:08:26 +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 4FP2Zf6bnWz3k70; Mon, 19 Apr 2021 10:08:26 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 D5EB91CFE4; Mon, 19 Apr 2021 10:08:26 +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 13JA8QxO066299; Mon, 19 Apr 2021 10:08:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JA8QJ2066298; Mon, 19 Apr 2021 10:08:26 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:08:26 GMT Message-Id: <202104191008.13JA8QJ2066298@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 3a855a2cf4 - main - FAQ: Point to the ntfs-3g manual page MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3a855a2cf4e20041afb0abb49e729e5069707081 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:08:27 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=3a855a2cf4e20041afb0abb49e729e5069707081 commit 3a855a2cf4e20041afb0abb49e729e5069707081 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 09:54:50 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 09:55:41 +0000 FAQ: Point to the ntfs-3g manual page The previous reference returns 404. --- documentation/content/en/books/faq/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index 87be76950a..d7e05aa380 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -1059,7 +1059,7 @@ ext2/ext3:: FreeBSD supports `ext2fs`, `ext3fs`, and `ext4fs` partitions. See man:ext2fs[5] for more information. NTFS:: -FUSE based NTFS support is available as a port (package:sysutils/fusefs-ntfs[]). For more information see http://www.tuxera.com/community/ntfs-3g-manual/[ntfs-3g]. +FUSE based NTFS support is available as a port (package:sysutils/fusefs-ntfs[]). For more information, see man:ntfs-3g[8]. FAT:: FreeBSD includes a read-write FAT driver. For more information, see man:mount_msdosfs[8]. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:08:28 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 074215EC0A9 for ; Mon, 19 Apr 2021 10:08:28 +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 4FP2Zg6tCjz3kNC; Mon, 19 Apr 2021 10:08:27 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 DE60F1CF7A; Mon, 19 Apr 2021 10:08:27 +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 13JA8RVU066320; Mon, 19 Apr 2021 10:08:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JA8Rng066319; Mon, 19 Apr 2021 10:08:27 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:08:27 GMT Message-Id: <202104191008.13JA8Rng066319@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: c5f5a82112 - main - FAQ: Update bits about getting a ports tree MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c5f5a82112f0de78da06ae73c19e4c99d4bb3111 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:08:28 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=c5f5a82112f0de78da06ae73c19e4c99d4bb3111 commit c5f5a82112f0de78da06ae73c19e4c99d4bb3111 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 10:00:11 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 10:00:11 +0000 FAQ: Update bits about getting a ports tree - Link to the portsnap manual - Replace Subversion with Git --- documentation/content/en/books/faq/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index d7e05aa380..c5829704e8 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -837,12 +837,12 @@ Most ports should work on all supported versions of FreeBSD. Those that do not a FreeBSD supports compressed binary packages to easily install and uninstall ports. Use man:pkg[7] to control the installation of packages. [[how-do-download-ports-tree]] -=== How do I download the Ports tree? Should I be using Subversion? +=== How do I download the Ports tree? Should I be using Git? Any of the methods listed here work: -* Use portsnap for most use cases. Refer to link:{handbook}#ports-using/[Using the Ports Collection] for instructions on how to use this tool. -* Use Subversion if custom patches to the ports tree are needed or if running FreeBSD-CURRENT. Refer to link:{handbook}#svn/[Using Subversion] for details. +* Use man:portsnap[8] for most use cases. Refer to link:{handbook}#ports-using/[Using the Ports Collection] for instructions on how to use this tool. +* Use Git if custom patches to the ports tree are needed or if running FreeBSD-CURRENT. Refer to link:{handbook}mirrors/#git[Using Git] for details. [[ports-4x]] === Why can I not build this port on my {rel2-relx} -, or {rel-relx} -STABLE machine? From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:19:23 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id CA9FA5EC35C for ; Mon, 19 Apr 2021 10:19:23 +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 4FP2qH5R09z3kbd; Mon, 19 Apr 2021 10:19:23 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 AD43B1D882; Mon, 19 Apr 2021 10:19:23 +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 13JAJNfZ079300; Mon, 19 Apr 2021 10:19:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JAJNkr079299; Mon, 19 Apr 2021 10:19:23 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:19:23 GMT Message-Id: <202104191019.13JAJNkr079299@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 66aba360e8 - main - Handbook: Mention that ports have transitioned to Git MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 66aba360e8e8abea842b7b8400fa79f2e9dfded4 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:19:23 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=66aba360e8e8abea842b7b8400fa79f2e9dfded4 commit 66aba360e8e8abea842b7b8400fa79f2e9dfded4 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 10:17:58 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 10:17:58 +0000 Handbook: Mention that ports have transitioned to Git --- documentation/content/en/books/handbook/mirrors/_index.adoc | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 28f250c66c..1801176cbd 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -456,8 +456,7 @@ Cloning over an existing non-git directory will fail. Git uses URLs to designate a repository, taking the form of _protocol://hostname/path_. The first component of the path is the FreeBSD repository to access. -There are two different repositories, `src` for the FreeBSD systerm source code, and `doc` for documentation. -In the future a third repository, 'ports' will be available for the FreeBSD ports code. +There are three different repositories, `src` for the FreeBSD systerm source code, `doc` for documentation, and `ports` for the FreeBSD Ports Collection. For example, the URL `https://git.FreeBSD.org/src.git` specifies the main branch of the src repository, using the `https` protocol. .Handy URL Table From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:26:05 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id B60125EC16E for ; Mon, 19 Apr 2021 10:26:05 +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 4FP2z14pT7z3kyX; Mon, 19 Apr 2021 10:26:05 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 97DE21D9EB; Mon, 19 Apr 2021 10:26:05 +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 13JAQ5wY092634; Mon, 19 Apr 2021 10:26:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JAQ5JA092633; Mon, 19 Apr 2021 10:26:05 GMT (envelope-from git) Date: Mon, 19 Apr 2021 10:26:05 GMT Message-Id: <202104191026.13JAQ5JA092633@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: d4907dfec3 - main - Clean up the list of online FreeBSD CD/DVD retailers MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: d4907dfec36cdfad3f9b64991354156e313ecf0d Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:26:05 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=d4907dfec36cdfad3f9b64991354156e313ecf0d commit d4907dfec36cdfad3f9b64991354156e313ecf0d Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 10:22:40 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 10:22:40 +0000 Clean up the list of online FreeBSD CD/DVD retailers The www.linuxcenter.ru shop seems to be gone. --- documentation/content/en/books/handbook/mirrors/_index.adoc | 9 --------- 1 file changed, 9 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 1801176cbd..9cb16428e7 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -58,15 +58,6 @@ Phone: (0177) 428 419 0 + Email: + WWW: http://www.hinner.de/linux/freebsd.html -* Linux Center + -Galernaya Street, 55 + -Saint-Petersburg + -190000 + -Russia + -Phone: +7-812-309-06-86 + -Email: + -WWW: http://linuxcenter.ru/shop/freebsd - [[mirrors-ftp]] == FTP Sites From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 10:48:54 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 579D45ECBD3 for ; Mon, 19 Apr 2021 10:48:54 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FP3TL20H8z3lpl; Mon, 19 Apr 2021 10:48:54 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from mail.j.mat.cc (owncloud.cube.mat.cc [79.143.240.228]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mail.mat.cc", Issuer "R3" (verified OK)) (Authenticated sender: mat/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 1BEA32F0D4; Mon, 19 Apr 2021 10:48:54 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from aching.in.mat.cc (unknown [IPv6:2a01:678:ab:0:3356:ef6b:256f:d0c6]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: mat@mat.cc) by mail.j.mat.cc (Postfix) with ESMTPSA id E3811942D80; Mon, 19 Apr 2021 10:48:52 +0000 (UTC) Date: Mon, 19 Apr 2021 12:48:51 +0200 From: Mathieu Arnold To: Mateusz Piotrowski <0mp@freebsd.org> Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Subject: Re: git: c5f5a82112 - main - FAQ: Update bits about getting a ports tree Message-ID: <20210419104851.ygnf5l74lbby7zf5@aching.in.mat.cc> References: <202104191008.13JA8Rng066319@gitrepo.freebsd.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="7yhf7xrb6e4ufgxj" Content-Disposition: inline In-Reply-To: <202104191008.13JA8Rng066319@gitrepo.freebsd.org> X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 10:48:54 -0000 --7yhf7xrb6e4ufgxj Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Apr 19, 2021 at 10:08:27AM +0000, Mateusz Piotrowski wrote: > The branch main has been updated by 0mp: >=20 > URL: https://cgit.FreeBSD.org/doc/commit/?id=3Dc5f5a82112f0de78da06ae73c1= 9e4c99d4bb3111 >=20 > commit c5f5a82112f0de78da06ae73c19e4c99d4bb3111 > Author: Mateusz Piotrowski <0mp@FreeBSD.org> > AuthorDate: 2021-04-19 10:00:11 +0000 > Commit: Mateusz Piotrowski <0mp@FreeBSD.org> > CommitDate: 2021-04-19 10:00:11 +0000 >=20 > FAQ: Update bits about getting a ports tree > =20 > - Link to the portsnap manual > - Replace Subversion with Git Might want to provide other means to get the ports tree than portsnap, it is not really supported any more, say, gitup for example. > --- > documentation/content/en/books/faq/_index.adoc | 6 +++--- > 1 file changed, 3 insertions(+), 3 deletions(-) >=20 > diff --git a/documentation/content/en/books/faq/_index.adoc b/documentati= on/content/en/books/faq/_index.adoc > index d7e05aa380..c5829704e8 100644 > --- a/documentation/content/en/books/faq/_index.adoc > +++ b/documentation/content/en/books/faq/_index.adoc > @@ -837,12 +837,12 @@ Most ports should work on all supported versions of= FreeBSD. Those that do not a > FreeBSD supports compressed binary packages to easily install and uninst= all ports. Use man:pkg[7] to control the installation of packages. > =20 > [[how-do-download-ports-tree]] > -=3D=3D=3D How do I download the Ports tree? Should I be using Subversion? > +=3D=3D=3D How do I download the Ports tree? Should I be using Git? > =20 > Any of the methods listed here work: > =20 > -* Use portsnap for most use cases. Refer to link:{handbook}#ports-using/= [Using the Ports Collection] for instructions on how to use this tool. > -* Use Subversion if custom patches to the ports tree are needed or if ru= nning FreeBSD-CURRENT. Refer to link:{handbook}#svn/[Using Subversion] for = details. > +* Use man:portsnap[8] for most use cases. Refer to link:{handbook}#ports= -using/[Using the Ports Collection] for instructions on how to use this too= l. > +* Use Git if custom patches to the ports tree are needed or if running F= reeBSD-CURRENT. Refer to link:{handbook}mirrors/#git[Using Git] for details. > =20 > [[ports-4x]] > =3D=3D=3D Why can I not build this port on my {rel2-relx} -, or {rel-rel= x} -STABLE machine? >=20 --=20 Mathieu Arnold --7yhf7xrb6e4ufgxj Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEVhwchfRfuV0unqO5KesJApEdfgIFAmB9YA9fFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDU2 MUMxQzg1RjQ1RkI5NUQyRTlFQTNCOTI5RUIwOTAyOTExRDdFMDIACgkQKesJApEd fgKF1hAAlueq3YVPvHxW0ubPgM1OvTl25jnWrZ4w1DdmcqfWsu+h5Ds2NP6FJ0/m 3Mhh7ZGyXxC/R6ZUYHZxCsIqQspT+BhifTfru8TS3YdYGsuBoj++5jcSwnXaX/UV zREZhmEJ6aIGmd/blDLHrsNHwHyiAA5LTClPAclTC9NPX4oR/Xr6fpWMuBhhY5/o 6/wnh81T5KWmTxU31Zu58GQiCwrhytginap9Wo1jRvoUA2qdXNWEnwlxxwemqOSs tKLcqZw+92fD67/QuL1tAS64IuwMP6Qs7r6C41llv9GkPrbZN1w8AajTudkyOesX fW9AeBeVUfBmQgLNuwzP90OW9J3dAJd38Ivi5tn7UCqBtqlIX1fsJkON6gWqbVO1 iVbldFu0E7vDySOCmGYQgC5gSj0JdKgumZkLlwAMcbmlHvmCEAtkzR/0MSLva76F E5P1agVTeD0AP4ZDSOTITX2gFkTdz+BmaPnoTUc4G0uDgajjwpIjfxOP4sLcP6aj 0F/fUSIsxTCdW/iECWNGRWrhTKii27Xj7tSsbBVzxMS2dMHe9dD1xs8b/1kJPf8X xq5lgKfVLp73ffdJCiI9RIKO7evUUfI6mLXeBg5iFhrurmqX/7UkpKqkLTqTMDZN ocybfWaEnxply3Dz+CgU8BYoPuVa6OquLHzf5uZWnqKZd4/QElQ= =paE7 -----END PGP SIGNATURE----- --7yhf7xrb6e4ufgxj-- From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 11:22:36 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id A12945EE219 for ; Mon, 19 Apr 2021 11:22:36 +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 4FP4DD4DhFz3nsr; Mon, 19 Apr 2021 11:22:36 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 844FC1E69B; Mon, 19 Apr 2021 11:22:36 +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 13JBMarb071625; Mon, 19 Apr 2021 11:22:36 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JBMak0071624; Mon, 19 Apr 2021 11:22:36 GMT (envelope-from git) Date: Mon, 19 Apr 2021 11:22:36 GMT Message-Id: <202104191122.13JBMak0071624@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 2fcb42cef3 - main - Handbook: Fix indentation MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2fcb42cef3a3c98371aeb0176e31839ad9d521b5 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 11:22:36 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=2fcb42cef3a3c98371aeb0176e31839ad9d521b5 commit 2fcb42cef3a3c98371aeb0176e31839ad9d521b5 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 10:32:32 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 10:32:32 +0000 Handbook: Fix indentation --- .../content/en/books/handbook/mirrors/_index.adoc | 29 ++++++++++++---------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 9cb16428e7..fe03a36cc0 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -567,13 +567,14 @@ For read-only access, please refer to the users section above. ==== Daily use * Clone the repository: - ++ [source,shell] .... % git clone -o freebsd --config remote.freebsd.fetch='+refs/notes/*:refs/notes/*' https://git.freebsd.org/${repo}.git .... - Then you should have the official mirrors as your remote: - ++ +Then you should have the official mirrors as your remote: ++ [source,shell] .... % git remote -v @@ -582,11 +583,11 @@ freebsd https://git.freebsd.org/${repo}.git (push) .... * Configure the FreeBSD committer data: - - The commit hook in repo.freebsd.org checks the "Commit" field matches the - committer's information in FreeBSD.org. The easiest way to get the suggested - config is by executing `/usr/local/bin/gen-gitconfig.sh` script on freefall: - ++ +The commit hook in repo.freebsd.org checks the "Commit" field matches the +committer's information in FreeBSD.org. The easiest way to get the suggested +config is by executing `/usr/local/bin/gen-gitconfig.sh` script on freefall: ++ [source,shell] .... % gen-gitconfig.sh @@ -596,23 +597,25 @@ freebsd https://git.freebsd.org/${repo}.git (push) .... * Set the push URL: - ++ [source,shell] .... % git remote set-url --push freebsd git@gitrepo.freebsd.org:${repo}.git .... - Then you should have separated fetch and push URLs as the most efficient setup: - ++ +Then you should have separated fetch and push URLs as the most efficient setup: ++ [source,shell] .... % git remote -v freebsd https://git.freebsd.org/${repo}.git (fetch) freebsd git@gitrepo.freebsd.org:${repo}.git (push) .... - Again, note that `gitrepo.freebsd.org` will be canonicalized to `repo.freebsd.org` in the future. ++ +Again, note that `gitrepo.freebsd.org` will be canonicalized to `repo.freebsd.org` in the future. * Install commit message template hook: - ++ [source,shell] .... % fetch https://cgit.freebsd.org/src/plain/tools/tools/git/hooks/prepare-commit-msg -o .git/hooks From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 11:22:37 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C37EB5EE29E for ; Mon, 19 Apr 2021 11:22:37 +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 4FP4DF5Dd2z3nsv; Mon, 19 Apr 2021 11:22:37 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 A6C1D1E573; Mon, 19 Apr 2021 11:22:37 +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 13JBMbCj071646; Mon, 19 Apr 2021 11:22:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JBMbSZ071645; Mon, 19 Apr 2021 11:22:37 GMT (envelope-from git) Date: Mon, 19 Apr 2021 11:22:37 GMT Message-Id: <202104191122.13JBMbSZ071645@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: d626f8222e - main - Avoid content duplication MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: d626f8222eb3964eaadc745c1ea30e488f416b89 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 11:22:37 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=d626f8222eb3964eaadc745c1ea30e488f416b89 commit d626f8222eb3964eaadc745c1ea30e488f416b89 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 11:21:13 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 11:21:13 +0000 Avoid content duplication Point to the table of Git-related URLs. --- documentation/content/en/books/handbook/mirrors/_index.adoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index fe03a36cc0..1cd4db6129 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -450,6 +450,7 @@ The first component of the path is the FreeBSD repository to access. There are three different repositories, `src` for the FreeBSD systerm source code, `doc` for documentation, and `ports` for the FreeBSD Ports Collection. For example, the URL `https://git.FreeBSD.org/src.git` specifies the main branch of the src repository, using the `https` protocol. +[[git-url-table]] .Handy URL Table [options="header,foooter"] |======================================================= @@ -551,8 +552,8 @@ These are also published as SSHFP records in DNS. === Web-based repository browser -The FreeBSD project currently uses cgit as the web-based repository browser: https://cgit.freebsd.org/ -The URL of the indivirual repository is at: https://cgit.freebsd.org/${repo}/ +The FreeBSD project currently uses cgit as the web-based repository browser: https://cgit.freebsd.org/. +The URLs of indivirual repositories are listed crossref:mirrors[git-url-table,here]. === For Users From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 11:27:58 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C52A15EDE78 for ; Mon, 19 Apr 2021 11:27:58 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: from mail-ej1-f46.google.com (mail-ej1-f46.google.com [209.85.218.46]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FP4LQ4xTfz3nrL; Mon, 19 Apr 2021 11:27:58 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: by mail-ej1-f46.google.com with SMTP id w23so36533856ejb.9; Mon, 19 Apr 2021 04:27:58 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:cc:references:from:subject:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=vvQJhjjzqIlWPtbXkFmtRxQQzle2zyVCmfTOjbkNkPw=; b=n0NVVorGqHrBkiBelqHOMLT0RaawecCoyk7nHICWQYNUSOM4GDXnLE0j+mehSrj0Hm r2wtkRyJFXzbczGS87f3Yr+hnMzMP+/TDXNRa3RPqUUh+yVw7S4MGSMTgLfL/sb9PfyT RPCQ8IHmcKYPw7wGEflIJCO6k7FFRh6Be/CMvhuMh4T/asoMFiwd3AlxpXHAHXvvdaK7 PQ+0dTxdJuI9raLUB2RBkfHtadJQxHZ2bKvFFiNVbPrA+xJ5DgebYVvH7nfahK6Zh5bM 8QNlrFqncUo4v5IszlI4j3KsvGovatkVOlKhtuDd/1+yL/fWGPkynkDZXVTLZyS/8Rre FIhQ== X-Gm-Message-State: AOAM5318kb54XoCTne+EF8imJVdTpii4WBM46owedw6o/ze0g88jKYUu Fl/r0fafpCaCWeD6o5cdhujF7XU74rwFKWW/ X-Google-Smtp-Source: ABdhPJxHzl3Ii2ozfO5VNBTohxqHzzVrGK2zzhVDV0jX92S8uFRrSYtcWFGeTUsMTl+qhIURJdDXFg== X-Received: by 2002:a17:907:1b19:: with SMTP id mp25mr21434985ejc.154.1618831677187; Mon, 19 Apr 2021 04:27:57 -0700 (PDT) Received: from [192.168.0.106] ([95.91.212.147]) by smtp.gmail.com with ESMTPSA id l14sm915078edc.0.2021.04.19.04.27.56 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 19 Apr 2021 04:27:56 -0700 (PDT) To: Mathieu Arnold Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org References: <202104191008.13JA8Rng066319@gitrepo.freebsd.org> <20210419104851.ygnf5l74lbby7zf5@aching.in.mat.cc> From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: Re: git: c5f5a82112 - main - FAQ: Update bits about getting a ports tree Message-ID: <2eea18b9-a493-15ce-47e7-897540929c81@FreeBSD.org> Date: Mon, 19 Apr 2021 13:28:08 +0200 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:78.0) Gecko/20100101 Thunderbird/78.9.1 MIME-Version: 1.0 In-Reply-To: <20210419104851.ygnf5l74lbby7zf5@aching.in.mat.cc> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: quoted-printable Content-Language: en-US X-Rspamd-Queue-Id: 4FP4LQ4xTfz3nrL X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 11:27:58 -0000 On 19/04/2021 12:48, Mathieu Arnold wrote: > On Mon, Apr 19, 2021 at 10:08:27AM +0000, Mateusz Piotrowski wrote: >> The branch main has been updated by 0mp: >> >> URL: https://cgit.FreeBSD.org/doc/commit/?id=3Dc5f5a82112f0de78da06ae7= 3c19e4c99d4bb3111 >> >> commit c5f5a82112f0de78da06ae73c19e4c99d4bb3111 >> Author: Mateusz Piotrowski <0mp@FreeBSD.org> >> AuthorDate: 2021-04-19 10:00:11 +0000 >> Commit: Mateusz Piotrowski <0mp@FreeBSD.org> >> CommitDate: 2021-04-19 10:00:11 +0000 >> >> FAQ: Update bits about getting a ports tree >> =20 >> - Link to the portsnap manual >> - Replace Subversion with Git > Might want to provide other means to get the ports tree than portsnap, > it is not really supported any more, say, gitup for example. Good point overall but isn't portsnap being brought back at the moment? Also, ideally, we'd just rewrite that FAQ entry to just point to appropri= ate handbook chapters. > >> --- >> documentation/content/en/books/faq/_index.adoc | 6 +++--- >> 1 file changed, 3 insertions(+), 3 deletions(-) >> >> diff --git a/documentation/content/en/books/faq/_index.adoc b/document= ation/content/en/books/faq/_index.adoc >> index d7e05aa380..c5829704e8 100644 >> --- a/documentation/content/en/books/faq/_index.adoc >> +++ b/documentation/content/en/books/faq/_index.adoc >> @@ -837,12 +837,12 @@ Most ports should work on all supported versions=20 of FreeBSD. Those that do not a >> FreeBSD supports compressed binary packages to easily install and un= install ports. Use man:pkg[7] to control the installation of packages. >> =20 >> [[how-do-download-ports-tree]] >> -=3D=3D=3D How do I download the Ports tree? Should I be using Subvers= ion? >> +=3D=3D=3D How do I download the Ports tree? Should I be using Git? >> =20 >> Any of the methods listed here work: >> =20 >> -* Use portsnap for most use cases. Refer to link:{handbook}#ports-usi= ng/[Using the Ports Collection] for instructions on how to use this tool.= >> -* Use Subversion if custom patches to the ports tree are needed or if=20 running FreeBSD-CURRENT. Refer to link:{handbook}#svn/[Using Subversion] = for details. >> +* Use man:portsnap[8] for most use cases. Refer to link:{handbook}#po= rts-using/[Using the Ports Collection] for instructions on how to use thi= s tool. >> +* Use Git if custom patches to the ports tree are needed or if runnin= g FreeBSD-CURRENT. Refer to link:{handbook}mirrors/#git[Using Git] for de= tails. >> =20 >> [[ports-4x]] >> =3D=3D=3D Why can I not build this port on my {rel2-relx} -, or {rel= -relx} -STABLE machine? >> From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 11:40:24 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 34E5F5EE369 for ; Mon, 19 Apr 2021 11:40:24 +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 4FP4cm0ycGz3p3j; Mon, 19 Apr 2021 11:40:24 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 13D5D1E824; Mon, 19 Apr 2021 11:40:24 +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 13JBeNI5093883; Mon, 19 Apr 2021 11:40:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JBeNcW093881; Mon, 19 Apr 2021 11:40:23 GMT (envelope-from git) Date: Mon, 19 Apr 2021 11:40:23 GMT Message-Id: <202104191140.13JBeNcW093881@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 37b3bccd17 - main - Document installation of SSL certificates only once MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 37b3bccd17125c6ecb75eab8e75f364dd677a459 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 11:40:24 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=37b3bccd17125c6ecb75eab8e75f364dd677a459 commit 37b3bccd17125c6ecb75eab8e75f364dd677a459 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 11:39:47 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 11:39:47 +0000 Document installation of SSL certificates only once Just point the Subversion chapter to the Git one. --- .../content/en/books/handbook/mirrors/_index.adoc | 19 +++---------------- 1 file changed, 3 insertions(+), 16 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 1cd4db6129..18dfa49db6 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -397,7 +397,7 @@ Additional information on the use of Git is included. [[git-ssl-certificates]] === Root SSL Certificates -Older FreeBSD systems do not have proper root certificates. +FreeBSD systems older than 12._x_ do not have proper root certificates. Installing package:security/ca_root_nss[] on these systems allows Git to verify the identity of HTTPS repository servers. The root SSL certificates can be installed from a port: @@ -727,21 +727,8 @@ This section demonstrates how to install Subversion on a FreeBSD system and use === Root SSL Certificates FreeBSD systems older than 12._x_ do not have proper root certificates. -Installing package:security/ca_root_nss[] on these systems allows Subversion to verify the identity of HTTPS repository servers. -The root SSL certificates can be installed from a port: - -[source,shell] -.... -# cd /usr/ports/security/ca_root_nss -# make install clean -.... - -or as a package: - -[source,shell] -.... -# pkg install ca_root_nss -.... +Those certificates allow Subversion to verify the identity of HTTPS repository server. +Installation instructions are described in crossref:mirrors[git-ssl-certificates,“Root SSL Certificates”]. [[svn-svnlite]] === Svnlite From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 11:44:49 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 498A75EE78C for ; Mon, 19 Apr 2021 11:44:49 +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 4FP4js1YlSz3png; Mon, 19 Apr 2021 11:44:49 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 242BA1E9AF; Mon, 19 Apr 2021 11:44:49 +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 13JBinbY098242; Mon, 19 Apr 2021 11:44:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JBinlY098241; Mon, 19 Apr 2021 11:44:49 GMT (envelope-from git) Date: Mon, 19 Apr 2021 11:44:49 GMT Message-Id: <202104191144.13JBinlY098241@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: a08c310936 - main - Add a cross-reference to External Mirrors MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a08c3109367dba4c9e2b11777847cf60ac35cd9b Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 11:44:49 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=a08c3109367dba4c9e2b11777847cf60ac35cd9b commit a08c3109367dba4c9e2b11777847cf60ac35cd9b Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 11:44:41 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 11:44:41 +0000 Add a cross-reference to External Mirrors --- documentation/content/en/books/handbook/mirrors/_index.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 18dfa49db6..45a060c427 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -524,7 +524,7 @@ To update [.filename]#/usr/src# created in the example above, use: The update is much quicker than a checkout, only transferring files that have changed. -There are also external mirrors maintained by project members available, please refer to the "External mirrors" section. +There are also external mirrors maintained by project members available, please refer to the crossref:mirrors[external-mirrors,External mirrors] section. === SSH related information @@ -665,6 +665,7 @@ These internal details may change often. ==== +[[external-mirrors]] === External mirrors Those mirrors are not hosted in FreeBSD.org but still maintained by the project members. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 12:00:18 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 85C3F5EF0A6 for ; Mon, 19 Apr 2021 12:00:18 +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 4FP53k28Tyz3qJJ; Mon, 19 Apr 2021 12:00:18 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 2B5BA1EB99; Mon, 19 Apr 2021 12:00:18 +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 13JC0IaB019277; Mon, 19 Apr 2021 12:00:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JC0IKO019268; Mon, 19 Apr 2021 12:00:18 GMT (envelope-from git) Date: Mon, 19 Apr 2021 12:00:18 GMT Message-Id: <202104191200.13JC0IKO019268@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 6269a3efb8 - main - Do not mention Git mirrors in the Subversion chapter MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6269a3efb8cf90e094e02ac6300c2f54358c7926 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 12:00:18 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=6269a3efb8cf90e094e02ac6300c2f54358c7926 commit 6269a3efb8cf90e094e02ac6300c2f54358c7926 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 11:58:48 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 11:58:48 +0000 Do not mention Git mirrors in the Subversion chapter The Git mirrors, sites and URLs are already described in the Git chapter. Also, chase the removal of the git-mirrors anchor. Point to the "Using Git" chapter instead. --- .../content/en/books/handbook/cutting-edge/_index.adoc | 2 +- documentation/content/en/books/handbook/mirrors/_index.adoc | 13 ------------- 2 files changed, 1 insertion(+), 14 deletions(-) diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc index f33f03d35f..3cd371ee7c 100644 --- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc @@ -554,7 +554,7 @@ The {dev-commits-src-main} list records the commit log entry for each change as + To join these lists, go to {mailman-lists}, click on the list to subscribe to, and follow the instructions. In order to track changes to the whole source tree, not just the changes to FreeBSD-CURRENT, subscribe to the {dev-commits-src-all}. -. Synchronize with the FreeBSD-CURRENT sources. Typically, `git` is used to check out the -CURRENT code from the `main` branch of one of the Git mirror sites listed in crossref:mirrors[git-mirrors,“Git Mirror Sites”]. +. Synchronize with the FreeBSD-CURRENT sources. Typically, `git` is used to check out the -CURRENT code from the `main` branch of the FreeBSD Git repository (see crossref:mirrors[git,“Using Git”] for details). . Due to the size of the repository, some users choose to only synchronize the sections of source that interest them or which they are contributing patches to. However, users that plan to compile the operating system from source must download _all_ of FreeBSD-CURRENT, not just selected portions. + Before compiling FreeBSD-CURRENT, read [.filename]#/usr/src/Makefile# very carefully and follow the instructions in <>. diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 45a060c427..48ac64ec14 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -817,19 +817,6 @@ An alternate way of updating the local working copy after checkout is provided b # make update SVN_UPDATE=yes .... -[[git-mirrors]] -=== Git Mirror Sites - -The FreeBSD Git repository is: - -[.programlisting] -.... -https://git.freebsd.org/ -.... - -This is a publicly accessible mirror network that uses GeoDNS to select an appropriate back end server. -To view the FreeBSD Subversion repositories through a browser, use https://cgit.freebsd.org[https://cgit.freebsd.org]. - [[svn-mirrors]] === Subversion Mirror Sites From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 12:19:04 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id E0A615F019C for ; Mon, 19 Apr 2021 12:19:04 +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 4FP5TN64RBz3rch; Mon, 19 Apr 2021 12:19:04 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 B8D041F280; Mon, 19 Apr 2021 12:19:04 +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 13JCJ4cA038889; Mon, 19 Apr 2021 12:19:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JCJ4Ef038888; Mon, 19 Apr 2021 12:19:04 GMT (envelope-from git) Date: Mon, 19 Apr 2021 12:19:04 GMT Message-Id: <202104191219.13JCJ4Ef038888@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 1db65ba06d - main - Fix formatting MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1db65ba06d3d53bf73d218d238cc72bb87a65ac7 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 12:19:04 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=1db65ba06d3d53bf73d218d238cc72bb87a65ac7 commit 1db65ba06d3d53bf73d218d238cc72bb87a65ac7 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 12:18:54 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 12:18:54 +0000 Fix formatting --- .../content/en/books/handbook/mirrors/_index.adoc | 39 +++++++++++----------- 1 file changed, 20 insertions(+), 19 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 48ac64ec14..5fec90a40c 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -528,25 +528,26 @@ There are also external mirrors maintained by project members available, please === SSH related information - - `ssh://${user}@${url}/${repo}.git` can be written as `${user}@${url}:${repo}.git`, i.e., following two URLs are both valid for passing to git: - - `ssh://anongit@git.freebsd.org/${repo}.git` - - `anongit@git.freebsd.org:${repo}.git` - - As well as the read-write repo: - - `ssh://git@(git)repo.freebsd.org/${repo}.git` - - `git@(git)repo.freebsd.org:${repo}.git` - -- gitrepo.FreeBSD.org host key fingerprints: - - - ECDSA key fingerprint is `SHA256:seWO5D27ySURcx4bknTNKlC1mgai0whP443PAKEvvZA` - - ED25519 key fingerprint is `SHA256:lNR6i4BEOaaUhmDHBA1WJsO7H3KtvjE2r5q4sOxtIWo` - - RSA key fingerprint is `SHA256:f453CUEFXEJAXlKeEHV+ajJfeEfx9MdKQUD7lIscnQI` - -- git.FreeBSD.org host key fingerprints: - - - ECDSA key fingerprint is `SHA256:/UlirUAsGiitupxmtsn7f9b7zCWd0vCs4Yo/tpVWP9w` - - ED25519 key fingerprint is `SHA256:y1ljKrKMD3lDObRUG3xJ9gXwEIuqnh306tSyFd1tuZE` - - RSA key fingerprint is `SHA256:jBe6FQGoH4HjvrIVM23dcnLZk9kmpdezR/CvQzm7rJM` +* `ssh://${user}@${url}/${repo}.git` can be written as `${user}@${url}:${repo}.git`, i.e., following two URLs are both valid for passing to `git`: +-- +** `ssh://anongit@git.freebsd.org/${repo}.git` +** `anongit@git.freebsd.org:${repo}.git` + +As well as the read-write repo: + +** `ssh://git@(git)repo.freebsd.org/${repo}.git` +** `git@(git)repo.freebsd.org:${repo}.git` +-- + +* gitrepo.FreeBSD.org host key fingerprints: +** ECDSA key fingerprint is `SHA256:seWO5D27ySURcx4bknTNKlC1mgai0whP443PAKEvvZA` +** ED25519 key fingerprint is `SHA256:lNR6i4BEOaaUhmDHBA1WJsO7H3KtvjE2r5q4sOxtIWo` +** RSA key fingerprint is `SHA256:f453CUEFXEJAXlKeEHV+ajJfeEfx9MdKQUD7lIscnQI` + +* git.FreeBSD.org host key fingerprints: +** ECDSA key fingerprint is `SHA256:/UlirUAsGiitupxmtsn7f9b7zCWd0vCs4Yo/tpVWP9w` +** ED25519 key fingerprint is `SHA256:y1ljKrKMD3lDObRUG3xJ9gXwEIuqnh306tSyFd1tuZE` +** RSA key fingerprint is `SHA256:jBe6FQGoH4HjvrIVM23dcnLZk9kmpdezR/CvQzm7rJM` These are also published as SSHFP records in DNS. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 12:24:02 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C98045F0889 for ; Mon, 19 Apr 2021 12:24:02 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FP5b65KBtz3rfp; Mon, 19 Apr 2021 12:24:02 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from mail.j.mat.cc (owncloud.cube.mat.cc [IPv6:2a01:678:4:1::228]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mail.mat.cc", Issuer "R3" (verified OK)) (Authenticated sender: mat/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 8DD41580; Mon, 19 Apr 2021 12:24:02 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from aching.in.mat.cc (unknown [IPv6:2a01:678:ab:0:3356:ef6b:256f:d0c6]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: mat@mat.cc) by mail.j.mat.cc (Postfix) with ESMTPSA id 69D09942D80; Mon, 19 Apr 2021 12:24:01 +0000 (UTC) Date: Mon, 19 Apr 2021 14:24:00 +0200 From: Mathieu Arnold To: Mateusz Piotrowski <0mp@freebsd.org> Cc: Mathieu Arnold , doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Subject: Re: git: c5f5a82112 - main - FAQ: Update bits about getting a ports tree Message-ID: <20210419122400.u7h6xzypr243e62m@aching.in.mat.cc> References: <202104191008.13JA8Rng066319@gitrepo.freebsd.org> <20210419104851.ygnf5l74lbby7zf5@aching.in.mat.cc> <2eea18b9-a493-15ce-47e7-897540929c81@FreeBSD.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="bcxtxvnbweemwj2r" Content-Disposition: inline In-Reply-To: <2eea18b9-a493-15ce-47e7-897540929c81@FreeBSD.org> X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 12:24:02 -0000 --bcxtxvnbweemwj2r Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Apr 19, 2021 at 01:28:08PM +0200, Mateusz Piotrowski wrote: > On 19/04/2021 12:48, Mathieu Arnold wrote: > > On Mon, Apr 19, 2021 at 10:08:27AM +0000, Mateusz Piotrowski wrote: > > > The branch main has been updated by 0mp: > > >=20 > > > URL: https://cgit.FreeBSD.org/doc/commit/?id=3Dc5f5a82112f0de78da06ae= 73c19e4c99d4bb3111 > > >=20 > > > commit c5f5a82112f0de78da06ae73c19e4c99d4bb3111 > > > Author: Mateusz Piotrowski <0mp@FreeBSD.org> > > > AuthorDate: 2021-04-19 10:00:11 +0000 > > > Commit: Mateusz Piotrowski <0mp@FreeBSD.org> > > > CommitDate: 2021-04-19 10:00:11 +0000 > > >=20 > > > FAQ: Update bits about getting a ports tree > > > - Link to the portsnap manual > > > - Replace Subversion with Git > > Might want to provide other means to get the ports tree than portsnap, > > it is not really supported any more, say, gitup for example. >=20 > Good point overall but isn't portsnap being brought back at the moment? Mmmm, this is a separate issue, portsnap may work, it is just not a supported way to get the ports tree. > Also, ideally, we'd just rewrite that FAQ entry to just point to appropri= ate handbook chapters. Probably, yes. --=20 Mathieu Arnold --bcxtxvnbweemwj2r Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEVhwchfRfuV0unqO5KesJApEdfgIFAmB9dltfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDU2 MUMxQzg1RjQ1RkI5NUQyRTlFQTNCOTI5RUIwOTAyOTExRDdFMDIACgkQKesJApEd fgIRjg//bll4b6GjUCEjYTU8rr6q52YKz6qTOQ0haJOrFN0hjAnI8ukWdQu38JJE wP9XFWNRlqOYapO5+9Idt58/LlGbLVxHH0PYfGFYsfMAtLuBSAtM6lL25Jwgje6m O51EXZasxqookNXasr1cZyaVSbcX21hP5sycU1GX3jYBM2GxLP8w8ycinqo323Wx bI8J7WWrxngGVH0hWUodxAIewisC4uS8Ng/4URv0g4hsk8+wrOYDJCb0PtlKAcPJ vupjlPpC11r5Zjbym2lXLiR3hZI868z9Nk92Hf7OZrMAUy7LoOLKJTr93C/uHRxm fQQjS88WBk7qgSxvLxOPc6V4MbjElVIiodi7B8b7eXdNlAqAzTk9yUP+BlufTuJ1 HHeww+m2Xfjh75hLkAZVJSqksuCwInVAYI2d9KmfjuQ7sx246eZ59vjLWVlCXOtt PjhFV3LBElBiXou+16RzESmggHQ8REwsImEPPMwinW1T3KFHmImVEQHqy+BoJ5nm K0RLS8oJaEATbo6nRhYqBlQebxRBgq1Buir8NcC95f4d4Pbml+fbENB+KP/1pxpq h8GMIfb+xl9hemwhYVAW75odl063aiiAFkp3laCYyVaxpd9WFj+6zcnzqAc4FMiv JwV9PpiQUsLaVEm4LOuNe1vf3F5AlBazBRd32tuBVvShRLDqofo= =P2md -----END PGP SIGNATURE----- --bcxtxvnbweemwj2r-- From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 12:37:29 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 1B8535F0C83 for ; Mon, 19 Apr 2021 12:37:29 +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 4FP5td0HKLz3sYV; Mon, 19 Apr 2021 12:37:29 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 ECBD01F623; Mon, 19 Apr 2021 12:37:28 +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 13JCbSMQ064846; Mon, 19 Apr 2021 12:37:28 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JCbSqI064845; Mon, 19 Apr 2021 12:37:28 GMT (envelope-from git) Date: Mon, 19 Apr 2021 12:37:28 GMT Message-Id: <202104191237.13JCbSqI064845@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 17e44b67f5 - main - Fix formatting MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 17e44b67f50e12428d1f9d6942a92a70f1148fe6 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 12:37:29 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=17e44b67f50e12428d1f9d6942a92a70f1148fe6 commit 17e44b67f50e12428d1f9d6942a92a70f1148fe6 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 12:36:50 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 12:36:50 +0000 Fix formatting Otherwise, rsync://ftp13.FreeBSD.org/ is included in the "Available collections" list of rsync://ftp-master.FreeBSD.org/. --- documentation/content/en/books/handbook/mirrors/_index.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 5fec90a40c..6d1aaafa1d 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -895,9 +895,11 @@ rsync://ftp-master.FreeBSD.org/ This server may only be used by FreeBSD primary mirror sites. + Available collections: - ++ +-- ** FreeBSD: The master archive of the FreeBSD FTP server. ** acl: The FreeBSD master ACL list. +-- + rsync://ftp13.FreeBSD.org/ + From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 15:23:23 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id A75E55F5B57 for ; Mon, 19 Apr 2021 15:23:23 +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 4FP9Z34F7nz4XYj; Mon, 19 Apr 2021 15:23:23 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 8487D21678; Mon, 19 Apr 2021 15:23:23 +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 13JFNNTN091143; Mon, 19 Apr 2021 15:23:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JFNNdi091142; Mon, 19 Apr 2021 15:23:23 GMT (envelope-from git) Date: Mon, 19 Apr 2021 15:23:23 GMT Message-Id: <202104191523.13JFNNdi091142@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: c64ae252b4 - main - Handbook: Remove an unused anchor MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c64ae252b4ff95c79bc7403b38801b53664ccd4b Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 15:23:23 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=c64ae252b4ff95c79bc7403b38801b53664ccd4b commit c64ae252b4ff95c79bc7403b38801b53664ccd4b Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 15:06:58 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 15:22:35 +0000 Handbook: Remove an unused anchor It's name does not make any sense anymore as there is no ports skeleton discussed in that section. --- documentation/content/en/books/handbook/ports/_index.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index 8130484319..c880d1e3b5 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -681,7 +681,6 @@ Some ports include [.filename]#pkg-message# or other files to handle special sit The port does not include the actual source code, also known as a [.filename]#distfile#. The extract portion of building a port will automatically save the downloaded source to [.filename]#/usr/ports/distfiles#. -[[ports-skeleton]] === Installing Ports This section provides basic instructions on using the Ports Collection to install or remove software. The detailed description of available `make` targets and environment variables is available in man:ports[7]. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 15:23:24 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id D2B6C5F5D67 for ; Mon, 19 Apr 2021 15:23:24 +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 4FP9Z45bGpz4Xfh; Mon, 19 Apr 2021 15:23:24 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 AAEF3218B6; Mon, 19 Apr 2021 15:23:24 +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 13JFNOtG091171; Mon, 19 Apr 2021 15:23:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JFNOBS091170; Mon, 19 Apr 2021 15:23:24 GMT (envelope-from git) Date: Mon, 19 Apr 2021 15:23:24 GMT Message-Id: <202104191523.13JFNOBS091170@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: c8171ff858 - main - Handbook: Move Ports Collection installation to a new section MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c8171ff8588d3eaa5b8ff105c9ada23fea8d3c12 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 15:23:24 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=c8171ff8588d3eaa5b8ff105c9ada23fea8d3c12 commit c8171ff8588d3eaa5b8ff105c9ada23fea8d3c12 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 15:08:03 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 15:23:30 +0000 Handbook: Move Ports Collection installation to a new section This way we can cross-reference it from other places in the documentation. --- .../content/en/books/handbook/ports/_index.adoc | 26 ++++++++++++---------- 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index c880d1e3b5..68d2d09676 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -579,6 +579,20 @@ pkg, by default, tracks quarterly branch-releases of the ports tree and not HEAD If the Ports Collection and pkg must be used in conjunction, then be sure that your Ports Collection and pkg are on the same branch release of the ports tree. ==== +The Ports Collection contains directories for software categories. Inside each category are subdirectories for individual applications. Each application subdirectory contains a set of files that tells FreeBSD how to compile and install that program, called a _ports skeleton_. Each port skeleton includes these files and directories: + +* [.filename]#Makefile#: contains statements that specify how the application should be compiled and where its components should be installed. +* [.filename]#distinfo#: contains the names and checksums of the files that must be downloaded to build the port. +* [.filename]#files/#: this directory contains any patches needed for the program to compile and install on FreeBSD. This directory may also contain other files used to build the port. +* [.filename]#pkg-descr#: provides a more detailed description of the program. +* [.filename]#pkg-plist#: a list of all the files that will be installed by the port. It also tells the ports system which files to remove upon deinstallation. + +Some ports include [.filename]#pkg-message# or other files to handle special situations. For more details on these files, and on ports in general, refer to the link:{porters-handbook}[FreeBSD Porter's Handbook]. + +The port does not include the actual source code, also known as a [.filename]#distfile#. The extract portion of building a port will automatically save the downloaded source to [.filename]#/usr/ports/distfiles#. + +=== Installing the Ports Collection + Before an application can be compiled using a port, the Ports Collection must first be installed. If it was not installed during the installation of FreeBSD, use one of the following methods to install it: [[ports-using-portsnap-method]] @@ -669,18 +683,6 @@ If the ports tree is not available, or pkg is being used to manage packages, Git .... **** -The Ports Collection contains directories for software categories. Inside each category are subdirectories for individual applications. Each application subdirectory contains a set of files that tells FreeBSD how to compile and install that program, called a _ports skeleton_. Each port skeleton includes these files and directories: - -* [.filename]#Makefile#: contains statements that specify how the application should be compiled and where its components should be installed. -* [.filename]#distinfo#: contains the names and checksums of the files that must be downloaded to build the port. -* [.filename]#files/#: this directory contains any patches needed for the program to compile and install on FreeBSD. This directory may also contain other files used to build the port. -* [.filename]#pkg-descr#: provides a more detailed description of the program. -* [.filename]#pkg-plist#: a list of all the files that will be installed by the port. It also tells the ports system which files to remove upon deinstallation. - -Some ports include [.filename]#pkg-message# or other files to handle special situations. For more details on these files, and on ports in general, refer to the link:{porters-handbook}[FreeBSD Porter's Handbook]. - -The port does not include the actual source code, also known as a [.filename]#distfile#. The extract portion of building a port will automatically save the downloaded source to [.filename]#/usr/ports/distfiles#. - === Installing Ports This section provides basic instructions on using the Ports Collection to install or remove software. The detailed description of available `make` targets and environment variables is available in man:ports[7]. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 15:23:25 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id E81C75F5DAD for ; Mon, 19 Apr 2021 15:23:25 +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 4FP9Z56Hgjz4XYm; Mon, 19 Apr 2021 15:23:25 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 CAD0C21679; Mon, 19 Apr 2021 15:23:25 +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 13JFNPsB091196; Mon, 19 Apr 2021 15:23:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JFNPoX091195; Mon, 19 Apr 2021 15:23:25 GMT (envelope-from git) Date: Mon, 19 Apr 2021 15:23:25 GMT Message-Id: <202104191523.13JFNPoX091195@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 5dddbce327 - main - FAQ: Do not explain how to get ports twice MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5dddbce32755648605f510517d66181af6bbb4d0 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 15:23:26 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=5dddbce32755648605f510517d66181af6bbb4d0 commit 5dddbce32755648605f510517d66181af6bbb4d0 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-19 15:15:59 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-19 15:23:30 +0000 FAQ: Do not explain how to get ports twice Instead, point users to the appropriate chapter in the handbook. I've named the anchor "ports-using-installation-methods" for consistency with the existing ones. There is no need to break existing bookmarks. At least for now. --- documentation/content/en/books/faq/_index.adoc | 5 +---- documentation/content/en/books/handbook/ports/_index.adoc | 1 + 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index c5829704e8..5db269a12b 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -839,10 +839,7 @@ FreeBSD supports compressed binary packages to easily install and uninstall port [[how-do-download-ports-tree]] === How do I download the Ports tree? Should I be using Git? -Any of the methods listed here work: - -* Use man:portsnap[8] for most use cases. Refer to link:{handbook}#ports-using/[Using the Ports Collection] for instructions on how to use this tool. -* Use Git if custom patches to the ports tree are needed or if running FreeBSD-CURRENT. Refer to link:{handbook}mirrors/#git[Using Git] for details. +See crossref:handbook[ports-using-installation-methods,Installing the Ports Collection]. [[ports-4x]] === Why can I not build this port on my {rel2-relx} -, or {rel-relx} -STABLE machine? diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc index 68d2d09676..cd49ab7eb9 100644 --- a/documentation/content/en/books/handbook/ports/_index.adoc +++ b/documentation/content/en/books/handbook/ports/_index.adoc @@ -591,6 +591,7 @@ Some ports include [.filename]#pkg-message# or other files to handle special sit The port does not include the actual source code, also known as a [.filename]#distfile#. The extract portion of building a port will automatically save the downloaded source to [.filename]#/usr/ports/distfiles#. +[[ports-using-installation-methods]] === Installing the Ports Collection Before an application can be compiled using a port, the Ports Collection must first be installed. If it was not installed during the installation of FreeBSD, use one of the following methods to install it: From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 16:39:37 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 623F45F7DD0 for ; Mon, 19 Apr 2021 16:39:37 +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 4FPCG12Q0Nz4bVd; Mon, 19 Apr 2021 16:39:37 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 45BE722812; Mon, 19 Apr 2021 16:39:37 +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 13JGdb5u085505; Mon, 19 Apr 2021 16:39:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JGdb62085504; Mon, 19 Apr 2021 16:39:37 GMT (envelope-from git) Date: Mon, 19 Apr 2021 16:39:37 GMT Message-Id: <202104191639.13JGdb62085504@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Li-Wen Hsu Subject: git: 62224e2759 - main - Correct the "Contributing to FreeBSD" link 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: 62224e275953339bba0a2dfc0473bd60dbea4f04 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 16:39:37 -0000 The branch main has been updated by lwhsu (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=62224e275953339bba0a2dfc0473bd60dbea4f04 commit 62224e275953339bba0a2dfc0473bd60dbea4f04 Author: Li-Wen Hsu AuthorDate: 2021-04-19 16:38:50 +0000 Commit: Li-Wen Hsu CommitDate: 2021-04-19 16:38:50 +0000 Correct the "Contributing to FreeBSD" link Reported by: Deb Goodkin Approved by: carlavilla (implicitly) Sponsored by: The FreeBSD Foundation --- website/content/en/projects/newbies.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/projects/newbies.adoc b/website/content/en/projects/newbies.adoc index 28d7a053c2..47f3fae726 100644 --- a/website/content/en/projects/newbies.adoc +++ b/website/content/en/projects/newbies.adoc @@ -41,4 +41,4 @@ Friends who run FreeBSD are a great resource. No book can replace chatting on th link:../../usergroups/[User groups] are good places to meet other FreeBSD users. If there is no one nearby, you might consider starting one! -For more information on getting involved in the community, see the link:{committers-guide}[Contributing to FreeBSD] article. +For more information on getting involved in the community, see the link:{contributing}[Contributing to FreeBSD] article. From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 18:09:10 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C7E555F9DCE for ; Mon, 19 Apr 2021 18:09:10 +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 4FPFFL5JM1z4gdc; Mon, 19 Apr 2021 18:09:10 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 A947E23B62; Mon, 19 Apr 2021 18:09:10 +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 13JI9Aqu006865; Mon, 19 Apr 2021 18:09:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JI9Axu006864; Mon, 19 Apr 2021 18:09:10 GMT (envelope-from git) Date: Mon, 19 Apr 2021 18:09:10 GMT Message-Id: <202104191809.13JI9Axu006864@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Li-Wen Hsu Subject: git: f4353eecab - main - Put a workaround to add a missing full stop 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: f4353eecab740032fcf800127b9f1d33140e00cc Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 18:09:10 -0000 The branch main has been updated by lwhsu (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=f4353eecab740032fcf800127b9f1d33140e00cc commit f4353eecab740032fcf800127b9f1d33140e00cc Author: Li-Wen Hsu AuthorDate: 2021-04-19 18:05:33 +0000 Commit: Li-Wen Hsu CommitDate: 2021-04-19 18:05:33 +0000 Put a workaround to add a missing full stop Approved by: carlavilla (implicitly) --- website/themes/beastie/layouts/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/themes/beastie/layouts/index.html b/website/themes/beastie/layouts/index.html index a9a12d6124..f45e760b3a 100755 --- a/website/themes/beastie/layouts/index.html +++ b/website/themes/beastie/layouts/index.html @@ -8,7 +8,7 @@

{{ i18n "freebsdProject" }}

{{ i18n "freebsdDescription1" }} - {{ i18n "freebsdDescription2" }} + {{ i18n "freebsdDescription2" }}. {{ i18n "freebsdDescription3" }} {{ i18n "freebsdDescription4" }} {{ i18n "freebsdDescription5" }} From owner-dev-commits-doc-all@freebsd.org Mon Apr 19 19:54:33 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 78E955FDC18 for ; Mon, 19 Apr 2021 19:54:33 +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 4FPHZx33zBz4nx4; Mon, 19 Apr 2021 19:54:33 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 5C04025517; Mon, 19 Apr 2021 19:54:33 +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 13JJsXQD053420; Mon, 19 Apr 2021 19:54:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13JJsXEL053419; Mon, 19 Apr 2021 19:54:33 GMT (envelope-from git) Date: Mon, 19 Apr 2021 19:54:33 GMT Message-Id: <202104191954.13JJsXEL053419@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mark Johnston Subject: git: 6f71dc766b - main - Clarify that the vendor merge commits should have proper commit messages MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: markj X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6f71dc766bc62271cdd74a5ef53fcb641bf4be9c Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 19:54:33 -0000 The branch main has been updated by markj (src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=6f71dc766bc62271cdd74a5ef53fcb641bf4be9c commit 6f71dc766bc62271cdd74a5ef53fcb641bf4be9c Author: Mark Johnston AuthorDate: 2021-04-13 13:41:03 +0000 Commit: Mark Johnston CommitDate: 2021-04-19 19:54:02 +0000 Clarify that the vendor merge commits should have proper commit messages Reviewed by: imp Differential Revision: https://reviews.freebsd.org/D29745 --- documentation/content/en/articles/committers-guide/_index.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 062399a010..23c1da10e9 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -1215,6 +1215,7 @@ The sources live in `contrib/mtree` since it is upstream software. This would generate a subtree merge commit of `contrib/mtree` against the local `vendor/NetBSD/mtree` branch. If there were conflicts, you would need to fix them before committing. +Include details about the changes being merged in the merge commit message. ==== Rebasing your change against latest FreeBSD source tree From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 04:22:51 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 0BA565E33CD for ; Tue, 20 Apr 2021 04:22:51 +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 4FPVsQ6wTBz3kdk; Tue, 20 Apr 2021 04:22:50 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 D591A3DCC; Tue, 20 Apr 2021 04:22:50 +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 13K4MoH4028633; Tue, 20 Apr 2021 04:22:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13K4MoST028632; Tue, 20 Apr 2021 04:22:50 GMT (envelope-from git) Date: Tue, 20 Apr 2021 04:22:50 GMT Message-Id: <202104200422.13K4MoST028632@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Li-Wen Hsu Subject: git: 6d2a97cf80 - main - Fix path: s, /usr/local/shared, /usr/local/share, 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: 6d2a97cf80b050c40723952aff9b3abe3c7db8a8 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 04:22:51 -0000 The branch main has been updated by lwhsu (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=6d2a97cf80b050c40723952aff9b3abe3c7db8a8 commit 6d2a97cf80b050c40723952aff9b3abe3c7db8a8 Author: Li-Wen Hsu AuthorDate: 2021-04-20 04:21:23 +0000 Commit: Li-Wen Hsu CommitDate: 2021-04-20 04:21:23 +0000 Fix path: s,/usr/local/shared,/usr/local/share, PR: 255101 Reported by: Christos Margiolis Approved by: carlavilla (implicitly) --- .../content/en/articles/fonts/_index.adoc | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/documentation/content/en/articles/fonts/_index.adoc b/documentation/content/en/articles/fonts/_index.adoc index 586622ef38..498371dfcb 100644 --- a/documentation/content/en/articles/fonts/_index.adoc +++ b/documentation/content/en/articles/fonts/_index.adoc @@ -144,8 +144,8 @@ For example: [source,shell] .... Create a directory to contain the font files -% mkdir -p /usr/local/shared/fonts/type1 -% cd /usr/local/shared/fonts/type1 +% mkdir -p /usr/local/share/fonts/type1 +% cd /usr/local/share/fonts/type1 Place the .pfa, .pfb and .afm files here @@ -262,7 +262,7 @@ So, to complete our example: .... Make the font accessible to X11 % cd /usr/X11R6/lib/X11/fonts/Type1 -% ln -s /usr/local/shared/fonts/type1/showboat.pfb . +% ln -s /usr/local/share/fonts/type1/showboat.pfb . Edit fonts.dir and fonts.scale, adding the line describing the font and incrementing the number of fonts which is found on the first line. @@ -300,11 +300,11 @@ Using the font from the previous example, here is how to use it with Ghostscript [source,shell] .... Put the font in Ghostscript's font directory -% cd /usr/local/shared/ghostscript/fonts -% ln -s /usr/local/shared/fonts/type1/showboat.pfb . +% cd /usr/local/share/ghostscript/fonts +% ln -s /usr/local/share/fonts/type1/showboat.pfb . Edit Fontmap so Ghostscript knows about the font -% cd /usr/local/shared/ghostscript/4.01 +% cd /usr/local/share/ghostscript/4.01 % ex Fontmap :$a /Showboat (showboat.pfb) ; % From CICA /fonts/atm/showboat @@ -317,10 +317,10 @@ Aladdin Ghostscript 4.01 (1996-7-10) Copyright (C) 1996 Aladdin Enterprises, Menlo Park, CA. All rights reserved. This software comes with NO WARRANTY: see the file PUBLIC for details. -Loading Times-Roman font from /usr/local/shared/ghostscript/fonts/tir_____.pfb... +Loading Times-Roman font from /usr/local/share/ghostscript/fonts/tir_____.pfb... /1899520 581354 1300084 13826 0 done. GS>Showboat DoFont -Loading Showboat font from /usr/local/shared/ghostscript/fonts/showboat.pfb... +Loading Showboat font from /usr/local/share/ghostscript/fonts/showboat.pfb... 1939688 565415 1300084 16901 0 done. >>showpage, press to continue<< >>showpage, press to continue<< @@ -361,7 +361,7 @@ Continuing with our example: Many .afm files are in Mac format... ^M delimited lines We need to convert them to UNIX(R) style ^J delimited lines % cd /tmp -% cat /usr/local/shared/fonts/type1/showboat.afm | +% cat /usr/local/share/fonts/type1/showboat.afm | tr '\015' '\012' >showboat.afm Now create the groff font file @@ -381,7 +381,7 @@ This can easily be determined from the groff font file as illustrated: [source,shell] .... Create the .pfa font file -% pfbtops /usr/local/shared/fonts/type1/showboat.pfb >showboat.pfa +% pfbtops /usr/local/share/fonts/type1/showboat.pfb >showboat.pfa .... Of course, if [.filename]#.pfa# is already available, just use a symbolic link to reference it. @@ -465,7 +465,7 @@ The funny upper/lower case is due to their being intended also for DOS shells. [.filename]#ttf2pf.ps# makes use of the others as upper case, so any renaming must be consistent with this. (Actually, [.filename]#GS_TTF.PS# and [.filename]#PFS2AFM.PS# are supposedly part of the Ghostscript distribution, but it is just as easy to use these as an isolated utility. FreeBSD does not seem to include the latter.) -You also may want to have these installed to [.filename]#/usr/local/shared/groff_font/devps#(?). +You also may want to have these installed to [.filename]#/usr/local/share/groff_font/devps#(?). `afmtodit`:: Creates font files for use with groff from ascii font metrics file. From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 09:47:19 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 8E0C25EE459 for ; Tue, 20 Apr 2021 09:47:19 +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 4FPf3q3fCBz4WqZ; Tue, 20 Apr 2021 09:47:19 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 701AE10C02; Tue, 20 Apr 2021 09:47:19 +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 13K9lJd9051989; Tue, 20 Apr 2021 09:47:19 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13K9lJrX051988; Tue, 20 Apr 2021 09:47:19 GMT (envelope-from git) Date: Tue, 20 Apr 2021 09:47:19 GMT Message-Id: <202104200947.13K9lJrX051988@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: be6e85b4a2 - main - [porters-handbook]: Clarify prefixes in patch file names MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: be6e85b4a2a66e6bd5a0b0cd5c9e6d24ff5247fc Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 09:47:19 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=be6e85b4a2a66e6bd5a0b0cd5c9e6d24ff5247fc commit be6e85b4a2a66e6bd5a0b0cd5c9e6d24ff5247fc Author: Fernando Apesteguía AuthorDate: 2021-04-18 17:22:23 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-20 09:42:36 +0000 [porters-handbook]: Clarify prefixes in patch file names Patches must start with `patch-` in order to be applied automatically. Conditional patches must not start with `patch-`. PR: 24903 Reported by: pauamma@gundo.com Approved by: 0mp (mentor) Differential Revision: https://reviews.freebsd.org/D28268 --- .../content/en/books/porters-handbook/slow-porting/_index.adoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc b/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc index f40a105bac..4146408768 100644 --- a/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc +++ b/documentation/content/en/books/porters-handbook/slow-porting/_index.adoc @@ -132,6 +132,7 @@ Manual patch creation is usually not necessary. Automatic patch generation as de ==== Patches are saved into files named [.filename]#patch-*# where * indicates the pathname of the file that is patched, such as [.filename]#patch-Imakefile# or [.filename]#patch-src-config.h#. +Patches with file names which do not start with [.filename]#patch-# will not be applied automatically. After the file has been modified, man:diff[1] is used to record the differences between the original and the modified version. `-u` causes man:diff[1] to produce "unified" diffs, the preferred form. @@ -208,6 +209,9 @@ DOS2UNIX_WRKSRC= ${WRKDIR} === Patching Conditionally Some ports need patches that are only applied for specific FreeBSD versions or when a particular option is enabled or disabled. Conditional patches are specified by placing the full paths to the patch files in `EXTRA_PATCHES`. +Conditional patch file names usually start with [.filename]#extra-# although this is not necessary. +However, their file names _must not_ start with [.filename]#patch-#. +If they do, they are applied unconditionally by the framework which is undesired for conditional patches. [[slow-patch-extra-ex1]] .Applying a Patch for a Specific FreeBSD Version From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 09:58:39 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 0AD305EEACE for ; Tue, 20 Apr 2021 09:58:39 +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 4FPfJt6ygZz4XSr; Tue, 20 Apr 2021 09:58:38 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 E1B1610ABE; Tue, 20 Apr 2021 09:58:38 +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 13K9wc4E065141; Tue, 20 Apr 2021 09:58:38 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13K9wcU9065140; Tue, 20 Apr 2021 09:58:38 GMT (envelope-from git) Date: Tue, 20 Apr 2021 09:58:38 GMT Message-Id: <202104200958.13K9wcU9065140@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 32abed26b2 - main - articles/committers-guide: Update "MFC with" description MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 32abed26b27c0da4e469703b87b9ad34084d4d2a Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 09:58:39 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=32abed26b27c0da4e469703b87b9ad34084d4d2a commit 32abed26b27c0da4e469703b87b9ad34084d4d2a Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-20 09:57:44 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 09:58:39 +0000 articles/committers-guide: Update "MFC with" description We use Git hashes now, not revision numbers. --- documentation/content/en/articles/committers-guide/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 23c1da10e9..3dbc468fda 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2582,7 +2582,7 @@ Approved by: re (username) |If the commit should be merged to a subset of stable branches, specify the branch names. |`MFC with:` -|If the commit should be merged together with a previous one in a single MFC commit (for example, where this commit corrects a bug in the previous change), specify the corresponding revision number. +|If the commit should be merged together with a previous one in a single MFC commit (for example, where this commit corrects a bug in the previous change), specify the corresponding Git hash. |`MFH:` |A ports quarterly branch name, to request approval for merge. From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 10:32:23 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 97CFB5EFDB9 for ; Tue, 20 Apr 2021 10:32:23 +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 4FPg3q3yCkz4YyB; Tue, 20 Apr 2021 10:32:23 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 7ABED11342; Tue, 20 Apr 2021 10:32:23 +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 13KAWNaQ016259; Tue, 20 Apr 2021 10:32:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KAWNFn016258; Tue, 20 Apr 2021 10:32:23 GMT (envelope-from git) Date: Tue, 20 Apr 2021 10:32:23 GMT Message-Id: <202104201032.13KAWNFn016258@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: ceee1def00 - main - articles/committers-guide: Document change in MFH policy MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 10:32:23 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 commit ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-20 10:14:58 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 10:14:58 +0000 articles/committers-guide: Document change in MFH policy Merging commits into the quarterly branch no longer requires an explicit approval [1]. Let's remove outdated documentation and leave a note explaining that there is no need for an explicit approval to MFH. [1] https://svnweb.freebsd.org/ports?view=revision&revision=556626 --- .../en/articles/committers-guide/_index.adoc | 60 +--------------------- 1 file changed, 1 insertion(+), 59 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 3dbc468fda..f0548fbce5 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2584,9 +2584,6 @@ Approved by: re (username) |`MFC with:` |If the commit should be merged together with a previous one in a single MFC commit (for example, where this commit corrects a bug in the previous change), specify the corresponding Git hash. -|`MFH:` -|A ports quarterly branch name, to request approval for merge. - |`Relnotes:` |If the change is a candidate for inclusion in the release notes for the next release from the branch, set to `yes`. @@ -3450,62 +3447,7 @@ For more information on how to merge commits to the quarterly branch, see <>. -==== - -[[ports-qa-blanket]] -==== Are there any changes that can be merged without asking for approval? - -The following blanket approvals for merging to the quarterly branches are in effect: - -[NOTE] -==== -This blanket approval also applies to direct commits for ports that have been removed from `head`. -==== - -[IMPORTANT] -==== -These fixes must be tested on the quarterly branch. -==== - -* Fixes that do not result in a change in contents of the resulting package. For example: -** [.filename]#pkg-descr#: `WWW`: URL updates (existing 404, moved or incorrect) -Build, runtime or packaging fixes, if the quarterly branch version is currently broken. -Missing dependencies (detected, linked against but not registered via `*_DEPENDS`). -* Fixing link:{porters-handbook}#uses-shebangfix[shebangs], stripping installed libraries and binaries, and plist fixes. -* Backport of security and reliability fixes which only result in `PORTREVISION` bumps and no changes to enabled features. for example, adding a patch fixing a buffer overflow. -* Minor version changes that do nothing but fix security or crash-related issues. -* Adding/fixing `CONFLICTS`. -* Web Browsers, browser plugins, and their required dependencies. - -[IMPORTANT] -==== -Commits that are not covered by these blanket approvals always require explicit approval of either {ports-secteam} or {portmgr}. -==== +As of November 30, 2020, there is no need to seek explicit approval to commit to the quarterly branch. [[ports-qa-misc-commit-mfh]] ==== What is the procedure for merging commits to the quarterly branch? From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 10:58:14 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 1AE885F03E5 for ; Tue, 20 Apr 2021 10:58:14 +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 4FPgdf0HcYz4Zg5; Tue, 20 Apr 2021 10:58:14 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 F0E091156D; Tue, 20 Apr 2021 10:58:13 +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 13KAwDk6045874; Tue, 20 Apr 2021 10:58:13 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KAwDdZ045873; Tue, 20 Apr 2021 10:58:13 GMT (envelope-from git) Date: Tue, 20 Apr 2021 10:58:13 GMT Message-Id: <202104201058.13KAwDdZ045873@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: bb4bdb25db - main - content/en: Use <

> for linking within a document MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bb4bdb25db841acd73da3ce543c964afe49f7f63 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 10:58:14 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=bb4bdb25db841acd73da3ce543c964afe49f7f63 commit bb4bdb25db841acd73da3ce543c964afe49f7f63 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-20 10:49:32 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 10:49:32 +0000 content/en: Use <
> for linking within a document I've used the following script to locate all the cases where crossref was used to link to a section within the same document: grep -R crossref: | while read -r case; do file=${case%%:*} dir=${file%/*} dir_name=${dir##*/} line=${case##*:} target_document=${line%%[*} if [ "$dir_name" = "$target_document" ]; then echo "$case" fi done --- documentation/content/en/books/handbook/mirrors/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 6d1aaafa1d..940df19568 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -524,7 +524,7 @@ To update [.filename]#/usr/src# created in the example above, use: The update is much quicker than a checkout, only transferring files that have changed. -There are also external mirrors maintained by project members available, please refer to the crossref:mirrors[external-mirrors,External mirrors] section. +There are also external mirrors maintained by project members available, please refer to the <> section. === SSH related information @@ -554,7 +554,7 @@ These are also published as SSHFP records in DNS. === Web-based repository browser The FreeBSD project currently uses cgit as the web-based repository browser: https://cgit.freebsd.org/. -The URLs of indivirual repositories are listed crossref:mirrors[git-url-table,here]. +The URLs of indivirual repositories are listed in <>. === For Users @@ -730,7 +730,7 @@ This section demonstrates how to install Subversion on a FreeBSD system and use FreeBSD systems older than 12._x_ do not have proper root certificates. Those certificates allow Subversion to verify the identity of HTTPS repository server. -Installation instructions are described in crossref:mirrors[git-ssl-certificates,“Root SSL Certificates”]. +Installation instructions are described in <>. [[svn-svnlite]] === Svnlite From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 11:01:40 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 6C9E05F0A8C for ; Tue, 20 Apr 2021 11:01:40 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FPgjc2chkz4b40; Tue, 20 Apr 2021 11:01:40 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-ej1-f50.google.com (mail-ej1-f50.google.com [209.85.218.50]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) (Authenticated sender: carlavilla) by smtp.freebsd.org (Postfix) with ESMTPSA id 49722ACCE; Tue, 20 Apr 2021 11:01:40 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-ej1-f50.google.com with SMTP id sd23so48972151ejb.12; Tue, 20 Apr 2021 04:01:40 -0700 (PDT) X-Gm-Message-State: AOAM530DejkE/QdxgWMKIPn0oZXMBbyTEVi7RfppHnXjM5+7ZDiTShXj KzUn1a2O1muQ/9J51KvI56FZBfRDNhDc5KyIMCI= X-Google-Smtp-Source: ABdhPJyxYSj6AcFflz4HlGxMiAgH4IVUS5kicQhO9zFuOyZZv8hCpKqt1saKdHyW6wH/b1DVB4UuC5YN06hVbKc60Jo= X-Received: by 2002:a17:906:9392:: with SMTP id l18mr26571480ejx.222.1618916499133; Tue, 20 Apr 2021 04:01:39 -0700 (PDT) MIME-Version: 1.0 References: <202104201058.13KAwDdZ045873@gitrepo.freebsd.org> In-Reply-To: <202104201058.13KAwDdZ045873@gitrepo.freebsd.org> From: Sergio Carlavilla Date: Tue, 20 Apr 2021 13:01:28 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: git: bb4bdb25db - main - content/en: Use <
> for linking within a document To: Mateusz Piotrowski <0mp@freebsd.org> Cc: dev-commits-doc-all@freebsd.org, doc-committers@freebsd.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.34 X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 11:01:40 -0000 On Tue, 20 Apr 2021 at 12:58, Mateusz Piotrowski <0mp@freebsd.org> wrote: > The branch main has been updated by 0mp: > > URL: > https://cgit.FreeBSD.org/doc/commit/?id=3Dbb4bdb25db841acd73da3ce543c964a= fe49f7f63 > > commit bb4bdb25db841acd73da3ce543c964afe49f7f63 > Author: Mateusz Piotrowski <0mp@FreeBSD.org> > AuthorDate: 2021-04-20 10:49:32 +0000 > Commit: Mateusz Piotrowski <0mp@FreeBSD.org> > CommitDate: 2021-04-20 10:49:32 +0000 > > content/en: Use <
> for linking within a document > > I've used the following script to locate all the cases where crossref > was used to link to a section within the same document: > > grep -R crossref: | while read -r case; do > file=3D${case%%:*} > dir=3D${file%/*} > dir_name=3D${dir##*/} > line=3D${case##*:} > target_document=3D${line%%[*} > if [ "$dir_name" =3D "$target_document" ]; then > echo "$case" > fi > done > --- > documentation/content/en/books/handbook/mirrors/_index.adoc | 6 +++--- > 1 file changed, 3 insertions(+), 3 deletions(-) > > diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc > b/documentation/content/en/books/handbook/mirrors/_index.adoc > index 6d1aaafa1d..940df19568 100644 > --- a/documentation/content/en/books/handbook/mirrors/_index.adoc > +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc > @@ -524,7 +524,7 @@ To update [.filename]#/usr/src# created in the exampl= e > above, use: > > The update is much quicker than a checkout, only transferring files that > have changed. > > -There are also external mirrors maintained by project members available, > please refer to the crossref:mirrors[external-mirrors,External mirrors] > section. > +There are also external mirrors maintained by project members available, > please refer to the <> section. > > =3D=3D=3D SSH related information > > @@ -554,7 +554,7 @@ These are also published as SSHFP records in DNS. > =3D=3D=3D Web-based repository browser > > The FreeBSD project currently uses cgit as the web-based repository > browser: https://cgit.freebsd.org/. > -The URLs of indivirual repositories are > listed crossref:mirrors[git-url-table,here]. > +The URLs of indivirual repositories are listed in <>. > > =3D=3D=3D For Users > > @@ -730,7 +730,7 @@ This section demonstrates how to install Subversion o= n > a FreeBSD system and use > > FreeBSD systems older than 12._x_ do not have proper root certificates. > Those certificates allow Subversion to verify the identity of HTTPS > repository server. > -Installation instructions are described in > crossref:mirrors[git-ssl-certificates,=E2=80=9CRoot SSL Certificates=E2= =80=9D]. > +Installation instructions are described in <>. > > [[svn-svnlite]] > =3D=3D=3D Svnlite > Hi, Nice script! Thanks! From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 11:24:00 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 1573B5F1896 for ; Tue, 20 Apr 2021 11:24:00 +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 4FPhCN09b8z4cFK; Tue, 20 Apr 2021 11:24:00 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 ED32F1208F; Tue, 20 Apr 2021 11:23:59 +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 13KBNxve086720; Tue, 20 Apr 2021 11:23:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KBNx4K086719; Tue, 20 Apr 2021 11:23:59 GMT (envelope-from git) Date: Tue, 20 Apr 2021 11:23:59 GMT Message-Id: <202104201123.13KBNx4K086719@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 7f37df0e34 - main - handbook/mirrors: Fix a typo MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7f37df0e3482e54c77addcde7873cefa68f61ad6 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 11:24:00 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=7f37df0e3482e54c77addcde7873cefa68f61ad6 commit 7f37df0e3482e54c77addcde7873cefa68f61ad6 Author: Pau Amma AuthorDate: 2021-04-20 11:21:58 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 11:23:32 +0000 handbook/mirrors: Fix a typo --- documentation/content/en/books/handbook/mirrors/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 940df19568..4c0374a0a7 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -729,7 +729,7 @@ This section demonstrates how to install Subversion on a FreeBSD system and use === Root SSL Certificates FreeBSD systems older than 12._x_ do not have proper root certificates. -Those certificates allow Subversion to verify the identity of HTTPS repository server. +Those certificates allow Subversion to verify the identity of HTTPS repository servers. Installation instructions are described in <>. [[svn-svnlite]] From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 12:28:53 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C0EB65F471E for ; Tue, 20 Apr 2021 12:28:53 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FPjfF550Lz4grr; Tue, 20 Apr 2021 12:28:53 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from mail.j.mat.cc (owncloud.cube.mat.cc [IPv6:2a01:678:4:1::228]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mail.mat.cc", Issuer "R3" (verified OK)) (Authenticated sender: mat/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 667ABBE80; Tue, 20 Apr 2021 12:28:53 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from aching.in.mat.cc (unknown [IPv6:2a01:678:ab:0:3356:ef6b:256f:d0c6]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: mat@mat.cc) by mail.j.mat.cc (Postfix) with ESMTPSA id 4720B942D80; Tue, 20 Apr 2021 12:28:50 +0000 (UTC) Date: Tue, 20 Apr 2021 14:28:49 +0200 From: Mathieu Arnold To: Mateusz Piotrowski <0mp@freebsd.org> Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Subject: Re: git: ceee1def00 - main - articles/committers-guide: Document change in MFH policy Message-ID: <20210420122849.rh5v2kohzvkxs4uu@aching.in.mat.cc> References: <202104201032.13KAWNFn016258@gitrepo.freebsd.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="z2mucrzakid4554m" Content-Disposition: inline In-Reply-To: <202104201032.13KAWNFn016258@gitrepo.freebsd.org> X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 12:28:53 -0000 --z2mucrzakid4554m Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Apr 20, 2021 at 10:32:23AM +0000, Mateusz Piotrowski wrote: > The branch main has been updated by 0mp: >=20 > URL: https://cgit.FreeBSD.org/doc/commit/?id=3Dceee1def00ac69f06b9d86b2fb= 1ff04bb6c84d48 >=20 > commit ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 > Author: Mateusz Piotrowski <0mp@FreeBSD.org> > AuthorDate: 2021-04-20 10:14:58 +0000 > Commit: Mateusz Piotrowski <0mp@FreeBSD.org> > CommitDate: 2021-04-20 10:14:58 +0000 >=20 > articles/committers-guide: Document change in MFH policy > =20 > Merging commits into the quarterly branch no longer requires an expli= cit > approval [1]. Let's remove outdated documentation and leave a note > explaining that there is no need for an explicit approval to MFH. Note that the MFH line should still be used to note intent. > [1] https://svnweb.freebsd.org/ports?view=3Drevision&revision=3D5566= 26 > --- > .../en/articles/committers-guide/_index.adoc | 60 +---------------= ------ > 1 file changed, 1 insertion(+), 59 deletions(-) >=20 > diff --git a/documentation/content/en/articles/committers-guide/_index.ad= oc b/documentation/content/en/articles/committers-guide/_index.adoc > index 3dbc468fda..f0548fbce5 100644 > --- a/documentation/content/en/articles/committers-guide/_index.adoc > +++ b/documentation/content/en/articles/committers-guide/_index.adoc > @@ -2584,9 +2584,6 @@ Approved by: re (username) > |`MFC with:` > |If the commit should be merged together with a previous one in a single= MFC commit (for example, where this commit corrects a bug in the previous = change), specify the corresponding Git hash. > =20 > -|`MFH:` > -|A ports quarterly branch name, to request approval for merge. > - > |`Relnotes:` > |If the change is a candidate for inclusion in the release notes for the= next release from the branch, set to `yes`. > =20 > @@ -3450,62 +3447,7 @@ For more information on how to merge commits to th= e quarterly branch, see < [[ports-qa-misc-request-mfh]] > =3D=3D=3D=3D What is the procedure to request authorization for merging = a commit to the quarterly branch? > =20 > -When doing the commit, add the branch name to the `MFH:` line, for examp= le: > - > -[.programlisting] > -.... > -MFH: 2014Q1 > -.... > - > -It will automatically notify the {ports-secteam} and the {portmgr}. > -They will then decide if the commit can be merged and answer with the pr= ocedure. > - > -If the commit has already been made, send an email to the {ports-secteam= } and the {portmgr} with the revision number and a small description of why= the commit needs to be merged. > - > -[TIP] > -=3D=3D=3D=3D > -If the MFH is covered by a blanket approval, please explain why with a c= ouple of words on the `MFH` line, so that the reviewing team can skip this = commit and save time. > - > -For example: > - > -[.programlisting] > -.... > -MFH: 2014Q1 (runtime fix) > -MFH: 2014Q1 (browser blanket) > -.... > - > -The list of blanket approvals is available in <>. > -=3D=3D=3D=3D > - > -[[ports-qa-blanket]] > -=3D=3D=3D=3D Are there any changes that can be merged without asking for= approval? > - > -The following blanket approvals for merging to the quarterly branches ar= e in effect: > - > -[NOTE] > -=3D=3D=3D=3D > -This blanket approval also applies to direct commits for ports that have= been removed from `head`. > -=3D=3D=3D=3D > - > -[IMPORTANT] > -=3D=3D=3D=3D > -These fixes must be tested on the quarterly branch. > -=3D=3D=3D=3D > - > -* Fixes that do not result in a change in contents of the resulting pack= age. For example: > -** [.filename]#pkg-descr#: `WWW`: URL updates (existing 404, moved or in= correct) > -Build, runtime or packaging fixes, if the quarterly branch version is cu= rrently broken. > -Missing dependencies (detected, linked against but not registered via `*= _DEPENDS`). > -* Fixing link:{porters-handbook}#uses-shebangfix[shebangs], stripping in= stalled libraries and binaries, and plist fixes. > -* Backport of security and reliability fixes which only result in `PORTR= EVISION` bumps and no changes to enabled features. for example, adding a pa= tch fixing a buffer overflow. > -* Minor version changes that do nothing but fix security or crash-relate= d issues. > -* Adding/fixing `CONFLICTS`. > -* Web Browsers, browser plugins, and their required dependencies. > - > -[IMPORTANT] > -=3D=3D=3D=3D > -Commits that are not covered by these blanket approvals always require e= xplicit approval of either {ports-secteam} or {portmgr}. > -=3D=3D=3D=3D > +As of November 30, 2020, there is no need to seek explicit approval to c= ommit to the quarterly branch. > =20 > [[ports-qa-misc-commit-mfh]] > =3D=3D=3D=3D What is the procedure for merging commits to the quarterly = branch? >=20 --=20 Mathieu Arnold --z2mucrzakid4554m Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEVhwchfRfuV0unqO5KesJApEdfgIFAmB+yPxfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDU2 MUMxQzg1RjQ1RkI5NUQyRTlFQTNCOTI5RUIwOTAyOTExRDdFMDIACgkQKesJApEd fgLwShAAnVC0eR5wk+GAWm4LzlomiAlMfFlQjxDur6/il+xWhCL08lEHwPIs6Vwr vPoOteRE3x8i6ODeg4t9okOu3aEe9339ArdKlKihB8u/P9KtWjvVlzqdCAa5mvuL jLrUhkRmnyLNZ+auBo1DxHzxQL10mkZ2slLX7b3xK/DVH8Xe8g5IcOePNPsNQIFY teFArnNQi+wP56rSennaoFtO4ZABatT2x2bFs2FJY0nkZ/w4ySNrMr3CRPfbbUCw pt+dNDmpTSo4pcMw/Poq+Ph9mgVyidopRC33bw9Wr5UyL2+j/pgfrJP9g5Oy1lzE Xyj2B4EYo7T8QLuHBohDyXezLomQWMooK8ObdS9LCZbiOPLNaM61Y3dbkAVdELw5 r7gJM8I25AOOi+Gwurmm+BJxjbIr5miVUIaXA99Q0HIiDTbXOBvYrEsoiVyFnwUI qWwA/0HSN0udTmdB7+y/+l4UhndbsLl+7s722X/5WYIOXoEnFfzEBh8jvV6avYz7 Ih7ES+cpl+TAMN/JsbQUOqz4ixpWg30r04UyUxMgLpVi/PPYV4FW9NPryyGwZmqP 6WTOtiuqaaw8cAcm9WAwt6HJ+vfUSgQZXMW+4ZmLNwmaTF6as4zBf/GNizeYGFJf wIXKxUafVKaOnEfRxldaT7ohY2JBoxoIAq2N7iVr76xFcDNYkVo= =TDCH -----END PGP SIGNATURE----- --z2mucrzakid4554m-- From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 12:39:35 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 96D315F4B65 for ; Tue, 20 Apr 2021 12:39:35 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: from mail-ed1-f47.google.com (mail-ed1-f47.google.com [209.85.208.47]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FPjtb3jGWz4hCr; Tue, 20 Apr 2021 12:39:35 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: by mail-ed1-f47.google.com with SMTP id h8so4722496edb.2; Tue, 20 Apr 2021 05:39:35 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=HGyN2J8D44sVWKnvGNlf8W1COrxc4itRkAeM5YZlBMY=; b=L0JS+b8XBlJBWKUKA3eLh5+1ofc8KIYXzvTvKmfTneS4pH0RYH2r1/2s8bdIugM+sY +cIpmmyYbsMi4UMGLGbhvDVaKl7AVT3fP22puEJokj2etkjg6acaCRLX2RcrnUUp7yKC I66uqrjQB5QUau43Zd4wOZqKvvPI1z3Ur8nUFbldbrRywEk/qG6FF2uv4A0PANfBD8sj 8rp9/mwxlMCaq72rwBFWXd2hSxGMDj4swCO6SiejCwzQzt/oWZX9LX8qAsvgMs0yJdOC puSD6A9ETLn6ifd493v7bLg5aAgI2DfU20oERqozcYzh6FgnGaM31cLGQ20ceefFmD08 n6lA== X-Gm-Message-State: AOAM532VzsguCo/65iNMlerFMDNSSRDcxeQ62sAfHlnyBMekYDCz5V4i wouykGo/HEwKJtm9dcbAQOtqZBjD9i0sNQ4p X-Google-Smtp-Source: ABdhPJyDq3WDWOWo1JOXzVHcequXIywnUsrcXt3ciOabjIakrGSYRJ436GwIZPYLexD2EsC6Yhpveg== X-Received: by 2002:a05:6402:706:: with SMTP id w6mr24950724edx.15.1618922374209; Tue, 20 Apr 2021 05:39:34 -0700 (PDT) Received: from [192.168.0.106] (ip5f5bd493.dynamic.kabel-deutschland.de. [95.91.212.147]) by smtp.gmail.com with ESMTPSA id hc43sm12970165ejc.97.2021.04.20.05.39.32 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 20 Apr 2021 05:39:33 -0700 (PDT) Subject: Re: git: ceee1def00 - main - articles/committers-guide: Document change in MFH policy To: Mathieu Arnold Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org References: <202104201032.13KAWNFn016258@gitrepo.freebsd.org> <20210420122849.rh5v2kohzvkxs4uu@aching.in.mat.cc> From: Mateusz Piotrowski <0mp@FreeBSD.org> Message-ID: <3252cd06-4140-0bc2-e958-983b4a2453c2@FreeBSD.org> Date: Tue, 20 Apr 2021 14:39:44 +0200 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:78.0) Gecko/20100101 Thunderbird/78.9.1 MIME-Version: 1.0 In-Reply-To: <20210420122849.rh5v2kohzvkxs4uu@aching.in.mat.cc> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit Content-Language: en-US X-Rspamd-Queue-Id: 4FPjtb3jGWz4hCr X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 12:39:35 -0000 On 20/04/2021 14:28, Mathieu Arnold wrote: > On Tue, Apr 20, 2021 at 10:32:23AM +0000, Mateusz Piotrowski wrote: >> The branch main has been updated by 0mp: >> >> URL: https://cgit.FreeBSD.org/doc/commit/?id=ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 >> >> commit ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 >> Author: Mateusz Piotrowski <0mp@FreeBSD.org> >> AuthorDate: 2021-04-20 10:14:58 +0000 >> Commit: Mateusz Piotrowski <0mp@FreeBSD.org> >> CommitDate: 2021-04-20 10:14:58 +0000 >> >> articles/committers-guide: Document change in MFH policy >> >> Merging commits into the quarterly branch no longer requires an explicit >> approval [1]. Let's remove outdated documentation and leave a note >> explaining that there is no need for an explicit approval to MFH. > Note that the MFH line should still be used to note intent. Hmm, true. It does make sense to leave MFH in the table of metadata fields for this use case. I'll bring back the MFH entry with an updated definition. From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 12:45:14 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 48AF25F49E6 for ; Tue, 20 Apr 2021 12:45:14 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: from mail-ej1-f46.google.com (mail-ej1-f46.google.com [209.85.218.46]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FPk152xLgz4hXh; Tue, 20 Apr 2021 12:45:13 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: by mail-ej1-f46.google.com with SMTP id r20so8297099ejo.11; Tue, 20 Apr 2021 05:45:13 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:from:to:cc:references:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=PHCsRSNRO1Hob/Wrv0593ucrA6dmBr/+LLZBN/K0kQw=; b=DLJ0XnF4ZYWWCW8v8bxQjqtyEau0G44rtvj3+ynUpCdylM+RUCPB/dSH2UJMR7zLYa 1i8cVq8dIfZ/gHpKYCapecgMWSI457O+hMLHpbDdi/tW5uWO7VD8VSXOY4PXhowrDYHt OfIkKXuJh0CcTOdvnr5E4EZ/RyWaFThrpDZiN73RAQtCo2nZmp0o91JF64BPnZkRDVt0 XavLJiifYA4JeT8aDtV4SsCr+K2srZWlH7IDQ1tnw7AEAZZyhXmBrvKcP30DhxrWkvKK yNdnV3IhETSyJzSktbmctAuN74+/ldzb3IDzSL8MqCj1yLTtNXNojGxoGsDgn3bJMI5o CqKA== X-Gm-Message-State: AOAM533+0hde76Wg1m232cx+hfkPhU4Zs4EamWYXe+Js9ET6PeaRNuRG fVZ1ItVCbRbJsz/5gIle/U0pL3KZctzxSlNq X-Google-Smtp-Source: ABdhPJwvlvTM0azg0H/KGcRNOEwK/dc4JX/kYmBfN8dQO0Cn9rLVpVNzoQw8cEUID4KcdJEU/0/vQA== X-Received: by 2002:a17:906:3949:: with SMTP id g9mr27721336eje.7.1618922711914; Tue, 20 Apr 2021 05:45:11 -0700 (PDT) Received: from [192.168.0.106] (ip5f5bd493.dynamic.kabel-deutschland.de. [95.91.212.147]) by smtp.gmail.com with ESMTPSA id w13sm15471350edx.80.2021.04.20.05.45.10 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 20 Apr 2021 05:45:11 -0700 (PDT) Subject: Re: git: ceee1def00 - main - articles/committers-guide: Document change in MFH policy From: Mateusz Piotrowski <0mp@FreeBSD.org> To: Mathieu Arnold Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org References: <202104201032.13KAWNFn016258@gitrepo.freebsd.org> <20210420122849.rh5v2kohzvkxs4uu@aching.in.mat.cc> <3252cd06-4140-0bc2-e958-983b4a2453c2@FreeBSD.org> Message-ID: <09538c5b-ae14-633b-4104-7973d7f8bb2c@FreeBSD.org> Date: Tue, 20 Apr 2021 14:45:22 +0200 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:78.0) Gecko/20100101 Thunderbird/78.9.1 MIME-Version: 1.0 In-Reply-To: <3252cd06-4140-0bc2-e958-983b4a2453c2@FreeBSD.org> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 8bit Content-Language: en-US X-Rspamd-Queue-Id: 4FPk152xLgz4hXh X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=pass (mx1.freebsd.org: domain of mpp302@gmail.com designates 209.85.218.46 as permitted sender) smtp.mailfrom=mpp302@gmail.com X-Spamd-Result: default: False [-2.53 / 15.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; TO_DN_SOME(0.00)[]; R_SPF_ALLOW(-0.20)[+ip4:209.85.128.0/17:c]; RWL_MAILSPIKE_GOOD(0.00)[209.85.218.46:from]; RCVD_COUNT_THREE(0.00)[3]; NEURAL_HAM_SHORT(-0.53)[-0.529]; FORGED_SENDER(0.30)[0mp@FreeBSD.org,mpp302@gmail.com]; RECEIVED_SPAMHAUS_PBL(0.00)[95.91.212.147:received]; MIME_TRACE(0.00)[0:+]; RBL_DBL_DONT_QUERY_IPS(0.00)[209.85.218.46:from]; FREEMAIL_ENVFROM(0.00)[gmail.com]; ASN(0.00)[asn:15169, ipnet:209.85.128.0/17, country:US]; MID_RHS_MATCH_FROM(0.00)[]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; FROM_NEQ_ENVFROM(0.00)[0mp@FreeBSD.org,mpp302@gmail.com]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; TO_MATCH_ENVRCPT_ALL(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[FreeBSD.org]; SPAMHAUS_ZRD(0.00)[209.85.218.46:from:127.0.2.255]; R_DKIM_NA(0.00)[]; RCVD_IN_DNSWL_NONE(0.00)[209.85.218.46:from]; RCVD_TLS_ALL(0.00)[]; MAILMAN_DEST(0.00)[dev-commits-doc-all] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 12:45:14 -0000 On 20/04/2021 14:39, Mateusz Piotrowski wrote: > On 20/04/2021 14:28, Mathieu Arnold wrote: >> On Tue, Apr 20, 2021 at 10:32:23AM +0000, Mateusz Piotrowski wrote: >>> The branch main has been updated by 0mp: >>> >>> URL: https://cgit.FreeBSD.org/doc/commit/?id=ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 >>> >>> commit ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 >>> Author: Mateusz Piotrowski <0mp@FreeBSD.org> >>> AuthorDate: 2021-04-20 10:14:58 +0000 >>> Commit: Mateusz Piotrowski <0mp@FreeBSD.org> >>> CommitDate: 2021-04-20 10:14:58 +0000 >>> >>> articles/committers-guide: Document change in MFH policy >>> Merging commits into the quarterly branch no longer requires an explicit >>> approval [1]. Let's remove outdated documentation and leave a note >>> explaining that there is no need for an explicit approval to MFH. >> Note that the MFH line should still be used to note intent. > Hmm, true. It does make sense to leave MFH in the table of metadata fields for this use case. I'll > bring back the MFH entry with an updated definition. https://reviews.freebsd.org/D29862 From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 12:50:36 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 5D6E45F510E for ; Tue, 20 Apr 2021 12:50:36 +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 4FPk7J1zy6z4hkX; Tue, 20 Apr 2021 12:50:36 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 2BD8712CE7; Tue, 20 Apr 2021 12:50:36 +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 13KCoatO001129; Tue, 20 Apr 2021 12:50:36 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KCoaig001128; Tue, 20 Apr 2021 12:50:36 GMT (envelope-from git) Date: Tue, 20 Apr 2021 12:50:36 GMT Message-Id: <202104201250.13KCoaig001128@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 9848bbc7ac - main - 989d921f5d -> 2a617095b1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ryusuke X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9848bbc7acdc267da9e13a8274f4d160aaf2e958 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 12:50:36 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=9848bbc7acdc267da9e13a8274f4d160aaf2e958 commit 9848bbc7acdc267da9e13a8274f4d160aaf2e958 Author: Ryusuke SUZUKI AuthorDate: 2021-04-20 12:50:12 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-20 12:50:12 +0000 989d921f5d -> 2a617095b1 --- .../ja/books/handbook/cutting-edge/_index.adoc | 528 ++++++++++++--------- 1 file changed, 296 insertions(+), 232 deletions(-) diff --git a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc index d6e844f24c..5e8fc1a762 100644 --- a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc @@ -48,13 +48,17 @@ toc::[] [[updating-upgrading-synopsis]] == この章では -あるリリースから次のリリースまでの期間にも、 FreeBSD の開発は休みなく続けられています。 最新の開発ツリーと同期することを好む人がいれば、 公式のリリース版を好んで使う方もいるでしょう。 しかしながら、公式のリリースといえども、 セキュリティや他の重要な修正のため、時にはアップデートを行う必要があります。 使用しているバージョンに関わらず、FreeBSD は手元のシステムを最新の開発ツリーと同期するために必要なツールをすべて用意しているので、 これらのツールを使ってバージョンのアップグレードを簡単に行うことができます。 この章では、開発ブランチを追いかける方法、および、FreeBSD システムをアップデートする基本的なツールについて解説します。 +あるリリースから次のリリースまでの期間にも、 FreeBSD の開発は休みなく続けられています。 +最新の開発ツリーと同期することを好む人がいる一方で、公式のリリース版を好んで使う方もいます。 +しかしながら、公式のリリースといえども、 セキュリティや他の重要な修正のため、時にはアップデートが行われます。 +使用しているバージョンに関わらず、FreeBSD は手元のシステムを最新の開発ツリーと同期するために必要なツールをすべて用意しているので、これらのツールを使ってバージョンのアップグレードを簡単に行うことができます。 +この章では、開発ブランチを追いかける方法、および、FreeBSD システムをアップデートする基本的なツールについて解説します。 この章を読んで分かるのは: -* freebsd-update もしくは Subversion を使った FreeBSD システムの更新方法 +* freebsd-update もしくは Git を使った FreeBSD システムの更新方法 * インストールされているシステムと、変更が行われていない状態との比較方法。 -* Subversion またはドキュメント用の ports を使って、 インストールされているドキュメントを最新版にアップデートする方法。 +* Git またはドキュメント用の ports を使って、 インストールされているドキュメントを最新版にアップデートする方法。 * 2 つの開発ブランチ、FreeBSD-STABLE と FreeBSD-CURRENT の違い * ベースシステム全体を再構築しインストールする方法 @@ -65,17 +69,24 @@ toc::[] [NOTE] ==== -この章を通じて、 FreeBSD のソースコードをダウンロードしたりアップデートするのに `svnlite` が用いられます。 必要に応じて package:devel/subversion[] port または package が使われることもあります。 +この章を通じて、 FreeBSD のソースコードをダウンロードしたりアップデートするのに `git` が用いられます。 +必要に応じて package:devel/git[] port または package が使われることもあります。 ==== [[updating-upgrading-freebsdupdate]] == FreeBSD Update -すみやかにセキュリティパッチを適用し、 オペレーティングシステムをアップグレードして、 最新のリリースに保つことは、システム管理における重要な側面です。 これらの処理を行うために FreeBSD には `freebsd-update` と呼ばれるユーティリティが用意されています。 +すみやかにセキュリティパッチを適用し、 オペレーティングシステムをアップグレードして、 最新のリリースに保つことは、システム管理における重要な側面です。 +これらの処理を行うために FreeBSD には `freebsd-update` と呼ばれるユーティリティが用意されています。 -このユーティリティを用いると、FreeBSD のセキュリティおよび eratta アップデートをバイナリによって行うことができます。 手動でパッチもしくは新しいカーネルをコンパイルし、 インストールする必要はありません。 バイナリアップデートは、 セキュリティチームがサポートしているすべてのアーキテクチャとリリースで利用できます。 https://www.FreeBSD.org/ja/security/[https://www.FreeBSD.org/ja/security/] には、 サポートが行われているリリースや保守終了予定日の一覧があります。 +このユーティリティを用いると、FreeBSD のセキュリティおよび eratta アップデートをバイナリによって行うことができます。 +手動でパッチもしくは新しいカーネルをコンパイルし、インストールする必要はありません。 +バイナリアップデートは、セキュリティチームがサポートしているすべてのアーキテクチャとリリースで利用できます。 +https://www.FreeBSD.org/ja/security/[https://www.FreeBSD.org/ja/security/] には、サポートが行われているリリースや保守終了予定日の一覧があります。 -このユーティリティは、マイナーリリースであったり、 他のリリースブランチへのアップグレードにも対応しています。 新しいリリースにアップデートする前に、 アップデートしようとしているリリースのアナウンスに目を通し、 重要な情報がないかどうかを確認してください。 リリースのアナウンスは https://www.FreeBSD.org/ja/releases/[https://www.FreeBSD.org/ja/releases/] で確認できます。 +このユーティリティは、マイナーリリースであったり、他のリリースブランチへのアップグレードにも対応しています。 +新しいリリースにアップデートする前に、アップデートしようとしているリリースのアナウンスに目を通し、重要な情報がないかどうかを確認してください。 +リリースのアナウンスは https://www.FreeBSD.org/ja/releases/[https://www.FreeBSD.org/ja/releases/] で確認できます。 [NOTE] ==== @@ -87,7 +98,9 @@ toc::[] [[freebsdupdate-config-file]] === 設定ファイル -`freebsd-update` のデフォルトの設定ファイルは、 そのままでも用いることができます。 [.filename]#/etc/freebsd-update.conf# の設定をデフォルトからきめ細かく調整して、 アップデートプロセスを制御するユーザもいます。 利用可能なオプションについてはこのファイルのコメントで説明されていますが、 以下の項目については補足が必要でしょう。 +`freebsd-update` のデフォルトの設定ファイルは、そのままでも用いることができます。 +[.filename]#/etc/freebsd-update.conf# の設定をデフォルトからきめ細かく調整して、 アップデートプロセスを制御するユーザもいます。 +利用可能なオプションについてはこのファイルのコメントで説明されていますが、以下の項目については補足が必要でしょう。 [.programlisting] .... @@ -95,7 +108,11 @@ toc::[] Components world kernel .... -このパラメータは、FreeBSD のどの部分を最新に維持するかを設定します。 デフォルトでは、ベースシステム全体、 そしてカーネルをアップデートします。 `src/base` や `src/sys` のように、個々の項目を指定することもできます。 この部分についてはデフォルトのままにしておき、 アップデートする項目をユーザがリストに加える形にするのがベストでしょう。 ソースコードとバイナリが同期していないと、 長い年月の間に悲惨な結果がもたらされる可能性があります。 +このパラメータは、FreeBSD のどの部分を最新に維持するかを設定します。 +デフォルトでは、ベースシステム全体、そしてカーネルをアップデートします。 +`src/base` や `src/sys` のように、個々の項目を指定することもできます。 +この部分についてはデフォルトのままにしておき、アップデートする項目をユーザがリストに加える形にするのがベストでしょう。 +ソースコードとバイナリが同期していないと、長い年月の間に悲惨な結果がもたらされる可能性があります。 [.programlisting] .... @@ -104,7 +121,8 @@ Components world kernel IgnorePaths /boot/kernel/linker.hints .... -[.filename]#/bin# や [.filename]#/sbin# 等の特定のディレクトリをアップデートで変更しないように、 これらのパスを追加してください。 このオプションは、ローカルの変更点を `freebsd-update` が上書きすることを防ぐ目的にも利用できます。 +[.filename]#/bin# や [.filename]#/sbin# 等の特定のディレクトリをアップデートで変更しないように、これらのパスを追加してください。 +このオプションは、ローカルの変更点を `freebsd-update` が上書きすることを防ぐ目的にも利用できます。 [.programlisting] .... @@ -114,7 +132,10 @@ IgnorePaths /boot/kernel/linker.hints UpdateIfUnmodified /etc/ /var/ /root/ /.cshrc /.profile .... -このオプションは、指定したディレクトリにある設定ファイルを、 ローカルで変更されていない場合のみアップデートします。 ユーザがこれらのファイルを変更していると、 変更されたファイルの自動アップデートは行われません。 他に、`KeepModifiedMetadata` という別のオプションが存在します。 このオプションは、`freebsd-update` がマージ中に変更点を保存するようにします。 +このオプションは、指定したディレクトリにある設定ファイルを、ローカルで変更されていない場合のみアップデートします。 +ユーザがこれらのファイルを変更していると、変更されたファイルの自動アップデートは行われません。 +他に、`KeepModifiedMetadata` という別のオプションが存在します。 +このオプションは、`freebsd-update` がマージ中に変更点を保存するようにします。 [.programlisting] .... @@ -123,7 +144,10 @@ UpdateIfUnmodified /etc/ /var/ /root/ /.cshrc /.profile MergeChanges /etc/ /var/named/etc/ /boot/device.hints .... -`freebsd-update` がマージすべきファイルが存在するディレクトリの一覧です。 ファイルのマージのプロセスは、 man:mergemaster[8] と同様 man:diff[1] パッチの連続ですが、 選択肢は少なく、マージを承認するか、エディタを起動するか、 `freebsd-update` を中断するかどうかを選んでください。 もし、心配な点があれば、 [.filename]#/etc# をバックアップしてからマージを承認してください。 `mergemaster` の詳細な情報については、 man:mergemaster[8] で確認してください。 +`freebsd-update` がマージすべきファイルが存在するディレクトリの一覧です。 +ファイルのマージのプロセスは、man:mergemaster[8] と同様 man:diff[1] パッチの連続ですが、選択肢は少なく、マージを承認するか、エディタを起動するか、`freebsd-update` を中断するかどうかを選んでください。 +もし、心配な点があれば、[.filename]#/etc# をバックアップしてからマージを承認してください。 +`mergemaster` の詳細な情報については、man:mergemaster[8] で確認してください。 [.programlisting] .... @@ -132,7 +156,8 @@ MergeChanges /etc/ /var/named/etc/ /boot/device.hints # WorkDir /var/db/freebsd-update .... -ここではすべてのパッチや一次ファイルを置くディレクトリを指定しています。 バージョンをアップグレードするのであれば、 この場所には少なくともギガバイトの空き容量が必要です。 +ここではすべてのパッチや一次ファイルを置くディレクトリを指定しています。 +バージョンをアップグレードするのであれば、この場所には少なくともギガバイトの空き容量が必要です。 [.programlisting] .... @@ -143,14 +168,20 @@ MergeChanges /etc/ /var/named/etc/ /boot/device.hints # StrictComponents no .... -このオプションを `yes` に設定すると、 `freebsd-update` は `Components` のリストが完全に正しいと判断し、 このリスト以外の変更点については取り扱いません。 `freebsd-update` は、効率的に `Components` リストに属するファイルをアップデートします。 +このオプションを `yes` に設定すると、`freebsd-update` は `Components` のリストが完全に正しいと判断し、このリスト以外の変更点については取り扱いません。 +`freebsd-update` は、効率的に `Components` リストに属するファイルをアップデートします。 [[freebsdupdate-security-patches]] === セキュリティパッチの適用 -FreeBSD のセキュリティパッチを適用する過程は簡単になりました。 管理者は `freebsd-update` を使うことで、 システムを完全にパッチがあたった状態に保つ事ができます。 FreeBSD セキュリティ勧告の詳細については、 crossref:security[security-advisories,FreeBSD セキュリティ勧告] の節で説明されています。 +FreeBSD のセキュリティパッチを適用する過程は簡単になりました。 +管理者は `freebsd-update` を使うことで、 システムを完全にパッチがあたった状態に保つ事ができます。 +FreeBSD セキュリティ勧告の詳細については、crossref:security[security-advisories,FreeBSD セキュリティ勧告] の節で説明されています。 -以下のコマンドを実行すると、FreeBSD のセキュリティパッチがダウンロードされ、インストールされます。 最初のコマンドは、未対応のパッチがあるかどうかを調べます。 もし未対応のパッチがある場合には、 パッチが当てられた際に変更されるファイルのリストが作成されます。 2 番目のコマンドはパッチを適用します。 +以下のコマンドを実行すると、FreeBSD のセキュリティパッチがダウンロードされ、インストールされます。 +最初のコマンドは、未対応のパッチがあるかどうかを調べます。 +もし未対応のパッチがある場合には、パッチが当てられた際に変更されるファイルのリストが作成されます。 +2 番目のコマンドはパッチを適用します。 [source,shell] .... @@ -158,11 +189,14 @@ FreeBSD のセキュリティパッチを適用する過程は簡単になりま # freebsd-update install .... -アップデートによってカーネルにパッチが当たった場合には、 パッチが当たったカーネルで起動するように、 システムを再起動する必要があります。 もし、実行中のバイナリにパッチが当てられた場合には、 パッチの当てられたバージョンのバイナリが使われるように、 影響のあるアプリケーションを再起動する必要があります。 +アップデートによってカーネルにパッチが当たった場合には、パッチが当たったカーネルで起動するように、システムを再起動する必要があります。 +もし、実行中のバイナリにパッチが当てられた場合には、パッチの当てられたバージョンのバイナリが使われるように、影響のあるアプリケーションを再起動する必要があります。 [NOTE] ==== -通常、ユーザはシステムを再起動する必要があります。 カーネルアップデートで再起動が必要かどうかを知るには、 `freebsd-version -k` と `uname -r` を実行してください。 これら 2 つのコマンドの結果が異なる場合には、 再起動が必要です。 +通常、ユーザはシステムを再起動する必要があります。 +カーネルアップデートで再起動が必要かどうかを知るには、`freebsd-version -k` と `uname -r` を実行してください。 +これら 2 つのコマンドの結果が異なる場合には、再起動が必要です。 ==== 毎日一度アップデートがないかどうかを自動的に確認するように設定するには、 以下のエントリを [.filename]#/etc/crontab# に追加してください。 @@ -172,7 +206,8 @@ FreeBSD のセキュリティパッチを適用する過程は簡単になりま @daily root freebsd-update cron .... -パッチが存在すると、 自動的にダウンロードされますが、適用はされません。 ``root``宛てにメールで、 ダウンロードされたパッチを確認し、 `freebsd-update install` とともに手動でインストールする必要のあることが通知されます。 +パッチが存在すると、自動的にダウンロードされますが、適用はされません。 +``root``宛てにメールで、ダウンロードされたパッチを確認し、`freebsd-update install` とともに手動でインストールする必要のあることが通知されます。 うまく行かなかった場合には、`freebsd-update` を以下のように実行すると、最後の変更までロールバックできます。 @@ -184,25 +219,39 @@ Uninstalling updates... done. カーネルまたはカーネルモジュールがアップデートされた場合には、 完了後にもう一度システムを再起動して、 影響のあったバイナリを再起動してください。 -`freebsd-update` ユーティリティが自動的にアップデートするカーネルは [.filename]#GENERIC# のみです。 カスタムカーネルをインストールしている場合には、 `freebsd-update` によりインストールした後、 カーネルを再構築し、もう一度インストールする必要があります。 デフォルトのカーネルの名前は _GENERIC_ です。 man:uname[1] コマンドを使ってインストールされているかどうかを確認できます。 +`freebsd-update` ユーティリティが自動的にアップデートするカーネルは [.filename]#GENERIC# のみです。 +カスタムカーネルをインストールしている場合には、`freebsd-update` によりインストールした後、カーネルを再構築し、もう一度インストールする必要があります。 +デフォルトのカーネルの名前は _GENERIC_ です。 +man:uname[1] コマンドを使ってインストールされているかどうかを確認できます。 [NOTE] ==== -[.filename]#GENERIC# カーネルを、 常に [.filename]#/boot/GENERIC# に置いておいてください。 さまざまな問題を解決する際や、 バージョンをアップグレードする際に助けとなります。 [.filename]#GENERIC# カーネルを用意する方法については、 <> を参照してください。 +[.filename]#GENERIC# カーネルを、常に [.filename]#/boot/GENERIC# に置いておいてください。 +さまざまな問題を解決する際や、バージョンをアップグレードする際に助けとなります。 +[.filename]#GENERIC# カーネルを用意する方法については、<> を参照してください。 ==== -[.filename]#/etc/freebsd-update.conf# のデフォルトの設定を変更しない限り、 `freebsd-update` は、 他の更新と共にカーネルソースをアップデートします。 新しいカスタムカーネルの再構築と再インストールは、 通常通り行うことができます。 +[.filename]#/etc/freebsd-update.conf# のデフォルトの設定を変更しない限り、`freebsd-update` は、他の更新と共にカーネルソースをアップデートします。 +新しいカスタムカーネルの再構築と再インストールは、通常通り行うことができます。 -`freebsd-update` は、 常にカーネルをアップデートするとは限りません。 `freebsd-update install` によってカーネルソースが変更されなかった場合には、 カスタムカーネルを再構築する必要はありません。 しかしながら `freebsd-update` は、 [.filename]#/usr/src/sys/conf/newvers.sh# を常にアップデートします。 これは、現在のシステムのパッチレベルを `uname -r` が `-p` で表示する時にこのファイルが参照されます。 そのため、何も変更されていない場合でも、 カスタムカーネルを再構築することにより、 `uname` がシステムの正確なパッチレベルを報告するようになります。 各システムにインストールされているアップデートをすばやく把握できるようになるので、 特に複数のシステムを管理するときに助けとなります。 +`freebsd-update` は、常にカーネルをアップデートするとは限りません。 +`freebsd-update install` によってカーネルソースが変更されなかった場合には、カスタムカーネルを再構築する必要はありません。 +しかしながら `freebsd-update` は、[.filename]#/usr/src/sys/conf/newvers.sh# を常にアップデートします。 +これは、現在のシステムのパッチレベルを `uname -r` が `-p` で表示する時にこのファイルが参照されます。 +そのため、何も変更されていない場合でも、カスタムカーネルを再構築することにより、`uname` がシステムの正確なパッチレベルを報告するようになります。 +各システムにインストールされているアップデートをすばやく把握できるようになるので、特に複数のシステムを管理するときに助けとなります。 [[freebsdupdate-upgrade]] === メジャーおよびマイナーバージョンのアップグレードを行う -FreeBSD のマイナーバージョン間のアップグレード、 たとえば、FreeBSD 9.0 から FreeBSD 9.1 へのアップグレードは、 _マイナーバージョン_ アップグレードと呼ばれます。 _メジャーバージョン_ アップグレードは、 FreeBSD 9.X から FreeBSD 10.X へのアップグレードといった、 FreeBSD のメジャーバージョンが変わるようなアップグレードのことです。 どちらもアップグレードも、`freebsd-update` にリリース番号のターゲットを指定する事で実行できます。 +FreeBSD のマイナーバージョン間のアップグレード、たとえば、FreeBSD 9.0 から FreeBSD 9.1 へのアップグレードは、_マイナーバージョン_ アップグレードと呼ばれます。 +_メジャーバージョン_ アップグレードは、FreeBSD 9.X から FreeBSD 10.X へのアップグレードといった、FreeBSD のメジャーバージョンが変わるようなアップグレードのことです。 +どちらもアップグレードも、`freebsd-update` にリリース番号のターゲットを指定する事で実行できます。 [NOTE] ==== -カスタムカーネルを使っているシステムでは、 アップグレードを行う前に [.filename]#GENERIC# カーネルが、 [.filename]#/boot/GENERIC# に置かれている事を確認してください。 [.filename]#GENERIC# カーネルを用意する方法については、 <> を参照してください。 +カスタムカーネルを使っているシステムでは、アップグレードを行う前に [.filename]#GENERIC# カーネルが、[.filename]#/boot/GENERIC# に置かれている事を確認してください。 +[.filename]#GENERIC# カーネルを用意する方法については、<> を参照してください。 ==== 以下のコマンドを実行すると、FreeBSD 9.0 のシステムを FreeBSD 9.1 にアップグレードします。 @@ -212,7 +261,9 @@ FreeBSD のマイナーバージョン間のアップグレード、 たとえ # freebsd-update -r 9.1-RELEASE upgrade .... -コマンドを実行すると、`freebsd-update` は設定ファイルと現在のシステムを評価し、 アップデートするために必要な情報を収集します。 画面には、どのコンポーネントが認識され、 どのコンポーネントが認識されていないといったリストが表示されます。 たとえば以下のように表示されます。 +コマンドを実行すると、`freebsd-update` は設定ファイルと現在のシステムを評価し、 アップデートするために必要な情報を収集します。 +画面には、どのコンポーネントが認識され、どのコンポーネントが認識されていないといったリストが表示されます。 +たとえば以下のように表示されます。 [source,shell] .... @@ -234,9 +285,10 @@ world/proflibs Does this look reasonable (y/n)? y .... -ここで、`freebsd-update` はアップグレードに必要なすべてのファイルをダウンロードします。 何をインストールし、どのように進むかといった質問をされることもあります。 +ここで、`freebsd-update` はアップグレードに必要なすべてのファイルをダウンロードします。 +何をインストールし、どのように進むかといった質問をされることもあります。 -カスタムカーネルを使っていると、 上記のステップで以下のような警告が表示されます。 +カスタムカーネルを使っていると、上記のステップで以下のような警告が表示されます。 [source,shell] .... @@ -246,13 +298,22 @@ This kernel will not be updated: you MUST update the kernel manually before running "/usr/sbin/freebsd-update install" .... -この時点ではこの警告を無視してもかまいません。 アップデートされた [.filename]#GENERIC# カーネルは、 アップグレードプロセスの途中で利用されます。 +この時点ではこの警告を無視してもかまいません。 +アップデートされた [.filename]#GENERIC# カーネルは、アップグレードプロセスの途中で利用されます。 -すべてのパッチがローカルシステムへダウンロードされたら、 次にパッチが適用されます。 このプロセスには時間がかかります。 この時間はコンピュータの性能とワークロードに依存します。 その後、設定ファイルがマージされます。 このプロセスでは、ユーザはファイルをマージするか、 画面上にエディタを立ち上げて手動でマージするかを尋ねられます。 プロセスが進むごとに、成功したマージのすべての結果の情報がユーザに示されます。 マージに失敗したり、無視した場合には、プロセスが中断します。 ユーザによっては [.filename]#/etc# のバックアップを取り、 [.filename]#master.passwd# や [.filename]#group# のような重要なファイルを後で手動でマージする方もいます。 +すべてのパッチがローカルシステムへダウンロードされたら、次にパッチが適用されます。 +このプロセスには時間がかかります。 +この時間はコンピュータの性能とワークロードに依存します。 +その後、設定ファイルがマージされます。 +このプロセスでは、ユーザはファイルをマージするか、画面上にエディタを立ち上げて手動でマージするかを尋ねられます。 +プロセスが進むごとに、成功したマージのすべての結果の情報がユーザに示されます。 +マージに失敗したり、無視した場合には、プロセスが中断します。 +ユーザによっては [.filename]#/etc# のバックアップを取り、[.filename]#master.passwd# や [.filename]#group# のような重要なファイルを後で手動でマージする方もいます。 [NOTE] ==== -すべてのパッチは別のディレクトリでマージされており、 まだ、システムには反映されていません。 すべてのパッチが正しく適用され、 すべての設定ファイルがマージされてプロセスがスムーズに進んだら、 ユーザは以下のコマンドを用いて、 変更点をディスクに反映してください。 +すべてのパッチは別のディレクトリでマージされており、まだ、システムには反映されていません。 +すべてのパッチが正しく適用され、すべての設定ファイルがマージされてプロセスがスムーズに進んだら、ユーザは以下のコマンドを用いて、変更点をディスクに反映してください。 [source,shell] .... @@ -261,7 +322,8 @@ before running "/usr/sbin/freebsd-update install" ==== -パッチは最初にカーネルとカーネルモジュールに対して当てられます。 システムがカスタムカーネルを実行している場合には、 man:nextboot[8] を使って次回の再起動時のカーネルを、 アップデートされた [.filename]#/boot/GENERIC# に設定してください。 +パッチは最初にカーネルとカーネルモジュールに対して当てられます。 +システムがカスタムカーネルを実行している場合には、man:nextboot[8] を使って次回の再起動時のカーネルを、アップデートされた [.filename]#/boot/GENERIC# に設定してください。 [source,shell] .... @@ -270,7 +332,9 @@ before running "/usr/sbin/freebsd-update install" [WARNING] ==== -[.filename]#GENERIC# カーネルで再起動する前に、 カーネルにシステムが適切に起動するために必要なすべてのドライバが含まれていること、 もしアップデートしているコンピュータがリモートでアクセスしているのであれば、 ネットワーク接続に必要なすべてのドライバも含まれていることを確認してください。 特に、これまで実行しているカスタムカーネルが、 カーネルモジュールとして提供されているビルドインの機能を含んでいるのであれば、 これらのモジュールを一時的に [.filename]#/boot/loader.conf# の機能を用いて、 [.filename]#GENERIC# に読み込んでください。 アップグレードプロセスが終わるまでは、 重要ではないサービスを無効にするとともに、 必要のないディスクやネットワークのマウントなども避けることが推奨されています +[.filename]#GENERIC# カーネルで再起動する前に、カーネルにシステムが適切に起動するために必要なすべてのドライバが含まれていること、もしアップデートしているコンピュータがリモートでアクセスしているのであれば、ネットワーク接続に必要なすべてのドライバも含まれていることを確認してください。 +特に、これまで実行しているカスタムカーネルが、カーネルモジュールとして提供されているビルドインの機能を含んでいるのであれば、これらのモジュールを一時的に [.filename]#/boot/loader.conf# の機能を用いて、[.filename]#GENERIC# に読み込んでください。 +アップグレードプロセスが終わるまでは、重要ではないサービスを無効にするとともに、必要のないディスクやネットワークのマウントなども避けることが推奨されています。 ==== アップデートされたカーネルでコンピュータを再起動してください。 @@ -280,7 +344,8 @@ before running "/usr/sbin/freebsd-update install" # shutdown -r now .... -システムがオンラインに戻ったら、以下のコマンドを使って `freebsd-update` を再び実行してください。 アップデートプロセスの状態は保存されているので、 `freebsd-update` を実行すると、 最初からではなく、次のステップに進み、 古い共有ライブラリとオブジェクトファイルを削除します。 +システムがオンラインに戻ったら、以下のコマンドを使って `freebsd-update` を再び実行してください。 +アップデートプロセスの状態は保存されているので、`freebsd-update` を実行すると、最初からではなく、次のステップに進み、古い共有ライブラリとオブジェクトファイルを削除します。 [source,shell] .... @@ -292,14 +357,18 @@ before running "/usr/sbin/freebsd-update install" 使用しているライブラリのバージョン番号の付けられ方によって、 3 つのインストールフェーズが 2 つになる場合もあります。 ==== -アップグレードはこれで終了です。 もしメジャーアップグレードを行った場合には、 <> で説明されているようにすべての ports および package を再構築してください。 +アップグレードはこれで終了です。 +もしメジャーアップグレードを行った場合には、<> で説明されているようにすべての ports および package を再構築してください。 [[freebsd-update-custom-kernel-9x]] ==== FreeBSD 9.X 以降のシステムにおけるカスタムカーネル -`freebsd-update` を使う前に、 [.filename]#GENERIC# カーネルが [.filename]#/boot/GENERIC# に置かれていることを確認してください。 ただ一度だけカスタムカーネルを構築したのであれば、 [.filename]#/boot/kernel.old# は [.filename]#GENERIC# カーネルそのものです。 このディレクトリの名前を [.filename]#/boot/GENERIC# へと変更してください。 +`freebsd-update` を使う前に、[.filename]#GENERIC# カーネルが [.filename]#/boot/GENERIC# に置かれていることを確認してください。 +ただ一度だけカスタムカーネルを構築したのであれば、[.filename]#/boot/kernel.old# は [.filename]#GENERIC# カーネルそのものです。 +このディレクトリの名前を [.filename]#/boot/GENERIC# へと変更してください。 -もし、2 回以上カスタムカーネルを構築した後であったり、 カスタムカーネルを構築した回数がわからなければ、 現在のオペレーティングシステムのバージョンの [.filename]#GENERIC# カーネルを入手してください。 コンピュータへの物理的なアクセスが可能であれば、 インストールメディアから [.filename]#GENERIC# カーネルをインストールできます。 +もし、2 回以上カスタムカーネルを構築した後であったり、カスタムカーネルを構築した回数がわからなければ、現在のオペレーティングシステムのバージョンの [.filename]#GENERIC# カーネルを入手してください。 +コンピュータへの物理的なアクセスが可能であれば、インストールメディアから [.filename]#GENERIC# カーネルをインストールできます。 [source,shell] .... @@ -316,50 +385,63 @@ before running "/usr/sbin/freebsd-update install" # make kernel __MAKE_CONF=/dev/null SRCCONF=/dev/null .... -`freebsd-update` がこのカーネルを [.filename]#GENERIC# カーネルとして認識するために、 [.filename]#GENERIC# コンフィグレーションファイルは、 とにかく変更してはいけません。 また、特別なオプションを指定しないで構築してください。 +`freebsd-update` がこのカーネルを [.filename]#GENERIC# カーネルとして認識するために、[.filename]#GENERIC# コンフィグレーションファイルは、とにかく変更してはいけません。 +また、特別なオプションを指定しないで構築してください。 -`freebsd-update` は、 [.filename]#/boot/GENERIC# が存在する事だけを必要とするので、 [.filename]#GENERIC# カーネルで再起動する必要はありません。 +`freebsd-update` は、[.filename]#/boot/GENERIC# が存在する事だけを必要とするので、[.filename]#GENERIC# カーネルで再起動する必要はありません。 [[freebsdupdate-portsrebuild]] ==== メジャーバージョンアップグレード後の package のアップグレード -一般的に、マイナーバージョンアップグレードの後では、 インストールされているアプリケーションは、問題なく動作するでしょう。 メジャーバージョンが異なるとアプリケーションバイナリーインタフェース (ABI) が異なるため、 サードパーティ製のアプリケーションの多くは動作しなくなるでしょう。 メジャーバージョンアップグレード後には、 インストールされているすべての packages, ports をアップグレードする必要があります。 package は、`pkg upgrade` を使ってアップグレードできます。 インストールされている ports をアップグレードする場合には、 package:ports-mgmt/portmaster[] といったユーティリティを使ってください。 +一般的に、マイナーバージョンアップグレードの後では、インストールされているアプリケーションは、問題なく動作するでしょう。 +メジャーバージョンが異なるとアプリケーションバイナリーインタフェース (ABI) が異なるため、サードパーティ製のアプリケーションの多くは動作しなくなるでしょう。 +メジャーバージョンアップグレード後には、インストールされているすべての packages, ports をアップグレードする必要があります。 +package は、`pkg upgrade` を使ってアップグレードできます。 +インストールされている ports をアップグレードする場合には、package:ports-mgmt/portmaster[] といったユーティリティを使ってください。 -すべての package の強制的なアップグレードでは、 バージョン番号が上がらない package に対しても、 リポジトリから最新のバージョンで、インストールされている package を置き換えます。 FreeBSD のメージャーバージョンが変わるようなアップグレードでは、 ABI のバージョンも変わるため、 このようなアップグレードが必要になります。 強制的なアップグレードを行うには、以下のように実行してください。 +すべての package の強制的なアップグレードでは、バージョン番号が上がらない package に対しても、リポジトリから最新のバージョンで、インストールされている package を置き換えます。 +FreeBSD のメージャーバージョンが変わるようなアップグレードでは、ABI のバージョンも変わるため、このようなアップグレードが必要になります。 +強制的なアップグレードを行うには、以下のように実行してください。 [source,shell] .... # pkg-static upgrade -f .... -インストールされているすべてのアプリケーションを再構築するには、 以下のコマンドを実行してください。 +インストールされているすべてのアプリケーションを再構築するには、以下のコマンドを実行してください。 [source,shell] .... # portmaster -af .... -このコマンドを実行すると、 設定を変更するオプションを持つアプリケーションは、 設定変更のスクリーンを表示し、 ユーザからの指示待ちの状態で停止します。 この振る舞いをやめ、デフォルトのオプションを使用するには、 上記のコマンドに `-G` を含めてください。 +このコマンドを実行すると、設定を変更するオプションを持つアプリケーションは、設定変更のスクリーンを表示し、ユーザからの指示待ちの状態で停止します。 +この振る舞いをやめ、デフォルトのオプションを使用するには、上記のコマンドに `-G` を含めてください。 -ソフトウェアのアップグレードが終わったら、最後にもう一度 `freebsd-update` を実行して、 すべてのアップグレードプロセスのやり残し作業を行い、 アップグレードのプロセスを完了してください。 +ソフトウェアのアップグレードが終わったら、最後にもう一度 `freebsd-update` を実行して、すべてのアップグレードプロセスのやり残し作業を行い、アップグレードのプロセスを完了してください。 [source,shell] .... # freebsd-update install .... -[.filename]#GENERIC# カーネルを一時的に読み込んでいたのであれば、crossref:kernelconfig[kernelconfig,FreeBSD カーネルのコンフィグレーション] に書かれている手順に従って、 新しいカスタムを構築し、インストールしてください。 +[.filename]#GENERIC# カーネルを一時的に読み込んでいたのであれば、crossref:kernelconfig[kernelconfig,FreeBSD カーネルのコンフィグレーション] に書かれている手順に従って、新しいカスタムを構築し、インストールしてください。 -コンピュータを再起動し、新しい FreeBSD を立ち上げてください。 これでアップグレードのプロセスは完了です。 +コンピュータを再起動し、新しい FreeBSD を立ち上げてください。 +これでアップグレードのプロセスは完了です。 [[freebsdupdate-system-comparison]] === システムの状態の比較 -`freebsd-update` を用いて、 インストールされている FreeBSD の状態と、 正しく動作することが分かっている状態とを比較できます。 このコマンドは、現在のシステムのユーティリティ、ライブラリ、 設定ファイルを評価するので、 組み込みの侵入検知システム (IDS) として使うことができます。 +`freebsd-update` を用いて、インストールされている FreeBSD の状態と、正しく動作することが分かっている状態とを比較できます。 +このコマンドは、現在のシステムのユーティリティ、ライブラリ、設定ファイルを評価するので、組み込みの侵入検知システム (IDS) として使うことができます。 [WARNING] ==== -このコマンドは、package:security/snort[] のような本当の IDS の置き換えになるものではありません。 `freebsd-update` はデータをディスクに保存するので、 不正な変更が行われる可能性があります。 `kern.securelevel` と、 `freebsd-update` のデータを使用しないときに、 読み取りのみの許可属性に設定されているファイルシステムに置くことで、 不正な変更の可能性を低くできますが、 よりよい解決方法は、 DVD または安全に保存されている外部 USB ディスクのような安全なディスクとシステムを比較することです。 組み込まれているユーティリティを用いた、別の方法による IDS 機能については、 crossref:security[security-ids,FreeBSD バイナリによる検出] の節をご覧ください。 +このコマンドは、package:security/snort[] のような本当の IDS の置き換えになるものではありません。 +`freebsd-update` はデータをディスクに保存するので、不正な変更が行われる可能性があります。 +`kern.securelevel` と、`freebsd-update` のデータを使用しないときに、読み取りのみの許可属性に設定されているファイルシステムに置くことで、不正な変更の可能性を低くできますが、よりよい解決方法は、DVD または安全に保存されている外部 USB ディスクのような安全なディスクとシステムを比較することです。 +組み込まれているユーティリティを用いた、別の方法による IDS 機能については、crossref:security[security-ids,FreeBSD バイナリによる検出] の節をご覧ください。 ==== 比較を行うには、 結果の出力先のファイル名を指定してください。 @@ -369,9 +451,10 @@ before running "/usr/sbin/freebsd-update install" # freebsd-update IDS >> outfile.ids .... -システムは検査され、リリースファイルの SHA256 ハッシュ値と現在インストールされているファイルのハッシュ値がファイルの一覧と共に、 指定した出力先のファイルに送られます。 +システムは検査され、リリースファイルの SHA256 ハッシュ値と現在インストールされているファイルのハッシュ値がファイルの一覧と共に、指定した出力先のファイルに送られます。 -これらの行は極めて長いのですが、出力形式は簡単にすぐに解析できます。 たとえば、これらのリリースで異なっているすべてのファイルを知りたいのであれば、 以下のコマンドを実行してください。 +これらの行は極めて長いのですが、出力形式は簡単にすぐに解析できます。 +たとえば、これらのリリースで異なっているすべてのファイルを知りたいのであれば、以下のコマンドを実行してください。 [source,shell] .... @@ -382,148 +465,53 @@ before running "/usr/sbin/freebsd-update install" /etc/pf.conf .... -上の表示例では出力は切り捨てられており、 実際にはもっと多くのファイルが存在します。 これらのファイルには、運用中に変更されるファイルがあります。 たとえば、[.filename]#/etc/passwd# はユーザがシステムに追加されると変更されます。 また、カーネルモジュールは、 `freebsd-update` によりアップデートされるため、変更されます。 このような特別なファイルやディレクトリを除外するには、 それらを [.filename]#/etc/freebsd-update.conf# の `IDSIgnorePaths` オプションに追加してください。 +上の表示例では出力は切り捨てられており、実際にはもっと多くのファイルが存在します。 +これらのファイルには、運用中に変更されるファイルがあります。 +たとえば、[.filename]#/etc/passwd# はユーザがシステムに追加されると変更されます。 +また、カーネルモジュールは、`freebsd-update` によりアップデートされるため、変更されます。 +このような特別なファイルやディレクトリを除外するには、それらを [.filename]#/etc/freebsd-update.conf# の `IDSIgnorePaths` オプションに追加してください。 [[updating-upgrading-documentation]] == ドキュメントのアップデート -ドキュメントは、FreeBSD オペレーティングシステムの必須要素です。 FreeBSD ドキュメントの最新バージョンは、FreeBSD ウェブサイト (link:https://www.FreeBSD.org/doc/[https://www.freebsd.org/doc/]) から入手できますが、 FreeBSD ウェブサイト、ハンドブック、FAQ および文書の最新版をローカルに用意しておくと便利です。 +ドキュメントは、FreeBSD オペレーティングシステムの必須要素です。 +FreeBSD ドキュメントの最新バージョンは、FreeBSD ウェブサイト (link:https://docs.FreeBSD.org/[Documentation Portal]) から入手できますが、 FreeBSD ウェブサイト、ハンドブック、FAQ および文書の最新版をローカルに用意しておくと便利です。 -この章では、ソースまたは Ports Collection を使って、 ローカルの FreeBSD ドキュメントを最新に保つ方法を説明します。 +この章では、ソースまたは Ports Collection を使って、ローカルの FreeBSD ドキュメントを最新に保つ方法を説明します。 -ドキュメントを編集したり、 ドキュメントの誤りを報告する方法については、 新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門 (link:{fdp-primer}[FreeBSD Documentation Project Primer]) をご覧ください。 +ドキュメントを編集したり、ドキュメントの誤りを報告する方法については、新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門 (link:{fdp-primer}[FreeBSD Documentation Project Primer]) をご覧ください。 [[updating-installed-documentation]] === ソースから FreeBSD ドキュメントをインストールする -ソースから FreeBSD ドキュメントを構築するのに必要なツールは、 FreeBSD のベースシステムには含まれていません。 必要なツールは、FreeBSD ドキュメンテーションプロジェクトが開発している package:textproc/docproj[] package または port からインストールできます。 +ソースから FreeBSD ドキュメントを構築するのに必要なツールは、FreeBSD のベースシステムには含まれていません。 +必要なツールは、新しい貢献者のための FreeBSD ドキュメンテーションプロジェクト入門で link:{fdp-primer}#overview-quick-start[説明されているステップ] に従ってインストールしてください。 -インストールしたら、svnlite を使って、ドキュメントのソースをダウンロードしてください。 +インストールしたら、git を使って、ドキュメントのソースをダウンロードしてください。 [source,shell] .... -# svnlite checkout https://svn.FreeBSD.org/doc/head /usr/doc +# git clone https://git.FreeBSD.org/doc.git /usr/doc .... -最初にドキュメントのソースをダウンロードするには少し時間がかかります。 ダウンロードが終わるまでお待ちください。 +最初にドキュメントのソースをダウンロードするには少し時間がかかります。 +ダウンロードが終わるまでお待ちください。 ダウンロードしたドキュメントのソースをアップデートするには、 以下のコマンドを実行してください。 [source,shell] .... -# svnlite update /usr/doc +# git pull .... -最新のドキュメントのソースのスナップショットを [.filename]#/usr/doc# に用意できたら、 インストールされているドキュメントをアップデートする準備はすべて整いました。 +最新のドキュメントのソースのスナップショットを [.filename]#/usr/doc# に用意できたら、インストールされているドキュメントをアップデートする準備はすべて整いました。 -利用可能なすべての言語のドキュメントをアップデートするには、 以下のように入力してください。 +ドキュメントをアップデートするには、以下のように入力してください。 [source,shell] .... # cd /usr/doc -# make install clean -.... - -もし、ある特定の言語のみをアップデートしたいのであれば、 [.filename]#/usr/doc# の下にある各言語のサブディレクトリで `make` を実行してください。 - -[source,shell] -.... -# cd /usr/doc/en_US.ISO8859-1 -# make install clean -.... - -ドキュメントをアップデートする別の方法は、 [.filename]#/usr/doc# または各言語のサブディレクトリで以下のコマンドを実行してください。 - -[source,shell] -.... -# make update -.... - -`FORMATS` を設定して、 以下のようにインストールする出力形式を指定できます。 - -[source,shell] -.... -# cd /usr/doc -# make FORMATS='html html-split' install clean -.... - -ドキュメンテーションの一部のアップデートを簡単にするオプションや、 特定の翻訳のビルドを行うためのオプションが用意されています。 これらのオプションは、システム全般のオプションである [.filename]#/etc/make.conf# や、`make` に与えるコマンドラインオプションで設定できます。 - -オプションには以下のようなものがあります。 - -`DOC_LANG`:: -ビルドおよびインストールの言語およびエンコーディングの一覧。 たとえば、英語のドキュメントを指定するには `en_US.ISO8859-1` を設定します。 - -`FORMATS`:: -ビルドを行うフォーマット、または出力フォーマットの一覧。 現在は `html`, `html-split`, `txt`, `ps` そして `pdf` に対応しています。 - -`DOCDIR`:: -ドキュメントをインストールする場所。デフォルトは [.filename]#/usr/share/doc# です。 - -FreeBSD のシステム全般のオプションに関連するもっと多くの `make` 変数については、 man:make.conf[5] をご覧ください。 - -[[doc-ports-install-package]] -=== ports を用いたドキュメンテーションのアップデート - -これまでのセクションでは、ソースコードを用いた FreeBSD ドキュメントのアップデート方法について説明してきました。 この節では、インストールされている FreeBSD のドキュメントをアップデートするもう一つの方法である、 Ports Collection を用いた方法について説明し、 以下について説明します。 - -* 構築済のドキュメントの packages をインストールする方法。 ローカルでの構築作業やドキュメンテーションツールチェインをインストールする必要はありません。 -* ports フレームワークを使ったドキュメントのソースの構築方法。 チェックアウトおよび構築作業が簡単になります。 - -FreeBSD のドキュメントをアップデートするこれらの方法は、 {doceng} が毎月アップデートしている ドキュメンテーション ports および packages によりサポートされています。 これらの ports は、FreeBSD Ports Collection の docs カテゴリ (http://www.freshports.org/docs/[http://www.freshports.org/docs/]) にまとめられています。 - -ドキュメンテーション ports の構成は以下の通りです。 - -* package:misc/freebsd-doc-en[] package または portは、 すべての英語文書をインストールします。 -* package:misc/freebsd-doc-all[] メタ package もしくは port は、 すべての利用可能な言語のすべてのドキュメントを構築します。 -* 各言語のために package または port が用意されています。たとえば、 package:misc/freebsd-doc-hu[] はハンガリー語のドキュメンテーション port です。 - -バイナリ package を使うと、 インストールする言語に用意されているすべての形式の FreeBSD ドキュメントがインストールされます。 たとえば、以下のコマンドを実行すると、 ハンガリー語のドキュメントの最新 package がインストールされます。 - -[source,shell] -.... -# pkg install hu-freebsd-doc -.... - -[NOTE] -==== -ドキュメントの package は、対応する port 名とは異なり、 `_lang_-freebsd-doc` の形式で名前がつけられています。 ここで、_lang_ は言語コードの短縮形です。 ハンガリー語の場合は `hu`、簡体字の場合には `zh_cn` です。 -==== - -ドキュメントのフォーマットを指定する場合には、package ではなく port から構築してください。たとえば、 英語のドキュメントを構築してインストールするには以下のようにして下さい。 - -[source,shell] -.... -# cd /usr/ports/misc/freebsd-doc-en -# make install clean -.... - -この port には、 構築およびインストールするフォーマットを設定するメニューがあります。 デフォルトでは、link:http://www.FreeBSD.org[http://www.FreeBSD.org] と同じ形式である分割版の HTML 形式、 PDF が選択されています。 - -以下のように、ドキュメンテーション ports を構築する際の `make` オプションが用意されています。 - -`WITH_HTML`:: -HTML 形式を構築します。 各ドキュメントに対し、単一版の HTML ファイルが構築されます。 整形されたドキュメントは、 [.filename]#article.html# や [.filename]#book.html# といった名前でインストールされます。 - -`WITH_PDF`:: -整形されたドキュメントは、 [.filename]#article.pdf# や [.filename]#book.pdf# といった名前でインストールされます。 - -`DOCBASE`:: -ドキュメントのインストール先を設定します。 デフォルトのインストール先は [.filename]#/usr/local/share/doc/freebsd# です。 - -以下は、上記の変数を用いてハンガリー語のドキュメントを PDF 形式でインストールする方法です。 - -[source,shell] -.... -# cd /usr/ports/misc/freebsd-doc-hu -# make -DWITH_PDF DOCBASE=share/doc/freebsd/hu install clean -.... - -crossref:ports[ports,アプリケーションのインストール - packages と ports] に書かれている手順を使って、 ドキュメンテーション package または port をアップデートできます。 たとえば、以下のコマンドを実行すると、 package:ports-mgmt/portupgrade[] から、package だけを使ってインストールされているハンガリー語のドキュメントをアップデートします。 - -[source,shell] -.... -# portmaster -PP hu-freebsd-doc +# make .... [[current-stable]] @@ -533,63 +521,89 @@ FreeBSD には二つの開発ブランチがあります。 それは FreeBSD-CU この節ではそれぞれのブランチと対象としている読者についての説明と、 どのようにしてシステムの対応するブランチを最新の状態に保つかについて説明します。 -_訳: 、1996 年 11 月 6 日_ - [[current]] === FreeBSD-CURRENT を使う -FreeBSD-CURRENT とは FreeBSD の開発の "最前線" なので、 FreeBSD-CURRENT のユーザは高い技術力を持つことが要求されます。 そこまでの技術力を持っていないが、 開発ブランチを追いかけたいと考えているユーザは、 かわりに FreeBSD-STABLE を追いかけると良いでしょう。 +FreeBSD-CURRENT とは FreeBSD の開発の "最前線" なので、FreeBSD-CURRENT のユーザは高い技術力を持つことが要求されます。 +そこまでの技術力を持っていないが、開発ブランチを追いかけたいと考えているユーザは、かわりに FreeBSD-STABLE を追いかけると良いでしょう。 -FreeBSD-CURRENT は FreeBSD の最新のソースコードであり、 中には現在開発途上のソフトウェア、 実験的な変更、あるいは過渡的な機能などが含まれています。 また、この中に入っている機能がすべて、 次の公式リリースに入るとは限りません。FreeBSD-CURRENT をソースからほぼ毎日コンパイルしている人はたくさんいますが、 短い期間ではコンパイルさえできない状態になっている時期もあります。 これらの問題は可能な限り迅速に解決されますが、 FreeBSD-CURRENT が不幸をもたらすか、 それとも新しい機能をもたらすかは、 まさにソースコードを同期した瞬間によるのです! +FreeBSD-CURRENT は FreeBSD の最新のソースコードであり、中には現在開発途上のソフトウェア、実験的な変更、あるいは過渡的な機能などが含まれています。 +また、この中に入っている機能がすべて、次の公式リリースに入るとは限りません。 +FreeBSD-CURRENT をソースからほぼ毎日コンパイルしている人はたくさんいますが、短い期間ではコンパイルさえできない状態になっている時期もあります。 +これらの問題は可能な限り迅速に解決されますが、FreeBSD-CURRENT が不幸をもたらすか、それとも新しい機能をもたらすかは、まさにソースコードを同期した瞬間によるのです! -FreeBSD-CURRENT は、 次の 3 つの重要なグループを対象としています。 +FreeBSD-CURRENT は、次の 3 つの重要なグループを対象としています。 . ソースツリーのある部分に関して活発に作業している FreeBSD コミュニティのメンバ。 . 活発にテストしている FreeBSD コミュニティのメンバ。 彼らは、種々の問題を解決するのに時間を惜しまない人々であり、 さまざまな変更に関する提案や FreeBSD の大まかな方向付けを行ないたいと思っている人々でもあり、 パッチも提出します。 . さまざまな事に目を向け、 参考のために最新のソースを使いたいと思っていたり、 時々コメントやコードを寄稿したいと考えているユーザ。 -FreeBSD-CURRENT は、次のリリースの前に、 最も早く新しい機能を入手する手段として、 期待しては__いけません__。 リリース前の機能は十分にテストされていないため、 バグを含んでいる可能性が大いにあるためです。 また、バグを修正するための素早い方法でもありません。 いかなるコミットは、元からあるバグを修正するのと同じく、 新しいバグを生み出すおそれがあります。 FreeBSD-CURRENT には "公式のサポート" はありません。 +FreeBSD-CURRENT は、次のリリースの前に、最も早く新しい機能を入手する手段として、期待しては__いけません__。 +リリース前の機能は十分にテストされていないため、バグを含んでいる可能性が大いにあるためです。 +また、バグを修正するための素早い方法でもありません。 +いかなるコミットは、元からあるバグを修正するのと同じく、新しいバグを生み出すおそれがあります。 +FreeBSD-CURRENT には "公式のサポート" はありません。 FreeBSD-CURRENT を追いかけるには -. {freebsd-current} と {svn-src-head} メーリングリストに加わってください。 さまざまな人がシステムの現在の状態について述べているコメントを見たり、 FreeBSD-CURRENT の現在の状態に関する重要な情報を見逃さないために、 _必須の_ ことです。 +. {freebsd-current} と {dev-commits-src-main} メーリングリストに加わってください。 +さまざまな人がシステムの現在の状態について述べているコメントを見たり、FreeBSD-CURRENT の現在の状態に関する重要な情報を見逃さないために、 _必須の_ ことです。 + -{svn-src-head} メーリングリストでは、 それぞれの変更についての commit ログが記録されています。 また、それに関して起こり得る副作用の情報を得ることができますので、 参加する価値のあるメーリングリストです。 +{dev-commits-src-main} メーリングリストでは、それぞれの変更についての commit ログが記録されています。 +また、それに関して起こり得る副作用の情報を得ることができますので、参加する価値のあるメーリングリストです。 + -これらのメーリングリストに入るには、 {mailman-lists-url} をたどって参加したいメーリングリストをクリックし、 手順の説明にしたがってください。 FreeBSD-CURRENT だけでなく、 ソースツリー全体の変更点を追いかけるのであれば、 {svn-src-all} メーリングリストを購読してください。 -. FreeBSD-CURRENT のソースを同期してください。 特に crossref:mirrors[svn,svnlite] を使って crossref:mirrors[svn-mirrors,「Subversion ミラーサイト」] の一覧にある Subversion ミラーサイトのひとつの `head` ブランチから -CURRENT コードをチェックアウトしてください。 -. リポジトリのサイズが大きいため、興味のある部分や、 パッチを当てる部分のソースのみを同期するユーザもいます。 しかしながら、 ソースからオペレーティングシステムをコンパイルしようと思っているユーザは、 一部分だけではなく、FreeBSD-CURRENT の _すべて_ をダウンロードする必要があります。 +これらのメーリングリストに入るには、 {mailman-lists} をたどって参加したいメーリングリストをクリックし、手順の説明にしたがってください。 +FreeBSD-CURRENT だけでなく、ソースツリー全体の変更点を追いかけるのであれば、 {dev-commits-src-all} メーリングリストを購読してください。 +. FreeBSD-CURRENT のソースを同期してください。 +特に `git` を使って crossref:mirrors[git-mirrors,「Git ミラーサイト」] の一覧にある Git ミラーサイトのひとつの `main` ブランチから -CURRENT コードをチェックアウトしてください。 +. リポジトリのサイズが大きいため、興味のある部分や、パッチを当てる部分のソースのみを同期するユーザもいます。 +しかしながら、ソースからオペレーティングシステムをコンパイルしようと思っているユーザは、一部分だけではなく、FreeBSD-CURRENT の _すべて_ をダウンロードする必要があります。 + -FreeBSD-CURRENT をコンパイル する前に [.filename]#/usr/src/Makefile# を注意深く読み、 <> に書かれている手順に従ってください。 {freebsd-current} と [.filename]#/usr/src/UPDATING# を読めば、 次のリリースへ向けて移ってゆくに当たって、 ときどき必要となる既存システムからの新システムの構築手順についての最新情報が得られるでしょう。 +FreeBSD-CURRENT をコンパイルする前に [.filename]#/usr/src/Makefile# を注意深く読み、<> に書かれている手順に従ってください。 +{freebsd-current} と [.filename]#/usr/src/UPDATING# を読めば、次のリリースへ向けて移ってゆくに当たって、ときどき必要となる既存システムからの新システムの構築手順についての最新情報が得られるでしょう。 . アクティブになってください! FreeBSD-CURRENT のユーザには、 拡張やバグ潰しに関して提案することが勧められています。 コードを伴う提案はいつでも歓迎されます! [[stable]] === FreeBSD-STABLE を使う -__訳: __ - -FreeBSD-STABLE とは定期的に公開されるリリースを作成するための開発ブランチです。 このブランチに加えられる変更は FreeBSD-CURRENT よりゆっくりで、 原則として、事前に FreeBSD-CURRENT で試験ずみであるという特徴があります。 ただ__そうであっても__、 これは開発用ブランチの一つであり、ある時点における FreeBSD-STABLE のソースがどんな場合にも使えるものであるとは限りません。 このブランチはもう一つの開発の流れというだけであって、 エンドユーザ向けのものではありません。 もし試験をする資源的な余裕がない場合は、代わりに最新の FreeBSD リリースを使ってください。 +FreeBSD-STABLE とは定期的に公開されるリリースを作成するための開発ブランチです。 +このブランチに加えられる変更は FreeBSD-CURRENT よりゆっくりで、原則として、事前に FreeBSD-CURRENT で試験ずみであるという特徴があります。 +ただ__そうであっても__、これは開発用ブランチの一つであり、ある時点における FreeBSD-STABLE のソースがどんな場合にも使えるものであるとは限りません。 +このブランチはもう一つの開発の流れというだけであって、エンドユーザ向けのものではありません。 +もし試験をする資源的な余裕がない場合は、代わりに最新の FreeBSD リリースを使ってください。 -FreeBSD の開発プロセスに興味があったり、 それに対する貢献を考えていて、特にそれが次回の FreeBSD のリリースに関係するものであるなら FreeBSD-STABLE を追うことを考えると良いでしょう。 +FreeBSD の開発プロセスに興味があったり、それに対する貢献を考えていて、特にそれが次回の FreeBSD のリリースに関係するものであるなら FreeBSD-STABLE を追うことを考えると良いでしょう。 -FreeBSD-STABLE ブランチはいつもコンパイルができ、 安定に動作すべきですが、 それが保証されているというわけではありません。 FreeBSD-STABLE のユーザは FreeBSD-CURRENT よりも多いため、FreeBSD-CURRENT で発見されなかったバグが FreeBSD-STABLE で発見され、 ときどきそれが問題となることがあるのは避けることができません。 このような理由から、盲目的に FreeBSD-STABLE を追いかけるべきではありません。 特に、開発環境もしくはテスト環境でコードを十分に試験せずに、 プロダクション品質が要求されるサーバを FreeBSD-STABLE にアップグレードしては__いけません__。 +FreeBSD-STABLE ブランチはいつもコンパイルができ、安定に動作すべきですが、それが保証されているというわけではありません。 +FreeBSD-STABLE のユーザは FreeBSD-CURRENT よりも多いため、FreeBSD-CURRENT で発見されなかったバグが FreeBSD-STABLE で発見され、ときどきそれが問題となることがあるのは避けることができません。 +このような理由から、盲目的に FreeBSD-STABLE を追いかけるべきではありません。 +特に、開発環境もしくはテスト環境でコードを十分に試験せずに、プロダクション品質が要求されるサーバを FreeBSD-STABLE にアップグレードしては__いけません__。 FreeBSD-STABLE を追いかけるには -. FreeBSD-STABLE の構築に関連する事柄や、 その他の注意すべき点 に関する情報を得るために、 {freebsd-stable} メーリングリストに加わってください。 また開発者は議論の余地がある修正や変更を考えている場合に、 このメーリングリストで公表し、 提案された変更に関して問題が生じるかどうかを返答する機会をユーザに与えます。 +. FreeBSD-STABLE の構築に関連する事柄や、その他の注意すべき点 に関する情報を得るために、 {freebsd-stable} メーリングリストに加わってください。 +また開発者は議論の余地がある修正や変更を考えている場合に、このメーリングリストで公表し、提案された変更に関して問題が生じるかどうかを返答する機会をユーザに与えます。 + -追いかけているブランチに関連する svn メーリングリストに参加してください。 たとえば、9-STABLE ブランチを追いかけているユーザは {svn-src-stable-9} メーリングリストに参加してください。 このリストでは、変更がなされるごとに作成される commit log やそれに伴う起こりうる副作用についての情報が記録されています。 +追いかけているブランチに関連する git メーリングリストに参加してください。 +たとえば、{betarel-current-major}-STABLE ブランチを追いかけているユーザは {dev-commits-src-branches} メーリングリストに参加してください。 +このリストでは、変更がなされるごとに作成される commit log やそれに伴う起こりうる副作用についての情報が記録されています。 + -これらのメーリングリストに入るには、{mailman-lists-url} をたどって参加したいメーリングリストをクリックし、 手順の説明にしたがってください。 ソースツリー全体の変更点を追いかけるには、 {svn-src-all} メーリングリストを購読してください。 -. 新しい FreeBSD-STABLE システムをインストールするには、 crossref:mirrors[mirrors,ミラーサイト] から最近の FreeBSD-STABLE リリースをインストールするか、 毎月公開されている FreeBSD-STABLE からビルドされたスナップショットを使ってください。 スナップショットの詳細については、link:https://www.FreeBSD.org/ja/snapshots/[www.freebsd.org/ja/snapshots] をご覧ください。 +これらのメーリングリストに入るには、 {mailman-lists} をたどって参加したいメーリングリストをクリックし、手順の説明にしたがってください。 +ソースツリー全体の変更点を追いかけるには、 {dev-commits-src-all} メーリングリストを購読してください。 +. 新しい FreeBSD-STABLE システムをインストールするには、 crossref:mirrors[mirrors,ミラーサイト] から最近の FreeBSD-STABLE リリースをインストールするか、毎月公開されている FreeBSD-STABLE からビルドされたスナップショットを使ってください。 +スナップショットの詳細については、link:https://www.FreeBSD.org/ja/snapshots/[www.freebsd.org/ja/snapshots] をご覧ください。 + -既に FreeBSD が動いているシステムを FreeBSD-STABLE にアップグレードするには、 crossref:mirrors[svn,svn] を使って、 希望する開発ブランチのソースをチェックアウしてください。 `stable/9` といったブランチ名は、 link:https://www.FreeBSD.org/releng/[www.freebsd.org/releng] で説明されています。 -. FreeBSD-STABLE をコンパイルしたり FreeBSD-STABLE へとアップグレード する前に、 [.filename]#/usr/src/Makefile# を注意深く読み、 <> に書かれている手順に従ってください。 {freebsd-stable} と [.filename]#/usr/src/UPDATING# を読んで、 次のリリースへ向けて移ってゆくに当たって、 ときどき必要となる既存システムからの新システムの構築手順についての最新情報を得てください。 +既に FreeBSD が動いているシステムを FreeBSD-STABLE にアップグレードするには、 crossref:mirrors[svn,svn] を使って、希望する開発ブランチのソースをチェックアウしてください。 +`stable/9` といったブランチ名は、link:https://www.FreeBSD.org/releng/[www.freebsd.org/releng] で説明されています。 +. FreeBSD-STABLE をコンパイルしたり FreeBSD-STABLE へとアップグレードする前に、 [.filename]#/usr/src/Makefile# を注意深く読み、 <> に書かれている手順に従ってください。 +{freebsd-stable} と [.filename]#/usr/src/UPDATING# を読んで、次のリリースへ向けて移ってゆくに当たって、ときどき必要となる既存システムからの新システムの構築手順についての最新情報を得てください。 [[makeworld]] == ソースを用いた FreeBSD のアップデート -ソースをコンパイルしてFreeBSD をアップデートする方法は、 バイナリを用いたアップデートに比べ、いくつもの利点があります。 特定のハードウェアをうまく利用するためのオプションを設定してコードを構築できます。 ベースシステムの特定の箇所の設定をデフォルトの設定から変更したり、 必要がない部分を完全に削除して構築することもできます。 システムを構築することによるアップデートは、 バイナリアップデートをインストールするだけのアップデートに比べ時間がかかりますが、 利用環境に合わせた FreeBSD を作成するような完全なカスタマイズが可能です。 +ソースをコンパイルしてFreeBSD をアップデートする方法は、 バイナリを用いたアップデートに比べ、いくつもの利点があります。 特定のハードウェアをうまく利用するためのオプションを設定してコードを構築できます。 +ベースシステムの特定の箇所の設定をデフォルトの設定から変更したり、必要がない部分を完全に削除して構築することもできます。 +システムを構築することによるアップデートは、バイナリアップデートをインストールするだけのアップデートに比べ時間がかかりますが、利用環境に合わせた FreeBSD を作成するような完全なカスタマイズが可能です。 [[updating-src-quick-start]] === クィックスタート @@ -602,7 +616,7 @@ FreeBSD-STABLE を追いかけるには + [source,shell] .... -# svnlite update /usr/src <.> +# git pull /usr/src <.> check /usr/src/UPDATING <.> # cd /usr/src <.> # make -j4 buildworld <.> @@ -614,7 +628,7 @@ check /usr/src/UPDATING <.> # shutdown -r now <.> .... -<.> +最新版のソースを入手してください。 ソースの入手およびアップデートに関する情報については <> をご覧ください。 +<.> 最新版のソースを入手してください。 ソースの入手およびアップデートに関する情報については <> をご覧ください。 <.> ソースの構築の前後で必要となる手動の作業について、 [.filename]#/usr/src/UPDATING# を確認してください。 @@ -643,32 +657,36 @@ check /usr/src/UPDATING <.> [[updating-src-obtaining-src]] === ソースコードのアップデート -FreeBSD のソースコードは [.filename]#/usr/src/# に置かれています。 このソースコードのアップデートには、 Subversion バージョン管理システムを利用する方法が推奨されています。まず、 ソースコードがバージョン管理下にあることを確認してください。 +FreeBSD のソースコードは [.filename]#/usr/src/# に置かれています。 +このソースコードのアップデートには、Git バージョン管理システムを利用する方法が推奨されています。 +まず、ソースコードがバージョン管理下にあることを確認してください。 [source,shell] .... -# svnlite info /usr/src -Path: /usr/src -Working Copy Root Path: /usr/src +# cd /usr/src +# git remote --v +origin ssh://git@gitrepo.FreeBSD.org/doc.git (fetch) +origin ssh://git@gitrepo.FreeBSD.org/doc.git (push) ... .... -この結果は、[.filename]#/usr/src/# がバージョン管理下にあり、man:svnlite[1] を使ってアップデートできることを示しています。 +この結果は、[.filename]#/usr/src/# がバージョン管理下にあり、man:git[1] を使ってアップデートできることを示しています。 [source,shell] .... -# svnlite update /usr/src +# git pull /usr/src .... -このディレクトリをアップデートしていない期間が長いと、 アップデートのプロセスには時間がかかります。 このプロセスが終わると、ソースコードは最新となり、 次節以降で説明する構築のプロセスを実行できます。 +このディレクトリをアップデートしていない期間が長いと、アップデートのプロセスには時間がかかります。 +このプロセスが終わると、ソースコードは最新となり、次節以降で説明する構築のプロセスを実行できます。 .ソースコードの入手 [NOTE] ==== -`'/usr/src' is not a working copy` という出力が出た場合には、 ファイルがなかったり、別な方法によりインストールされているので、 新しくソースコードをチェックアウトする必要があります。 +`fatal: not a git repository` という出力が出た場合には、ファイルがなかったり、別な方法によりインストールされているので、新しくソースコードをチェックアウトする必要があります。 [[updating-src-obtaining-src-repopath]] -.FreeBSD のバージョンおよびリポジトリパス +.FreeBSD のバージョンおよびリポジトリブランチ [cols="1,1,1", options="header"] |=== | uname -r の出力 @@ -676,11 +694,11 @@ Working Copy Root Path: /usr/src | 説明 |`_X.Y_-RELEASE` -|``base/releng/``_X.Y_ +|`releng/_X.Y_` |このリリースバージョンに対する重大なセキュルティへの対応およびバグの修正パッチのみが適用されています。 このブランチは、ほとんどのユーザに推奨されます。 |`_X.Y_-STABLE` -|``base/stable/``_X_ +|`stable/_X_` | リリースバージョンに対し、 そのブランチにおけるすべての開発の成果が反映されたものです。 _STABLE_ は、 Applications Binary Interface (ABI) が変更されないことを意味しており、 このブランチの以前のバージョンでコンパイルされたソフトウェアは、 このバージョンでも実行できることを意味しています。 たとえば、FreeBSD 10.1 で実行するようにコンパイルされたソフトウェアは、 FreeBSD 10-STABLE においても実行できます。 @@ -688,7 +706,7 @@ Working Copy Root Path: /usr/src STABLE ブランチは、 時期によってはユーザに影響するようなバグや非互換性を持つことがあります。 これらは通常すぐに修正されます。 |`_X_-CURRENT` -|`base/head/` +|`main` |リリースが行われていない最新の FreeBSD の開発バージョンです。 CURRENT ブランチは大きなバグや非互換があることもあるので、 高度な知識を持ったユーザのみ使用が推奨されます。 |=== @@ -700,12 +718,13 @@ man:uname[1] を使って FreeBSD のバージョンを確認してください 10.3-RELEASE .... -<> から分かるように、`10.3-RELEASE` のアップデートのためのソースコードのパスは、 `base/releng/10.3` です。 このパスは、ソースコードをチェックアウトする時に使います。 +<> から分かるように、`10.3-RELEASE` のアップデートのためのソースコードのパスは、`releng/10.3` です。 +このパスは、ソースコードをチェックアウトする時に使います。 [source,shell] .... # mv /usr/src /usr/src.bak <.> -# svnlite checkout https://svn.freebsd.org/base/releng/10.3 /usr/src <.> +# git clone --branch releng/10.3 ssh://git@gitrepo.FreeBSD.org/src.git /usr/src <.> .... <.> この古いディレクトリを、 邪魔にならないように移動してください。 このディレクトリ以下に対して変更を行ってなければ、 削除しても構わないでしょう。 @@ -715,7 +734,9 @@ man:uname[1] を使って FreeBSD のバージョンを確認してください [[updating-src-building]] === ソースからの構築 -まず最初に _world_ (カーネルを除くオペレーティングシステムのすべて) をコンパイルします。 このステップを最初に実行するのは、 カーネルの構築を最新のツールを使って行うようにするためです。 このステップが終わったら、カーネルそのものを構築します。 +まず最初に _world_ (カーネルを除くオペレーティングシステムのすべて) をコンパイルします。 +このステップを最初に実行するのは、カーネルの構築を最新のツールを使って行うようにするためです。 +このステップが終わったら、カーネルそのものを構築します。 [source,shell] .... @@ -731,7 +752,9 @@ man:uname[1] を使って FreeBSD のバージョンを確認してください [[updating-src-building-clean-build]] ==== クリーンビルドの実行 -FreeBSD ビルドシステムのいくつかのバージョンは、 オブジェクトが一時的に置かれるディレクトリ [.filename]#/usr/obj# に前回のコンパイルされたコードを残します。 これにより、変更されていないコードを再コンパイルせずにすむので、 その後の構築時間を短縮できます。 すべてを再構築するには、構築を開始する前に、 `cleanworld` を実行してください。 +FreeBSD ビルドシステムのいくつかのバージョンは、オブジェクトが一時的に置かれるディレクトリ [.filename]#/usr/obj# に前回のコンパイルされたコードを残します。 +これにより、変更されていないコードを再コンパイルせずにすむので、その後の構築時間を短縮できます。 +すべてを再構築するには、構築を開始する前に、`cleanworld` を実行してください。 [source,shell] .... @@ -741,7 +764,11 @@ FreeBSD ビルドシステムのいくつかのバージョンは、 オブジ [[updating-src-building-jobs]] ==== ジョブの数の設定 -マルチコアプロセッサを搭載するシステムでは、 構築のためのジョブの数を増やすことで、 構築にかかる時間を短縮できます。 `sysctl hw.ncpu` を使って、 コアの数を確認してください。 ジョブの数がどのように構築の速さに影響するかを確実に知るには、 プロセッサにより異なりますし、FreeBSD のバージョンにより使用されるビルドシステムも変わるため、 実際に試してみるしか方法はありません。 試してみる最初のジョブの数の候補としては、 コアの数の半分から倍の数の間で検討してみてください。 ジョブの数は、`-j` を使って指定します。 +マルチコアプロセッサを搭載するシステムでは、構築のためのジョブの数を増やすことで、構築にかかる時間を短縮できます。 +`sysctl hw.ncpu` を使って、コアの数を確認してください。 +ジョブの数がどのように構築の速さに影響するかを確実に知るには、プロセッサにより異なりますし、FreeBSD のバージョンにより使用されるビルドシステムも変わるため、実際に試してみるしか方法はありません。 +試してみる最初のジョブの数の候補としては、コアの数の半分から倍の数の間で検討してみてください。 +ジョブの数は、`-j` を使って指定します。 [[updating-src-building-jobs-example]] .構築のジョブの数を増やす @@ -759,7 +786,9 @@ FreeBSD ビルドシステムのいくつかのバージョンは、 オブジ [[updating-src-building-only-kernel]] ==== カーネルのみを構築する -ソースコードが変更された場合には、 `buildworld` を完了しなければいけません。 その後、いつでも `buildkernel` でカーネルを構築できます。 カーネルだけを構築するには、以下のように実行してください。 +ソースコードが変更された場合には、`buildworld` を完了しなければいけません。 +その後、いつでも `buildkernel` でカーネルを構築できます。 +カーネルだけを構築するには、以下のように実行してください。 [source,shell] .... @@ -770,7 +799,9 @@ FreeBSD ビルドシステムのいくつかのバージョンは、 オブジ [[updating-src-building-custom-kernel]] ==== カスタムカーネルの構築 -FreeBSD 標準のカーネルは、 [.filename]#GENERIC# と呼ばれる _カーネルコンフィグレーションファイル_ に基づいています。 [.filename]#GENERIC# カーネルには、 最も良く使われるデバイスドライバやオプションが含まれています。 しかしながら、 特定の目的に合わせてデバイスドライバやオプションを削除したり追加するためには、 カスタムカーネルを構築することが有用であったり、 必要となることがあります。 +FreeBSD 標準のカーネルは、[.filename]#GENERIC# と呼ばれる _カーネルコンフィグレーションファイル_ に基づいています。 +[.filename]#GENERIC# カーネルには、最も良く使われるデバイスドライバやオプションが含まれています。 +しかしながら、特定の目的に合わせてデバイスドライバやオプションを削除したり追加するためには、カスタムカーネルを構築することが有用であったり、必要となることがあります。 たとえば、極端に RAM が制限されているような小さな組み込みのコンピュータを開発しているユーザであれば、 必要のないデバイスドライバやオプションを削除することで、 カーネルを少しでも小さくできるでしょう。 @@ -778,10 +809,13 @@ FreeBSD 標準のカーネルは、 [.filename]#GENERIC# と呼ばれる _カー [TIP] ==== -[.filename]#/usr/src# は、 削除されたり作り直されたりする可能性があるため、 カスタムカーネルのコンフィグレーションファイルは、 [.filename]#/root# のような別のディレクトリで管理することが好ましいです。 カーネルコンフィグレーションファイルは、 [.filename]#conf# ディレクトリにリンクします。 このディレクトリが削除されたり、上書きされた場合には、 カーネルコンフィグレーションファイルを新しいディレクトリにもう一度リンクしてください。 +[.filename]#/usr/src# は、削除されたり作り直されたりする可能性があるため、カスタムカーネルのコンフィグレーションファイルは、[.filename]#/root# のような別のディレクトリで管理することが好ましいです。 +カーネルコンフィグレーションファイルは、[.filename]#conf# ディレクトリにリンクします。 +このディレクトリが削除されたり、上書きされた場合には、カーネルコンフィグレーションファイルを新しいディレクトリにもう一度リンクしてください。 ==== -カスタムコンフィグレーションファイルは、 [.filename]#GENERIC# コンフィグレーションファイルをコピーして作成できます。 たとえば、 ストレージサーバ用の [.filename]#STORAGESERVER# という名前の新しいカスタムカーネルは、 以下のようにして作成できます。 +カスタムコンフィグレーションファイルは、[.filename]#GENERIC# コンフィグレーションファイルをコピーして作成できます。 +たとえば、ストレージサーバ用の [.filename]#STORAGESERVER# という名前の新しいカスタムカーネルは、以下のようにして作成できます。 [source,shell] .... @@ -829,12 +863,13 @@ FreeBSD 標準のカーネルは、 [.filename]#GENERIC# と呼ばれる _カー [[updating-src-completing]] === アップデートの完了 -アップデートの完了までに、いくつかの最終作業が残されています。 デフォルトから変更した設定ファイルを新しいバージョンのファイルにマージし、 古くなったライブラリを見つけて削除した後に、 システムを再起動します。 +アップデートの完了までに、いくつかの最終作業が残されています。 +デフォルトから変更した設定ファイルを新しいバージョンのファイルにマージし、古くなったライブラリを見つけて削除した後に、システムを再起動します。 [[updating-src-completing-merge-mergemaster]] ==== man:mergemaster[8] を用いた設定ファイルのマージ -man:mergemaster[8] を用いることで、 システムの設定ファイルに行われている変更を、 簡単にこれらのファイルの新しいバージョンにマージできます。 +man:mergemaster[8] を用いることで、システムの設定ファイルに行われている変更を、 簡単にこれらのファイルの新しいバージョンにマージできます。 `-Ui` オプションを使って man:mergemaster[8] を実行すると、 ユーザが手を加えていないファイルのアップデートおよび新しく追加されたファイルのインストールを自動的に行います。 @@ -843,12 +878,14 @@ man:mergemaster[8] を用いることで、 システムの設定ファイルに # mergemaster -Ui .... -ファイルのマージを手動で行う必要がある時は、 ファイルの中で残す箇所の選択を対話的におこなうようなインタフェースが表示さます。 詳細については、man:mergemaster[8] をご覧ください。 +ファイルのマージを手動で行う必要がある時は、ファイルの中で残す箇所の選択を対話的におこなうようなインタフェースが表示さます。 +詳細については、man:mergemaster[8] をご覧ください。 [[updating-src-completing-check-old]] ==== 使われなくなったファイルやライブラリの確認 -アップデート後に、 使われなくなったファイルやディレクトリが残ることがあります。 これらのファイルは、 +アップデート後に、使われなくなったファイルやディレクトリが残ることがあります。 +これらのファイルは、 [source,shell] .... @@ -876,12 +913,14 @@ man:mergemaster[8] を用いることで、 システムの設定ファイルに # make delete-old-libs .... -これらの古いライブラリを利用しているプログラムは、 ライブラリが削除されると動かなくなります。 これらのプログラムは、古いライブラリを削除した後に、 再構築もしくは置き換える必要があります。 +これらの古いライブラリを利用しているプログラムは、ライブラリが削除されると動かなくなります。 +これらのプログラムは、古いライブラリを削除した後に、再構築もしくは置き換える必要があります。 [TIP] ==== -古いファイルとディレクトリのすべてを削除しても問題ないことを確認したら、 コマンドに `BATCH_DELETE_OLD_FILES` を設定することで、各ファイルを削除する際に kbd:[y] および kbd:[Enter] を押さなくても済むようにできます。以下はその例です。 +古いファイルとディレクトリのすべてを削除しても問題ないことを確認したら、コマンドに `BATCH_DELETE_OLD_FILES` を設定することで、各ファイルを削除する際に kbd:[y] および kbd:[Enter] を押さなくても済むようにできます。 +以下はその例です。 [source,shell] .... @@ -903,18 +942,43 @@ man:mergemaster[8] を用いることで、 システムの設定ファイルに [[small-lan]] == 複数のマシンで追いかける -複数のコンピュータで同じソースツリーを追いかけていて、 全部のマシンにソースをダウンロードして全部を再構築するのは、 ディスクスペース、ネットワーク帯域、 そして CPU サイクルの無駄使いです。 解決策は 1 つのマシンに仕事のほとんどをさせ、 残りのマシンは NFS 経由でそれをマウントする、というものです。 このセクションではそのやり方を概観します。 NFS の使い方の詳細については、crossref:advanced-networking[network-nfs,「NFS」] をご覧下さい。 - -まず初めに、同じバイナリで動かそうとするマシンたちを決めます。 このマシンたちのことを__ビルドセット__と呼びます。 それぞれのマシンはカスタムカーネルを持っているかもしれませんが、 同じユーザランドバイナリを動かそうというのです。 このビルドセットから、 __ビルドマシン__となるマシンを 1 台選びます。 ベースシステムとカーネルを構築するのはこのマシンになります。 理想的には、このマシンは `make buildworld` と `make buildkernel` を実行するのに十分な CPU を持った速いマシンであるべきです。 - -_テストマシン_ となるべきマシンも選んでください。 更新されたソフトウェアを使う前にそのマシンでテストするのです。 テストマシンはかなり長い時間落ちていても だいじょうぶなマシン__であったほうがいいでしょう__。 ビルドマシンでもかまいませんが、 ビルドマシンである必要はありません。 - -このビルドセットのマシンはすべて [.filename]#/usr/obj# と [.filename]#/usr/src# をビルドマシンから FTP 経由でマウントする必要があります。 ビルドセット自体が複数ある場合は、 [.filename]#/usr/src# はひとつのビルドマシン上にあるべきです。 他のマシンからはそれを NFS マウントするようにしましょう。 - -ビルドセットのすべてのマシン上の [.filename]#/etc/make.conf# と [.filename]#/etc/src.conf# がビルドマシンと一致していることを確認してください。つまり、 ビルドマシンはビルドセットのどのマシンもインストールしようとしている ベースシステムを全部ビルドしなければならないということです。 また、各ビルドマシンは [.filename]#/etc/make.conf# にそれぞれのビルドマシンのカーネル名を `KERNCONF` で指定し、 ビルドマシンは自分自身のカーネルから順に全部のカーネル名を `KERNCONF` にリストアップしてください。 ビルドマシンは各マシンのカーネル設定ファイルを [.filename]#/usr/src/sys/arch/conf# に持っていなければなりません。 - -ビルドマシンにて、 <> に書いてあるようにカーネルとベースシステムを構築してください。 でも、まだビルドマシンにはインストールしないでください。 そのかわり、 ビルドしたカーネルをテストマシンにインストールしてください。 FTP 経由で [.filename]#/usr/src# および [.filename]#/usr/obj# をテストマシンにマウントしてください。 その後、`shutdown now` を実行してシングルユーザモードに移行し、 新しいカーネルとベースシステムをインストールし、 いつもするように `mergemaster` を実行してください。 終わったら、再起動して通常のマルチユーザ動作に戻します。 - -テストマシンにあるものすべてがちゃんと動いている確信が得られたら、 同じ手順でビルドセットの他のマシンにも新しいソフトウェアをインストールします。 - -ports ツリーにも同じ方法が使えます。 最初のステップは、 ビルドセットのすべてのマシンが NFS 経由で [.filename]#/usr/ports# をマウントすることです。 そして、distfiles を共有するように [.filename]#/etc/make.conf# を設定します。 NFS マウントによってマップされる `root` ユーザが何であれ、`DISTDIR` はそのユーザが書き込める共通の共有ディレクトリに設定する必要があります。 ports をローカルでビルドする場合には、 各マシンは `WRKDIRPREFIX` を自分のマシンのビルドディレクトリに設定しなければなりません。 また、ビルドシステムが packages をビルドしてビルドセットのコンピュータに配布するのであれば、 `DISTDIR` と同じようにビルドシステム上の `PACKAGES` ディレクトリも設定してください。 +複数のコンピュータで同じソースツリーを追いかけていて、全部のマシンにソースをダウンロードして全部を再構築するのは、ディスクスペース、ネットワーク帯域、そして CPU サイクルの無駄使いです。 +解決策は 1 つのマシンに仕事のほとんどをさせ、残りのマシンは NFS 経由でそれをマウントする、というものです。 +このセクションではそのやり方を概観します。NFS の使い方の詳細については、crossref:advanced-networking[network-nfs,「NFS」] をご覧下さい。 + +まず初めに、同じバイナリで動かそうとするマシンたちを決めます。 +このマシンたちのことを__ビルドセット__と呼びます。 +それぞれのマシンはカスタムカーネルを持っているかもしれませんが、同じユーザランドバイナリを動かそうというのです。 +このビルドセットから、 __ビルドマシン__となるマシンを 1 台選びます。 +ベースシステムとカーネルを構築するのはこのマシンになります。 +理想的には、このマシンは `make buildworld` と `make buildkernel` を実行するのに十分な CPU を持った速いマシンであるべきです。 + +_テストマシン_ となるべきマシンも選んでください。 +更新されたソフトウェアを使う前にそのマシンでテストするのです。 +テストマシンはかなり長い時間落ちていても だいじょうぶなマシン__であったほうがいいでしょう__。 +ビルドマシンでもかまいませんが、ビルドマシンである必要はありません。 + +このビルドセットのマシンはすべて [.filename]#/usr/obj# と [.filename]#/usr/src# をビルドマシンから FTP 経由でマウントする必要があります。 +ビルドセット自体が複数ある場合は、[.filename]#/usr/src# はひとつのビルドマシン上にあるべきです。 +他のマシンからはそれを NFS マウントするようにしましょう。 + +ビルドセットのすべてのマシン上の [.filename]#/etc/make.conf# と [.filename]#/etc/src.conf# がビルドマシンと一致していることを確認してください。 +つまり、ビルドマシンはビルドセットのどのマシンもインストールしようとしているベースシステムを全部ビルドしなければならないということです。 +また、各ビルドマシンは [.filename]#/etc/make.conf# にそれぞれのビルドマシンのカーネル名を `KERNCONF` で指定し、ビルドマシンは自分自身のカーネルから順に全部のカーネル名を `KERNCONF` にリストアップしてください。 +ビルドマシンは各マシンのカーネル設定ファイルを [.filename]#/usr/src/sys/arch/conf# に持っていなければなりません。 + +ビルドマシンにて、<> に書いてあるようにカーネルとベースシステムを構築してください。 +でも、まだビルドマシンにはインストールしないでください。 +そのかわり、ビルドしたカーネルをテストマシンにインストールしてください。 +FTP 経由で [.filename]#/usr/src# および [.filename]#/usr/obj# をテストマシンにマウントしてください。 +その後、`shutdown now` を実行してシングルユーザモードに移行し、新しいカーネルとベースシステムをインストールし、いつもするように `mergemaster` を実行してください。 +終わったら、再起動して通常のマルチユーザ動作に戻します。 + +テストマシンにあるものすべてがちゃんと動いている確信が得られたら、同じ手順でビルドセットの他のマシンにも新しいソフトウェアをインストールします。 + +ports ツリーにも同じ方法が使えます。 *** 5 LINES SKIPPED *** From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 12:56:34 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 6EA015F52B1 for ; Tue, 20 Apr 2021 12:56:34 +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 4FPkGB2gB7z4hpV; Tue, 20 Apr 2021 12:56:34 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 4E5AB12CFF; Tue, 20 Apr 2021 12:56:34 +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 13KCuYO6005719; Tue, 20 Apr 2021 12:56:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KCuYAl005718; Tue, 20 Apr 2021 12:56:34 GMT (envelope-from git) Date: Tue, 20 Apr 2021 12:56:34 GMT Message-Id: <202104201256.13KCuYAl005718@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: a527f32556 - main - committers-guide: Bring back MFH metadata field MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a527f3255652174c5a4ac7acdea672ed2a95b21c Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 12:56:34 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=a527f3255652174c5a4ac7acdea672ed2a95b21c commit a527f3255652174c5a4ac7acdea672ed2a95b21c Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-20 12:42:40 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 12:56:44 +0000 committers-guide: Bring back MFH metadata field The MFH field is still useful to note that the commit is going to be merged into a quarterly branch. Reported by: mat Reviewed by: mat Differential Revision: https://reviews.freebsd.org/D29862 --- documentation/content/en/articles/committers-guide/_index.adoc | 3 +++ 1 file changed, 3 insertions(+) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index f0548fbce5..08968c1516 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2584,6 +2584,9 @@ Approved by: re (username) |`MFC with:` |If the commit should be merged together with a previous one in a single MFC commit (for example, where this commit corrects a bug in the previous change), specify the corresponding Git hash. +|`MFH:` +|If the commit is to be merged into a ports quarterly branch name, specify the quarterly branch. For example `2021Q2`. + |`Relnotes:` |If the change is a candidate for inclusion in the release notes for the next release from the branch, set to `yes`. From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 13:15:48 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id B02685F59D4 for ; Tue, 20 Apr 2021 13:15:48 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: from mail-yb1-xb34.google.com (mail-yb1-xb34.google.com [IPv6:2607:f8b0:4864:20::b34]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FPkhN4QDvz4k6Z; Tue, 20 Apr 2021 13:15:48 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: by mail-yb1-xb34.google.com with SMTP id v3so40567034ybi.1; Tue, 20 Apr 2021 06:15:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=LsfZdKrS5aieasB1vnEL+JEND1nPQi6Z9cwYcAFaqWw=; b=pq8BuhHgq/3FoIoEbXhuGFJxnR8yMMqIMlPKQPG0+XyqJknXVjlc7f7jO8fVzQ2368 pU3x+2EEjLs35Y1zfEhtawlfBRC1ahIV7x6AksJab9tTVhGnJj1Yzh4czNS3L5maW9WY WYEXU3nEdTC3Y4mJWVjHbAfZJOcHAixWvPWdg3N71269TqcSYu/d72rU9Uxt8qTTnkUT Cm0wobCrZgzSFIDH4m9rAuwhR2ltzXKGgkV0mUjomD2ObH7s5GYVxWERW9j6jxm2iLyQ Ytt9oRI+rctvXmGGF7sdu0KhF81abE31zjA+g4A7XJMhd1EWgvvM8oX7qvrDJtQai2Nh eAVA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=LsfZdKrS5aieasB1vnEL+JEND1nPQi6Z9cwYcAFaqWw=; b=anUVPeOmaMa7LIA40PQB4BMmZ8n8mY14Ergv2rcCIVXpb41T6p/TLCy0HOvZkk2WXV KHX9jD7T/HRMfsuQmnwFl7LjmlDcI07w8w9/35HJ+031bP16IvQPGfToD07fFESuaegX S0okVHHnAbpFlbqG5JXhQaWVhmhFcW/o5f6Ao6wVZdRHyc07BPyH2Ab+5dgaLHxfcg/B 8hEagH7crIPxuHezVNEo9OzD5ecLXievlaCNOskqq+is2jhonG2jJZDLv/DXdTlofgO0 UP2BXuByIkT1MF99xxIkrrKpf4Jkz1xKBMpmzV/M6WbeBun7ff4jnXxGTkPWTSDzfW6y GFTA== X-Gm-Message-State: AOAM532QH+MTZ+CYTG03CVTF8EUjqhPw8+JGVQJqPS0/3JxlF3+iYBNQ QMGvN6zR8ii46vH8U6tewQRMFXRtjbuArDSwufgyXUrQ/JNBcw== X-Google-Smtp-Source: ABdhPJy5RrSYv0iLZjlfmPNJ4Lub6BxGQSAKWW+2rDPviq2R5DHQo/YzHduuBQ35b1PEBewS9SPnDE5REGgGmDEeKe8= X-Received: by 2002:a05:6902:532:: with SMTP id y18mr24316400ybs.377.1618924546519; Tue, 20 Apr 2021 06:15:46 -0700 (PDT) MIME-Version: 1.0 References: <202104201032.13KAWNFn016258@gitrepo.freebsd.org> <20210420122849.rh5v2kohzvkxs4uu@aching.in.mat.cc> <3252cd06-4140-0bc2-e958-983b4a2453c2@FreeBSD.org> In-Reply-To: <3252cd06-4140-0bc2-e958-983b4a2453c2@FreeBSD.org> From: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= Date: Tue, 20 Apr 2021 15:12:18 +0200 Message-ID: Subject: Re: git: ceee1def00 - main - articles/committers-guide: Document change in MFH policy To: Mateusz Piotrowski <0mp@freebsd.org> Cc: Mathieu Arnold , doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 4FPkhN4QDvz4k6Z X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; TAGGED_FROM(0.00)[] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 13:15:48 -0000 On Tue, Apr 20, 2021 at 2:39 PM Mateusz Piotrowski <0mp@freebsd.org> wrote: > > On 20/04/2021 14:28, Mathieu Arnold wrote: > > On Tue, Apr 20, 2021 at 10:32:23AM +0000, Mateusz Piotrowski wrote: > >> The branch main has been updated by 0mp: > >> > >> URL: https://cgit.FreeBSD.org/doc/commit/?id=ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 > >> > >> commit ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 > >> Author: Mateusz Piotrowski <0mp@FreeBSD.org> > >> AuthorDate: 2021-04-20 10:14:58 +0000 > >> Commit: Mateusz Piotrowski <0mp@FreeBSD.org> > >> CommitDate: 2021-04-20 10:14:58 +0000 > >> > >> articles/committers-guide: Document change in MFH policy > >> > >> Merging commits into the quarterly branch no longer requires an explicit > >> approval [1]. Let's remove outdated documentation and leave a note > >> explaining that there is no need for an explicit approval to MFH. > > Note that the MFH line should still be used to note intent. > Hmm, true. It does make sense to leave MFH in the table of metadata fields for this use case. I'll > bring back the MFH entry with an updated definition. The template still says: # MFH: Maybe something like "State your intention to merge this change" would be more appropriate. From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 14:46:05 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id B3F085D9AAF for ; Tue, 20 Apr 2021 14:46:05 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: from mail-ej1-f42.google.com (mail-ej1-f42.google.com [209.85.218.42]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FPmhX3SCjz4pgT; Tue, 20 Apr 2021 14:46:04 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: by mail-ej1-f42.google.com with SMTP id u21so58702375ejo.13; Tue, 20 Apr 2021 07:46:04 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=qWoqy/0FAcV24fKxqQNNlGMHjBzk4tcQ2OM9SVKLOhM=; b=E00zN2K48KJSKaqazT4srCEZwzGzxFnlG8lD7JCDg78FVBtwuQKmWL37HTVy8TVcuL YCuoyJJUpHTaL2YicGR9s4YZ4uyfd0L2Do+kj0VE/kx10lo8mpkgzd6h6Lqn01TVv0QP 5FmFg8AnDBOg8uVFhrsNd1MtWOoUPbbEE4vuH7YRLAuMDB5XfIFDJsIGHHbi1rnbW7Xv YrI3Us5Ipgtec4b3cLkx67Fa2Vx7CSIwl1AaIaIlo6r/nHOtONEBDQrPGKMxu2AfQmDv oda4T/ljfmhLhhEtqFUosMqou0yH1zPwLFLXy9jBZ/a/6vaS1t66KMUQqIppwvIxAbG/ V9zQ== X-Gm-Message-State: AOAM533lKa6IXU5vTqtFeC98CjLqSzIuKRx/QoNFH0j9oFgUfS83CwYl LkazJ0lRQ1jtA++vPseZy68dKY6shaJcg2hj X-Google-Smtp-Source: ABdhPJwWUaXDyyUa1xqge0ctl+9ckOj7wSB/dEgRyvoyupzX9H5c7SLpFg/M6poKQsF2uvcZLIAOQA== X-Received: by 2002:a17:906:6a49:: with SMTP id n9mr28005809ejs.397.1618929963024; Tue, 20 Apr 2021 07:46:03 -0700 (PDT) Received: from [192.168.0.106] (ip5f5bd493.dynamic.kabel-deutschland.de. [95.91.212.147]) by smtp.gmail.com with ESMTPSA id x7sm15927382eds.67.2021.04.20.07.46.01 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 20 Apr 2021 07:46:02 -0700 (PDT) Subject: Re: git: ceee1def00 - main - articles/committers-guide: Document change in MFH policy To: =?UTF-8?Q?Fernando_Apestegu=c3=ada?= Cc: Mathieu Arnold , doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org References: <202104201032.13KAWNFn016258@gitrepo.freebsd.org> <20210420122849.rh5v2kohzvkxs4uu@aching.in.mat.cc> <3252cd06-4140-0bc2-e958-983b4a2453c2@FreeBSD.org> From: Mateusz Piotrowski <0mp@FreeBSD.org> Message-ID: Date: Tue, 20 Apr 2021 16:46:13 +0200 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:78.0) Gecko/20100101 Thunderbird/78.9.1 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Content-Language: en-US X-Rspamd-Queue-Id: 4FPmhX3SCjz4pgT X-Spamd-Bar: -- Authentication-Results: mx1.freebsd.org; dkim=none; dmarc=none; spf=pass (mx1.freebsd.org: domain of mpp302@gmail.com designates 209.85.218.42 as permitted sender) smtp.mailfrom=mpp302@gmail.com X-Spamd-Result: default: False [-2.88 / 15.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; TO_DN_SOME(0.00)[]; RWL_MAILSPIKE_GOOD(0.00)[209.85.218.42:from]; R_SPF_ALLOW(-0.20)[+ip4:209.85.128.0/17]; RCVD_COUNT_THREE(0.00)[3]; NEURAL_HAM_SHORT(-0.88)[-0.880]; FREEMAIL_TO(0.00)[gmail.com]; FORGED_SENDER(0.30)[0mp@FreeBSD.org,mpp302@gmail.com]; RECEIVED_SPAMHAUS_PBL(0.00)[95.91.212.147:received]; MIME_TRACE(0.00)[0:+]; FREEMAIL_ENVFROM(0.00)[gmail.com]; ASN(0.00)[asn:15169, ipnet:209.85.128.0/17, country:US]; R_DKIM_NA(0.00)[]; FROM_NEQ_ENVFROM(0.00)[0mp@FreeBSD.org,mpp302@gmail.com]; MID_RHS_MATCH_FROM(0.00)[]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; NEURAL_HAM_LONG(-1.00)[-1.000]; TAGGED_RCPT(0.00)[]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[FreeBSD.org]; SPAMHAUS_ZRD(0.00)[209.85.218.42:from:127.0.2.255]; TO_MATCH_ENVRCPT_SOME(0.00)[]; RBL_DBL_DONT_QUERY_IPS(0.00)[209.85.218.42:from]; RCVD_IN_DNSWL_NONE(0.00)[209.85.218.42:from]; RCVD_TLS_ALL(0.00)[]; MAILMAN_DEST(0.00)[dev-commits-doc-all] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 14:46:05 -0000 On 20/04/2021 15:12, Fernando Apesteguía wrote: > On Tue, Apr 20, 2021 at 2:39 PM Mateusz Piotrowski <0mp@freebsd.org> wrote: >> On 20/04/2021 14:28, Mathieu Arnold wrote: >>> On Tue, Apr 20, 2021 at 10:32:23AM +0000, Mateusz Piotrowski wrote: >>>> The branch main has been updated by 0mp: >>>> >>>> URL: https://cgit.FreeBSD.org/doc/commit/?id=ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 >>>> >>>> commit ceee1def00ac69f06b9d86b2fb1ff04bb6c84d48 >>>> Author: Mateusz Piotrowski <0mp@FreeBSD.org> >>>> AuthorDate: 2021-04-20 10:14:58 +0000 >>>> Commit: Mateusz Piotrowski <0mp@FreeBSD.org> >>>> CommitDate: 2021-04-20 10:14:58 +0000 >>>> >>>> articles/committers-guide: Document change in MFH policy >>>> >>>> Merging commits into the quarterly branch no longer requires an explicit >>>> approval [1]. Let's remove outdated documentation and leave a note >>>> explaining that there is no need for an explicit approval to MFH. >>> Note that the MFH line should still be used to note intent. >> Hmm, true. It does make sense to leave MFH in the table of metadata fields for this use case. I'll >> bring back the MFH entry with an updated definition. > The template still says: > > # MFH: > > Maybe something like "State your intention to merge this change" would > be more appropriate. Good point! Here are some reviews for the hooks if you are interested: https://reviews.freebsd.org/D29861 https://reviews.freebsd.org/D29860 https://reviews.freebsd.org/D29858 From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 15:13:36 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id EFFCE5DAF90 for ; Tue, 20 Apr 2021 15:13:36 +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 4FPnJJ6WvMz4rp0; Tue, 20 Apr 2021 15:13:36 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 D2EC615134; Tue, 20 Apr 2021 15:13:36 +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 13KFDa5B092217; Tue, 20 Apr 2021 15:13:36 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KFDaAq092216; Tue, 20 Apr 2021 15:13:36 GMT (envelope-from git) Date: Tue, 20 Apr 2021 15:13:36 GMT Message-Id: <202104201513.13KFDaAq092216@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: ea68d93d5f - main - committers-guide: Discourage use of Submitted by MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ea68d93d5f4051c77e47f17182c5d4160605aa20 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 15:13:37 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=ea68d93d5f4051c77e47f17182c5d4160605aa20 commit ea68d93d5f4051c77e47f17182c5d4160605aa20 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-20 15:11:49 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 15:11:49 +0000 committers-guide: Discourage use of Submitted by The use of "Submitted by" is discouraged in all the source trees now. --- documentation/content/en/articles/committers-guide/_index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 08968c1516..cf26d2ce87 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2530,8 +2530,8 @@ a mailing list. |`Submitted by:` |The name and e-mail address of the person that submitted the fix; for developers, just the username on the FreeBSD cluster. -Typically not used with Git; in the src and doc trees submitted patches should -have the author set by using `git commit --author` +Typically not used with Git; submitted patches should +have the author set by using `git commit --author`. If the submitter is the maintainer of the port being committed, include "(maintainer)" after the email address. From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 15:46:09 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 5EC285DC22E for ; Tue, 20 Apr 2021 15:46:09 +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 4FPp1s2HQQz4sxX; Tue, 20 Apr 2021 15:46:09 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 4172615842; Tue, 20 Apr 2021 15:46:09 +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 13KFk9Pb031752; Tue, 20 Apr 2021 15:46:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KFk9pu031751; Tue, 20 Apr 2021 15:46:09 GMT (envelope-from git) Date: Tue, 20 Apr 2021 15:46:09 GMT Message-Id: <202104201546.13KFk9pu031751@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: bcd1bb7a20 - main - committers-guide: Remove "Submitted by" from examples MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bcd1bb7a20c7204bd9e2eaf5f3148a9157a47447 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 15:46:09 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=bcd1bb7a20c7204bd9e2eaf5f3148a9157a47447 commit bcd1bb7a20c7204bd9e2eaf5f3148a9157a47447 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-20 15:30:23 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 15:45:19 +0000 committers-guide: Remove "Submitted by" from examples Reviewed by: imp Differential Revision: https://reviews.freebsd.org/D29868 --- documentation/content/en/articles/committers-guide/_index.adoc | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index cf26d2ce87..0944750736 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2611,16 +2611,18 @@ Approved by: re (username) [example] ==== -The commit is based on a patch from a PR submitted by John Smith. The commit message "PR" and "Submitted by" fields are filled.. +The commit is based on a patch from a PR submitted by John Smith. +The commit message "PR" field is filled. [.programlisting] .... ... PR: 12345 - Submitted by: John Smith .... +The committer sets the author of the patch with `git commit --author "John Smith "`. + ==== .Commit Log for a Commit Needing Review @@ -2701,7 +2703,6 @@ The extra information to include in the commit would look something like [.programlisting] .... PR: 54321 -Submitted by: John Smith Reviewed by: -arch Obtained from: NetBSD MFC after: 1 month From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 15:46:10 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 870AC5DC1EB for ; Tue, 20 Apr 2021 15:46:10 +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 4FPp1t3N0Hz4t84; Tue, 20 Apr 2021 15:46:10 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 6522A15649; Tue, 20 Apr 2021 15:46:10 +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 13KFkAxJ031778; Tue, 20 Apr 2021 15:46:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KFkA24031777; Tue, 20 Apr 2021 15:46:10 GMT (envelope-from git) Date: Tue, 20 Apr 2021 15:46:10 GMT Message-Id: <202104201546.13KFkA24031777@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 5755cad0f0 - main - committers-guide: Fix indentation of commit message examples MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5755cad0f0248f797648076b754900e9a19d6667 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 15:46:10 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=5755cad0f0248f797648076b754900e9a19d6667 commit 5755cad0f0248f797648076b754900e9a19d6667 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-20 15:44:20 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-20 15:45:54 +0000 committers-guide: Fix indentation of commit message examples --- .../content/en/articles/committers-guide/_index.adoc | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 0944750736..1b698c39a9 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2618,7 +2618,7 @@ The commit message "PR" field is filled. .... ... - PR: 12345 +PR: 12345 .... The committer sets the author of the patch with `git commit --author "John Smith "`. @@ -2636,7 +2636,7 @@ After posting patches to the appropriate mailing list (in this case, `freebsd-ar .... ... - Reviewed by: -arch +Reviewed by: -arch .... ==== @@ -2651,7 +2651,7 @@ Commit a port, after working with the listed MAINTAINER, who said to go ahead an .... ... - Approved by: abc (maintainer) +Approved by: abc (maintainer) .... Where _abc_ is the account name of the person who approved. @@ -2667,7 +2667,7 @@ Committing some code based on work done in the OpenBSD project. .... ... - Obtained from: OpenBSD +Obtained from: OpenBSD .... ==== @@ -2682,7 +2682,7 @@ Committing some code which will be merged from FreeBSD-CURRENT into the FreeBSD- .... ... -MFC after: 2 weeks +MFC after: 2 weeks .... Where _2_ is the number of days, weeks, or months after which an MFC is planned. The _weeks_ option may be `day`, `days`, `week`, `weeks`, `month`, `months`. @@ -2702,11 +2702,11 @@ The extra information to include in the commit would look something like [.programlisting] .... -PR: 54321 -Reviewed by: -arch -Obtained from: NetBSD -MFC after: 1 month -Relnotes: yes +PR: 54321 +Reviewed by: -arch +Obtained from: NetBSD +MFC after: 1 month +Relnotes: yes .... ==== From owner-dev-commits-doc-all@freebsd.org Tue Apr 20 15:51:14 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id E5DB35DC4FD for ; Tue, 20 Apr 2021 15:51:14 +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 4FPp7k630rz4tGN; Tue, 20 Apr 2021 15:51:14 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 C22FA1584F; Tue, 20 Apr 2021 15:51:14 +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 13KFpE1f040545; Tue, 20 Apr 2021 15:51:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13KFpEgU040544; Tue, 20 Apr 2021 15:51:14 GMT (envelope-from git) Date: Tue, 20 Apr 2021 15:51:14 GMT Message-Id: <202104201551.13KFpEgU040544@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: a0dabc992e - main - [articles][vm-design] Add Spanish translation MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a0dabc992e83873aae24948eee0ea4b3b170a370 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Apr 2021 15:51:15 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=a0dabc992e83873aae24948eee0ea4b3b170a370 commit a0dabc992e83873aae24948eee0ea4b3b170a370 Author: Fernando Apesteguía AuthorDate: 2021-04-08 14:20:04 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-20 15:45:07 +0000 [articles][vm-design] Add Spanish translation Add the Spanish translation for the vm-design article. Most of the work was done with Weblate[1] Reviewed by: 0mp, carlavilla Approved by: 0mp (mentor) Differential Revision: https://reviews.freebsd.org/D29646 [1] https://translate-dev.freebsd.org/projects/documentation/articlesvm-design_index/es/ --- .../content/es/articles/vm-design/_index.adoc | 216 +++++++++++++++++++++ 1 file changed, 216 insertions(+) diff --git a/documentation/content/es/articles/vm-design/_index.adoc b/documentation/content/es/articles/vm-design/_index.adoc new file mode 100644 index 0000000000..01bef76726 --- /dev/null +++ b/documentation/content/es/articles/vm-design/_index.adoc @@ -0,0 +1,216 @@ +--- +authors: + - + author: 'Matthew Dillon' + email: dillon@apollo.backplane.com +releaseinfo: $FreeBSD$ +title: 'Elementos de diseño del sistema de Memoria Virtual de FreeBSD' +trademarks: '["freebsd", "linux", "microsoft", "opengroup", "daemon-news", "general"]' +--- + += Elementos de diseño del sistema de Memoria Virtual de FreeBSD +:doctype: article +:toc: macro +:toclevels: 1 +:icons: font +:sectnums: +:sectnumlevels: 6 +:source-highlighter: rouge +:experimental: + +ifeval::["{backend}" == "html5"] +:imagesdir: ../../../images/articles/vm-design/ +endif::[] + +ifeval::["{backend}" == "pdf"] +:imagesdir: ../../../../static/images/articles/vm-design/ +endif::[] + +ifeval::["{backend}" == "epub3"] +:imagesdir: ../../../../static/images/articles/vm-design/ +endif::[] + +[.abstract-title] +Resumen + +El título es sólo una forma elegante de decir que voy a intentar describir la enchilada de la Memoria Virtual, espero que de un modo que todo el mundo pueda seguir. Durante el último año me he concentrado en un número de subsistemas principales del kernel de FreeBSD, con los subsistemas de Memoria Virtual e Intercambio siendo los más interesantes y NFS siendo "una tarea necesaria". Reescribí sólo pequeñas porciones del código. En el área de Memoria Virtual la única reescritura importante que he hecho es el subsistema de intercambio. La mayor parte de mi trabajo fue de limpieza y mantenimiento, con tan sólo reescrituras moderadas de código y sin ajustes algorítmicos importantes en el subsistema de Memoria Virtual. El grueso de la base teórica del subsistema de Memoria Virtual permanece sin cambios y mucho del crédito del esfuerzo de modernización en los últimos años es para John Dyson y David Greenman. Como no soy un historiador como Kirk no intentaré etiquetar t odas las características con nombres de personas, ya que me equivocaría irremediablemente. + +''' + +toc::[] + +[[introduction]] +== Introducción + +Antes de avanzar con el diseño real dediquemos un poco de tiempo a la necesidad de mantener y modernizar cualquier base de código de larga duración. En el mundo de la programación, los algoritmos tienen a se más importantes que el código y es precisamente debido a las raíces académicas de BSD que una gran parte de la atención se puso desde el comienzo en el diseño algorítmico. Prestar más atención al diseño generalmente lleva a una base de código limpio y flexible que puede ser modificado fácilmente, extendido o reemplazado a lo largo del tiempo. Aunque BSD es considerado por alguna gente como un sistema operativo"viejo", aquellos de nosotros que trabajamos en él solemos verlo más como una base de código"madura" la cual tiene varios componentes modificados, extendidos, o reemplazados con código moderno. Ha evolucionado, y FreeBSD está a la vanguardia independientemente de cómo de viejo sea parte del código. Es importante hacer esta distinción y que mucha gent e pasa por alto. El mayor error que puede cometer un programador es no aprender de la historia, y es precisamente este error el que han cometido muchos otros sistemas operativos modernos. Windows NT(R) es el mejor ejemplo, y las consecuencias han sido nefastas. Linux también comete este error hasta cierto punto—lo suficiente para que nosotros la gente de BSD hagamos pequeñas bromas de vez en cuando, por lo menos. El problema de Linux es simplemente la falta de experiencia y de una historia contra la que comparar ideas, un problema que está siendo tratado rápidamente por la comunidad Linux de la misma forma que ha sido tratado en la comunidad BSD—mediante el desarrollo continuo de código. La gente de Windows NT(R), por otro lado, repiten los mismos errores solucionados por UNIX(R) hace décadas y pasan años arreglándolos. Una y otra vez. Sufren un caso severo de "no diseñado aquí" y "siempre tenemos la razón porque nuestro departamento de marketing así lo dice". Tengo poca tolerancia hacia cualquiera que no pued! e aprender de la historia. + +Mucha de la aparente complejidad del diseño de FreeBSD, especialmente en el subsistema de Memoria Virtual/Intercambio, es un resultado directo de tener que resolver serios problemas de rendimiento que ocurren bajo condiciones variadas. Estos problemas no se deben aun mal diseño algorítmico sino que surgen de factores ambientales. En cualquier comparación directa entre plataformas, estos problemas se hacen más evidentes cuando los recursos del sistema empiezan a sufrir estrés. Como describo en el subsistema de Memoria Virtual/Intercambio de FreeBSD el lector siempre debería tener en mente dos puntos: + +. El aspecto más importante del diseño de rendimiento es lo que se conoce como "Optimización del Camino Crítico". Es común que las optimizaciones de rendimiento inflen algo el código con el fin de mejorar el rendimiento del camino crítico. +. Un diseño sólido, generalizado tiene mejor rendimiento a largo plazo que un diseño altamente optimizado. Mientras que un diseño generalizado puede terminar siendo más lento que un diseño altamente optimizado cuando se implementan inicialmente, el diseño generalizado tiende a ser más fácil de adaptar a condiciones cambiantes y el diseño altamente optimizado termina siendo desechado. + +Cualquier base de código que sobrevivirá y será mantenible durante años debe por lo tanto ser diseñada adecuadamente desde el comienzo incluso si tiene algo de coste en rendimiento. Hace veinte años la gente todavía discutía si la programación en ensamblador era mejor que programar en un lenguaje de alto nivel porque producía código que era diez veces más rápido. Hoy, la falibilidad de ese argumento es obvio — de modo paralelo al diseño algorítmico y la generalización de código. + +[[vm-objects]] +== Objetos de Memoria Virtual + +La mejor manera de empezar describiendo el sistema de Memoria Virtual de FreeBSD is mirarlo desde la perspectiva de un proceso de usuario. Cada proceso de usuario ve una espacio de direcciones de Memoria Virtual único, privado y contiguo que contiene diversos tipos de objetos de memoria. Estos objetos tienen diversas características. Código de programa y datos de programa son de forma efectiva un solo fichero mapeado en memoria (el fichero binario que se está ejecutando), pero el código del programa es de solo lectura mientras que los datos de programa son copy-on-write. El BSS del programa es sólo memoria asignada y rellenada con ceros bajo demanda, llamada rellenado de página cero bajo demanda. Ficheros arbitrarios pueden ser mapeados en memoria en el espacio de direcciones también, que es como funciona el mecanismo de librerías compartidas. Dichos mapeos pueden requerir modificaciones para permanecer privados al proceso que los realiza. La llamada al sistema fork añade una nueva dimensión a al problema de la gestión de la Memoria Virtual a añadir a la complejidad ya existente. + +Una página de datos binarios de un programa (que es una página copy-on-write básica) ilustra esta complejidad. Un programa binario contiene una sección de datos preinicializados que es inicialmente mapeado directamente por el fichero del programa. Cuando un programa se carga en el espacio de direcciones de Memoria Virtual del proceso, este área es inicialmente mapeado en memoria y respaldado por el programa binario mismo, permitiendo al sistema de Memoria Virtual liberar/reutilizar la página y después cargarla de nuevo desde el binario. Sin embargo, en el momento en que un proceso modifica estos datos, el sistema de Memoria Virtual debe hacer una copia privada para ese proceso. Puesto que la copia privada ha sido modificada, el sistema de Memoria Virtual podría no ser capaz de liberarla, porque no hay forma de restaurarla posteriormente. + +Notarás inmediatamente que lo que originalmente era un simple mapeo de un fichero se ha convertido en algo más complejo. Los datos pueden ser modificados página a página mientras que el mapeo de ficheros engloba varias páginas a la vez. La complejidad aumenta más cuando un proceso se bifurca. Cuando un proceso se bifurca, el resultado son dos procesos—cada uno con su propio espacio de direcciones privado que incluye cualquier modificación hecha por el proceso original antes de la llamada a `fork()`. Sería tonto para el sistema de Memoria Virtual hacer una copia completa de los datos en el momento de llamar a `fork()` porque es bastante posible que al menos uno de los dos procesos solamente necesite leer de esa página a partir de este momento, permitiendo así que se use la página original. Lo que era una página privada se ha convertido en una página copy-on-write de nuevo, puesto que cada proceso (padre y hijo) espera que sus propias modificaciones personales después del fork permanezcan privadas para ellos y que afecten al otro. + +FreeBSD gestiona todo esto con un modelo de Objetos de Memoria Virtual en capas. El fichero del programa binario original termina siendo la capa de Objetos de Memoria Virtual más baja. Una capa copy-on-write se sitúa encima de ella para mantener aquellas páginas que han sido copiadas del fichero original. Si el programa modifica una página de datos que pertenece al fichero original el sistema de Memoria Virtual recibe un fallo de página y hace una copia de la página en la capa superior. Cuando un proceso bifurca, se empujan nuevas capas de Objetos de Memoria Virtual. Esto puede cobrar más sentido con un ejemplo bastante básico. Un `fork()` es una operación común para cualquier sistema *BSD, así que este ejemplo considerará un programa que arranca, y bifurca. Cuando el proceso arranca, el sistema de Memoria Virtual crea una capa de objetos, llamémosla A: + +image::fig1.png["Una imagen"] + +A representa el fichero—las páginas pueden ser paginadas hacia o desde el medio físico del fichero según sea necesario. Paginar desde el disco es razonable para un programa, pero en realidad no queremos paginar de vuelta y sobrescribir el ejecutable. Por tanto, el sistema de Memoria Virtual crea una segunda capa, B, que estará respaldada físicamente por espacio de intercambio: + +image::fig2.png[] + +En la primera escritura a una página después de esto, se crea una nueva página en B, y su contenido es inicializado desde A. Todas las páginas en B pueden ser paginadas a o desde el dispositivo de intercambio. Cuando el programa bifurca, el sistema de Memoria Virtual crea dos capas de objetos nuevas—C1 para el padre, y C2 para el hijo—que descansan sobre B: + +image::fig3.png[] + +En este caso, digamos que una página en B es modificada por el proceso padre original. El proceso recibirá un fallo de copy-on-write y duplicará la página en C1, dejando la página original en B sin tocar. Ahora, digamos que la misma página en B es modificada por el proceso hijo. El proceso recibirá un fallo de copy-on-write y duplicará la página en C2. La página original en B está ahora completamente oculta ya que tanto C1 como C2 tienen una copia y B podría teóricamente ser destruida si no representa un fichero "real"; sin embargo, este tipo de optimización no es trivial de hacer porque es muy fina. FreeBSD no hace esta optimización. Ahora, supón (como suele ser el caso) que el proceso hijo hace un `exec()`. Su espacio de direcciones actual es habitualmente remplazado por un nuevo espacio de direcciones que representa un nuevo fichero. En este caso, la capa C2 es destruida: + +image::fig4.png[] + +En este caso, el número de hijos de B ha bajado a uno, y todos los accesos a B van ahora a través de C1. Esto significa que B y C1 pueden colapsarse juntas. Cualquier página en B que también existe en C1 se borran de B durante el colapso. Por lo tanto, incluso aunque la optimización en el paso anterior no se pudo hacer, podemos recuperar las páginas muertas bien cuando el proceso sale o cuando llama a `exec()`. + +Este modelo crea un número de problemas potenciales. El primero es que puedes terminar con una pila de Objetos de Memoria Virtual relativamente profunda que puede tener un coste de tiempo de escaneo y de memoria cuando recibes un fallo. Capas muy profundas pueden ocurrir cuando los procesos se bifurcan y se bifurcan de nuevo (en el padre o en el hijo). El segundo problema es que puedes terminar con páginas muertas, inaccesibles en lo profundo de la pila de Objetos de Memoria Virtual. En nuestro último ejemplo si tanto los el proceso padre como el hijo modifican la misma página, ambos obtienen su propia copia privada de la página y la página original en B ya no es accesible por nadie. Esa página en B puede ser liberada. + +FreeBSD soluciona el problema de capas profundas con una optimización especial llamada "Caso de Todo Sombreado". Este caso ocurre si C1 o C2 generan suficientes fallos COW como para sombrear (ocultar) todas las páginas en B. Digamos que C1 lo consigue. C1 puede ahora puentear B completamente, así que en lugar de tener C1->B->A y C2->B->A ahora tenemos C1->A y C2->B->A. Pero mira lo que ha pasado también—ahora B tiene sólo una referencia (C1), así que podemos colapsar B y C2 juntas. El resultado final es que B se borra completamente y tenemos C1->A y C2->A. Habitualmente el caso es que B contendrá un gran número de páginas y ni C1 ni C2 serán capaces de ocultarla completamente. Si bifurcamos de nuevo y creamos un conjunto de capas D, sin embargo, es mucho más probable que una de las capas de D eventualmente sea capaz de ocultar el conjunto mucho menor representado por C1 o C2. La misma optimización funcionará en cualquier punto del grafo y el resultado total de esto es que incluso en una máquina con muchas bifurcaciones las pilas de Objetos de Memoria Virtual tienen a no ser mucho más profundas de 4. Esto es verdad tanto para el padre como para los hijos y es así tanto si el padre hace la bifurcación como si los hijos bifurcan en cascada. + +El problema de la página muerta todavía existe en el caso en el que C1 o C2 no ocultan completamente B. Debido a otras optimizaciones este caso no es demasiado problema y simplemente permitimos que haya páginas muertas. Si el sistema se queda sin memoria las intercambiará a disco, utilizando un poco de espacio de intercambio, pero eso es todo. + +La ventaja del modelo de Objetos de Memoria Virtual es que `fork()` es extremadamente rápido, ya que no se necesita realizar una copia real de datos. La desventaja es que puedes construir un conjunto de capas de Objetos de Memoria Virtual relativamente complejo que haga un poco más lento el manejo de fallos de página, y que tienes que gastar memoria en la gestión de las estructuras de los Objetos de Memoria Virtual. Las optimizaciones que hace FreeBSD demuestran que reducen los problemas lo suficiente de forma que pueden ser ignorados, eliminando prácticamente la desventaja. + +[[swap-layers]] +== Capas de Intercambio + +Las páginas de datos privadas se crean como páginas copy-on-write o rellenas con ceros. Cuando se hace un cambio, y por lo tanto una copia, el objeto de respaldo original (normalmente un fichero) ya no puede ser utilizado para guardar una copia de la página cuando el sistema de Memoria Virtual necesita reutilizarla para otros fines. Aquí es donde aparece el Intercambio. El Intercambio se asigna para crear almacenamiento de respaldo para memoria que de otra forma no la tendría. FreeBSD asigna la estructura de gestión del intercambio para un Objeto de Memoria Virtual solo cuando se necesita realmente. Sin embargo históricamente, la estructura de gestión del intercambio ha tenido problemas: + +* En FreeBSD 3.X la estructura de gestión de intercambio preasigna un array que engloba todo el objeto que requiere almacenamiento de respaldo de intercambio—incluso si solo unas pocas páginas de ese objeto están respaldadas en el área de intercambio. Esto crea un problema de fragmentación de la memoria del núcleo cuando se mapean objetos grandes, o cuando procesos con tamaños de ejecución grandes (RSS) bifurcan. +* Además, para llevar la cuenta del espacio de intercambio, una "lista de huecos" es mantenida en la memoria del núcleo, y esta tiende a fragmentarse de forma severa también. Puesto que la "lista de huecos" es una lista lineal, el rendimiento de asignación y liberación de intercambio es de un orden subóptimo de O(n) por página. +* Requiere que se lleven a cabo asignaciones de memoria del núcleo durante el proceso de liberación de espacio de intercambio, y eso crea problemas de bloqueo por baja memoria. +* El problema se exacerba debido a los huecos creados por el algoritmo de entrelazado. +* Además, el mapa de bloques de intercambio se puede fragmentar fácilmente dando como resultado asignaciones no contiguas. +* La memoria del núcleo se debe asignar al vuelo para las estructuras adicionales de gestión de intercambio cuando se escribe en el área de intercambio. + +De esa lista se hace evidente que había mucho margen de mejora. Para FreeBSD 4.X, reescribí completamente el subsistema de intercambio: + +* Las estructuras de gestión de intercambio se asignan mediante una tabla has en lugar de un array lineal dándoles un tamaño de asignación fijo y mucha mayor granularidad. +* En lugar de utilizar una lista enlazada linear para llevar la cuenta de las reservas de espacio de intercambio, ahora usa un mapa de bits de bloques de intercambio dispuestos en una estructura tipo árbol radix con anotaciones sobre el espacio libre en las estructuras de nodos del radix. +* El mapa de bits entero para el árbol radix también se preasigna para evitar tener que asignar memoria del núcleo durante operaciones de intercambio con un nivel crítico de memoria baja. Después de todo, el sistema tiende a utilizar intercambio cuando está bajo en memoria de forma que deberíamos evitar asignar memoria del núcleo en esas situaciones para evitar potenciales bloqueos. +* Para reducir la fragmentación el árbol radix es capaz de asignar de una sola vez grandes trozos contiguos, saltándose pequeños trozos fragmentados. + +No realicé el paso final de tener un "puntero de anotaciones para las asignaciones" que recorrería una porción del espacio de intercambio según se hicieran las asignaciones para así garantizar asignaciones contiguas o al menos localidad de referencia, pero aseguré que esa condición no podría darse. + +[[freeing-pages]] +== Cuando liberar una página + +Como el sistema de Memoria Virtual usa toda la memoria disponible para cachear disco, normalmente hay pocas páginas que estén realmente libres. El sistema de Memoria Virtual depende de su habilidad para adecuadamente escoger las páginas que no están en uso para reutilizarlas en nuevas asignaciones. Seleccionar las páginas óptimas para liberar es posiblemente la función más importante que cualquier sistema de Memoria Virtual puede realizar porque si la elección no es buena, el sistema de Memoria Virtual puede verse forzada a recuperar páginas de disco innecesariamente, degradando seriamente el rendimiento del sistema. + +¿Cuánto trabajo extra estamos dispuestos a sufrir en el camino crítico para evitar liberar la página equivocada? Cada decisión errónea que hacemos costará cientos de miles de ciclos de CPU y una parada notable de los procesos afectados, así que estamos dispuestos a soportar una cantidad significativa de trabajo extra para estar seguros que se escoge la página adecuada. Por esto es por lo que FreeBSD tiende a superar en rendimiento a otros sistemas cuando se estresan los recursos de memoria. + +El algoritmo que determina la página libre se construye en base al histórico de uso de las páginas de memoria. Para adquirir este histórico, el sistema se aprovecha de la característica del bit de página utilizada que la mayoría del hardware de tablas de página posee. + +En cualquier caso, el bit de página utilizada se blanquea y en algún momento posterior el sistema de Memoria Virtual se encuentra con la página de nuevo y ve que el bit de página utilizada ha sido marcado. Esto indica que la página todavía se está utilizando activamente. Si el bit está blanqueado eso indica que la página no se usa activamente. Mediante el chequeo periódico de este bit, se desarrollo (en forma de contador) un histórico de uso . Cuando posteriormente el sistema de Memoria Virtual necesita liberar algunas páginas, examinar este histórico se convierte en la piedra de toque para determinar la mejor página candidata para reutilizar. + +Para esas plataformas que no tienen esta característica, el sistema en realidad emula un bit de página utilizada. Desmapea o protege una página, forzando un fallo de página si ésta es accedida de nuevo. Cuando se maneja el fallo de página, el sistema simplemente marca la página como usada y desprotege la página de forma que puede ser utilizada. Aunque realizar este fallo de página tan solo para determinar si una página está siendo usada puede parecer una proposición cara, es mucho menos cara que reutilizar la página para otro propósito para darse cuenta después de que otro proceso la necesita y tener que ir al disco. + +FreeBSD utiliza varias colas de páginas para refinar aún más la selección de páginas a reutilizar así como para determinar cuando se deben llevar las páginas sucias a su almacenamiento de respaldo. Puesto que las tablas de páginas en FreeBSD son entidades dinámicas, cuesta virtualmente nada desmapear una página del espacio de direcciones de cualquier proceso que la esté usando. Cuando se ha escogido una página candidata basándose en el contador de página utilizada, esto es precisamente lo que se hace. El sistema debe distinguir entre páginas limpias que pueden en teoría ser liberadas en cualquier momento, y páginas sucias que deben ser escritas primero en el almacenamiento de respaldo antes de ser reutilizadas. Cuando se encuentra una página candidata se mueve a la cola inactiva si está sucia, o a la cola de caché si está limpia. In algoritmo separado que se bajas en el ratio de páginas sucias respecto de las limpias determina cuándo se tienen que escribir a d isco las páginas sucias de la cola inactiva. Una vez hecho esto, las páginas escritas se mueven de la cola inactiva a la cola de caché. En este punto, las páginas en la cola de caché todavía pueden ser reactivadas por un fallo de Memoria Virtual con un coste relativamente bajo. Sin embargo, las páginas de la cola de caché se consideran como "inmediatamente liberables" y serán reutilizadas de modo LRU (Usada Menos Recientemente) cuando el sistema necesita asignar nueva memoria. + +Es importante señalar que el sistema de Memoria Virtual de FreeBSD intenta separar páginas limpias y sucias para expresar la razón de evitar la escritura innecesaria de páginas sucias (que come ancho de banda de E/S), y tampoco mueve de forma gratuita páginas entre distintas colas de páginas cuando el sistema de memoria no está bajo estrés. Este es el motivo por el que verás algunos sistemas con contadores de cola de caché muy bajos y contadores de cola de páginas activa altos cuando se ejecuta el comando `systat -vm`. Según el sistema de Memoria Virtual va sufriendo más estrés, hace un gran esfuerzo por mantener varias colas de páginas en los niveles que determina que son más efectivos. + +Durante años ha circulado una leyenda urbana acerca de que Linux hacía un mejor trabajo que FreeBSD evitando escribir en intercambio, pero de hecho esto no es cierto. Lo que ocurría en realidad era que FreeBSD estaba llevando a intercambio de forma proactiva páginas no utilizadas para hacer sitio para más caché de disco mientras que Linux estaba manteniendo las páginas sin utilizar y dejando menos memoria disponible para la caché y para páginas de procesos. No sé si esto sigue siendo cierto a día de hoy. + +[[prefault-optimizations]] +== Optimizaciones de Prefallo y de Rellenado con Ceros + +Realizar un fallo de Memoria Virtual no es costoso y la página subyacente ya está cargada y simplemente puede ser mapeada en el proceso, pero puede ser costoso si hay muchas de ellas de forma regular. Un buen ejemplo de esto es ejecutar un programa como man:ls[1] o man:ps[1] una y otra vez. Si el programa binario está mapeado en la memoria pero no lo está en la tabla de páginas, entonces todas las páginas que serán accedidas por el programa generarán un fallo cada vez que el programa se ejecute. Esto es innecesario cuando las páginas en cuestión ya están en la Caché de Memoria Virtual, de modo que FreeBSD intentará pre-poblar las tablas de páginas de un proceso con aquellas páginas que ya están en la Caché de Memoria Virtual. Algo que FreeBSD no hace todavía es un pre-copy-on-write de ciertas páginas al hacer exec. Por ejemplo, si ejecutas el programa man:ls[1] mientras ejecutas `vmstat 1` notarás que siempre produce un cierto número de fallos de página, inclus o cuando lo ejecutas una y otra vez. Estos son fallos de página de rellenados de ceros, no fallos de código de programa (que ya han sido pre-fallados). Realizar una pre-copia de páginas en un exec o fork es un área en el que ser sujeto de más estudio. + +Un gran porcentaje de los fallos de página que se producen son fallos de rellenado de ceros. Habitualmente puedes verlo observando la salida del comando `vmstat -s`. Esto ocurre cuando un proceso accede a páginas de su área de BSS. Se espera que el área de BSS esté inicializada a cero pero el sistema de Memoria Virtual no se molesta en asignar ninguna memoria en absoluto hasta el momento en el que el proceso accede de verdad. Cuando se produce un fallo el sistema de Memoria Virtual no solo debe asignar una nueva página, tiene que inicializarla a cero también. Para optimizar la operación de rellenado de ceros el sistema de Memoria Virtual tiene la capacidad de pre-inicializar páginas a cero y marcarlas como tal, y solicitar páginas pre-inicializadas a cero cuando ocurre un fallo de rellenado de ceros. La pre-inicialización a cero ocurren cuando la CPU está ociosa pero el número de páginas que el sistema pre-inicializa a cero está limitado para evitar destrozar las cach és de memoria. Este es un ejemplo excelente de cómo añadir complejidad al sistema de Memoria Virtual para optimizar el camino crítico. + +[[page-table-optimizations]] +== Optimizaciones de la Tabla de Páginas + +Las optimizaciones de la tabla de páginas constituyen la parte más controvertida del diseño de la Memoria Virtual de FreeBSD y ha mostrado cierta tensión con la llegada de uso serio de `mmap()`. Creo que esto en realidad es una característica de la mayor parte de los BSDS aunque no estoy seguro de cuándo se introdujo por primera vez. Hay dos optimizaciones principales. La primar es que las tablas de páginas hardware no contienen un estado persistente sino que pueden descartarse en cualquier momento con solo un pequeño sobre coste en la gestión. La segunda es que cada entrada en la tabla de páginas activas en el sistema tiene una estructura `pv_entry` que lo gobierna la cual está enlazada a la estructura `vm_page`. FreeBSD puede simplemente iterar sobre esos mapeos que se sabe que existen mientras Linux tiene que comprobar todas las tablas de páginas que _podrían_ contener un mapeo específico para ver si es así, lo que puede provocar un sobre coste de O(n^2) en algunas situaciones. Por esto FreeBSD tiene a tomar mejores decisiones sobre qué páginas reutilizar o intercambiar cuando la memoria está bajo estrés, resultando en un mejor rendimiento bajo carga. Sin embargo, FreeBSD requiere ajustes del núcleo para acomodar situaciones con grandes espacios de direcciones compartidos como los que pueden darse en sistemas nuevos porque podría agotar las estructuras `pv_entry`. + +Tanto Linux como FreeBSD necesitan trabajar en este área. FreeBSD trata de maximizar la ventaja de un modelo de mapeo activo potencialmente disperso (no todos los procesos necesitan mapear todas las páginas de una biblioteca compartida por ejemplo), mientras que Linux trata de simplificar sus algoritmos. FreeBSD en general tiene la venta del rendimiento a costa de gastar algo más de memoria extra, pero FreeBSD se desmorona en el caso donde un fichero grande está compartido de forma masiva entre cientos de procesos. Linux, por otro lado, se desmorona en el caso donde muchos procesos mapean pocas porciones de la misma biblioteca compartida y también se ejecuta de forma no-óptima cuando intenta determinar si una página puede ser reutilizada o no. + +[[page-coloring-optimizations]] +== Coloreado de Páginas + +Terminaremos con las optimizaciones de coloreado de páginas. El coloreado de páginas es una optimización de rendimiento diseñada para asegurar que el acceso a páginas contiguas en memoria virtual hacen el mejor uso posible de la caché del procesador. Hace mucho tiempo (es decir, más de 10 años) las cachés de los procesadores solían mapear memoria virtual en lugar de memoria física. Esto produjo un gran número de problemas que incluyen tener que limpiar la caché en cada cambio de contexto en algunos casos, y problemas con los alias de datos en la caché. De hecho, si no tienes cuidado, páginas contiguas en memoria virtual podrían terminar utilizando la misma página en la caché del procesador—llevando a desechar prematuramente datos cacheables y reduciendo el rendimiento de la CPU. Esto es cierto incluso en cachés asociativas multi direccionales (aunque el efecto se mitiga algo). + +El código de asignación de memoria de FreeBSD implementa optimizaciones de coloreado de páginas, lo que significa que el código se asignación de memoria intentará localizar páginas libres que son contiguas desde el punto de vista de la caché. Por ejemplo, si la página 16 de memoria física está asignada a la página 0 de la memoria virtual del proceso y la caché puede mantener 4 páginas, el código de coloreado de páginas no asignará la página 20 de memoria física a la página 1 de la memoria virtual de un proceso. En su lugar, asignaría la página 21 de memoria física. El código de coloreado de páginas intenta evitar la asignación de la página 20 porque esto mapea sobre la misma memoria cacheada que la página 16 y resultaría en un cacheo no óptimo. Este código añade una significativa complejidad al subsistema de asignación de memoria de la Memoria Virtual como puedes imaginar, pero el resultado merece la pena. El Coloreado de Páginas hace que la memoria de la Memoria Virtual sea tan determinista como la memoria física en términos de rendimiento de caché. + +[[conclusion]] +== Conclusión + +La Memoria Virtual en lo sistemas operativos modernos deben afrontar diversas situaciones de forma eficiente y para muchos patrones de uso distintos. La aproximación modular y algorítmica que históricamente ha tomado BSD nos permite estudiar y entender la implementación actual así como reemplazar piezas de código relativamente grandes de forma también relativamente limpia. Ha habido una serie de mejoras en el sistema e Memoria Virtual de FreeBSD en los últimos años, y el trabajo continua. + +[[allen-briggs-qa]] +== Sesión extra de Preguntas y Respuestas por Allen Briggs + +=== ¿Qué es el algoritmo de entrelazado al que hiciste referencia en la lista de problemas del sistema de intercambio de FreeBSD 3.X? + +FreeBSD utiliza un entrelazado de intercambio fijo con un valor por defecto de 4. Esto significa que FreeBSD reserva espacio para cuatro áreas de intercambio incluso si solo tienes una, dos o tres. Puesto que el espacio de intercambio está entrelazado el espacio lineal de direcciones que representa las "cuatro áreas de intercambio" estará fragmentado si en realidad no tienes cuatro áreas de intercambio. Por ejemplo, si tienes dos áreas de intercambio A y B la representación del espacio de direcciones en FreeBSD para ese área de intercambio estará entrelazada en bloques de 16 páginas: + +.... +A B C D A B C D A B C D A B C D +.... + +FreeBSD 3.X utiliza una aproximación de "lista secuencial de regiones libres" para contabilizar las áreas de intercambio libres. La idea es que grandes bloques de espacio lineal libre puede ser representado con un único nodo en la lista ([.filename]#kern/subr_rlist.c#). Pero debido a la fragmentación la lista termina estando completamente fragmentada. En el ejemplo superior, espacio de intercambio completamente sin utilizar hará que A y B se muestren como "libre" y C y D como "todo asignado". Cada secuencia A-B requiere un nodo en la lista para ser contabilizado porque C y D son huecos, así que el nodo de la lista no puede ser combinado junto con la siguiente secuencia A-B. + +¿Por qué entrelazamos nuestro espacio de intercambio en lugar de mover las áreas hacia el final y hacer algo más interesante? Es mucho más fácil asignar rondas lineales de un espacio de direcciones y luego entrelazar automáticamente el resultado en múltiples discos en lugar de tratar de poner toda esa sofisticación en otro lado. + +La fragmentación causa otros problemas. Al utilizar una lista lineal en 3.X, y tener una cantidad tan grande de fragmentación, asignar y liberar intercambio termina siendo un algoritmo O(N) en lugar de un algoritmo O(1). Junto con otros factores (mucho acceso al intercambio) y empiezas a tener niveles de sobrecarga de orden O(N^2) y O(N^3), lo que es malo. El sistema 3.X puede necesitar además asignar Memoria Virtual del Núcleo durante una operación de intercambio para crear un nuevo nodo en la lista lo que puede producir un bloqueo si el sistema está intentando desalojar páginas en una situación de memoria baja. + +En 4.X no utilizamos una lista secuencial. En su lugar utilizamos un árbol radix y mapas de bits de bloques de intercambio en lugar de nodos de listas por rangos. Sufrimos la penalización de preasignar todos los mapas de bits necesarios para todo el área de intercambio pero esto al final desaprovecha menos memoria debido al uso de un mapa de bits (un bit por bloque) en lugar de una lista enlazada de nodos. El uso del árbol radix en lugar de una lista secuencia nos proporciona un rendimiento de casi O(1) independientemente de cómo de fragmentado esté el árbol. + +=== ¿Cómo se relaciona la separación de páginas limpias y sucias (inactivas) con la situación donde puedes ver contadores bajos de la lista de cache y contadores altos de la lista activa en `systat -vm`? ¿Las estadísticas de systat cuentan las páginas activas y las sucias de forma conjunta en el contador de la cola activa? + +Sí, eso es confuso. La relación es "objetivo" versus "realidad". Nuestro objeto es separar las páginas pero la realidad es que si no estamos en una crisis de memoria, en realidad no necesitamos hacerlo. + +Esto significa que FreeBSD no intentará demasiado fuerte separar las páginas sucias (cola inactiva) de las limpias (cola de caché ) cuando el sistema no está bajo estrés, ni intentará desactivar páginas (cola activa -> cola inactiva) cuando el sistema no está bajo estrés, incluso si no están siendo utilizadas. + +=== En el ejemplo de man:ls[1] / `vmstat 1`, algunos de los fallos de página no serían fallos de páginas de datos (COW del fichero del ejecutable a una página privada)? Es decir, esperaría algunos fallos de página fueran de rellenado de ceros y otros de datos de programa. ¿O te refieres a que FreeBSD hace pre-COW para los datos de programa? + +Un fallo COW puede ser de rellenado de ceros o de datos de programa. El mecanismo es el mismo en cualquier caso porque el los datos de respaldo del programa ya estarán en la caché. De hecho estoy mezclando los dos. FreeBSD no hace pre-COW de los datos de programa o de rellenado de ceros, pero _sí_ premapea páginas que existen en la caché. + +=== En la sección de optimizaciones de la tabla de páginas, puedes dar algo más de detalle acerca de `pv_entry` y `vm_page` (o debería vm_page ser `vm_pmap`—como en 4.4, cf. pp. 180-181 de McKusick, Bostic, Karel, Quarterman)? Específicamente, ¿qué tipo de operación/reacción requeriría un escaneo de los mapas? + +Un `vm_page` representa una tupla (objeto,índice#). Un `pv_entry` representa una entrada de la tabla de páginas hardware (pte). Si tienes cinco procesos compartiendo la misma página física y la tabla de páginas de tres de esos procesos mapean la página, ésta será representada mediante una sola estructura `vm_page` y tres estructuras `pv_entry`. + +Las estructuras `pv_entry` sólo representan páginas mapeadas por la MMU (una `pv_entry` representa una pte). Esto significa que cuando necesitamos eliminar todas las referencias hardware a la `vm_page` (para reutilizar la página para otra cosa, pasarla a disco, borrarla, marcarla como sucia y demás) podemos simplemente escanear la lista enlazada de estructuras `pv_entry` asociadas con esa `vm_page` y eliminar o modificar la pte de sus tablas de páginas. + +En Linux no existe dicha lista enlazada. Para eliminar todos los mapeos de tablas de páginas hardware para una `vm_page` linux debe acceder a cada objeto de Memoria Virtual que _podría_ haber mapeado la página. Por ejemplo, si tienes 50 procesos todos mapeando la misma biblioteca compartida y quieres eliminar la página X de esa biblioteca, necesitas acceder a la tabla de páginas de cada uno de esos 50 procesos incluso si sólo 10 de ellos han mapeado la página. Así que Linux está favoreciendo la simplicidad en el diseño por el rendimiento. Muchos algoritmos de Memoria Virtual que son O(1) o (una N pequeña) en FreeBSD terminan siendo O(N), O(N^2), o peor en Linux. Puesto que los pte que representan una página concreta en un objeto suelen estar en el mismo desplazamiento en todas las tablas de páginas en las que están mapeadas, reducir el número de accesos a las tablas de páginas en el mismo desplazamiento del pte evitará por lo general que se destruya la línea de cac hé L1 para ese desplazamiento, lo que puede conllevar un mejor rendimiento. + +FreeBSD tiene más complejidad (el esquema de `pv_entry`) para mejorar el rendimiento (para limitar los accesos a la tabla de páginas _sólo_ a aquellos pte que necesitan ser modificados). + +Pero FreeBSD tiene un problema de escalado que Linux no tiene en cuento a que hay un número limitado de estructuras `pv_entry` y esto causa problemas cuando tienes datos masivamente compartidos. En esta caso podrías agotar las estructuras `pv_entry` incluso si hay memoria libre disponible de sobra. Esto se puede solucionar bastante fácilmente aumentando el número de estructuras `pv_entry` en la configuración del núcleo, pero necesitamos encontrar una forma mejor de hacerlo. + +Respecto a la sobrecarga de memoria de una tabla de páginas versus el esquema de `pv_entry`: Linux utiliza tablas de páginas "permanentes" que no se descartan, pero no necesita una `pv_entry` para cada pte potencialmente mapeado. FreeBSD utiliza tablas de páginas "desechables" pero añade una estructura `pv_entry` para cada pte que esté realmente mapeado. Creo que la utilización de memoria termina siendo la misma, dándole a FreeBSD una ventaja algorítmica con su habilidad para desechar tablas de páginas a voluntad con muy poca sobrecarga. + +=== Por último, en la sección de coloreado de páginas, podría ayudar describir un poco más a lo que te refieres. No lo seguí del todo. + +¿Sabes cómo funciona una memoria caché hardware L1? Lo explicaré: Imagina una máquina con 16MB de memoria principal pero sólo 128K de caché L1. Normalmente esta caché funciona de modo que cada bloque de 128K de memoria principal utiliza _los mismos_ 128K de caché. Si accedes al desplazamiento 0 en memoria principal y luego al desplazamiento 128L en memoria principal ¡terminas descartando los datos cacheados que leíste del desplazamiento 0! + +Ahora bien, esto simplificando mucho las cosas. Lo que he descrito es lo que se llama una caché de memoria hardware de "mapeo directo". La mayoría de cachés modernas son lo que se llaman cachés asociativas de conjuntos de doble sentido o cachés asociativas de conjuntos de cuádruple sentido. La asociación por conjuntos te permite acceder hasta N regiones de memoria distintas que se solapan en la misma memoria de caché sin destruir los datos cacheados previamente. Pero sólo N. + +Así que si tenemos una caché de conjuntos asociativa de cuádruple sentido puedo acceder los desplazamientos 0, 128K, 256K y 384K y todavía ser capaz de acceder al desplazamiento 0 de nuevo y que me lo devuelva de la caché L1. Se luego accedo al desplazamiento 512K, sin embargo, uno de loas cuatro objetos de datos cacheados previamente será descartado por la caché. + +Es extremadamente importante... _extremadamente_ importante que la mayoría de accesos a memoria del procesador vengan de la caché L1, porque la caché L1 opera a la frecuencia del procesador. En el momento en el que tienes una pérdida en la caché L1 y tienes que ir a la caché L2 o a la memoria principal, el procesador parará y potencialmente se sentaría a esperar durante un tiempo equivalente a _cientos_ de instrucciones hasta que la lectura de memoria principal se complete. La memoria principal (la memoria dinámica que pones en tu ordenador) es _lenta_, cuando se compara con la velocidad del procesador. + +Ok, ahora vamos con el coloreado de páginas: Todas las memorias caché modernas con lo que se conoce como cachés _físicas_. Cachean direcciones de memoria física, no direcciones de memoria virtual. Esto permite no molestar a la caché durante un cambio de contexto de procesos, lo que es muy importante. + +Pero en el mundo UNIX(R) tú tratas con espacios de direcciones virtuales, no espacios de direcciones físicas. Cualquier programa que escribas verá un espacio de direcciones virtuales que se le ha proporcionado. Las páginas virtuales _reales_ que están por debajo del espacio de direcciones virtuales ¡no están necesariamente contiguas físicamente! De hecho, podrías tener dos páginas que están pegadas una a la otra en el espacio de direcciones del proceso y que terminan estando en el desplazamiento 0 y el desplazamiento 128K en memoria _física_. + +Un programa normalmente asume que dos páginas que están una al lado de la otra serán cacheadas de forma óptima. Es decir, que puedes acceder a objetos de datos en ambas páginas sin tener que destrozar las entradas de caché de la otra página. Pero esto sólo es cierto si las páginas físicas bajo el espacio de memoria virtual son contiguas (en lo que a la caché se refiere). + +Esto es lo que hace el coloreado de páginas. En lugar de asignar páginas físicas de forma _aleatoria_, lo que podría resultar en un rendimiento de caché no óptimo, el coloreado de Páginas asigna páginas físicas _razonablemente contiguas_ a direcciones virtuales. Por lo tanto los programas se pueden escribir asumiendo que las características de la caché hardware subyacente son las mismas para el espacio de direcciones virtuales a como serían si el programa estuviera ejecutándose directamente en un espacio de direcciones físicas. + +Nótese que digo "razonablemente" contiguas en lugar de simplemente "contiguas". Desde el punto de vista de una caché de mapeo directo de 128K, la dirección física 0 es la misma que la dirección física 128K. De modo que dos páginas una al lado de la otra en tu espacio de memoria virtual podrían terminar siendo el desplazamiento 128K y 132K en memoria física, pero podría fácilmente ser también el desplazamiento 128K y 4K en memoria física y mantener todavía las mismas características de rendimiento de la caché. Así que el coloreado de páginas _no_ tiene que asignar páginas de memoria física realmente contiguas a páginas de memoria virtual que sí lo son, sólo necesita asegurarse de que asigna páginas contiguas desde el punto de vista del rendimiento y la operativa de la caché. From owner-dev-commits-doc-all@freebsd.org Wed Apr 21 08:10:59 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C06F45FC0A8 for ; Wed, 21 Apr 2021 08:10:59 +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 4FQCtC4z8Sz4n1r; Wed, 21 Apr 2021 08:10:59 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 9D95822C13; Wed, 21 Apr 2021 08:10:59 +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 13L8AxKA042552; Wed, 21 Apr 2021 08:10:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13L8Axkt042551; Wed, 21 Apr 2021 08:10:59 GMT (envelope-from git) Date: Wed, 21 Apr 2021 08:10:59 GMT Message-Id: <202104210810.13L8Axkt042551@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ka Ho Ng Subject: git: 0a0df62229 - main - books/porters-handbook: Fix git server link MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: khng X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0a0df62229478edf7dd4f6bca75b38e143f2bb19 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Apr 2021 08:10:59 -0000 The branch main has been updated by khng (src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=0a0df62229478edf7dd4f6bca75b38e143f2bb19 commit 0a0df62229478edf7dd4f6bca75b38e143f2bb19 Author: Ka Ho Ng AuthorDate: 2021-04-21 08:10:36 +0000 Commit: Ka Ho Ng CommitDate: 2021-04-21 08:10:36 +0000 books/porters-handbook: Fix git server link https://git.FreeBSD.org is the correct URL to our git public server. Reported by: Hung-Yi Chen Reviewed by: delphij Approved by: lwhsu Differential Revision: https://reviews.freebsd.org/D29879 --- documentation/content/en/books/porters-handbook/upgrading/_index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc index dc01bd897b..1b383ebfa0 100644 --- a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc +++ b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc @@ -88,13 +88,13 @@ When possible, please submit a man:git[1] diff. They are easier to handle than d [source,shell] .... % cd ~/my_ports_wrkdir <.> -% git clone https://cgit.FreeBSD.org/ports.git <.> +% git clone https://git.FreeBSD.org/ports.git <.> % cd ~/my_wrkdir/dns/pdnsd .... <.> This can be anywhere, of course. Building ports is not limited to within [.filename]#/usr/ports/#. -<.> https://cgit.FreeBSD.org/[cgit.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}#svn-mirrors[Subversion mirror sites] for more information. +<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}#svn-mirrors[Subversion mirror sites] for more information. While in the port directory, make any changes that are needed. If adding, moving, or removing a file, use `git` to track these changes: From owner-dev-commits-doc-all@freebsd.org Wed Apr 21 23:24:28 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 6DD795F531B for ; Wed, 21 Apr 2021 23:24:28 +0000 (UTC) (envelope-from koobs.freebsd@gmail.com) Received: from mail-pg1-x52f.google.com (mail-pg1-x52f.google.com [IPv6:2607:f8b0:4864:20::52f]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FQc8C5hqjz4bcQ; Wed, 21 Apr 2021 23:24:27 +0000 (UTC) (envelope-from koobs.freebsd@gmail.com) Received: by mail-pg1-x52f.google.com with SMTP id p12so31446604pgj.10; Wed, 21 Apr 2021 16:24:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:message-id:date:mime-version:user-agent:reply-to:subject :content-language:to:cc:references:from:in-reply-to :content-transfer-encoding; bh=XO1aX6PHA1RCCMbb542ks6UOhbwQCtZ5Q1O0UeVh6nM=; b=YN61f7ADFG+zpAUSg9U902SMi/DquABsxN08t80g8e3nRGe8E1cuon7JOqr6bBrDsa PzFCeSLm7gGEuL9IlDzXyjsks/phbVafHNJGm+POSpHSE+napf3fZEFQyKmOjmZlYYty EIcVY/ehx1uUkyxrbuCUoAMM7zxi4CqlePkfnIZW/12pRVoSiYYc2rKreKh/RFajoqVV Qco8Mr8J1NEo+Goyih26mW23QoGlJFg4cyp3+ZYLMbUPf4CQcNSkmw/S6GMD16yGI6v2 z2a54A8JcD6quweLGMf85wwDa+S1C8xgdLQIAZhZrpmaXvUpFS2gSy5gOVglg2LbqVuQ p0qw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:message-id:date:mime-version:user-agent :reply-to:subject:content-language:to:cc:references:from:in-reply-to :content-transfer-encoding; bh=XO1aX6PHA1RCCMbb542ks6UOhbwQCtZ5Q1O0UeVh6nM=; b=eas43+4f3GdRfuq43YCfVyqbDizYpw6wONdOdzTSUkwihLWMUIPZ410ryEl0gWuNmI bpKoaxtF+7q31WF3+k/GkWzM0904b1Amnnut0HUzS5qHM/mnuNjlpVqJv4TA2bo8dIm7 rI/xphaT/RYD9jkY7/iGCx2ETT+sQvf1IFsDBZpKD94pmGgbMmpzILrAYqKwWCXSat5v lWTN/O6uK3u8YNGCqFlJwcUuIrwv9ggZNzLp7HrS9C5QTdK3sOSkldv7HMgHz99V/YAb O/RDx0hX/UmxoMKFm+ELLTUKIX7wlVIBigoWW+UoerUAdbDr6z2p0u9maUMuB4Nlkx4f Nl5g== X-Gm-Message-State: AOAM530O55mEW9In+8j36RiLWjwp9FblOvm6bYxxkk0oDzBMuAgnVSjk yA9whpqbnJdZE0c5Hb5otFWUq4yged6otkTA X-Google-Smtp-Source: ABdhPJzGf2pVPdwUfzPptpACrT5tOSxc6PMXXwnkiyzryBzQREgOUpEGGRBReDiuFdab+jBGiU80GQ== X-Received: by 2002:a17:90a:66c3:: with SMTP id z3mr14399912pjl.196.1619047465889; Wed, 21 Apr 2021 16:24:25 -0700 (PDT) Received: from [2403:5800:7500:3601:1098:d4a6:ef0d:2107] (2403-5800-7500-3601-1098-d4a6-ef0d-2107.ip6.aussiebb.net. [2403:5800:7500:3601:1098:d4a6:ef0d:2107]) by smtp.gmail.com with UTF8SMTPSA id gt22sm377117pjb.7.2021.04.21.16.24.23 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 21 Apr 2021 16:24:25 -0700 (PDT) Sender: Kubilay Kocak Message-ID: <6d8a9c8f-4c12-26ab-2d48-0978b95e31b3@FreeBSD.org> Date: Thu, 22 Apr 2021 09:24:20 +1000 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:90.0) Gecko/20100101 Thunderbird/90.0a1 Reply-To: koobs@FreeBSD.org Subject: Re: git: c5f5a82112 - main - FAQ: Update bits about getting a ports tree Content-Language: en-US To: Mathieu Arnold , Mateusz Piotrowski <0mp@freebsd.org> Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org References: <202104191008.13JA8Rng066319@gitrepo.freebsd.org> <20210419104851.ygnf5l74lbby7zf5@aching.in.mat.cc> <2eea18b9-a493-15ce-47e7-897540929c81@FreeBSD.org> <20210419122400.u7h6xzypr243e62m@aching.in.mat.cc> From: Kubilay Kocak In-Reply-To: <20210419122400.u7h6xzypr243e62m@aching.in.mat.cc> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 4FQc8C5hqjz4bcQ X-Spamd-Bar: --- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=gmail.com header.s=20161025 header.b=YN61f7AD; dmarc=none; spf=pass (mx1.freebsd.org: domain of koobsfreebsd@gmail.com designates 2607:f8b0:4864:20::52f as permitted sender) smtp.mailfrom=koobsfreebsd@gmail.com X-Spamd-Result: default: False [-3.20 / 15.00]; HAS_REPLYTO(0.00)[koobs@FreeBSD.org]; TO_DN_SOME(0.00)[]; R_SPF_ALLOW(-0.20)[+ip6:2607:f8b0:4000::/36]; REPLYTO_ADDR_EQ_FROM(0.00)[]; RCVD_COUNT_THREE(0.00)[3]; DKIM_TRACE(0.00)[gmail.com:+]; NEURAL_HAM_SHORT(-1.00)[-1.000]; FORGED_SENDER(0.30)[koobs@FreeBSD.org,koobsfreebsd@gmail.com]; RCVD_TLS_LAST(0.00)[]; MIME_TRACE(0.00)[0:+]; FREEMAIL_ENVFROM(0.00)[gmail.com]; MID_RHS_MATCH_FROM(0.00)[]; TAGGED_FROM(0.00)[]; ASN(0.00)[asn:15169, ipnet:2607:f8b0::/32, country:US]; ARC_NA(0.00)[]; RBL_DBL_DONT_QUERY_IPS(0.00)[2607:f8b0:4864:20::52f:from]; R_DKIM_ALLOW(-0.20)[gmail.com:s=20161025]; FROM_NEQ_ENVFROM(0.00)[koobs@FreeBSD.org,koobsfreebsd@gmail.com]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; TO_MATCH_ENVRCPT_ALL(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[FreeBSD.org]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; SPAMHAUS_ZRD(0.00)[2607:f8b0:4864:20::52f:from:127.0.2.255]; RCVD_IN_DNSWL_NONE(0.00)[2607:f8b0:4864:20::52f:from]; MAILMAN_DEST(0.00)[dev-commits-doc-all] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Apr 2021 23:24:28 -0000 On 19/04/2021 10:24 pm, Mathieu Arnold wrote: > On Mon, Apr 19, 2021 at 01:28:08PM +0200, Mateusz Piotrowski wrote: >> On 19/04/2021 12:48, Mathieu Arnold wrote: >>> On Mon, Apr 19, 2021 at 10:08:27AM +0000, Mateusz Piotrowski wrote: >>>> The branch main has been updated by 0mp: >>>> >>>> URL: https://cgit.FreeBSD.org/doc/commit/?id=c5f5a82112f0de78da06ae73c19e4c99d4bb3111 >>>> >>>> commit c5f5a82112f0de78da06ae73c19e4c99d4bb3111 >>>> Author: Mateusz Piotrowski <0mp@FreeBSD.org> >>>> AuthorDate: 2021-04-19 10:00:11 +0000 >>>> Commit: Mateusz Piotrowski <0mp@FreeBSD.org> >>>> CommitDate: 2021-04-19 10:00:11 +0000 >>>> >>>> FAQ: Update bits about getting a ports tree >>>> - Link to the portsnap manual >>>> - Replace Subversion with Git >>> Might want to provide other means to get the ports tree than portsnap, >>> it is not really supported any more, say, gitup for example. >> >> Good point overall but isn't portsnap being brought back at the moment? > > Mmmm, this is a separate issue, portsnap may work, it is just not a > supported way to get the ports tree. It's not? The community is hearing conflicting information about this. > >> Also, ideally, we'd just rewrite that FAQ entry to just point to appropriate handbook chapters. > > Probably, yes. > From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 06:23:10 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id DDB0D5E0CAF for ; Thu, 22 Apr 2021 06:23:10 +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 4FQnRL5svFz3CS0; Thu, 22 Apr 2021 06:23:10 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 BCBF614F02; Thu, 22 Apr 2021 06:23:10 +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 13M6NA88013392; Thu, 22 Apr 2021 06:23:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M6NAFJ013391; Thu, 22 Apr 2021 06:23:10 GMT (envelope-from git) Date: Thu, 22 Apr 2021 06:23:10 GMT Message-Id: <202104220623.13M6NAFJ013391@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: 8f3c366fd2 - main - [committers-guide] Update src branches information MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8f3c366fd271b1a7778e9245bc6c11ad531daf40 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 06:23:10 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=8f3c366fd271b1a7778e9245bc6c11ad531daf40 commit 8f3c366fd271b1a7778e9245bc6c11ad531daf40 Author: Fernando Apesteguía AuthorDate: 2021-04-21 16:37:45 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-21 16:39:58 +0000 [committers-guide] Update src branches information Summary: s/SVN/Git s/head/main Although there are other branches in the repo (like vendor/ or releng/), if they were not considered noteworthy before, I choose not make them notheworthy now. Test Plan: * Renders OK. Reviewers: 0mp, gbe Differential Revision: https://reviews.freebsd.org/D29886 --- documentation/content/en/articles/committers-guide/_index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 1b698c39a9..ffab5e8ddd 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -73,8 +73,8 @@ toc::[] |_Ports Management Team monthly reports_ |[.filename]#/home/portmgr/public/monthly-reports# on the `FreeBSD.org` cluster. -|_Noteworthy `src/` SVN Branches:_ -|`stable/n` (`n`-STABLE), `head` (-CURRENT) +|_Noteworthy `src/` Git Branches:_ +|`stable/n` (`n`-STABLE), `main` (-CURRENT) |=== man:ssh[1] is required to connect to the project hosts. For more information, see <>. From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 06:26:56 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 67BB05E0D4D for ; Thu, 22 Apr 2021 06:26:56 +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 4FQnWh2Wwyz3CYD; Thu, 22 Apr 2021 06:26:56 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 4970A14BD9; Thu, 22 Apr 2021 06:26:56 +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 13M6Quk1013899; Thu, 22 Apr 2021 06:26:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M6Qucv013898; Thu, 22 Apr 2021 06:26:56 GMT (envelope-from git) Date: Thu, 22 Apr 2021 06:26:56 GMT Message-Id: <202104220626.13M6Qucv013898@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: 69fe0eea04 - main - [committers-guide] Consistent use of Subversion MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 69fe0eea04c0e6927b90d5f8f4b5e0c45cea267d Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 06:26:56 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=69fe0eea04c0e6927b90d5f8f4b5e0c45cea267d commit 69fe0eea04c0e6927b90d5f8f4b5e0c45cea267d Author: Fernando Apesteguía AuthorDate: 2021-04-21 16:46:51 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-22 06:22:52 +0000 [committers-guide] Consistent use of Subversion Majority of the uses capitalize the first letter. Let the rest do the same. Approved by: 0mp Differential Revision: https://reviews.freebsd.org/D29888 --- .../content/en/articles/committers-guide/_index.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index ffab5e8ddd..f55b9dc0bc 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -499,7 +499,7 @@ Stashing is also integrated with the 'git pull' command: just add '--autostash' ===== Keeping a local branch [[keeping_a_local_branch]] It is much easier to keep a local branch with Git than Subversion. -In subversion you need to merge the commit, and resolve the conflicts. +In Subversion you need to merge the commit, and resolve the conflicts. This is manageable, but can lead to a convoluted history that's hard to upstream should that ever be necessary, or hard to replicate if you need to do so. Git also allows one to merge, along with the same problems. That's one way to manage the branch, but it's the least flexible. @@ -811,7 +811,7 @@ When committing source commits to stable and releng branches, we have the follow * Avoid introducing known breakage into stable and releng branches. * Allow developers to determine which changes have or have not been landed from one branch to another. -With subversion, we used the following practices to achieve these goals: +With Subversion, we used the following practices to achieve these goals: * Using 'MFC' and 'MFS' tags to mark commits that merged changes from another branch. * Squashing fixup commits into the main commit when merging a change. @@ -819,7 +819,7 @@ With subversion, we used the following practices to achieve these goals: With Git, we will need to use different strategies to achieve the same goals. This document aims to define best practices when merging source commits using Git that achieve these goals. -In general, we aim to use Git's native support to achieve these goals rather than enforcing practices built on subversion's model. +In general, we aim to use Git's native support to achieve these goals rather than enforcing practices built on Subversion's model. One general note: due to technical differences with Git, we will not be using Git "merge commits" (created via `git merge`) in stable or releng branches. Instead, when this document refers to "merge commits", it means a commit originally made to `main` that is replicated or "landed" to a stable branch, or a commit from a stable branch that is replicated to a releng branch with some variation of `git cherry-pick`. @@ -851,7 +851,7 @@ When merging multiple commits, keep all the "cherry picked from" lines. ===== Trim Metadata? -One area that was not clearly documented with subversion (or even CVS) is how to format metadata in log messages for MFC commits. +One area that was not clearly documented with Subversion (or even CVS) is how to format metadata in log messages for MFC commits. Should it include the metadata from the original commit unchanged, or should it be altered to reflect information about the MFC commit itself? Historical practice has varied, though some of the variance is by field. @@ -1399,7 +1399,7 @@ Either build it from ports, or install it using pkg (though some folks might use If you have no changes pending, the migration is straightforward. In this, you abandon the Subversion tree and clone the Git repository. -It's likely best to retain your subversion tree, in case there's something you've forgotten about there. +It's likely best to retain your Subversion tree, in case there's something you've forgotten about there. First, let's clone the repository: [source,shell] @@ -2915,7 +2915,7 @@ Phabricator accounts cannot be merged, please do not open a new account. Besides the repository meisters, there are other FreeBSD project members and teams whom you will probably get to know in your role as a committer. Briefly, and by no means all-inclusively, these are: `{doceng}`:: -doceng is the group responsible for the documentation build infrastructure, approving new documentation committers, and ensuring that the FreeBSD website and documentation on the FTP site is up to date with respect to the subversion tree. +doceng is the group responsible for the documentation build infrastructure, approving new documentation committers, and ensuring that the FreeBSD website and documentation on the FTP site is up to date with respect to the Subversion tree. It is not a conflict resolution body. The vast majority of documentation related discussion takes place on the {freebsd-doc}. More details regarding the doceng team can be found in its https://www.FreeBSD.org/internal/doceng/[charter]. From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 06:28:33 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id E94A55E0F96 for ; Thu, 22 Apr 2021 06:28:33 +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 4FQnYY6Hnfz3CYH; Thu, 22 Apr 2021 06:28:33 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 CB3FF14EAD; Thu, 22 Apr 2021 06:28:33 +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 13M6SXew014196; Thu, 22 Apr 2021 06:28:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M6SX7S014195; Thu, 22 Apr 2021 06:28:33 GMT (envelope-from git) Date: Thu, 22 Apr 2021 06:28:33 GMT Message-Id: <202104220628.13M6SX7S014195@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: 0eb1ef29d9 - main - [committers-guide] Fix typo MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0eb1ef29d9e8d02ee45d9397632f841c13ceb462 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 06:28:34 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=0eb1ef29d9e8d02ee45d9397632f841c13ceb462 commit 0eb1ef29d9e8d02ee45d9397632f841c13ceb462 Author: Fernando Apesteguía AuthorDate: 2021-04-21 16:53:50 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-22 06:24:48 +0000 [committers-guide] Fix typo s/relese/release Approved by: 0mp Differential Revision: https://reviews.freebsd.org/D29889 --- documentation/content/en/articles/committers-guide/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index f55b9dc0bc..585d2b1478 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -2552,7 +2552,7 @@ There are several cases where approval is customary: * while a new committer is under mentorship * commits to an area of the tree to which you do not usually commit -* during a relese cycle +* during a release cycle * committing to a repo where you do not hold a commit bit (e.g. src committer committing to docs) While under mentorship, get mentor approval before the commit. Enter the mentor's username in this field, and note that they are a mentor: From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 06:32:25 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id E081D5E12B8 for ; Thu, 22 Apr 2021 06:32:25 +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 4FQnf1668Wz3CjS; Thu, 22 Apr 2021 06:32:25 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 C48D614FB8; Thu, 22 Apr 2021 06:32:25 +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 13M6WPxt026143; Thu, 22 Apr 2021 06:32:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M6WPpi026142; Thu, 22 Apr 2021 06:32:25 GMT (envelope-from git) Date: Thu, 22 Apr 2021 06:32:25 GMT Message-Id: <202104220632.13M6WPpi026142@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: a30982fef8 - main - [committers-guide] Remove obsolete misc question MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a30982fef8762f3ea80e1840bad9c9f289ba8a3f Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 06:32:25 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=a30982fef8762f3ea80e1840bad9c9f289ba8a3f commit a30982fef8762f3ea80e1840bad9c9f289ba8a3f Author: Fernando Apesteguía AuthorDate: 2021-04-22 06:03:57 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-22 06:28:34 +0000 [committers-guide] Remove obsolete misc question Adding files in Git does not requiere special considerations. Approved by: 0mp Differential Revision: https://reviews.freebsd.org/D29884 --- documentation/content/en/articles/committers-guide/_index.adoc | 7 ------- 1 file changed, 7 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 585d2b1478..e47a0ddff2 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -3648,13 +3648,6 @@ Blanket approval for most ports applies to these types of fixes: * Trivial and _tested_ build and runtime fixes. * Documentations or metadata changes to ports, like [.filename]#pkg-descr# or `COMMENT`. -=== How do I add a new file to a branch? - -To add a file onto a branch, simply checkout or update to the branch you want to add to and then add the file using the add operation as you normally would. -This works fine for the `doc` and `ports` trees. -The `src` tree uses SVN and requires more care because of the `mergeinfo` properties. -See the <> for details on how to perform an MFC. - === How do I access people.FreeBSD.org to put up personal or project information? `people.FreeBSD.org` is the same as `freefall.FreeBSD.org`. From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 07:28:38 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C321A5E21B7 for ; Thu, 22 Apr 2021 07:28:38 +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 4FQptt59fkz3FGN; Thu, 22 Apr 2021 07:28:38 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 A4B1A15769; Thu, 22 Apr 2021 07:28:38 +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 13M7Sco0094128; Thu, 22 Apr 2021 07:28:38 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M7SctH094127; Thu, 22 Apr 2021 07:28:38 GMT (envelope-from git) Date: Thu, 22 Apr 2021 07:28:38 GMT Message-Id: <202104220728.13M7SctH094127@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: 5e5b9e25d7 - main - [handbook] Show how to configure sleep on lid closure MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5e5b9e25d72bb4001933071b41aeaedf932384e9 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 07:28:38 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=5e5b9e25d72bb4001933071b41aeaedf932384e9 commit 5e5b9e25d72bb4001933071b41aeaedf932384e9 Author: Fernando Apesteguía AuthorDate: 2021-04-22 07:20:14 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-22 07:23:42 +0000 [handbook] Show how to configure sleep on lid closure Add information about how to make FreeBSD sleep and resume when the lid state switches. Approved By: 0mp (mentor) Differential Revision: https://reviews.freebsd.org/D29897 --- .../content/en/books/handbook/config/_index.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc index 23640b3584..4b39749713 100644 --- a/documentation/content/en/books/handbook/config/_index.adoc +++ b/documentation/content/en/books/handbook/config/_index.adoc @@ -1406,6 +1406,21 @@ A common problem with suspend/resume is that many device drivers do not save, re This test emulates the suspend/resume cycle of all device drivers without actually going into `S3` state. In some cases, problems such as losing firmware state, device watchdog time out, and retrying forever, can be captured with this method. Note that the system will not really enter `S3` state, which means devices may not lose power, and many will work fine even if suspend/resume methods are totally missing, unlike real `S3` state. +If the previous test worked, on a laptop it is possible to configure the system +to suspend into `S3` on lid close and resume when it is open back again: + +[source,shell] +.... +# sysctl hw.acpi.lid_switch_state=S3 +.... + +This change can be made persistent across reboots: + +[source,shell] +.... +# echo ‘hw.acpi.lid_switch_state=S3’ >> /etc/sysctl.conf +.... + Harder cases require additional hardware, such as a serial port and cable for debugging through a serial console, a Firewire port and cable for using man:dcons[4], and kernel debugging skills. To help isolate the problem, unload as many drivers as possible. If it works, narrow down which driver is the problem by loading drivers until it fails again. Typically, binary drivers like [.filename]#nvidia.ko#, display drivers, and USB will have the most problems while Ethernet interfaces usually work fine. If drivers can be properly loaded and unloaded, automate this by putting the appropriate commands in [.filename]#/etc/rc.suspend# and [.filename]#/etc/rc.resume#. Try setting `hw.acpi.reset_video` to `1` if the display is messed up after resume. Try setting longer or shorter values for `hw.acpi.sleep_delay` to see if that helps. From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 07:34:17 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 1A9695E2273 for ; Thu, 22 Apr 2021 07:34:17 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: from mail-ej1-f50.google.com (mail-ej1-f50.google.com [209.85.218.50]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FQq1P09ggz3Fw9; Thu, 22 Apr 2021 07:34:16 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: by mail-ej1-f50.google.com with SMTP id r9so67283582ejj.3; Thu, 22 Apr 2021 00:34:16 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=cGsaI2fCvCHBoae2SP2Qg+FRuaxR6toHNYoRI5bMU18=; b=Mi5uw4sTfQSxr5lucUOKds5XzPMEnL4/a+W1vWCjRHVZ0c4fxuRdkT6JlonBnSt8UO tVsFj/evNAi9FxVQXHc/KkPPhJJLhKJIM3tKAB1RUQKmvn9VrN5DgYCXPkF/d8B0McwY K20/qg35ZXw8WxKPEbp9JU0Sd/L29klCUVzCjP0rybYdge2ja2+3XlhSyQKmwEW0K/kk OKKlaErTY8EGXATN26fP+lfp0S0o7c2hyJ9wzAqCAHHpOOZQXCz/ZvQSlz7L5AV6KbFt /7Bpy4ObVbSIetwuQSFCg3S/Fk0sKnjWS99pq/vuxL8e9AwkTKP1w8Q6yPu4k5wuZDZ9 5LFA== X-Gm-Message-State: AOAM531CHWRWlvLQlgXAHESgplphX8jOXsRiOMHBAYjwwOmRL30W7OTR wH/Wee22DXwuBJeDPJW5SKczMEvSSr3i2A== X-Google-Smtp-Source: ABdhPJz/vEm23qZrtWzWMEtkVGfRI4d/ahDrZLugUFFpIxRtPg8k9LGFYD122m1auiAqgOAMxj7vpA== X-Received: by 2002:a17:906:44b:: with SMTP id e11mr1932909eja.551.1619076855837; Thu, 22 Apr 2021 00:34:15 -0700 (PDT) Received: from [192.168.0.106] (ip5f5bd493.dynamic.kabel-deutschland.de. [95.91.212.147]) by smtp.gmail.com with ESMTPSA id yr16sm1243742ejb.63.2021.04.22.00.34.14 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 22 Apr 2021 00:34:15 -0700 (PDT) Subject: Re: git: 5e5b9e25d7 - main - [handbook] Show how to configure sleep on lid closure To: =?UTF-8?Q?Fernando_Apestegu=c3=ada?= , doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org References: <202104220728.13M7SctH094127@gitrepo.freebsd.org> From: Mateusz Piotrowski <0mp@FreeBSD.org> Message-ID: <4917a232-d697-7724-5120-4d252b6b7178@FreeBSD.org> Date: Thu, 22 Apr 2021 09:34:28 +0200 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:78.0) Gecko/20100101 Thunderbird/78.9.1 MIME-Version: 1.0 In-Reply-To: <202104220728.13M7SctH094127@gitrepo.freebsd.org> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Content-Language: en-US X-Rspamd-Queue-Id: 4FQq1P09ggz3Fw9 X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 07:34:17 -0000 On 22/04/2021 09:28, Fernando Apesteguía wrote: > echo ‘hw.acpi.lid_switch_state=S3’ Hmm, I've not spotted that in the review. Could you fix those quotes? We should use the ASCII ones in code examples. Thanks! From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 07:39:08 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 2C7FF5E26AE for ; Thu, 22 Apr 2021 07:39:08 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: from mail-qk1-f173.google.com (mail-qk1-f173.google.com [209.85.222.173]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FQq700dWXz3Ftk; Thu, 22 Apr 2021 07:39:07 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: by mail-qk1-f173.google.com with SMTP id x11so45379107qkp.11; Thu, 22 Apr 2021 00:39:07 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=c5xrNlVcajnjc1py7Qpuk3Y6YIAuYUe1z066EzzbKIk=; b=mkM1BlSjbWhXQbAqrI9on+gP7KXmW9SmNjCgF3LUyEosgDQKNjUwsBYsBxsrat9Ttu lecQzQoCAn7IOZExKeCZkr34lyuTGmffRtnHxzwBIIk0NflKqv6nCpEd7DoUbonitiB0 cNC7Cn2Lai9L+pVkERfcbYm+CNsiv35ACUyioCQB4XUSfh6qiMTRIaiSB6/hZKuKGOWL lWKpPFPjXPEjrLgL0JL7zZY2vTtQUXcUF2iDtWq6w0StKJPgIbgZi+fSLPse/UFLfOKq wO2q60wAIVN3E4afxTT2cR8M3NqRSggaMQIag+lkYhvOqk97Yj1TljYhqnG00gdg214k qfvg== X-Gm-Message-State: AOAM532pYYD1FmG3F5KzfOLmtGvcn4S2TCap0miy5b0Wv7bNPx1/efye G0SWAbQUGMBLIP01dAdrhLyLjHjj0VQDCg== X-Google-Smtp-Source: ABdhPJzrYNVWF6/2T5J+882pisqg5YoKbZ76wCWHSr2E+0KnVqx0HvkJ542l+qGIfVqHIl/6fiREIg== X-Received: by 2002:a37:9ec4:: with SMTP id h187mr2251159qke.249.1619077146644; Thu, 22 Apr 2021 00:39:06 -0700 (PDT) Received: from mail-yb1-f173.google.com (mail-yb1-f173.google.com. [209.85.219.173]) by smtp.gmail.com with ESMTPSA id q28sm1606916qkm.15.2021.04.22.00.39.06 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 22 Apr 2021 00:39:06 -0700 (PDT) Received: by mail-yb1-f173.google.com with SMTP id i4so12735514ybe.2; Thu, 22 Apr 2021 00:39:06 -0700 (PDT) X-Received: by 2002:a25:bb41:: with SMTP id b1mr2729142ybk.249.1619077146214; Thu, 22 Apr 2021 00:39:06 -0700 (PDT) MIME-Version: 1.0 References: <202104220728.13M7SctH094127@gitrepo.freebsd.org> <4917a232-d697-7724-5120-4d252b6b7178@FreeBSD.org> In-Reply-To: <4917a232-d697-7724-5120-4d252b6b7178@FreeBSD.org> From: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= Date: Thu, 22 Apr 2021 09:35:38 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: git: 5e5b9e25d7 - main - [handbook] Show how to configure sleep on lid closure To: Mateusz Piotrowski <0mp@freebsd.org> Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: 4FQq700dWXz3Ftk X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; TAGGED_FROM(0.00)[] X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 07:39:08 -0000 On Thu, Apr 22, 2021 at 9:34 AM Mateusz Piotrowski <0mp@freebsd.org> wrote: > > On 22/04/2021 09:28, Fernando Apestegu=C3=ADa wrote: > > echo =E2=80=98hw.acpi.lid_switch_state=3DS3=E2=80=99 > > Hmm, I've not spotted that in the review. Could you fix those quotes? We = should use the ASCII ones > in code examples. Yes, will do. > > Thanks! > From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 07:45:05 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 0A1035E2AC8 for ; Thu, 22 Apr 2021 07:45:05 +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 4FQqFr6tzsz3GZ6; Thu, 22 Apr 2021 07:45:04 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 DB0F615E40; Thu, 22 Apr 2021 07:45:04 +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 13M7j4TR020344; Thu, 22 Apr 2021 07:45:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M7j4GU020343; Thu, 22 Apr 2021 07:45:04 GMT (envelope-from git) Date: Thu, 22 Apr 2021 07:45:04 GMT Message-Id: <202104220745.13M7j4GU020343@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?RmVybmFuZG8gQXBlc3RlZ3XDrWE=?= Subject: git: f82b1afba2 - main - [committers-guide] Fix quotes MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f82b1afba2221f25c4698b663565ce0bc2cc9964 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 07:45:05 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=f82b1afba2221f25c4698b663565ce0bc2cc9964 commit f82b1afba2221f25c4698b663565ce0bc2cc9964 Author: Fernando Apesteguía AuthorDate: 2021-04-22 07:40:14 +0000 Commit: Fernando Apesteguía CommitDate: 2021-04-22 07:40:14 +0000 [committers-guide] Fix quotes Follow-up for commit 5e5b9e25d72bb4001933071b41aeaedf932384e9 Reported by: 0mp Approved by: 0mp (mentor) --- documentation/content/en/books/handbook/config/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc index 4b39749713..66173c1ece 100644 --- a/documentation/content/en/books/handbook/config/_index.adoc +++ b/documentation/content/en/books/handbook/config/_index.adoc @@ -1418,7 +1418,7 @@ This change can be made persistent across reboots: [source,shell] .... -# echo ‘hw.acpi.lid_switch_state=S3’ >> /etc/sysctl.conf +# echo 'hw.acpi.lid_switch_state=S3' >> /etc/sysctl.conf .... Harder cases require additional hardware, such as a serial port and cable for debugging through a serial console, a Firewire port and cable for using man:dcons[4], and kernel debugging skills. From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 07:55:21 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id C519D5E316B for ; Thu, 22 Apr 2021 07:55:21 +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 4FQqTj4vSvz3Gkh; Thu, 22 Apr 2021 07:55:21 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 9B5E616096; Thu, 22 Apr 2021 07:55:21 +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 13M7tLmc033329; Thu, 22 Apr 2021 07:55:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M7tLQO033328; Thu, 22 Apr 2021 07:55:21 GMT (envelope-from git) Date: Thu, 22 Apr 2021 07:55:21 GMT Message-Id: <202104220755.13M7tLQO033328@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 16ca20a527 - main - handbook: Make the Git URL table name more descriptive MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 16ca20a527bce7d537375f6fab179549c07fe723 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 07:55:21 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=16ca20a527bce7d537375f6fab179549c07fe723 commit 16ca20a527bce7d537375f6fab179549c07fe723 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-22 07:48:14 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-22 07:55:25 +0000 handbook: Make the Git URL table name more descriptive "Handy URL Table" is not very informative when cross-referenced from other parts of the documentation. Reviewed by: debdrup Differential Revision: https://reviews.freebsd.org/D29919 --- documentation/content/en/books/handbook/mirrors/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index 4c0374a0a7..b4187c2139 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -451,7 +451,7 @@ There are three different repositories, `src` for the FreeBSD systerm source cod For example, the URL `https://git.FreeBSD.org/src.git` specifies the main branch of the src repository, using the `https` protocol. [[git-url-table]] -.Handy URL Table +.FreeBSD Git Repository URL Table [options="header,foooter"] |======================================================= |Item | Git URL From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 08:23:17 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 06E035E486A for ; Thu, 22 Apr 2021 08:23:17 +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 4FQr5w6lBLz3JY5; Thu, 22 Apr 2021 08:23:16 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 DAA5C16A15; Thu, 22 Apr 2021 08:23:16 +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 13M8NGCb074384; Thu, 22 Apr 2021 08:23:16 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M8NGJj074383; Thu, 22 Apr 2021 08:23:16 GMT (envelope-from git) Date: Thu, 22 Apr 2021 08:23:16 GMT Message-Id: <202104220823.13M8NGJj074383@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ka Ho Ng Subject: git: e457b6efe3 - main - books/porters-handbook: Fix numerous mismatches in section 11.1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: khng X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e457b6efe37c739fdad985344a64a3ac0c4dfe6b Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 08:23:17 -0000 The branch main has been updated by khng (src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=e457b6efe37c739fdad985344a64a3ac0c4dfe6b commit e457b6efe37c739fdad985344a64a3ac0c4dfe6b Author: Ka Ho Ng AuthorDate: 2021-04-22 07:04:59 +0000 Commit: Ka Ho Ng CommitDate: 2021-04-22 08:20:59 +0000 books/porters-handbook: Fix numerous mismatches in section 11.1 In step 1 users were told to do "cd ~/my_ports_wrkdir" but after clone the repository users were instead told to do "cd ~/my_wrkdir". Also, the git command in step 2 is not followed by either of them. The mirror sites table is outdated as well. This fix changes the whole shell code block to use the directory name my_wrkdir. Also, the repository URL table xref replaces the old SVN mirror sites xref. Reported by: Pau Amma Approved by: 0mp Differential Revision: https://reviews.freebsd.org/D29916 --- .../content/en/books/porters-handbook/upgrading/_index.adoc | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc index 1b383ebfa0..69b161d486 100644 --- a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc +++ b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc @@ -87,14 +87,13 @@ When possible, please submit a man:git[1] diff. They are easier to handle than d [source,shell] .... -% cd ~/my_ports_wrkdir <.> -% git clone https://git.FreeBSD.org/ports.git <.> +% git clone https://git.FreeBSD.org/ports.git ~/my_wrkdir <.> <.> % cd ~/my_wrkdir/dns/pdnsd .... <.> This can be anywhere, of course. Building ports is not limited to within [.filename]#/usr/ports/#. -<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}#svn-mirrors[Subversion mirror sites] for more information. +<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}mirrors/#git-url-table[FreeBSD Git Repository URL Table] for more information. While in the port directory, make any changes that are needed. If adding, moving, or removing a file, use `git` to track these changes: From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 08:36:33 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 13C4F5E558F for ; Thu, 22 Apr 2021 08:36:33 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FQrPF00Vtz3L0w; Thu, 22 Apr 2021 08:36:33 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from mail.j.mat.cc (owncloud.cube.mat.cc [IPv6:2a01:678:4:1::228]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mail.mat.cc", Issuer "R3" (verified OK)) (Authenticated sender: mat/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id CFAACB50; Thu, 22 Apr 2021 08:36:32 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from aching.in.mat.cc (unknown [IPv6:2a01:678:ab:50:14c8:2e79:9c12:8f51]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: mat@mat.cc) by mail.j.mat.cc (Postfix) with ESMTPSA id 06750942D80; Thu, 22 Apr 2021 08:36:31 +0000 (UTC) Date: Thu, 22 Apr 2021 10:36:29 +0200 From: Mathieu Arnold To: Kubilay Kocak Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Subject: Re: git: c5f5a82112 - main - FAQ: Update bits about getting a ports tree Message-ID: <20210422083629.oaalgv4ae4o67kgw@aching.in.mat.cc> References: <202104191008.13JA8Rng066319@gitrepo.freebsd.org> <20210419104851.ygnf5l74lbby7zf5@aching.in.mat.cc> <2eea18b9-a493-15ce-47e7-897540929c81@FreeBSD.org> <20210419122400.u7h6xzypr243e62m@aching.in.mat.cc> <6d8a9c8f-4c12-26ab-2d48-0978b95e31b3@FreeBSD.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="hyog5b4np3n7h7km" Content-Disposition: inline In-Reply-To: <6d8a9c8f-4c12-26ab-2d48-0978b95e31b3@FreeBSD.org> X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 08:36:33 -0000 --hyog5b4np3n7h7km Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Apr 22, 2021 at 09:24:20AM +1000, Kubilay Kocak wrote: > On 19/04/2021 10:24 pm, Mathieu Arnold wrote: > > On Mon, Apr 19, 2021 at 01:28:08PM +0200, Mateusz Piotrowski wrote: > > > On 19/04/2021 12:48, Mathieu Arnold wrote: > > > > On Mon, Apr 19, 2021 at 10:08:27AM +0000, Mateusz Piotrowski wrote: > > > > > The branch main has been updated by 0mp: > > > > >=20 > > > > > URL: https://cgit.FreeBSD.org/doc/commit/?id=3Dc5f5a82112f0de78da= 06ae73c19e4c99d4bb3111 > > > > >=20 > > > > > commit c5f5a82112f0de78da06ae73c19e4c99d4bb3111 > > > > > Author: Mateusz Piotrowski <0mp@FreeBSD.org> > > > > > AuthorDate: 2021-04-19 10:00:11 +0000 > > > > > Commit: Mateusz Piotrowski <0mp@FreeBSD.org> > > > > > CommitDate: 2021-04-19 10:00:11 +0000 > > > > >=20 > > > > > FAQ: Update bits about getting a ports tree > > > > > - Link to the portsnap manual > > > > > - Replace Subversion with Git > > > > Might want to provide other means to get the ports tree than portsn= ap, > > > > it is not really supported any more, say, gitup for example. > > >=20 > > > Good point overall but isn't portsnap being brought back at the momen= t? > >=20 > > Mmmm, this is a separate issue, portsnap may work, it is just not a > > supported way to get the ports tree. >=20 > It's not? The community is hearing conflicting information about this. portsnap is fragile, portmgr has had absolutely no success in having things evolved for years, and while it was great in the old CVS times where networks were flacky, and CVS was hard to use, there has been better alternatives, with svn, there was svnup, and with git, there is gitup. Both use the repository directly, and don't require a third party middleware. --=20 Mathieu Arnold --hyog5b4np3n7h7km Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEVhwchfRfuV0unqO5KesJApEdfgIFAmCBNYlfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDU2 MUMxQzg1RjQ1RkI5NUQyRTlFQTNCOTI5RUIwOTAyOTExRDdFMDIACgkQKesJApEd fgKjVw/+Osi54feOCp63DiYf8k1gLtQRJySKbEj8HaU/czOvxJ+MngGrNPdVmmdB J/fqupA6zvDW8dZ1IiiH9JDzpYkIu5sAUfRNgjCR9Dn65/1aFv/A3VCYivL3r+WX MJOjN/oplgv+aWjeDTJikJW5QpS8tIz+lZmzzJXrgIqrGe8yl4BHE0PI16ZLGKy7 Z6oYXsYff60df7j8k+9jwiPu6aXdcH4VARp++MU7M+f5la2OdzJ56frd9oCwHLLs 85CMdZvaLejtAF6Aet8I0gBojMpWolhxmHl+bPb7vmdMbEWVElM8JaFjDGZ0qzd7 c5SehOKudIlxWT0ErbAHZdaArYO3vNWhjBZTxTD+8MARNbXnBW3GaNVoqt8zjYND 96B3jWj9Ue2PshZbaAlC5TDQpRqD2BBWBSqCX/xSjCd7pSQdizXp08Bpp5IWy5H6 7Szmlb7+RvKUYqaW7OGIYHYhrUCaZ/e/RCLyDVfjwbTeirEbx8YuSjUJB3GV6Wsk ufhfKfGCuFlxkAl32JCi4w2qE+WCwhwKmqr8+M3E0zGnTO8QVSKh3I+EG8oTUeLj dPVIulkFjxtY/rBZzMGVUv9AitIav0NJJPopDC6u7yht+YkSv+lobpM6zVxiSpyh ehQ6rPhPzyrgmmb5Bn8LtXThkp8akNQ1+RNC7j1yRwCon3XU9b0= =8Qtp -----END PGP SIGNATURE----- --hyog5b4np3n7h7km-- From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 09:45:16 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 069F45E8205 for ; Thu, 22 Apr 2021 09:45:16 +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 4FQswW6jzyz3PMr; Thu, 22 Apr 2021 09:45:15 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 D9966179B6; Thu, 22 Apr 2021 09:45: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 13M9jFtA081016; Thu, 22 Apr 2021 09:45:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13M9jFJa081015; Thu, 22 Apr 2021 09:45:15 GMT (envelope-from git) Date: Thu, 22 Apr 2021 09:45:15 GMT Message-Id: <202104220945.13M9jFJa081015@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Hans Petter Selasky Subject: git: 4b895a34bb - main - Document __FreeBSD_version 1400007 through 1400010 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: hselasky X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4b895a34bb7e1be4b50faccc5ea55dfe4ba5f72c Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 09:45:16 -0000 The branch main has been updated by hselasky (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=4b895a34bb7e1be4b50faccc5ea55dfe4ba5f72c commit 4b895a34bb7e1be4b50faccc5ea55dfe4ba5f72c Author: Hans Petter Selasky AuthorDate: 2021-04-22 09:43:53 +0000 Commit: Hans Petter Selasky CommitDate: 2021-04-22 09:43:53 +0000 Document __FreeBSD_version 1400007 through 1400010 --- .../en/books/porters-handbook/versions/_index.adoc | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/versions/_index.adoc b/documentation/content/en/books/porters-handbook/versions/_index.adoc index 201081035c..906490dfb9 100644 --- a/documentation/content/en/books/porters-handbook/versions/_index.adoc +++ b/documentation/content/en/books/porters-handbook/versions/_index.adoc @@ -76,6 +76,26 @@ Here is a convenient list of `__FreeBSD_version` values as defined in https://cg |gitref:c96151d33509655efb7fb26768cb56a041c176f1[repository="src",length=12] |March 17, 2021 |14.0-CURRENT after adding sndstat(4) enumeration ioctls. + +|1400007 +|gitref:d36d6816151705907393889d661cbfd25c630ca8[repository="src",length=12] +|April 6, 2021 +|14.0-CURRENT after fixing wrong dlpi_tls_data. + +|1400008 +|gitref:e152bbecb221a592e7dbcabe3d1170a60f0d0dfe[repository="src",length=12] +|April 11, 2021 +|14.0-CURRENT after changing the internal KAPI between the krpc and NFS. + +|1400009 +|gitref:9ca874cf740ee68c5742df8b5f9e20910085c011[repository="src",length=12] +|April 20, 2021 +|14.0-CURRENT after adding TCP LRO support for VLAN and VxLAN. + +|1400010 +|gitref:a3a02acde1009f03dc78e979e051acee9f9247c2[repository="src",length=12] +|April 21, 2021 +|14.0-CURRENT after changing the sndstat(4) ioctls nvlist schema and definitions. |=== [[versions-13]] From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 15:24:11 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 5882C5F6276 for ; Thu, 22 Apr 2021 15:24:11 +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 4FR1Rb24ldz4W2r; Thu, 22 Apr 2021 15:24:11 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 395501C43E; Thu, 22 Apr 2021 15:24:11 +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 13MFOBn5033620; Thu, 22 Apr 2021 15:24:11 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13MFOB7D033619; Thu, 22 Apr 2021 15:24:11 GMT (envelope-from git) Date: Thu, 22 Apr 2021 15:24:11 GMT Message-Id: <202104221524.13MFOB7D033619@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: dde11c5ad8 - main - releases: add 13.0-RELEASE to the releasees page MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: dde11c5ad850dd3264f161f25fca872327edace2 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 15:24:11 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=dde11c5ad850dd3264f161f25fca872327edace2 commit dde11c5ad850dd3264f161f25fca872327edace2 Author: Glen Barber AuthorDate: 2021-04-22 15:23:40 +0000 Commit: Glen Barber CommitDate: 2021-04-22 15:23:40 +0000 releases: add 13.0-RELEASE to the releasees page Reported by: bcran Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releases/_index.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/content/en/releases/_index.adoc b/website/content/en/releases/_index.adoc index 6dec225101..854fdbedc0 100644 --- a/website/content/en/releases/_index.adoc +++ b/website/content/en/releases/_index.adoc @@ -25,6 +25,8 @@ Complete information about the release date and the estimated End-Of-Life (EOL) === Production Release +*Release {rel130-current}* ({rel130-current-date}) _link:{u-rel130-announce}[Announcement] : link:{u-rel130-notes}[Release Notes] : link:{u-rel130-installation}[Installation Instructions] : link:{u-rel130-hardware}[Hardware Compatibility List] : link:{u-rel130-readme}[Readme] : link:{u-rel130-errata}[Errata] : link:{u-rel130-signatures}[Signed Checksums]_ + *Release {rel122-current}* ({rel122-current-date}) _link:{u-rel122-announce}[Announcement] : link:{u-rel122-notes}[Release Notes] : link:{u-rel122-installation}[Installation Instructions] : link:{u-rel122-hardware}[Hardware Compatibility List] : link:{u-rel122-readme}[Readme] : link:{u-rel122-errata}[Errata] : link:{u-rel122-signatures}[Signed Checksums]_ *Release {rel114-current}* ({rel114-current-date}) _link:{u-rel114-announce}[Announcement] : link:{u-rel114-notes}[Release Notes] : link:{u-rel114-installation}[Installation Instructions] : link:{u-rel114-hardware}[Hardware Notes] : link:{u-rel114-readme}[Readme] : link:{u-rel114-errata}[Errata] : link:{u-rel114-signatures}[Checksums]_ From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 19:25:53 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id F28365FC3FC for ; Thu, 22 Apr 2021 19:25:53 +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 4FR6pT6FWWz4jdC; Thu, 22 Apr 2021 19:25:53 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 C8E681F964; Thu, 22 Apr 2021 19:25:53 +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 13MJPrse052800; Thu, 22 Apr 2021 19:25:53 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13MJProZ052799; Thu, 22 Apr 2021 19:25:53 GMT (envelope-from git) Date: Thu, 22 Apr 2021 19:25:53 GMT Message-Id: <202104221925.13MJProZ052799@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 8cc847924e - main - security: add stable/13 and releng/13.0 information MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8cc847924e7cf49f36866b1fea3c83b61336b717 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 19:25:54 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=8cc847924e7cf49f36866b1fea3c83b61336b717 commit 8cc847924e7cf49f36866b1fea3c83b61336b717 Author: Glen Barber AuthorDate: 2021-04-22 19:04:51 +0000 Commit: Glen Barber CommitDate: 2021-04-22 19:04:51 +0000 security: add stable/13 and releng/13.0 information Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/security/_index.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/content/en/security/_index.adoc b/website/content/en/security/_index.adoc index 2ce2eb63ff..cef71c7e2d 100644 --- a/website/content/en/security/_index.adoc +++ b/website/content/en/security/_index.adoc @@ -96,6 +96,8 @@ link:unsupported[Older releases] are not supported and users are strongly encour [cols=",,,",options="header",] |=== |Branch |Release |Release Date |Expected EoL +|stable/13 |n/a |n/a |January 31, 2026 +|releng/13.0 |13.0-RELEASE |April 13, 2021 |13.1-RELEASE + 3 months |stable/12 |n/a |n/a |June 30, 2024 |releng/12.2 |12.2-RELEASE |October 27, 2020 |12.3-RELEASE + 3 months |stable/11 |n/a |n/a |September 30, 2021 From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 19:25:55 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 087825FC7CE for ; Thu, 22 Apr 2021 19:25:55 +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 4FR6pV6vplz4jM8; Thu, 22 Apr 2021 19:25:54 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 E04FB1F663; Thu, 22 Apr 2021 19:25:54 +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 13MJPsGr052821; Thu, 22 Apr 2021 19:25:54 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13MJPsSr052820; Thu, 22 Apr 2021 19:25:54 GMT (envelope-from git) Date: Thu, 22 Apr 2021 19:25:54 GMT Message-Id: <202104221925.13MJPsSr052820@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 32d3b817c3 - main - security: bump version numbers MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 32d3b817c3ff1d76428f6c9383b627bf52d5c3a6 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 19:25:55 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=32d3b817c3ff1d76428f6c9383b627bf52d5c3a6 commit 32d3b817c3ff1d76428f6c9383b627bf52d5c3a6 Author: Glen Barber AuthorDate: 2021-04-22 19:05:54 +0000 Commit: Glen Barber CommitDate: 2021-04-22 19:05:54 +0000 security: bump version numbers Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/security/_index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/content/en/security/_index.adoc b/website/content/en/security/_index.adoc index cef71c7e2d..3ffa29cc72 100644 --- a/website/content/en/security/_index.adoc +++ b/website/content/en/security/_index.adoc @@ -65,8 +65,8 @@ Advisories are always signed using the FreeBSD Security Officer link:so_public_k The FreeBSD Security Officer provides security advisories for _-STABLE Branches_ and the _Security Branches_. (Advisories are not issued for the _-CURRENT Branch_, which is primarily oriented towards FreeBSD developers.) -* The -STABLE branch tags have names like `stable/10`. The corresponding builds have names like `FreeBSD 10.1-STABLE`. -* Each FreeBSD Release has an associated Security Branch. The Security Branch tags have names like `releng/10.1`. The corresponding builds have names like `FreeBSD 10.1-RELEASE-p4`. +* The -STABLE branch tags have names like `stable/13`. The corresponding builds have names like `FreeBSD 13.0-STABLE`. +* Each FreeBSD Release has an associated Security Branch. The Security Branch tags have names like `releng/13.0`. The corresponding builds have names like `FreeBSD 13.0-RELEASE-p1`. Issues affecting the FreeBSD Ports Collection are covered separately in http://vuxml.FreeBSD.org/[the FreeBSD VuXML document]. From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 19:25:56 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 2B6CC5FC6D6 for ; Thu, 22 Apr 2021 19:25:56 +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 4FR6pX0ngsz4jkC; Thu, 22 Apr 2021 19:25:56 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 0E58D1FA25; Thu, 22 Apr 2021 19:25:56 +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 13MJPtEp052842; Thu, 22 Apr 2021 19:25:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13MJPt5r052841; Thu, 22 Apr 2021 19:25:55 GMT (envelope-from git) Date: Thu, 22 Apr 2021 19:25:55 GMT Message-Id: <202104221925.13MJPt5r052841@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 63003c8f89 - main - security: bump version numbers for freebsd-update(8) upgrades MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 63003c8f896100bf6ace1755ba2e8c47afdcd377 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 19:25:56 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=63003c8f896100bf6ace1755ba2e8c47afdcd377 commit 63003c8f896100bf6ace1755ba2e8c47afdcd377 Author: Glen Barber AuthorDate: 2021-04-22 19:06:28 +0000 Commit: Glen Barber CommitDate: 2021-04-22 19:06:28 +0000 security: bump version numbers for freebsd-update(8) upgrades Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/security/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/security/_index.adoc b/website/content/en/security/_index.adoc index 3ffa29cc72..82c44a41d9 100644 --- a/website/content/en/security/_index.adoc +++ b/website/content/en/security/_index.adoc @@ -73,7 +73,7 @@ Issues affecting the FreeBSD Ports Collection are covered separately in http://v [[how]] == How to update your system -For users that have previously installed a binary version of FreeBSD (e.g., {rel120-current} or {rel112-current}), commands: +For users that have previously installed a binary version of FreeBSD (e.g., {rel123-current} or {rel114-current}), commands: `# freebsd-update fetch` From owner-dev-commits-doc-all@freebsd.org Thu Apr 22 20:07:47 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 075A25FD619 for ; Thu, 22 Apr 2021 20:07:47 +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 4FR7kp6twBz4l06; Thu, 22 Apr 2021 20:07:46 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 DB60F2018A; Thu, 22 Apr 2021 20:07:46 +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 13MK7kib006130; Thu, 22 Apr 2021 20:07:46 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13MK7kM8006127; Thu, 22 Apr 2021 20:07:46 GMT (envelope-from git) Date: Thu, 22 Apr 2021 20:07:46 GMT Message-Id: <202104222007.13MK7kM8006127@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 3b0cb15d91 - main - security: spell '2' correctly MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gjb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3b0cb15d911b07191ec01b838b8ae09dc019c6eb Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 Apr 2021 20:07:47 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=3b0cb15d911b07191ec01b838b8ae09dc019c6eb commit 3b0cb15d911b07191ec01b838b8ae09dc019c6eb Author: Glen Barber AuthorDate: 2021-04-22 20:07:21 +0000 Commit: Glen Barber CommitDate: 2021-04-22 20:07:21 +0000 security: spell '2' correctly Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/security/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/security/_index.adoc b/website/content/en/security/_index.adoc index 82c44a41d9..b26fa79152 100644 --- a/website/content/en/security/_index.adoc +++ b/website/content/en/security/_index.adoc @@ -73,7 +73,7 @@ Issues affecting the FreeBSD Ports Collection are covered separately in http://v [[how]] == How to update your system -For users that have previously installed a binary version of FreeBSD (e.g., {rel123-current} or {rel114-current}), commands: +For users that have previously installed a binary version of FreeBSD (e.g., {rel122-current} or {rel114-current}), commands: `# freebsd-update fetch` From owner-dev-commits-doc-all@freebsd.org Fri Apr 23 07:37:25 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 9D5655E312C for ; Fri, 23 Apr 2021 07:37:25 +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 4FRR2Y3kxzz3m73; Fri, 23 Apr 2021 07:37:25 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 63A3110C5; Fri, 23 Apr 2021 07:37:25 +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 13N7bP8q018675; Fri, 23 Apr 2021 07:37:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13N7bPCc018674; Fri, 23 Apr 2021 07:37:25 GMT (envelope-from git) Date: Fri, 23 Apr 2021 07:37:25 GMT Message-Id: <202104230737.13N7bPCc018674@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Matthew Seaman Subject: git: 2ec4c29abf - main - Extend the expiry date on my PGP keys for another year. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: matthew X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2ec4c29abfec7a516ee3e51245a3074986584690 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Apr 2021 07:37:25 -0000 The branch main has been updated by matthew (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=2ec4c29abfec7a516ee3e51245a3074986584690 commit 2ec4c29abfec7a516ee3e51245a3074986584690 Author: Matthew Seaman AuthorDate: 2021-04-23 07:35:58 +0000 Commit: Matthew Seaman CommitDate: 2021-04-23 07:35:58 +0000 Extend the expiry date on my PGP keys for another year. --- documentation/static/pgpkeys/matthew.key | 1217 ++++++++++++------------------ 1 file changed, 490 insertions(+), 727 deletions(-) diff --git a/documentation/static/pgpkeys/matthew.key b/documentation/static/pgpkeys/matthew.key index 6c065ce71c..b121864f14 100644 --- a/documentation/static/pgpkeys/matthew.key +++ b/documentation/static/pgpkeys/matthew.key @@ -1,20 +1,17 @@ -// $FreeBSD: head/share/pgpkeys/matthew.key 54068 2020-04-22 06:39:39Z matthew $ -// // sh addkey.sh matthew 036F6C9EE7F39EBF ; - [.literal-block-margin] .... -pub rsa4096/036F6C9EE7F39EBF 2013-09-29 [SC] [expires: 2021-04-23] +pub rsa4096/036F6C9EE7F39EBF 2013-09-29 [SC] [expires: 2022-04-23] Key fingerprint = 72CF AC21 79BC B024 B5B5 4590 036F 6C9E E7F3 9EBF uid Matthew Seaman uid Matthew Seaman uid Matthew Seaman -sub rsa4096/5D0DFEAF7BFB01B4 2013-09-29 [E] [expires: 2021-04-23] -sub rsa4096/BB23AF518E1A4013 2013-10-06 [S] [expires: 2021-04-23] -sub rsa4096/E527EC985DBEA0A8 2013-10-06 [E] [expires: 2021-04-23] -sub rsa4096/00513F10E0A9E4E7 2013-10-06 [S] [expires: 2021-04-23] -sub rsa4096/0AC81803C8520138 2013-10-06 [E] [expires: 2021-04-23] +sub rsa4096/5D0DFEAF7BFB01B4 2013-09-29 [E] [expires: 2022-04-23] +sub rsa4096/BB23AF518E1A4013 2013-10-06 [S] [expires: 2022-04-23] +sub rsa4096/E527EC985DBEA0A8 2013-10-06 [E] [expires: 2022-04-23] +sub rsa4096/00513F10E0A9E4E7 2013-10-06 [S] [expires: 2022-04-23] +sub rsa4096/0AC81803C8520138 2013-10-06 [E] [expires: 2022-04-23] .... @@ -34,723 +31,489 @@ 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 -OwvNhIccW08S+N72f+yuXWOQ/dv79cwruE26/BEXgIP09MYcOWwcUCXzOoUR3er+ -jzcsN9uFjcsBVUJLIEru1askHRzCUa5P9S9GAFBwN49HC5IJWEzdLP27FjjOG5UG -3+QZahHrjG1i6S3bIYXtaGsqNyfkp9Is7Wpj2kk+s9Ua+YMG/V5YVlbANIexa1yr -75p1W9biqXpCWnB3TaHSfI0G1t9w8K2qhR/Z1/YLIcRzZ2aHJnvbzJYw5Cs1jfNp -FytbASsxj0rbReouftlBvVWFRxsZ+oG1ZXL64/SVKMZAnfBNxd1uajp+HtoQtYoT -u88la6zcdnAhOD5JdOntN2VF8iQnDfPgkidfuSZ1C059xaRPTSRJBgMRDtOlDxgz -7Pxx/7L2jwxRY1dq6NGioflY7CCpGc7bi1K6xnf3lBL8X2nGpRAVsg9Lx1ShIWkg -NbTAcPXpXcXlJ1xqz8HS8Twadh6gIfk/RNchBIED9lkVCKHYp/XQb8T8vMwn/kTW -Um5WlPkQUFQN4D1b6+dJw4bwn/wiRS8did1MU1OytJB6tljfEUCx0uKkzqr+33MA -EQEAAYkEpAQYAQoADwIbAgUCVTqrdQUJCI0DYgKJwb0gBBkBCgBmBQJSUUKTXxSA -AAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25zLm9wZW5wZ3AuZmlmdGhob3JzZW1h -bi5uZXQxOUYxNTRFQ0JGMTEyRTUwNTQ0RTNGMzAwMDUxM0YxMEUwQTlFNEU3AAoJ -EABRPxDgqeTnTRYP/2anlXRqCpDLwCz82Yxs/OPupdJHDMUjeE31pnnNGKUpgxMw -sOP0maBqh5WW/JXE3r5jazV4OnPsFcOj/mHJdtDc2/fCrfQubM/sxlZjzyvtzvYG -j5xKpSCp528Sl1zR0HXfDH9FE6YnzKl9CJFjqoXv7UChqEPfn3iryyGk6CHvzY6L -FuryfWAIBamdNNec8GxJYTDRZoAzDiNkoIwWfZ4D9VPNjKm+/+xvRsR7Z8LiQUpz -yYDfLWr9jvbljwtDfHXsmQR+MvREQT0xTHOOsI5FtN9KJXKu4OIWeea6TyBMhkGQ -quLtYBom24kCWRMlEE+wSZu9Pz3lK97jYz5UDg1f5ReUwb6hhxJpUkH6OmG/0EMd -OwivW74VEjtlz98m0vCcKDGZYGc2XI4j4kBfaLetedvwqf167CoLZPn4OQEWacss -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 -=mU0O +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 *** 267 LINES SKIPPED *** From owner-dev-commits-doc-all@freebsd.org Fri Apr 23 12:27:56 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 5E3645F22F9 for ; Fri, 23 Apr 2021 12:27:56 +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 4FRYTm2FNzz4d9q; Fri, 23 Apr 2021 12:27:56 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 31C18549D; Fri, 23 Apr 2021 12:27:56 +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 13NCRuI5006982; Fri, 23 Apr 2021 12:27:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13NCRunZ006981; Fri, 23 Apr 2021 12:27:56 GMT (envelope-from git) Date: Fri, 23 Apr 2021 12:27:56 GMT Message-Id: <202104231227.13NCRunZ006981@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 109383f679 - main - 985dccbda6 -> 3b0cb15d91 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ryusuke X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 109383f679f33174f503ccbaab5d8631a0263685 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Apr 2021 12:27:56 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=109383f679f33174f503ccbaab5d8631a0263685 commit 109383f679f33174f503ccbaab5d8631a0263685 Author: Ryusuke SUZUKI AuthorDate: 2021-04-23 12:27:36 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-23 12:27:36 +0000 985dccbda6 -> 3b0cb15d91 --- website/content/ja/security/_index.adoc | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/website/content/ja/security/_index.adoc b/website/content/ja/security/_index.adoc index f529058bf9..6873372809 100644 --- a/website/content/ja/security/_index.adoc +++ b/website/content/ja/security/_index.adoc @@ -65,15 +65,17 @@ FreeBSD のベースシステムに関わるセキュリティの問題は、電 FreeBSD セキュリティオフィサは、 _-STABLE ブランチ_ と _セキュリティブランチ_ に対してセキュリティ勧告を提供しています (_-CURRENT ブランチ_ に対する勧告は提供されません)。 -* -STABLE ブランチには `stable/10` のようなタグ名が付けられています。 これに対応する構築物は `FreeBSD 10.1-STABLE` のような名前になります。 -* FreeBSD の各リリースには、 対応するセキュリティブランチがひとつ用意されています。 セキュリティブランチには `releng/10.1` のようなタグ名が付けられています。 これに対応する構築物は `FreeBSD 10.1-RELEASE-p4` のような名前になります。 +* -STABLE ブランチには `stable/13` のようなタグ名が付けられています。 +これに対応する構築物は `FreeBSD 13.0-STABLE` のような名前になります。 +* FreeBSD の各リリースには、 対応するセキュリティブランチがひとつ用意されています。 セキュリティブランチには `releng/13.0` のようなタグ名が付けられています。 +これに対応する構築物は `FreeBSD 13.0-RELEASE-p1` のような名前になります。 Ports Collection に関連した問題は、link:http://vuxml.FreeBSD.org/[FreeBSD VuXML] により提供されます。 [[how]] == システムのアップデートの方法 -バイナリ版の FreeBSD (たとえば rel120-current} や {rel112-current}) をインストールしたユーザは、 以下のコマンドでアップデートできます。 +バイナリ版の FreeBSD (たとえば rel122-current} や {rel114-current}) をインストールしたユーザは、 以下のコマンドでアップデートできます。 `# freebsd-update fetch` @@ -96,6 +98,8 @@ link:unsupported[これ以前の古いリリース] はサポートされませ [cols=",,,",options="header",] |=== |ブランチ |リリース |リリース日 |保守終了予定日 +|stable/13 |n/a |n/a |2026 年 1 月 31 日 +|releng/13.0 |13.0-RELEASE |2021 年 4 月 13 日 |13.1-RELEASE 公開から 3 ヵ月後 |stable/12 |n/a |n/a |2024 年 6 月 30 日 |releng/12.2 |12.2-RELEASE |2020 年 10 月 27 日 |12.3-RELEASE 公開から 3 ヵ月後 |stable/11 |なし |なし |2021 年 9 月 30 日 From owner-dev-commits-doc-all@freebsd.org Fri Apr 23 22:53:54 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id D9A3F5E17CD for ; Fri, 23 Apr 2021 22:53:54 +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 4FRqN25phcz3R9G; Fri, 23 Apr 2021 22:53:54 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 B01B015A9E; Fri, 23 Apr 2021 22:53:54 +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 13NMrsA3046595; Fri, 23 Apr 2021 22:53:54 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13NMrsqq046594; Fri, 23 Apr 2021 22:53:54 GMT (envelope-from git) Date: Fri, 23 Apr 2021 22:53:54 GMT Message-Id: <202104232253.13NMrsqq046594@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Brooks Davis Subject: git: b5e5960090 - main - Bump PGP key expiration MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: brooks X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b5e5960090da86a8ca51b30e3718984679fcb460 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 Apr 2021 22:53:54 -0000 The branch main has been updated by brooks (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=b5e5960090da86a8ca51b30e3718984679fcb460 commit b5e5960090da86a8ca51b30e3718984679fcb460 Author: Brooks Davis AuthorDate: 2021-04-23 22:53:15 +0000 Commit: Brooks Davis CommitDate: 2021-04-23 22:53:26 +0000 Bump PGP key expiration --- documentation/static/pgpkeys/brooks.key | 81 ++++++++++++++++----------------- 1 file changed, 38 insertions(+), 43 deletions(-) diff --git a/documentation/static/pgpkeys/brooks.key b/documentation/static/pgpkeys/brooks.key index cf906e55a0..28b9253112 100644 --- a/documentation/static/pgpkeys/brooks.key +++ b/documentation/static/pgpkeys/brooks.key @@ -1,20 +1,16 @@ -// $FreeBSD: head/share/pgpkeys/brooks.key 54027 2020-03-31 21:22:23Z brooks $ -// -// sh addkey.sh brooks ACD05DB49E6E07C0 ; - - -[.literal-block-margin] -.... -pub 2048R/ACD05DB49E6E07C0 2015-04-24 [expires: 2021-04-19] + + + uid Brooks Eugene Davis -sub 2048R/4055CD642D33B023 2015-04-24 [expires: 2021-04-19] - -.... +uid Brooks Eugene Davis +sub 2048R/4055CD642D33B023 2015-04-24 [expires: 2023-04-23] -[.literal-block-margin] -.... +]]> +