From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 10:19: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 8F9615FB39F for ; Mon, 26 Apr 2021 10:19:08 +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 4FTLTm3gnYz3CyY; Mon, 26 Apr 2021 10:19:08 +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 71179257C2; Mon, 26 Apr 2021 10:19:08 +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 13QAJ83s073546; Mon, 26 Apr 2021 10:19:08 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QAJ8n6073545; Mon, 26 Apr 2021 10:19:08 GMT (envelope-from git) Date: Mon, 26 Apr 2021 10:19:08 GMT Message-Id: <202104261019.13QAJ8n6073545@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: e35388b00e - main - 2a617095b1 -> 7859bada69 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: e35388b00ef000cc0f473b09f11adae268ba9a5b 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, 26 Apr 2021 10:19:08 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=e35388b00ef000cc0f473b09f11adae268ba9a5b commit e35388b00ef000cc0f473b09f11adae268ba9a5b Author: Ryusuke SUZUKI AuthorDate: 2021-04-26 10:18:46 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-26 10:18:46 +0000 2a617095b1 -> 7859bada69 --- .../ja/books/handbook/cutting-edge/_index.adoc | 58 ++++++++++++++++++++-- 1 file changed, 54 insertions(+), 4 deletions(-) diff --git a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc index 5e8fc1a762..492f680317 100644 --- a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc @@ -622,9 +622,10 @@ check /usr/src/UPDATING <.> # make -j4 buildworld <.> # make -j4 kernel <.> # shutdown -r now <.> +# etcupdate -p <.> # cd /usr/src <.> # make installworld <.> -# mergemaster -Ui <.> +# etcupdate -B <.> # shutdown -r now <.> .... @@ -640,11 +641,13 @@ check /usr/src/UPDATING <.> <.> 新しいカーネルを使うため、 システムを再起動してください。 +<.> installworld を行う前に、[.filename]#/etc/# に置かれている設定ファイルのアップデートとマージを行ってください。 + <.> ソースが置かれているディレクトリに移動してください。 <.> world をインストールしてください。 -<.> [.filename]#/etc/# に置かれている設定ファイルをアップデートしたりマージしてください。 +<.> [.filename]#/etc/# に置かれている設定ファイルのアップデートとマージを行ってください。 <.> 新しく構築された world およびカーネルを利用するため、 システムを再起動してください。 ==== @@ -866,11 +869,58 @@ FreeBSD 標準のカーネルは、[.filename]#GENERIC# と呼ばれる _カー アップデートの完了までに、いくつかの最終作業が残されています。 デフォルトから変更した設定ファイルを新しいバージョンのファイルにマージし、古くなったライブラリを見つけて削除した後に、システムを再起動します。 +[[updating-src-completing-merge-etcupdate]] +==== man:etcupdate[8] を用いた設定ファイルのマージ + +man:etcupdate[8] は、[.filename]#/etc/# 以下のファイルのように installworld のプロセスで更新されないファイルをアップデートするツールです。 +このツールは、ローカルにあるファイルに対する変更点を 3-way マージでアップデートします。 +man:mergemaster[8] の対話的なプロンプトと対照的に、このツールはユーザによる操作を最小限になるように設計されています。 + +[NOTE] +==== +一般的に、man:etcupdate[8] は、実行する際に特定の引数を必要としません。 +しかしながら、man:etcupdate[8] を最初に使用した際に、どのようなアップデートが行われたかの健全性をチェックする便利なコマンドがあります。 + +[source,shell] +.... +# etcupdate diff +.... + +このコマンドにより、ユーザは設定の変更を検証できます。 +==== + +man:etcupdate[8] が自動的にファイルをマージできない場合には、 +以下を実行することで、手動の操作により衝突を解決できます。 + +[source,shell] +.... +# etcupdate resolve +.... + +[WARNING] +==== +man:mergemaster[8] から man:etcupdate[8] に移行する際に、 +最初に man:etcupdate[8] を実行すると、不適切に変更点がマージされ、誤った衝突が起こる可能性があります。 +これを避けるには、ソースを更新して新しく buildworld を行う *前に* 以下のステップを行ってください。 + +[source,shell] +.... +# etcupdate bootstrap <.> +# etcupdate diff <.> +.... + +<.> [.filename]#/etc# ファイルを保存するデータベースをブートストラップしてください。 +詳細については、 man:etcupdate[8] を参照してください。 + +<.> ブートストラップ後、差分を確認してください。 +不必要なローカルでの変更点をなくし、将来的なアップデートにおいて、衝突が起きる可能性が低くなるようにしてください。 +==== + [[updating-src-completing-merge-mergemaster]] ==== man:mergemaster[8] を用いた設定ファイルのマージ -man:mergemaster[8] を用いることで、システムの設定ファイルに行われている変更を、 簡単にこれらのファイルの新しいバージョンにマージできます。 - +man:mergemaster[8] を用いることで、システムの設定ファイルに行われている変更を、これらのファイルの新しいバージョンにマージできます。 +man:mergemaster[8] は、設定ファイルのアップデートで推奨されている man:etcupdate[8] の代価のツールです。 `-Ui` オプションを使って man:mergemaster[8] を実行すると、 ユーザが手を加えていないファイルのアップデートおよび新しく追加されたファイルのインストールを自動的に行います。 [source,shell] From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 11:03:41 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 33BAA5FBF7E for ; Mon, 26 Apr 2021 11:03:41 +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 4FTMT90ttCz3Fgc; Mon, 26 Apr 2021 11:03:41 +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 0701626265; Mon, 26 Apr 2021 11:03:41 +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 13QB3egw038855; Mon, 26 Apr 2021 11:03:40 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QB3edC038854; Mon, 26 Apr 2021 11:03:40 GMT (envelope-from git) Date: Mon, 26 Apr 2021 11:03:40 GMT Message-Id: <202104261103.13QB3edC038854@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 8889d10710 - main - 7859bada69 -> 6269a3efb8 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: 8889d1071020cb506d9d88369256638e4b190203 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, 26 Apr 2021 11:03:41 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=8889d1071020cb506d9d88369256638e4b190203 commit 8889d1071020cb506d9d88369256638e4b190203 Author: Ryusuke SUZUKI AuthorDate: 2021-04-26 11:03:13 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-26 11:03:13 +0000 7859bada69 -> 6269a3efb8 --- documentation/content/ja/books/handbook/cutting-edge/_index.adoc | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc index 492f680317..882d09525d 100644 --- a/documentation/content/ja/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/ja/books/handbook/cutting-edge/_index.adoc @@ -555,7 +555,7 @@ FreeBSD-CURRENT を追いかけるには これらのメーリングリストに入るには、 {mailman-lists} をたどって参加したいメーリングリストをクリックし、手順の説明にしたがってください。 FreeBSD-CURRENT だけでなく、ソースツリー全体の変更点を追いかけるのであれば、 {dev-commits-src-all} メーリングリストを購読してください。 . FreeBSD-CURRENT のソースを同期してください。 -特に `git` を使って crossref:mirrors[git-mirrors,「Git ミラーサイト」] の一覧にある Git ミラーサイトのひとつの `main` ブランチから -CURRENT コードをチェックアウトしてください。 +通常は `git` を使って FreeBSD Git リポジトリの `main` ブランチから -CURRENT コードをチェックアウトしてください (crossref:mirrors[git,「Git を使う」] を参照してください)。 . リポジトリのサイズが大きいため、興味のある部分や、パッチを当てる部分のソースのみを同期するユーザもいます。 しかしながら、ソースからオペレーティングシステムをコンパイルしようと思っているユーザは、一部分だけではなく、FreeBSD-CURRENT の _すべて_ をダウンロードする必要があります。 + @@ -668,9 +668,8 @@ FreeBSD のソースコードは [.filename]#/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) -... +origin https://git.freebsd.org/src.git (fetch) +origin https://git.freebsd.org/src.git (push) .... この結果は、[.filename]#/usr/src/# がバージョン管理下にあり、man:git[1] を使ってアップデートできることを示しています。 @@ -727,7 +726,7 @@ man:uname[1] を使って FreeBSD のバージョンを確認してください [source,shell] .... # mv /usr/src /usr/src.bak <.> -# git clone --branch releng/10.3 ssh://git@gitrepo.FreeBSD.org/src.git /usr/src <.> +# git clone --branch releng/10.3 https://git.FreeBSD.org/src.git /usr/src <.> .... <.> この古いディレクトリを、 邪魔にならないように移動してください。 このディレクトリ以下に対して変更を行ってなければ、 削除しても構わないでしょう。 From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 13:13: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 D9F075FF94F for ; Mon, 26 Apr 2021 13:13:58 +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 4FTQMV5vKKz3Mdg; Mon, 26 Apr 2021 13:13:58 +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 BD4D53A; Mon, 26 Apr 2021 13:13:58 +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 13QDDwLN011958; Mon, 26 Apr 2021 13:13:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QDDweZ011957; Mon, 26 Apr 2021 13:13:58 GMT (envelope-from git) Date: Mon, 26 Apr 2021 13:13:58 GMT Message-Id: <202104261313.13QDDweZ011957@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: fc09d63a36 - main - security: update EN and SA templates for 13.0-RELEASE 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: fc09d63a368bf0646e342b786db380b833d833c3 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, 26 Apr 2021 13:13:58 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=fc09d63a368bf0646e342b786db380b833d833c3 commit fc09d63a368bf0646e342b786db380b833d833c3 Author: Glen Barber AuthorDate: 2021-04-26 13:13:39 +0000 Commit: Glen Barber CommitDate: 2021-04-26 13:13:39 +0000 security: update EN and SA templates for 13.0-RELEASE Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/static/security/advisory-template.txt | 2 +- website/static/security/errata-template.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/website/static/security/advisory-template.txt b/website/static/security/advisory-template.txt index 4a5d401663..5acc43d5d8 100644 --- a/website/static/security/advisory-template.txt +++ b/website/static/security/advisory-template.txt @@ -12,7 +12,7 @@ Affects: Corrected: 2021-XX-XX XX:XX:XX UTC (stable/13, 13.0-STABLE) - 2021-XX-XX XX:XX:XX UTC (releng/13.0, 13.0-BETA2-pXX) + 2021-XX-XX XX:XX:XX UTC (releng/13.0, 13.0-RELEASE-pXX) 2021-XX-XX XX:XX:XX UTC (stable/12, 12.2-STABLE) 2021-XX-XX XX:XX:XX UTC (releng/12.2, 12.2-RELEASE-pXX) 2021-XX-XX XX:XX:XX UTC (stable/11, 11.4-STABLE) diff --git a/website/static/security/errata-template.txt b/website/static/security/errata-template.txt index ef1cad8464..c3acf0e74d 100644 --- a/website/static/security/errata-template.txt +++ b/website/static/security/errata-template.txt @@ -12,7 +12,7 @@ Affects: Corrected: 2021-XX-XX XX:XX:XX UTC (stable/13, 13.0-STABLE) - 2021-XX-XX XX:XX:XX UTC (releng/13.0, 13.0-BETA2-pXX) + 2021-XX-XX XX:XX:XX UTC (releng/13.0, 13.0-RELEASE-pXX) 2021-XX-XX XX:XX:XX UTC (stable/12, 12.2-STABLE) 2021-XX-XX XX:XX:XX UTC (releng/12.2, 12.2-RELEASE-pXX) 2021-XX-XX XX:XX:XX UTC (stable/11, 11.4-STABLE) From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 16:21: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 9175D5E666A for ; Mon, 26 Apr 2021 16:21: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 4FTVXR3l8Wz3q1L; Mon, 26 Apr 2021 16:21: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 73CAE2846; Mon, 26 Apr 2021 16:21: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 13QGLxW9064447; Mon, 26 Apr 2021 16:21:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QGLx6t064441; Mon, 26 Apr 2021 16:21:59 GMT (envelope-from git) Date: Mon, 26 Apr 2021 16:21:59 GMT Message-Id: <202104261621.13QGLx6t064441@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: bcf75b25de - main - kobj: Use one sentence per line MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bcf75b25de3c6f53d166b2c766304e58e9f04c50 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, 26 Apr 2021 16:21:59 -0000 The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=bcf75b25de3c6f53d166b2c766304e58e9f04c50 commit bcf75b25de3c6f53d166b2c766304e58e9f04c50 Author: Warner Losh AuthorDate: 2021-04-19 02:16:47 +0000 Commit: Warner Losh CommitDate: 2021-04-26 16:20:16 +0000 kobj: Use one sentence per line In advance of updating this chapter, go through and make it one sentence per line. No content changes. Sponsored by: Netflix --- .../en/books/arch-handbook/kobj/_index.adoc | 57 +++++++++++++++++----- 1 file changed, 44 insertions(+), 13 deletions(-) diff --git a/documentation/content/en/books/arch-handbook/kobj/_index.adoc b/documentation/content/en/books/arch-handbook/kobj/_index.adoc index 01321c5c62..bd11946acd 100644 --- a/documentation/content/en/books/arch-handbook/kobj/_index.adoc +++ b/documentation/content/en/books/arch-handbook/kobj/_index.adoc @@ -29,7 +29,9 @@ include::shared/en/urls.adoc[] toc::[] -Kernel Objects, or _Kobj_ provides an object-oriented C programming system for the kernel. As such the data being operated on carries the description of how to operate on it. This allows operations to be added and removed from an interface at run time and without breaking binary compatibility. +Kernel Objects, or _Kobj_ provides an object-oriented C programming system for the kernel. +As such the data being operated on carries the description of how to operate on it. +This allows operations to be added and removed from an interface at run time and without breaking binary compatibility. [[kernel-objects-term]] == Terminology @@ -49,9 +51,18 @@ A standard set of one or more methods. [[kernel-objects-operation]] == Kobj Operation -Kobj works by generating descriptions of methods. Each description holds a unique id as well as a default function. The description's address is used to uniquely identify the method within a class' method table. +Kobj works by generating descriptions of methods. +Each description holds a unique id as well as a default function. +The description's address is used to uniquely identify the method within a class' method table. -A class is built by creating a method table associating one or more functions with method descriptions. Before use the class is compiled. The compilation allocates a cache and associates it with the class. A unique id is assigned to each method description within the method table of the class if not already done so by another referencing class compilation. For every method to be used a function is generated by script to qualify arguments and automatically reference the method description for a lookup. The generated function looks up the method by using the unique id associated with the method description as a hash into the cache associated with the object's class. If the method is not cached the generated function proceeds to use the class' table to find the method. If the method is found then the associated function within the class is used; otherwise, the default function associated with the method description is used. +A class is built by creating a method table associating one or more functions with method descriptions. +Before use the class is compiled. +The compilation allocates a cache and associates it with the class. +A unique id is assigned to each method description within the method table of the class if not already done so by another referencing class compilation. +For every method to be used a function is generated by script to qualify arguments and automatically reference the method description for a lookup. +The generated function looks up the method by using the unique id associated with the method description as a hash into the cache associated with the object's class. +If the method is not cached the generated function proceeds to use the class' table to find the method. +If the method is found then the associated function within the class is used; otherwise, the default function associated with the method description is used. These indirections can be visualized as the following: @@ -102,7 +113,8 @@ KOBJMETHOD(NAME, FUNC) === Creating an Interface Template -The first step in using Kobj is to create an Interface. Creating the interface involves creating a template that the script [.filename]#src/sys/kern/makeobjops.pl# can use to generate the header and code for the method declarations and method lookup functions. +The first step in using Kobj is to create an Interface. +Creating the interface involves creating a template that the script [.filename]#src/sys/kern/makeobjops.pl# can use to generate the header and code for the method declarations and method lookup functions. Within this template the following keywords are used: `#include`, `INTERFACE`, `CODE`, `METHOD`, `STATICMETHOD`, and `DEFAULT`. @@ -115,7 +127,9 @@ For example: #include .... -The `INTERFACE` keyword is used to define the interface name. This name is concatenated with each method name as [interface name]_[method name]. Its syntax is INTERFACE [interface name];. +The `INTERFACE` keyword is used to define the interface name. +This name is concatenated with each method name as [interface name]_[method name]. +Its syntax is INTERFACE [interface name];. For example: @@ -124,7 +138,8 @@ For example: INTERFACE foo; .... -The `CODE` keyword copies its arguments verbatim into the code file. Its syntax is `CODE { [whatever] };` +The `CODE` keyword copies its arguments verbatim into the code file. +Its syntax is `CODE { [whatever] };` For example: @@ -138,7 +153,8 @@ CODE { }; .... -The `METHOD` keyword describes a method. Its syntax is `METHOD [return type] [method name] { [object [, arguments]] };` +The `METHOD` keyword describes a method. +Its syntax is `METHOD [return type] [method name] { [object [, arguments]] };` For example: @@ -151,7 +167,9 @@ METHOD int bar { }; .... -The `DEFAULT` keyword may follow the `METHOD` keyword. It extends the `METHOD` key word to include the default function for method. The extended syntax is `METHOD [return type] [method name] { [object; [other arguments]] }DEFAULT [default function];` +The `DEFAULT` keyword may follow the `METHOD` keyword. +It extends the `METHOD` key word to include the default function for method. +The extended syntax is `METHOD [return type] [method name] { [object; [other arguments]] }DEFAULT [default function];` For example: @@ -164,7 +182,9 @@ METHOD int bar { } DEFAULT foo_hack; .... -The `STATICMETHOD` keyword is used like the `METHOD` keyword except the kobj data is not at the head of the object structure so casting to kobj_t would be incorrect. Instead `STATICMETHOD` relies on the Kobj data being referenced as 'ops'. This is also useful for calling methods directly out of a class's method table. +The `STATICMETHOD` keyword is used like the `METHOD` keyword except the kobj data is not at the head of the object structure so casting to kobj_t would be incorrect. +Instead `STATICMETHOD` relies on the Kobj data being referenced as 'ops'. +This is also useful for calling methods directly out of a class's method table. Other complete examples: @@ -176,7 +196,11 @@ src/sys/kern/device_if.m === Creating a Class -The second step in using Kobj is to create a class. A class consists of a name, a table of methods, and the size of objects if Kobj's object handling facilities are used. To create the class use the macro `DEFINE_CLASS()`. To create the method table create an array of kobj_method_t terminated by a NULL entry. Each non-NULL entry may be created using the macro `KOBJMETHOD()`. +The second step in using Kobj is to create a class. +A class consists of a name, a table of methods, and the size of objects if Kobj's object handling facilities are used. +To create the class use the macro `DEFINE_CLASS()`. +To create the method table create an array of kobj_method_t terminated by a NULL entry. +Each non-NULL entry may be created using the macro `KOBJMETHOD()`. For example: @@ -191,11 +215,16 @@ kobj_method_t foomethods[] = { }; .... -The class must be "compiled". Depending on the state of the system at the time that the class is to be initialized a statically allocated cache, "ops table" have to be used. This can be accomplished by declaring a `struct kobj_ops` and using `kobj_class_compile_static();` otherwise, `kobj_class_compile()` should be used. +The class must be "compiled". +Depending on the state of the system at the time that the class is to be initialized a statically allocated cache, "ops table" have to be used. +This can be accomplished by declaring a `struct kobj_ops` and using `kobj_class_compile_static();` otherwise, `kobj_class_compile()` should be used. === Creating an Object -The third step in using Kobj involves how to define the object. Kobj object creation routines assume that Kobj data is at the head of an object. If this in not appropriate you will have to allocate the object yourself and then use `kobj_init()` on the Kobj portion of it; otherwise, you may use `kobj_create()` to allocate and initialize the Kobj portion of the object automatically. `kobj_init()` may also be used to change the class that an object uses. +The third step in using Kobj involves how to define the object. +Kobj object creation routines assume that Kobj data is at the head of an object. +If this in not appropriate you will have to allocate the object yourself and then use `kobj_init()` on the Kobj portion of it; otherwise, you may use `kobj_create()` to allocate and initialize the Kobj portion of the object automatically. +`kobj_init()` may also be used to change the class that an object uses. To integrate Kobj into the object you should use the macro KOBJ_FIELDS. @@ -212,7 +241,9 @@ struct foo_data { === Calling Methods -The last step in using Kobj is to simply use the generated functions to use the desired method within the object's class. This is as simple as using the interface name and the method name with a few modifications. The interface name should be concatenated with the method name using a '_' between them, all in upper case. +The last step in using Kobj is to simply use the generated functions to use the desired method within the object's class. +This is as simple as using the interface name and the method name with a few modifications. +The interface name should be concatenated with the method name using a '_' between them, all in upper case. For example, if the interface name was foo and the method was bar then the call would be: From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 16:22: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 AC4435E67E3 for ; Mon, 26 Apr 2021 16:22: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 4FTVXS4MzXz3psN; Mon, 26 Apr 2021 16:22: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 8954D24E1; Mon, 26 Apr 2021 16:22:00 +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 13QGM08U065229; Mon, 26 Apr 2021 16:22:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QGM0ft065221; Mon, 26 Apr 2021 16:22:00 GMT (envelope-from git) Date: Mon, 26 Apr 2021 16:22:00 GMT Message-Id: <202104261622.13QGM0ft065221@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Warner Losh Subject: git: b9c2beb17b - main - committer-guide: master->main rename in an example or two MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b9c2beb17bbb78591ccad1078705f67fe48e6055 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, 26 Apr 2021 16:22:00 -0000 The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/doc/commit/?id=b9c2beb17bbb78591ccad1078705f67fe48e6055 commit b9c2beb17bbb78591ccad1078705f67fe48e6055 Author: Warner Losh AuthorDate: 2021-04-26 16:11:32 +0000 Commit: Warner Losh CommitDate: 2021-04-26 16:20:16 +0000 committer-guide: master->main rename in an example or two These instances of master or freebsd/master which should really be main. I did these examples against the old github mirror. Sponsored by: Netflix --- documentation/content/en/articles/committers-guide/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index e47a0ddff2..1799f8d47e 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -435,11 +435,11 @@ The good version will be the last one you checked out. If you want to know the last version you checked out, you should use 'git reflog': [source,shell] .... -5ef0bd68b515 (HEAD -> master, freebsd/master, freebsd/HEAD) HEAD@{0}: pull --ff-only: Fast-forward -a8163e165c5b (upstream/master) HEAD@{1}: checkout: moving from b6fb97efb682994f59b21fe4efb3fcfc0e5b9eeb to master +5ef0bd68b515 (HEAD -> main, freebsd/main, freebsd/HEAD) HEAD@{0}: pull --ff-only: Fast-forward +a8163e165c5b (upstream/main) HEAD@{1}: checkout: moving from b6fb97efb682994f59b21fe4efb3fcfc0e5b9eeb to main ... .... -shows me moving the working tree to the master branch (a816...) and then updating from upstream (to 5ef0...). +shows me moving the working tree to the main branch (a816...) and then updating from upstream (to 5ef0...). In this case, bad would be HEAD (or 5rf0bd68) and good would be a8163e165. As you can see from the output, HEAD@{1} also often works, but isn't foolproof if you have done other things to your Git tree after updating, but before you discover the need to bisect. ==== From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 18:22:42 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 BC6C55EB8A8 for ; Mon, 26 Apr 2021 18:22:42 +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 4FTYCk4zb4z4R0Y; Mon, 26 Apr 2021 18:22:42 +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 9DD094680; Mon, 26 Apr 2021 18:22:42 +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 13QIMgkW026355; Mon, 26 Apr 2021 18:22:42 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QIMgCf026354; Mon, 26 Apr 2021 18:22:42 GMT (envelope-from git) Date: Mon, 26 Apr 2021 18:22:42 GMT Message-Id: <202104261822.13QIMgCf026354@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Guangyuan Yang Subject: git: cdc25df8de - main - articles/committers-guide: fix typo MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ygy X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: cdc25df8deabea284a5d1fba92bd4a1510141d63 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, 26 Apr 2021 18:22:42 -0000 The branch main has been updated by ygy: URL: https://cgit.FreeBSD.org/doc/commit/?id=cdc25df8deabea284a5d1fba92bd4a1510141d63 commit cdc25df8deabea284a5d1fba92bd4a1510141d63 Author: Ceri Davies AuthorDate: 2021-04-26 18:18:49 +0000 Commit: Guangyuan Yang CommitDate: 2021-04-26 18:18:49 +0000 articles/committers-guide: fix typo --- 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 1799f8d47e..1f9c843090 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -486,7 +486,7 @@ All changes that you have not pushed are local and can easily be modified (git r ===== Keeping local changes The simplest way to keep local changes (especially trivial ones) is to use 'git stash'. -In its simples form, you use 'git stash' to record the changes (which pushes them onto the stash stack). +In its simplest form, you use 'git stash' to record the changes (which pushes them onto the stash stack). Most people use this to save changes before updating the tree as described above. They then use 'git stash apply' to re-apply them to the tree. The stash is a stack of changes that can be examined with 'git stash list'. From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 20:34: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 3BBD95EFD59 for ; Mon, 26 Apr 2021 20:34: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 4FTc7d1GDLz4YnK; Mon, 26 Apr 2021 20:34: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 1E4BC60A5; Mon, 26 Apr 2021 20:34: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 13QKYL8O098996; Mon, 26 Apr 2021 20:34:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QKYLTr098995; Mon, 26 Apr 2021 20:34:21 GMT (envelope-from git) Date: Mon, 26 Apr 2021 20:34:21 GMT Message-Id: <202104262034.13QKYLTr098995@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 656d6eccb7 - main - committers-guide: Clean up commit bit types 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: 656d6eccb7a854c5eb581445774a37e1defe605b 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, 26 Apr 2021 20:34:21 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=656d6eccb7a854c5eb581445774a37e1defe605b commit 656d6eccb7a854c5eb581445774a37e1defe605b Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-26 20:25:31 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-26 20:34:26 +0000 committers-guide: Clean up commit bit types description There is no need to mention explicitly that src committers may commit to the doc tree if they receive an appropriate approval. That's true for all the other committer types and trees. --- 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 1f9c843090..eaf2922cb7 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -226,7 +226,7 @@ Additional areas of authority may be added at a later date: when this occurs, th |src |core@ -|src/, doc/ subject to appropriate review +|src/ |doc |doceng@ From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 20:34: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 64AAB5EFDC0 for ; Mon, 26 Apr 2021 20:34: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 4FTc7f2KZdz4Yhv; Mon, 26 Apr 2021 20:34: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 42D515FB1; Mon, 26 Apr 2021 20:34: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 13QKYMQO099017; Mon, 26 Apr 2021 20:34:22 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QKYMwx099016; Mon, 26 Apr 2021 20:34:22 GMT (envelope-from git) Date: Mon, 26 Apr 2021 20:34:22 GMT Message-Id: <202104262034.13QKYMwx099016@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 70d4e0e799 - main - committers-guide: Update list of files all committers may modify 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: 70d4e0e7990cc75cf98313b71081622804ac4a0e 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, 26 Apr 2021 20:34:22 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=70d4e0e7990cc75cf98313b71081622804ac4a0e commit 70d4e0e7990cc75cf98313b71081622804ac4a0e Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-26 20:32:31 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-26 20:34:26 +0000 committers-guide: Update list of files all committers may modify The paths have changed after the switch to Git. --- 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 eaf2922cb7..74307313e9 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -245,7 +245,7 @@ Committers are encouraged to seek review for their work as part of the normal de === Policy for Committer Activity in Other Trees -* All committers may modify [.filename]#base/head/shared/misc/committers-*.dot#, [.filename]#base/head/usr.bin/calendar/calendars/calendar.freebsd#, and [.filename]#ports/head/astro/xearth/files#. +* All committers may modify [.filename]#src/share/misc/committers-*.dot#, [.filename]#src/usr.bin/calendar/calendars/calendar.freebsd#, and [.filename]#ports/astro/xearth/files#. * doc committers may commit documentation changes to [.filename]#src# files, such as man pages, READMEs, fortune databases, calendar files, and comment fixes without approval from a src committer, subject to the normal care and tending of commits. * Any committer may make changes to any other tree with an "Approved by" from a non-mentored committer with the appropriate bit. * Committers can acquire an additional bit by the usual process of finding a mentor who will propose them to core, doceng, or portmgr, as appropriate. When approved, they will be added to 'access' and the normal mentoring period will ensue, which will involve a continuing of "Approved by" for some period. From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 20:37: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 66B985F0075 for ; Mon, 26 Apr 2021 20:37:48 +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 4FTcCc2TmJz4Ys8; Mon, 26 Apr 2021 20:37:48 +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 485706207; Mon, 26 Apr 2021 20:37:48 +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 13QKbmY4099349; Mon, 26 Apr 2021 20:37:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QKbmOa099348; Mon, 26 Apr 2021 20:37:48 GMT (envelope-from git) Date: Mon, 26 Apr 2021 20:37:48 GMT Message-Id: <202104262037.13QKbmOa099348@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 77e05e5b5c - main - committers-guide: Merge duplicate policies into one 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: 77e05e5b5cf5b83589c4693ca8b9b7a9c75d3486 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, 26 Apr 2021 20:37:48 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=77e05e5b5cf5b83589c4693ca8b9b7a9c75d3486 commit 77e05e5b5cf5b83589c4693ca8b9b7a9c75d3486 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-26 20:36:33 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-26 20:36:33 +0000 committers-guide: Merge duplicate policies into one Those two points describe the same situation. Merge them into one point. --- 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 74307313e9..e087eb3c05 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -248,8 +248,8 @@ Committers are encouraged to seek review for their work as part of the normal de * All committers may modify [.filename]#src/share/misc/committers-*.dot#, [.filename]#src/usr.bin/calendar/calendars/calendar.freebsd#, and [.filename]#ports/astro/xearth/files#. * doc committers may commit documentation changes to [.filename]#src# files, such as man pages, READMEs, fortune databases, calendar files, and comment fixes without approval from a src committer, subject to the normal care and tending of commits. * Any committer may make changes to any other tree with an "Approved by" from a non-mentored committer with the appropriate bit. +Mentored committers can provide a "Reviewed by" but not an "Approved by". * Committers can acquire an additional bit by the usual process of finding a mentor who will propose them to core, doceng, or portmgr, as appropriate. When approved, they will be added to 'access' and the normal mentoring period will ensue, which will involve a continuing of "Approved by" for some period. -* "Approved by" is only acceptable from non-mentored src committers -- mentored committers can provide a "Reviewed by" but not an "Approved by". [[git-primer]] == Git Primer From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 20:53: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 3E3545F0C40 for ; Mon, 26 Apr 2021 20:53: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 4FTcYT1Lj3z4Zbv; Mon, 26 Apr 2021 20:53:17 +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 210776603; Mon, 26 Apr 2021 20:53:17 +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 13QKrHu4025480; Mon, 26 Apr 2021 20:53:17 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QKrHaj025479; Mon, 26 Apr 2021 20:53:17 GMT (envelope-from git) Date: Mon, 26 Apr 2021 20:53:17 GMT Message-Id: <202104262053.13QKrHaj025479@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 6e8e66005b - main - committers-guide: Do not use google as a verb 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: 6e8e66005b6ab914c488d9fd4e6d01d0efcb3948 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, 26 Apr 2021 20:53:17 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=6e8e66005b6ab914c488d9fd4e6d01d0efcb3948 commit 6e8e66005b6ab914c488d9fd4e6d01d0efcb3948 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-26 20:40:03 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-26 20:40:03 +0000 committers-guide: Do not use google as a verb --- 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 e087eb3c05..b8f7b19441 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -263,7 +263,7 @@ this section is a work in progress... === Git basics There are many primers on how to use Git on the web. -There's a lot of them (google "Git primer"). +There's a lot of them (search for "Git primer"). This one comes up first, and is generally good. https://danielmiessler.com/study/git/ and https://gist.github.com/williewillus/068e9a8543de3a7ef80adb2938657b6b are good overviews. The Git book is also complete, but much longer https://git-scm.com/book/en/v2. From owner-dev-commits-doc-all@freebsd.org Mon Apr 26 20:53: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 6119C5F0B27 for ; Mon, 26 Apr 2021 20:53: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 4FTcYV2MDsz4ZKb; Mon, 26 Apr 2021 20:53: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 43E3464AD; Mon, 26 Apr 2021 20:53: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 13QKrIBK025501; Mon, 26 Apr 2021 20:53:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13QKrIft025500; Mon, 26 Apr 2021 20:53:18 GMT (envelope-from git) Date: Mon, 26 Apr 2021 20:53:18 GMT Message-Id: <202104262053.13QKrIft025500@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 18298aec36 - main - committers-guide: Remove confusing line 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: 18298aec36fb8beceb9ffd78f06ecd3c60190615 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, 26 Apr 2021 20:53:18 -0000 The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=18298aec36fb8beceb9ffd78f06ecd3c60190615 commit 18298aec36fb8beceb9ffd78f06ecd3c60190615 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-04-26 20:46:09 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-04-26 20:46:09 +0000 committers-guide: Remove confusing line It is unclear what this line is referring to. Remove it. --- documentation/content/en/articles/committers-guide/_index.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index b8f7b19441..ecdfb633ad 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -264,7 +264,6 @@ this section is a work in progress... There are many primers on how to use Git on the web. There's a lot of them (search for "Git primer"). -This one comes up first, and is generally good. https://danielmiessler.com/study/git/ and https://gist.github.com/williewillus/068e9a8543de3a7ef80adb2938657b6b are good overviews. The Git book is also complete, but much longer https://git-scm.com/book/en/v2. There is also this website https://ohshitgit.com/ for common traps and pitfalls of Git, in case you need guidance to fix things up. From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 00:29:27 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 BB67D5F5E11 for ; Tue, 27 Apr 2021 00:29:27 +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 4FTjLv4zCbz4kqV; Tue, 27 Apr 2021 00:29: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 9967911392; Tue, 27 Apr 2021 00:29: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 13R0TRnT004976; Tue, 27 Apr 2021 00:29:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13R0TRvD004975; Tue, 27 Apr 2021 00:29:27 GMT (envelope-from git) Date: Tue, 27 Apr 2021 00:29:27 GMT Message-Id: <202104270029.13R0TRvD004975@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Allan Jude Subject: git: 43cb53c0e1 - main - Fix missing markup that was messing up the first paragraph MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: allanjude X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 43cb53c0e1f74b181cffe3d790e46f5e2c1a73b6 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, 27 Apr 2021 00:29:27 -0000 The branch main has been updated by allanjude: URL: https://cgit.FreeBSD.org/doc/commit/?id=43cb53c0e1f74b181cffe3d790e46f5e2c1a73b6 commit 43cb53c0e1f74b181cffe3d790e46f5e2c1a73b6 Author: Allan Jude AuthorDate: 2021-04-27 00:28:43 +0000 Commit: Allan Jude CommitDate: 2021-04-27 00:28:43 +0000 Fix missing markup that was messing up the first paragraph Sponsored-by: Klara Inc. --- documentation/content/en/books/handbook/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/_index.adoc b/documentation/content/en/books/handbook/_index.adoc index d7af05ae9f..cd161a2719 100644 --- a/documentation/content/en/books/handbook/_index.adoc +++ b/documentation/content/en/books/handbook/_index.adoc @@ -24,7 +24,7 @@ include::shared/en/mailing-lists.adoc[] [.abstract-title] Abstract -Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel130-current}-RELEASE, _FreeBSD {rel122-current}-RELEASE_, _FreeBSD {rel121-current}-RELEASE_ and _FreeBSD {rel114-current}-RELEASE_. This book is the result of ongoing work by many individuals. Some sections might be outdated. Those interested in helping to update and expand this document should send email to the {freebsd-doc}. +Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel130-current}-RELEASE_, _FreeBSD {rel122-current}-RELEASE_, _FreeBSD {rel121-current}-RELEASE_ and _FreeBSD {rel114-current}-RELEASE_. This book is the result of ongoing work by many individuals. Some sections might be outdated. Those interested in helping to update and expand this document should send email to the {freebsd-doc}. The latest version of this book is available from the https://www.FreeBSD.org/[FreeBSD web site]. Previous versions can be obtained from https://docs.FreeBSD.org/doc/[https://docs.FreeBSD.org/doc/]. The book can be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:./mirrors#mirrors-ftp[mirror sites]. Printed copies can be purchased at the https://www.freebsdmall.com/[FreeBSD Mall]. Searches can be performed on the handbook and other documents on the link:https://www.FreeBSD.org/search/[search page]. From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 00:32: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 131F15F5E35 for ; Tue, 27 Apr 2021 00:32: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 4FTjQM73ldz4ktM; Tue, 27 Apr 2021 00:32: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 E58F01113F; Tue, 27 Apr 2021 00:32: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 13R0WRA6016769; Tue, 27 Apr 2021 00:32:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13R0WRGm016768; Tue, 27 Apr 2021 00:32:27 GMT (envelope-from git) Date: Tue, 27 Apr 2021 00:32:27 GMT Message-Id: <202104270032.13R0WRGm016768@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Allan Jude Subject: git: 863b9e26bf - main - Allow binding to interfaces other than loopback MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: allanjude X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 863b9e26bfe6022ff4cbdbe3d81e27c1561870e0 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, 27 Apr 2021 00:32:28 -0000 The branch main has been updated by allanjude: URL: https://cgit.FreeBSD.org/doc/commit/?id=863b9e26bfe6022ff4cbdbe3d81e27c1561870e0 commit 863b9e26bfe6022ff4cbdbe3d81e27c1561870e0 Author: Allan Jude AuthorDate: 2021-04-27 00:31:37 +0000 Commit: Allan Jude CommitDate: 2021-04-27 00:31:37 +0000 Allow binding to interfaces other than loopback This is the same as fd2542a877f6ac5dab6f6d819c8319beeb53aa76 except applied to the website Makefile instead of only documentation Sponsored-By: Klara Inc. --- website/Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/Makefile b/website/Makefile index a4b6bf497a..cc4f66b22f 100644 --- a/website/Makefile +++ b/website/Makefile @@ -44,7 +44,7 @@ generate-releases: .PHONY ${PYTHON_CMD} ./tools/releases-toml.py -p ./shared/releases.adoc run-local: .PHONY - ${HUGO_CMD} server -D --baseURL="http://$(.HOST):1313" + ${HUGO_CMD} server -D $(BIND:D--bind=$(BIND)) --baseURL="http://$(.HOST):1313" build: .PHONY ${HUGO_CMD} From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 00: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 C35455F6225 for ; Tue, 27 Apr 2021 00: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 4FTjhx4qk5z4lkv; Tue, 27 Apr 2021 00:45: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 94A031137D; Tue, 27 Apr 2021 00:45: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 13R0j5oX030616; Tue, 27 Apr 2021 00:45:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13R0j54g030615; Tue, 27 Apr 2021 00:45:05 GMT (envelope-from git) Date: Tue, 27 Apr 2021 00:45:05 GMT Message-Id: <202104270045.13R0j54g030615@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Guangyuan Yang Subject: git: 1114f5f2d2 - main - handbook: fix typo MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ygy X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1114f5f2d23fbc25373fe10de1a30680138042f3 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, 27 Apr 2021 00:45:05 -0000 The branch main has been updated by ygy: URL: https://cgit.FreeBSD.org/doc/commit/?id=1114f5f2d23fbc25373fe10de1a30680138042f3 commit 1114f5f2d23fbc25373fe10de1a30680138042f3 Author: Andreas Bjørnestad AuthorDate: 2021-04-27 00:42:09 +0000 Commit: Guangyuan Yang CommitDate: 2021-04-27 00:42:55 +0000 handbook: fix typo PR: 252706 --- documentation/content/en/books/handbook/disks/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/disks/_index.adoc b/documentation/content/en/books/handbook/disks/_index.adoc index 9d04b6ebc6..4f22ff2772 100644 --- a/documentation/content/en/books/handbook/disks/_index.adoc +++ b/documentation/content/en/books/handbook/disks/_index.adoc @@ -644,7 +644,7 @@ Once an ISO has been burned to a CD, it can be mounted by specifying the file sy # mount -t cd9660 /dev/cd0 /mnt .... -Since `mount` assumes that a file system is of type `ufs`, a `Incorrect super block` error will occur if `-t cd9660` is not included when mounting a data CD. +Since `mount` assumes that a file system is of type `ufs`, an `Incorrect super block` error will occur if `-t cd9660` is not included when mounting a data CD. While any data CD can be mounted this way, disks with certain ISO 9660 extensions might behave oddly. For example, Joliet disks store all filenames in two-byte Unicode characters. If some non-English characters show up as question marks, specify the local charset with `-C`. For more information, refer to man:mount_cd9660[8]. From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 06:15:41 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 D0F2E621F3A for ; Tue, 27 Apr 2021 06:15:41 +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 4FTs2P5brzz3Jl3; Tue, 27 Apr 2021 06:15:41 +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 B300E15EA4; Tue, 27 Apr 2021 06:15:41 +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 13R6FfPj073525; Tue, 27 Apr 2021 06:15:41 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13R6Ff5t073524; Tue, 27 Apr 2021 06:15:41 GMT (envelope-from git) Date: Tue, 27 Apr 2021 06:15:41 GMT Message-Id: <202104270615.13R6Ff5t073524@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mathieu Arnold Subject: git: fb18f59114 - main - Add a short section about commit message for ports. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mat X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fb18f59114f2ec4bede6ded22ac8e299c867c4f9 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, 27 Apr 2021 06:15:41 -0000 The branch main has been updated by mat: URL: https://cgit.FreeBSD.org/doc/commit/?id=fb18f59114f2ec4bede6ded22ac8e299c867c4f9 commit fb18f59114f2ec4bede6ded22ac8e299c867c4f9 Author: Mathieu Arnold AuthorDate: 2021-04-26 15:58:55 +0000 Commit: Mathieu Arnold CommitDate: 2021-04-27 06:14:40 +0000 Add a short section about commit message for ports. Reviewed by: bapt Differential Revision: https://reviews.freebsd.org/D29994 --- .../en/articles/committers-guide/_index.adoc | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index ecdfb633ad..63a4e70f38 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -473,6 +473,33 @@ There is also a mirror on GitHub, see link:{handbook}mirrors/#mirrors[Exteral mi The 'current' branch is 'main' . The quarterly branches are named 'yyyyQn' for year 'yyyy' and quarter 'n'. +===== Commit message formats + +A hook is available in the ports repository to help you write up your commit messages in https://cgit.freebsd.org/ports/tree/.hooks/prepare-commit-msg[.hooks/prepare-commit-message]. +It can be enabled by running ``git config --add core.hooksPath .hooks``. + +The main point being that a commit message should be formatted in the following way: + +.... +category/port: Summary. + +Description of why the changes where made. + +PR: 12345 +.... + +[IMPORTANT] +==== +The first line is the subject of the commit, it contains what port was changed, and a summary of the commit. +It should contain 50 characters or less. + +A blank line should separate it from the rest of the commit message. + +The rest of the commit message should be wrapped at the 72 characters boundary. + +Another blank line should be added if there are any metadata fields, so that they are easily distinguishable from the commit message. +==== + ==== Managing Local Changes This section addresses tracking local changes. If you have no local changes, you can stop reading now (it is the last section and OK to skip). From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 06:17:13 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 E41D7621EF1 for ; Tue, 27 Apr 2021 06:17:13 +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 4FTs49659Hz3KCh; Tue, 27 Apr 2021 06:17:13 +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 C3E0E15D97; Tue, 27 Apr 2021 06:17: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 13R6HDF5073939; Tue, 27 Apr 2021 06:17:13 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13R6HDFT073938; Tue, 27 Apr 2021 06:17:13 GMT (envelope-from git) Date: Tue, 27 Apr 2021 06:17:13 GMT Message-Id: <202104270617.13R6HDFT073938@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mathieu Arnold Subject: git: a6e878928c - main - Add a first quick and dirty draft of what Git can do with GnuPG. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mat X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a6e878928c14923f3fa3aad6ab1b1b4811fe1bc2 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, 27 Apr 2021 06:17:13 -0000 The branch main has been updated by mat: URL: https://cgit.FreeBSD.org/doc/commit/?id=a6e878928c14923f3fa3aad6ab1b1b4811fe1bc2 commit a6e878928c14923f3fa3aad6ab1b1b4811fe1bc2 Author: Mathieu Arnold AuthorDate: 2021-04-22 11:39:47 +0000 Commit: Mathieu Arnold CommitDate: 2021-04-27 06:16:49 +0000 Add a first quick and dirty draft of what Git can do with GnuPG. Reviewed by: rene, imp, lwhsu Differential Revision: https://reviews.freebsd.org/D29726 --- .../en/articles/committers-guide/_index.adoc | 50 ++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 63a4e70f38..523a290408 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -462,6 +462,56 @@ When you are done, report the bad version to the developer (or fix the bug yours 'git bisect reset' will end the process and return you back to where you started (usually tip of main). Again, the git-bisect manual (linked above) is a good resource for when things go wrong or for unusual cases. +[[git-gpg-signing]] +==== Signing the commits, tags, and pushes, with GnuPG + +Git knows how to sign commits, tags, and pushes. +When you sign a Git commit or a tag, you can prove that the code you submitted came from you and wasn't altered while you were transferring it. +You also can prove that you submitted the code and not someone else. + +A more in-depth documentation on signing commits and tags can be found in the https://git-scm.com/book/en/v2/Git-Tools-Signing-Your-Work[Git Tools - Signing Your Work] chapter of the Git's book. + +The rationale behind signing pushes can be found in the https://github.com/git/git/commit/a85b377d0419a9dfaca8af2320cc33b051cbed04[commit that introduced the feature]. + +The best way is to simply tell Git you always want to sign commits, tags, and pushes. +You can do this by setting a few configuration variables: + +[source,shell] +.... +% git config --add user.signingKey=LONG-KEY-ID +% git config --add commit.gpgSign=true +% git config --add tag.gpgSign=true +% git config --add push.gpgSign=if-asked +.... + +// push.gpgSign should probably be set to `yes` once we enable it, or be set with --global, so that it is enabled for all repositories. + +[NOTE] +====== +To avoid possible collisions, make sure you give a long key id to Git. +You can get the long id with: `gpg --list-secret-keys --keyid-format LONG`. +====== + +[TIP] +====== +To use specific subkeys, and not have GnuPG to resolve the subkey to a primary key, attach `!` to the key. +For example, to encrypt for the subkey `DEADBEEF`, use `DEADBEEF!`. +====== + +===== Verifying signatures + +Commit signatures can be verified by running either `git verify-commit `, or `git log --show-signature`. + +Tag signatures can be verifed with `git verity-tag `, or `git tag -v `. + +//// +Commented out for now until we decide what to do. + +Git pushes are a bit different, they live in a special ref in the repository. +TODO: write how to verify them + +//// + ==== Ports Considerations The ports tree operates the same way. The branch names are different and the repositories are in different locations. From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 12:24: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 7730F5E74C4 for ; Tue, 27 Apr 2021 12:24: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 4FV1CY30xsz3v2K; Tue, 27 Apr 2021 12:24: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 59FDC1ABC8; Tue, 27 Apr 2021 12:24: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 13RCO9JS073890; Tue, 27 Apr 2021 12:24:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13RCO9B7073889; Tue, 27 Apr 2021 12:24:09 GMT (envelope-from git) Date: Tue, 27 Apr 2021 12:24:09 GMT Message-Id: <202104271224.13RCO9B7073889@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Muhammad Moinur Rahman Subject: git: 1e8479a736 - main - Add Best Practices virtual panel discussion into events Approved by: core Differential Revision: https://reviews.freebsd.org/D30000 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bofh X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1e8479a7360648908ebaac9613f644b688ef7639 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, 27 Apr 2021 12:24:09 -0000 The branch main has been updated by bofh (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=1e8479a7360648908ebaac9613f644b688ef7639 commit 1e8479a7360648908ebaac9613f644b688ef7639 Author: Muhammad Moinur Rahman AuthorDate: 2021-04-27 12:22:43 +0000 Commit: Muhammad Moinur Rahman CommitDate: 2021-04-27 12:24:02 +0000 Add Best Practices virtual panel discussion into events Approved by: core Differential Revision: https://reviews.freebsd.org/D30000 --- website/data/en/events/events2021.toml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/website/data/en/events/events2021.toml b/website/data/en/events/events2021.toml index b590000c29..4482771812 100644 --- a/website/data/en/events/events2021.toml +++ b/website/data/en/events/events2021.toml @@ -37,3 +37,21 @@ startDate = "2021-03-31" endDate = "2021-03-31" site = "live.FreeBSD.org" description = "On March 31st at 18:00 UTC we will hold a \"FreeBSD Office Hours\", an interactive online event where users, contributors, and developers can ask questions or to offer comments. The topic will be \"Survey Results\", hosted by Sean Chittenden. For more information, please see the Office Hours page on the FreeBSD wiki." + +[[events]] +id = "freebsd-office-hours-2021-05-12" +name = "FreeBSD Office Hours" +url = "https://live.freebsd.org/FreeBSD/officehours/" +startDate = "2021-05-12" +endDate = "2021-05-12" +site = "live.FreeBSD.org" +description = "On May 12th at 18:00 UTC we will hold a \"FreeBSD Office Hours\", an interactive online event where users, contributors, and developers can ask questions or to offer comments. The topic will be \"Best Practices virtual panel discussion\", hosted by Warner Losh. For more information, please see the Office Hours page on the FreeBSD wiki." + +[[events]] +id = "freebsd-office-hours-2021-05-26" +name = "FreeBSD Office Hours" +url = "https://live.freebsd.org/FreeBSD/officehours/" +startDate = "2021-05-26" +endDate = "2021-05-26" +site = "live.FreeBSD.org" +description = "On May 26th at 02:00 UTC we will hold a \"FreeBSD Office Hours\", an interactive online event where users, contributors, and developers can ask questions or to offer comments. The topic will be \"Best Practices virtual panel discussion\", hosted by Warner Losh. For more information, please see the Office Hours page on the FreeBSD wiki." From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 13:23: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 D059E5F1474 for ; Tue, 27 Apr 2021 13:23: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 4FV2X55cqXz4SLy; Tue, 27 Apr 2021 13:23: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 B3DD01B9FE; Tue, 27 Apr 2021 13:23: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 13RDNXLV055004; Tue, 27 Apr 2021 13:23:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13RDNX4J055003; Tue, 27 Apr 2021 13:23:33 GMT (envelope-from git) Date: Tue, 27 Apr 2021 13:23:33 GMT Message-Id: <202104271323.13RDNX4J055003@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Allan Jude Subject: git: 262984365e - main - Remove excess trailing / after {handbook} MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: allanjude X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 262984365ed00105d43064756f6c6cce3f348ecc 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, 27 Apr 2021 13:23:33 -0000 The branch main has been updated by allanjude: URL: https://cgit.FreeBSD.org/doc/commit/?id=262984365ed00105d43064756f6c6cce3f348ecc commit 262984365ed00105d43064756f6c6cce3f348ecc Author: Allan Jude AuthorDate: 2021-04-27 13:19:44 +0000 Commit: Allan Jude CommitDate: 2021-04-27 13:20:15 +0000 Remove excess trailing / after {handbook} Sponsored-By: Klara Inc. --- website/content/en/releases/13.0R/relnotes.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/releases/13.0R/relnotes.adoc b/website/content/en/releases/13.0R/relnotes.adoc index 153548151e..870e1522d5 100644 --- a/website/content/en/releases/13.0R/relnotes.adoc +++ b/website/content/en/releases/13.0R/relnotes.adoc @@ -30,7 +30,7 @@ The {releaseType} distribution to which these release notes apply represents the The {releaseType} distribution to which these release notes apply represents a point along the {releaseBranch} development branch between {releasePrev} and the future {releaseNext}. Information regarding pre-built, binary {releaseType} distributions along this branch can be found at https://www.FreeBSD.org/releases/[https://www.FreeBSD.org/releases/]. -This distribution of FreeBSD {releaseCurrent} is a {releaseType} distribution. It can be found at https://www.FreeBSD.org/releases/[https://www.FreeBSD.org/releases/] or any of its mirrors. More information on obtaining this (or other) {releaseType} distributions of FreeBSD can be found in the link:{handbook}/mirrors[Obtaining FreeBSD appendix] to the link:{handbook}/[FreeBSD Handbook]. +This distribution of FreeBSD {releaseCurrent} is a {releaseType} distribution. It can be found at https://www.FreeBSD.org/releases/[https://www.FreeBSD.org/releases/] or any of its mirrors. More information on obtaining this (or other) {releaseType} distributions of FreeBSD can be found in the link:{handbook}mirrors[Obtaining FreeBSD appendix] to the link:{handbook}[FreeBSD Handbook]. All users are encouraged to consult the release errata before installing FreeBSD. The errata document is updated with "late-breaking" information discovered late in the release cycle or after the release. Typically, it contains information on known bugs, security advisories, and corrections to documentation. An up-to-date copy of the errata for FreeBSD {releaseCurrent} can be found on the FreeBSD Web site. From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 15:05: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 AFCBE5F4AAC for ; Tue, 27 Apr 2021 15:05: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 4FV4p74hHmz4Xld; Tue, 27 Apr 2021 15:05:51 +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 93B661CDA1; Tue, 27 Apr 2021 15:05:51 +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 13RF5p8J089991; Tue, 27 Apr 2021 15:05:51 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13RF5poA089990; Tue, 27 Apr 2021 15:05:51 GMT (envelope-from git) Date: Tue, 27 Apr 2021 15:05:51 GMT Message-Id: <202104271505.13RF5poA089990@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: f847aaeb60 - main - o Remove 12.1-RELEASE from the Handbook index page. 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: f847aaeb602a5948c09ff0a6ba0d0775c38fb885 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, 27 Apr 2021 15:05:51 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=f847aaeb602a5948c09ff0a6ba0d0775c38fb885 commit f847aaeb602a5948c09ff0a6ba0d0775c38fb885 Author: Ryusuke SUZUKI AuthorDate: 2021-04-27 13:32:23 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-27 13:32:23 +0000 o Remove 12.1-RELEASE from the Handbook index page. --- documentation/content/en/books/handbook/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/_index.adoc b/documentation/content/en/books/handbook/_index.adoc index cd161a2719..e22ea09e43 100644 --- a/documentation/content/en/books/handbook/_index.adoc +++ b/documentation/content/en/books/handbook/_index.adoc @@ -24,7 +24,7 @@ include::shared/en/mailing-lists.adoc[] [.abstract-title] Abstract -Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel130-current}-RELEASE_, _FreeBSD {rel122-current}-RELEASE_, _FreeBSD {rel121-current}-RELEASE_ and _FreeBSD {rel114-current}-RELEASE_. This book is the result of ongoing work by many individuals. Some sections might be outdated. Those interested in helping to update and expand this document should send email to the {freebsd-doc}. +Welcome to FreeBSD! This handbook covers the installation and day to day use of _FreeBSD {rel130-current}-RELEASE_, _FreeBSD {rel122-current}-RELEASE_ and _FreeBSD {rel114-current}-RELEASE_. This book is the result of ongoing work by many individuals. Some sections might be outdated. Those interested in helping to update and expand this document should send email to the {freebsd-doc}. The latest version of this book is available from the https://www.FreeBSD.org/[FreeBSD web site]. Previous versions can be obtained from https://docs.FreeBSD.org/doc/[https://docs.FreeBSD.org/doc/]. The book can be downloaded in a variety of formats and compression options from the https://download.freebsd.org/ftp/doc/[FreeBSD FTP server] or one of the numerous link:./mirrors#mirrors-ftp[mirror sites]. Printed copies can be purchased at the https://www.freebsdmall.com/[FreeBSD Mall]. Searches can be performed on the handbook and other documents on the link:https://www.FreeBSD.org/search/[search page]. From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 16:05:27 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 23A2B5F615C for ; Tue, 27 Apr 2021 16:05:27 +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 4FV66v0b5qz4bDN; Tue, 27 Apr 2021 16:05: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 0722B1DC60; Tue, 27 Apr 2021 16:05: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 13RG5QcB070745; Tue, 27 Apr 2021 16:05:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13RG5QPM070744; Tue, 27 Apr 2021 16:05:26 GMT (envelope-from git) Date: Tue, 27 Apr 2021 16:05:26 GMT Message-Id: <202104271605.13RG5QPM070744@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 1c909733b8 - main - 13.0: turn releng/13.0 over to security-officer 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: 1c909733b8ed8b6c52c6e8677781c631def54d21 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, 27 Apr 2021 16:05:27 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=1c909733b8ed8b6c52c6e8677781c631def54d21 commit 1c909733b8ed8b6c52c6e8677781c631def54d21 Author: Glen Barber AuthorDate: 2021-04-27 16:01:47 +0000 Commit: Glen Barber CommitDate: 2021-04-27 16:01:47 +0000 13.0: turn releng/13.0 over to security-officer Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releases/13.0R/schedule.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/releases/13.0R/schedule.adoc b/website/content/en/releases/13.0R/schedule.adoc index fd4c5b783b..8cfc7988c6 100644 --- a/website/content/en/releases/13.0R/schedule.adoc +++ b/website/content/en/releases/13.0R/schedule.adoc @@ -48,7 +48,7 @@ Announcements regarding the availability of the ALPHA snapshots will be sent to |RC5 builds begin |2 April 2021 |2 April 2021 |Fifth release candidate. |RELEASE builds begin |9 April 2021 |9 April 2021 |{localRel}-RELEASE builds begin. |RELEASE announcement |13 April 2021 |13 April 2021 |{localRel}-RELEASE press release. -|Turn over to the secteam |- |- |{localBranchReleng} branch is handed over to the FreeBSD Security Officer Team in one or two weeks after the announcement. +|Turn over to the secteam |- |27 April 2021 |{localBranchReleng} branch is handed over to the FreeBSD Security Officer Team in one or two weeks after the announcement. |=== "*" indicates "as-needed" items. From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 16:07: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 3F5565F6165 for ; Tue, 27 Apr 2021 16:07: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 4FV69B1Mp9z4bBP; Tue, 27 Apr 2021 16:07: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 212411DBA1; Tue, 27 Apr 2021 16:07: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 13RG7Qhm071102; Tue, 27 Apr 2021 16:07:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13RG7Qrq071101; Tue, 27 Apr 2021 16:07:26 GMT (envelope-from git) Date: Tue, 27 Apr 2021 16:07:26 GMT Message-Id: <202104271607.13RG7Qrq071101@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Glen Barber Subject: git: 952889e6af - main - 13.0: update the releng page to show releng/13.0 is now owned by so@ 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: 952889e6af94e082df3976efe5cc7e3699c71fbc 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, 27 Apr 2021 16:07:26 -0000 The branch main has been updated by gjb: URL: https://cgit.FreeBSD.org/doc/commit/?id=952889e6af94e082df3976efe5cc7e3699c71fbc commit 952889e6af94e082df3976efe5cc7e3699c71fbc Author: Glen Barber AuthorDate: 2021-04-27 16:06:38 +0000 Commit: Glen Barber CommitDate: 2021-04-27 16:06:38 +0000 13.0: update the releng page to show releng/13.0 is now owned by so@ Sponsored by: Rubicon Communications, LLC ("Netgate") --- website/content/en/releng/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/releng/_index.adoc b/website/content/en/releng/_index.adoc index d5e385237c..9a213a5597 100644 --- a/website/content/en/releng/_index.adoc +++ b/website/content/en/releng/_index.adoc @@ -48,7 +48,7 @@ This table lists the code freeze status for major branches of the `src/` reposit |Branch |Status |Contact |Notes |`main` |Open |committers |Active development branch for 14.0-CURRENT. |`stable/13` |Open |committers |Development branch for FreeBSD 13-STABLE. -|`releng/13.0` |Frozen |re@FreeBSD.org |FreeBSD 13.0 supported errata fix branch. +|`releng/13.0` |Frozen |so@FreeBSD.org |FreeBSD 13.0 supported errata fix branch. |`stable/12` |Open |committers |Development branch for FreeBSD 12-STABLE. |`releng/12.2`|Frozen|security-officer@FreeBSD.org|FreeBSD 12.2 supported errata fix branch. |`releng/12.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 12.1 errata fix branch (not officially supported). From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 16:39: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 13B2F5F711F for ; Tue, 27 Apr 2021 16:39: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 4FV6tW05B6z4cYM; Tue, 27 Apr 2021 16:39:47 +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 DF8F01DAFB; Tue, 27 Apr 2021 16:39: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 13RGdk4c011435; Tue, 27 Apr 2021 16:39:46 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13RGdkSo011434; Tue, 27 Apr 2021 16:39:46 GMT (envelope-from git) Date: Tue, 27 Apr 2021 16:39:46 GMT Message-Id: <202104271639.13RGdkSo011434@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: fe72008903 - main - 989d921f5d -> f847aaeb60 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: fe720089030f8ae04e591261c43e1bb0ac0b3e1d 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, 27 Apr 2021 16:39:47 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=fe720089030f8ae04e591261c43e1bb0ac0b3e1d commit fe720089030f8ae04e591261c43e1bb0ac0b3e1d Author: Ryusuke SUZUKI AuthorDate: 2021-04-27 16:39:23 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-27 16:39:23 +0000 989d921f5d -> f847aaeb60 --- documentation/content/ja/books/handbook/_index.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/content/ja/books/handbook/_index.adoc b/documentation/content/ja/books/handbook/_index.adoc index d93c7a9e5a..018812dfad 100644 --- a/documentation/content/ja/books/handbook/_index.adoc +++ b/documentation/content/ja/books/handbook/_index.adoc @@ -31,7 +31,8 @@ include::shared/ja/mailing-lists.adoc[] [.abstract-title] 概要 -FreeBSD へようこそ! このハンドブックは __FreeBSD {rel122-current}-RELEASE__, __FreeBSD {rel121-current}-RELEASE__ および __FreeBSD {rel114-current}-RELEASE__ のインストールと日常での使い方について記述したものです。 本ハンドブックはさまざまな人々による編集の成果で、 現在も改編作業中です。 いま存在するセクションの中には情報が古くなってしまっているものがあります。 もし、この文書を新しくしたり、 新しい情報の追加に協力したいとお考えなら、 {freebsd-doc} まで電子メールを (英語で) 送ってください。 +FreeBSD へようこそ! このハンドブックは __FreeBSD {rel130-current}-RELEASE__, __FreeBSD {rel122-current}-RELEASE__ および __FreeBSD {rel114-current}-RELEASE__ のインストールと日常での使い方について記述したものです。 +本ハンドブックはさまざまな人々による編集の成果で、 現在も改編作業中です。 いま存在するセクションの中には情報が古くなってしまっているものがあります。 もし、この文書を新しくしたり、 新しい情報の追加に協力したいとお考えなら、 {freebsd-doc} まで電子メールを (英語で) 送ってください。 このハンドブックの最新バージョンは、いつでも http://www.jp.FreeBSD.org/[日本国内版の FreeBSD ウェブサイト] および https://www.FreeBSD.org/ja/[FreeBSD ウェブサイト] から入手できます。 この文書の以前のバージョンは https://docs.FreeBSD.org/doc/[https://docs.FreeBSD.org/doc/] から入手できます。 また、他のさまざまな文書形式、圧縮形式のものが https://download.freebsd.org/ftp/doc/[FreeBSD FTP サーバ] や数多くの <> からダウンロードできます。 このハンドブックの書籍版 (英語版) は、 https://www.freebsdmall.com/[FreeBSD Mall] から購入できます。また、 ハンドブックおよび他の文書の検索については、link:https://www.FreeBSD.org/search/[検索ページ] で行なうことができます。 From owner-dev-commits-doc-all@freebsd.org Tue Apr 27 17:03: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 3055D5F7F09 for ; Tue, 27 Apr 2021 17:03: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 4FV7PW0b1nz4f4W; Tue, 27 Apr 2021 17:03: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 06FF01E7C2; Tue, 27 Apr 2021 17:03: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 13RH3A5L051733; Tue, 27 Apr 2021 17:03:10 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13RH3AH8051732; Tue, 27 Apr 2021 17:03:10 GMT (envelope-from git) Date: Tue, 27 Apr 2021 17:03:10 GMT Message-Id: <202104271703.13RH3AH8051732@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 5a137559c8 - main - Add missing left curly bracket for rel122-current and activate link to security. FreeBSD.org. 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: 5a137559c8fa9c23d7c31d9ab115735fce2a20f1 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, 27 Apr 2021 17:03:11 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=5a137559c8fa9c23d7c31d9ab115735fce2a20f1 commit 5a137559c8fa9c23d7c31d9ab115735fce2a20f1 Author: Ryusuke SUZUKI AuthorDate: 2021-04-27 17:02:16 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-27 17:02:16 +0000 Add missing left curly bracket for rel122-current and activate link to security. FreeBSD.org. --- website/content/ja/security/_index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/content/ja/security/_index.adoc b/website/content/ja/security/_index.adoc index 6873372809..c16a85e790 100644 --- a/website/content/ja/security/_index.adoc +++ b/website/content/ja/security/_index.adoc @@ -61,7 +61,7 @@ FreeBSD のベースシステムに関わるセキュリティの問題は、電 公開された勧告は、link:advisories/[FreeBSD セキュリティ勧告] ページをご覧ください。 -勧告は、常に FreeBSD セキュリティオフィサの link:https://www.FreeBSD.org/security/so_public_key.asc[PGP 鍵] で署名され、http://security.FreeBSD.org/ ウェブサーバの http://security.FreeBSD.org/advisories/[advisories] および http://security.FreeBSD.org/patches/[patches] サブディレクトリにある関連パッチとともにアーカイブされます。 +勧告は、常に FreeBSD セキュリティオフィサの link:https://www.FreeBSD.org/security/so_public_key.asc[PGP 鍵] で署名され、 http://security.FreeBSD.org/ ウェブサーバの http://security.FreeBSD.org/advisories/[advisories] および http://security.FreeBSD.org/patches/[patches] サブディレクトリにある関連パッチとともにアーカイブされます。 FreeBSD セキュリティオフィサは、 _-STABLE ブランチ_ と _セキュリティブランチ_ に対してセキュリティ勧告を提供しています (_-CURRENT ブランチ_ に対する勧告は提供されません)。 @@ -75,7 +75,7 @@ Ports Collection に関連した問題は、link:http://vuxml.FreeBSD.org/[FreeB [[how]] == システムのアップデートの方法 -バイナリ版の FreeBSD (たとえば rel122-current} や {rel114-current}) をインストールしたユーザは、 以下のコマンドでアップデートできます。 +バイナリ版の FreeBSD (たとえば {rel122-current} や {rel114-current}) をインストールしたユーザは、 以下のコマンドでアップデートできます。 `# freebsd-update fetch` From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 08:07: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 D6A2962F6E0 for ; Wed, 28 Apr 2021 08:07:35 +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 4FVWT35klrz3t4n; Wed, 28 Apr 2021 08:07:35 +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 B790723B7; Wed, 28 Apr 2021 08:07:35 +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 13S87ZDF046994; Wed, 28 Apr 2021 08:07:35 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13S87Z6G046993; Wed, 28 Apr 2021 08:07:35 GMT (envelope-from git) Date: Wed, 28 Apr 2021 08:07:35 GMT Message-Id: <202104280807.13S87Z6G046993@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Bradley T. Hughes" Subject: git: ef2d99ee9f - main - Update GGP key for bhughes@ MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bhughes X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ef2d99ee9f178158af2bb6d1ac43fa65767e1e55 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, 28 Apr 2021 08:07:35 -0000 The branch main has been updated by bhughes (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=ef2d99ee9f178158af2bb6d1ac43fa65767e1e55 commit ef2d99ee9f178158af2bb6d1ac43fa65767e1e55 Author: Bradley T. Hughes AuthorDate: 2021-04-28 08:03:13 +0000 Commit: Bradley T. Hughes CommitDate: 2021-04-28 08:04:58 +0000 Update GGP key for bhughes@ Extend the expiry date on the/my previously expired key. --- documentation/static/pgpkeys/bhughes.key | 79 +++++++++++++++++--------------- 1 file changed, 42 insertions(+), 37 deletions(-) diff --git a/documentation/static/pgpkeys/bhughes.key b/documentation/static/pgpkeys/bhughes.key index 945a42d668..6788cfb2aa 100644 --- a/documentation/static/pgpkeys/bhughes.key +++ b/documentation/static/pgpkeys/bhughes.key @@ -1,15 +1,13 @@ -// $FreeBSD: head/share/pgpkeys/bhughes.key 50296 2017-05-30 19:17:27Z bhughes $ -// // sh addkey.sh bhughes B12E03CA55A31C15 ; - [.literal-block-margin] .... -pub rsa2048/B12E03CA55A31C15 2017-05-29 [SC] [expires: 2020-05-28] +pub rsa2048/B12E03CA55A31C15 2017-05-29 [SC] [expires: 2023-06-24] Key fingerprint = 9580 065C 49C1 ED72 1F6D 56BA B12E 03CA 55A3 1C15 -uid Bradley T. Hughes +uid Bradley T. Hughes uid Bradley T. Hughes -sub rsa2048/427A7C7D32CF6EBC 2017-05-29 [E] [expires: 2020-05-28] +uid Bradley T. Hughes (Work) +sub rsa2048/427A7C7D32CF6EBC 2017-05-29 [E] [expires: 2023-06-24] .... @@ -23,36 +21,43 @@ jAek9//cFs1ltYMsK9iHkApS+UDrFLAnlxV23UfISvNA+j6rsb6GJg+av1H8OBkl 9X84wJZ/z53jkjqoy2oTORuirkF2g2dxAfLJkmOGAOGlbkq/z0bKWKnfTm/JvEOW 0kJ/Vd1hBiS52IFMVy6HKK4BJmO9Zm0xDsIpU7dOyuzl3xwSKcnRBO7/m6C0bNDM pNwg6xcRr7Nb5LDwXneUG+7rRg6nDv8MMjGvABEBAAG0LkJyYWRsZXkgVC4gSHVn -aGVzIDxicmFkbGV5dGh1Z2hlc0BmYXN0bWFpbC5mbT6JAVQEEwEKAD4WIQSVgAZc -ScHtch9tVrqxLgPKVaMcFQUCWSyCdAIbAwUJBaOagAULCQgHAwUVCgkICwUWAwIB -AAIeAQIXgAAKCRCxLgPKVaMcFaDcB/4mAGtnabB0y0h++fpq/dJemPfa4rU8o8Am -NcOONyuGwq4AtWYvXJTXSDRuN5ruiTs2M0Gpcyept9laAAyKRFQLDXxGUvnXjexG -vqYUWGrV2tEmx53guIyQM2iBtaCVawIAgWHwpp2XJzqJcl9J97063E2Mh/wpCR8a -5lZl34621erqq/nb+YPGRBBTmSIEFMFszGb+tjO/01ep4b4pE3W8f+fuZzXz2R7A -datFZVmbCOZWLYdlHTPuCG1L3AH6A3mW5DRBSJ0R3Kg+DpNYCFmFd2irZR8VKpws -XySJtH2ekthuKv92TLfYIZvyvvWHRQIBGuYFHDo+FUGP6rTnThzgtCdCcmFkbGV5 -IFQuIEh1Z2hlcyA8Ymh1Z2hlc0BmcmVlYnNkLm9yZz6JAVQEEwEKAD4WIQSVgAZc -ScHtch9tVrqxLgPKVaMcFQUCWSyCqgIbAwUJBaOagAULCQgHAwUVCgkICwUWAwIB -AAIeAQIXgAAKCRCxLgPKVaMcFcv6B/90l63Yach1Jd59795gVsqkT8+Z/UUPFy2g -Bkth/LGVcubr71Uv89EKcMhFl6XWgx83Hnq0nSw4nNgRq0SpRwO5rVcvj1DJbbRl -dVEmtTCOViQkgXdDPZDB+qtBNCsou6zIqscz+QDloJzEi6xa9on5hQpfkvv7+tpM -w5q4rTTICoZTv+UmXgSDsRnskvrd9K59IHK19PfUYrvZNwhit7ix67H4JLLVV5tD -mF/U4B9RPTZRsHrMg2+TJ9EEuFYjqPKUxAJLSYrwCkLGldmNEFq1KtZTIacSYY0N -j0JnjmrMrQro/PVFAzOxYVwsQvbnK8uAVpAkhCxhwTgal5SCKrINuQENBFksgnQB -CADgd0/ltbTvQZN3HexbxqAx6q+aCzoCSkLupxodmZ0Fz8A/GghXJiYG0J/X3qx5 -ko9wQKKhmamOMrzE9xMb5JmKnJ5sbejDUm2u/jQ0hRr2SEAg/6PF/Bxpz+jJRn93 -bMxzdDRfeYhWJPdJMExfqSOFh34u5szmSl5Cx63dfgchTRlnOyktiVts2CcUYkfL -8QSa7EbdmZLwEUcYUWRWUStjjFAkyw0PbHGWH+JJ7bBwUFkgEqvYD4TFaGpVAQm9 -9OVdyR8GLGY9T8tibt5ijgFtdDerAu/4Pw+ufEnqI53eATZOOB2AsKobtsYuH+vk -2KwPBSDOTWNhjPgOFs3cGh9JABEBAAGJATwEGAEKACYWIQSVgAZcScHtch9tVrqx -LgPKVaMcFQUCWSyCdAIbDAUJBaOagAAKCRCxLgPKVaMcFam9B/0b0NDMlF9oU37h -5vZOY+Wzn4Jhil+3rAt+lXNCT7wQ/rSnmyD3iNCMkaAXB4z1KB2XYyzBevBXO8XX -UF6sM1Qx81cpGs7n/+mzYeV1sLFdV7+Xb5rmjCGvr53FxeBiD4CZqDRqSZ0IPCIf -s1D118/RuX559YrD+yF2A/trK25diRK2QLUFjBra272KQgavVgS6t9OOl5sppGi8 -yB2+f0raCE4EV7xLKC3CAk/VTKEsfjP/lfY+LoUCJZ8HuaafCl0+bKbE7J3eBofn -s2eaDjGUQyYw4dNxT75odOER0hRQskM1/ypRCWeLFejApotcMiAl+KPZZh9EvPw9 -A73TWQI5 -=Qc6N +aGVzIDxicmFkbGV5dGh1Z2hlc0BmYXN0bWFpbC5mbT6JAVQEEwEKAD4CGwMFCwkI +BwMFFQoJCAsFFgMCAQACHgECF4AWIQSVgAZcScHtch9tVrqxLgPKVaMcFQUCXvLs +xQUJC2oE0QAKCRCxLgPKVaMcFSQqCACfP0wP3FCFK+IuYnznq9HJdXAXN4dmZb/s +e9igr0OjRuSgPUqMUDM7OjyJbg2zmDeYaRrPlNYLwGPpG7hMvxZ1pyGci2HDprxf +Xcpaas2LykLGxQ9ezK5fZLkVhxXfcADFWKNqLriX/8HWhNOmourZp8TSk/VoZr0h +ukaKWLjOak95/Twjvk1L3+RfSyPu7hwjfo8WfGjx4ajAQyu+v1F+2Uvi6jeihiIc +MA6R//z9afyylJrAhvYXaAYzdAhR7QbBKSD9LDaWGXVOCF38i+kPYiykEnI7HsbB +xPtEwz6n55dEmx6l3SIQj57HpLt+ZKVmzvLms9tyyjEXQZbwvGG4tDJCcmFkbGV5 +IFQuIEh1Z2hlcyAoV29yaykgPGJyYWRsZXkuaHVnaGVzQG1pbGVzLm5vPokBVAQT +AQoAPgIbAwULCQgHAwUVCgkICwUWAwIBAAIeAQIXgBYhBJWABlxJwe1yH21WurEu +A8pVoxwVBQJe8uzFBQkLagTRAAoJELEuA8pVoxwVi8kH/3I/gXkOcvCsMurFxEwJ +gLuAUgx58EuxKtQW7hP9UW2QW7WVl/tY7KV1pQ3bjIHVBh7rMCJNPnisKCMLJxc4 +KPTyYUzdODpBKf2m1+RjN/TMMydxfp9ZeqWAnM8UYgXmqjkDI80Xce0G3zxprpde +emkFjfU0Cv2iKn0bam/lAX6Myj6FSdBJ36GUz7T56ZoEh62m/1P/8iWykV9Hnu9t +WI9vGa91BOo+RzcX9jdt3zFU7gvjPrSbuVkQaI/wyE5ZJxKrs4ViDIn48hQX/Y99 +MVnQGkTEmIRM3FQogxk8O+ErgtvZuUWy3bGjZrkmrLijmagKqROspc/Oslx3qdQ4 +FtS0J0JyYWRsZXkgVC4gSHVnaGVzIDxiaHVnaGVzQEZyZWVCU0Qub3JnPokBVAQT +AQoAPhYhBJWABlxJwe1yH21WurEuA8pVoxwVBQJgiFxSAhsDBQkLagTRBQsJCAcD +BRUKCQgLBRYDAgEAAh4FAheAAAoJELEuA8pVoxwV6TYIAJtHaNBEBf3xZf9jkEKi +Wtf/TQHjnIuM6wj2Tetj8BbBdONvRpv0FaY18WOexYepQQ8QSlT1jzXPGiy7Dbmn +TjxV7oYBpTOF6kgbtL7wJMsZ8tsGBTzORQSfiVUseSCk2NQDeL8ZJjk3j7mLtE6a +yWaLyaokapFuMYZheOPhheH8UcljHVKgVNjT0SRUIHwkxeNam4Yas8EVOZfT20b+ +YYDfDVEKW5w2QIeddNqqxLKtr/mYKs7h132QCpQUPEUSLJEkrDuJGgGWp1x8t2Oi +exOoojqAudTiTwsYkGCmG/O6fAKaVHZdqJiKjsamJfVHKrpfByehQDEQ7V5x1pkY +iQC5AQ0EWSyCdAEIAOB3T+W1tO9Bk3cd7FvGoDHqr5oLOgJKQu6nGh2ZnQXPwD8a +CFcmJgbQn9ferHmSj3BAoqGZqY4yvMT3ExvkmYqcnmxt6MNSba7+NDSFGvZIQCD/ +o8X8HGnP6MlGf3dszHN0NF95iFYk90kwTF+pI4WHfi7mzOZKXkLHrd1+ByFNGWc7 +KS2JW2zYJxRiR8vxBJrsRt2ZkvARRxhRZFZRK2OMUCTLDQ9scZYf4kntsHBQWSAS +q9gPhMVoalUBCb305V3JHwYsZj1Py2Ju3mKOAW10N6sC7/g/D658Seojnd4BNk44 +HYCwqhu2xi4f6+TYrA8FIM5NY2GM+A4WzdwaH0kAEQEAAYkBPAQYAQoAJgIbDBYh +BJWABlxJwe1yH21WurEuA8pVoxwVBQJe8u0BBQkLagUNAAoJELEuA8pVoxwVhP0H +/3nQhCUVBusl1auQU2BCvZH+m8T4qmVYA0nc8ZtZcxoSrC6ExKjQLETGSEIwHtpt +ET7pJxXnepxfIdFbxSk/9u906fo9e/lMljSdBntcxLvphsTr2cGamqaoIXS7inQY +zYNq3xLmvWoD0c6FTUsjpCBCYdPc5tGRteCbaMuPSzFLcbzo0MrqULGw2M/TTmS5 +ecfzgAsKl5vs/L+3IN47Vl57KfGGvX+y4NxUvDSZUmEOVm5b9/tZQXfrASsCQlvb +KWJJXYJJ3cqhHx5BP5EAXEaXpg15dTDBVNU6fEYClmT3bUU81/+Jb26nnEt+fHkt +2ut4+yuZBypA867gbsvMvZU= +=QYY9 -----END PGP PUBLIC KEY BLOCK----- .... - From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 09:35: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 D684F5E295E for ; Wed, 28 Apr 2021 09:35: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 4FVYPw59XVz4Ry2; Wed, 28 Apr 2021 09:35: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 97A0A3829; Wed, 28 Apr 2021 09:35:00 +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 13S9Z0r3066015; Wed, 28 Apr 2021 09:35:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13S9Z0P8066014; Wed, 28 Apr 2021 09:35:00 GMT (envelope-from git) Date: Wed, 28 Apr 2021 09:35:00 GMT Message-Id: <202104280935.13S9Z0P8066014@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Marc Fonvieille Subject: git: 2f4bcd81ab - main - en/books/handbook/wine: add a missing .png extension which prevented the image rendering. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: blackend X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2f4bcd81abee2abfecbf4f782da7b2fa05111c97 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, 28 Apr 2021 09:35:00 -0000 The branch main has been updated by blackend: URL: https://cgit.FreeBSD.org/doc/commit/?id=2f4bcd81abee2abfecbf4f782da7b2fa05111c97 commit 2f4bcd81abee2abfecbf4f782da7b2fa05111c97 Author: Marc Fonvieille AuthorDate: 2021-04-28 09:33:21 +0000 Commit: Marc Fonvieille CommitDate: 2021-04-28 09:33:21 +0000 en/books/handbook/wine: add a missing .png extension which prevented the image rendering. --- documentation/content/en/books/handbook/wine/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/wine/_index.adoc b/documentation/content/en/books/handbook/wine/_index.adoc index ee1c1e7846..96f4a3177c 100644 --- a/documentation/content/en/books/handbook/wine/_index.adoc +++ b/documentation/content/en/books/handbook/wine/_index.adoc @@ -345,7 +345,7 @@ Selections made on the _Applications_ tab will affect the scope of changes made [[applications]] ==== Applications -image::wine-config-1[] +image::wine-config-1.png[] The _Applications_ contains controls enabling the association of programs with a particular version of Windows(R). On first start-up the _Application settings_ section will contain a single entry: _Default Settings_. This corresponds to all the default configurations of the prefix, which (as the disabled _Remove application_ button implies) cannot be deleted. From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 09:42: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 7D9A45E3156 for ; Wed, 28 Apr 2021 09:42: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 4FVYZ420d4z4Sp0; Wed, 28 Apr 2021 09:42: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 37D94336C; Wed, 28 Apr 2021 09:42: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 13S9g4md078810; Wed, 28 Apr 2021 09:42:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13S9g4VM078809; Wed, 28 Apr 2021 09:42:04 GMT (envelope-from git) Date: Wed, 28 Apr 2021 09:42:04 GMT Message-Id: <202104280942.13S9g4VM078809@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Marc Fonvieille Subject: git: 3254c49c84 - main - /en/books/handbook/wine/: remove extra whitespaces in some command lines. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: blackend X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3254c49c849245cb2eb419c34eccbcb4454e6c08 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, 28 Apr 2021 09:42:04 -0000 The branch main has been updated by blackend: URL: https://cgit.FreeBSD.org/doc/commit/?id=3254c49c849245cb2eb419c34eccbcb4454e6c08 commit 3254c49c849245cb2eb419c34eccbcb4454e6c08 Author: Marc Fonvieille AuthorDate: 2021-04-28 09:39:31 +0000 Commit: Marc Fonvieille CommitDate: 2021-04-28 09:39:31 +0000 /en/books/handbook/wine/: remove extra whitespaces in some command lines. --- documentation/content/en/books/handbook/wine/_index.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/content/en/books/handbook/wine/_index.adoc b/documentation/content/en/books/handbook/wine/_index.adoc index 96f4a3177c..6a7b33aec4 100644 --- a/documentation/content/en/books/handbook/wine/_index.adoc +++ b/documentation/content/en/books/handbook/wine/_index.adoc @@ -457,9 +457,9 @@ To compile it from source, issue the following in the terminal: [source,shell] .... # cd /usr/ports/emulators/i386-wine -# make install -# cd /usr/ports/emulators/winetricks -# make install +# make install +# cd /usr/ports/emulators/winetricks +# make install .... If a manual installation is required, refer to the https://github.com/Winetricks/winetricks[Github] account for instructions. @@ -526,7 +526,7 @@ Homura is available in the FreeBSD Ports system. However, than the _emulators_ s [source,shell] .... # cd /usr/ports/games/homura -# make install +# make install .... [[using-homura]] From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 10:15: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 24FBB5E4863 for ; Wed, 28 Apr 2021 10:15: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 4FVZJq0DQlz4VK5; Wed, 28 Apr 2021 10:15:39 +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 EEBA44133; Wed, 28 Apr 2021 10:15: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 13SAFcku019498; Wed, 28 Apr 2021 10:15:38 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13SAFcU4019497; Wed, 28 Apr 2021 10:15:38 GMT (envelope-from git) Date: Wed, 28 Apr 2021 10:15:38 GMT Message-Id: <202104281015.13SAFcU4019497@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Marc Fonvieille Subject: git: 1fbaec46fa - main - en/books/handbook/wine/_index.adoc: Fix wrong markup for a Web link. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: blackend X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1fbaec46faf8f8600ac602599c23a3962eae01d9 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, 28 Apr 2021 10:15:39 -0000 The branch main has been updated by blackend: URL: https://cgit.FreeBSD.org/doc/commit/?id=1fbaec46faf8f8600ac602599c23a3962eae01d9 commit 1fbaec46faf8f8600ac602599c23a3962eae01d9 Author: Marc Fonvieille AuthorDate: 2021-04-28 10:14:28 +0000 Commit: Marc Fonvieille CommitDate: 2021-04-28 10:14:28 +0000 en/books/handbook/wine/_index.adoc: Fix wrong markup for a Web link. --- documentation/content/en/books/handbook/wine/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/content/en/books/handbook/wine/_index.adoc b/documentation/content/en/books/handbook/wine/_index.adoc index 6a7b33aec4..9cf6a58e7c 100644 --- a/documentation/content/en/books/handbook/wine/_index.adoc +++ b/documentation/content/en/books/handbook/wine/_index.adoc @@ -764,7 +764,7 @@ Perhaps. Many Windows(R) games rely on DirectX, a proprietary Microsoft graphics The _dxvk_ project, which is an attempt to implement DirectX using the FreeBSD-compatible Vulkan graphics sub-system, is one such. Although its primary target is WINE on Linux, https://forums.freebsd.org/threads/what-about-gaming-on-freebsd.723/page-9[some FreeBSD users report] compiling and using dxvk. -In addition, work is under way on a wine-protonhttps://www.freshports.org/emulators/wine-proton/[port]. This will bring the work of Valve, developer of the Steam gaming platform, to FreeBSD. Proton is a distribution of WINE designed to allow many Windows(R) games to run on other operating systems with minimal setup. +In addition, work is under way on a https://www.freshports.org/emulators/wine-proton/[wine-proton port]. This will bring the work of Valve, developer of the Steam gaming platform, to FreeBSD. Proton is a distribution of WINE designed to allow many Windows(R) games to run on other operating systems with minimal setup. [[is-there-anywhere-freebsd-wine-users-gather-to-exchange-tips-and-tricks]] ==== Is There Anywhere FreeBSD WINE Users Gather to Exchange Tips and Tricks? From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 11:56: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 47A575E7CD2 for ; Wed, 28 Apr 2021 11:56: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 4FVcY61Xg8z4Zq3; Wed, 28 Apr 2021 11:56: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 23C3F58F1; Wed, 28 Apr 2021 11:56: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 13SBuQch052681; Wed, 28 Apr 2021 11:56:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13SBuQ72052680; Wed, 28 Apr 2021 11:56:26 GMT (envelope-from git) Date: Wed, 28 Apr 2021 11:56:26 GMT Message-Id: <202104281156.13SBuQ72052680@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: cb6fa9060a - main - 132ff9d795 -> 5dddbce327 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: cb6fa9060ad4f803e164bdf6d91f06cb1d5c605d 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, 28 Apr 2021 11:56:26 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=cb6fa9060ad4f803e164bdf6d91f06cb1d5c605d commit cb6fa9060ad4f803e164bdf6d91f06cb1d5c605d Author: Ryusuke SUZUKI AuthorDate: 2021-04-28 11:55:48 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-28 11:55:48 +0000 132ff9d795 -> 5dddbce327 --- .../content/ja/books/handbook/ports/_index.adoc | 33 +++++++++++++--------- 1 file changed, 20 insertions(+), 13 deletions(-) diff --git a/documentation/content/ja/books/handbook/ports/_index.adoc b/documentation/content/ja/books/handbook/ports/_index.adoc index 038a4263f6..2975f73a33 100644 --- a/documentation/content/ja/books/handbook/ports/_index.adoc +++ b/documentation/content/ja/books/handbook/ports/_index.adoc @@ -586,6 +586,26 @@ HEAD の port と対応する quarterly ブランチの port の依存関係は もし、Ports Collection と pkg を組み合わせて使用しなければならないのであれば、Ports Collection と pkg が同じ ports ツリーのブランチを使用していることを必ず確認してください。 ==== +Ports Collection は、ソフトウェアのカテゴリを表すディレクトリを持ちます。 +各カテゴリには、各アプリケーションのサブディレクトリがあります。 +各アプリケーションのサブディレクトリには、プログラムを FreeBSD 上で正しくコンパイルしてインストールする方法を提供する、 _ports スケルトン_ と呼ばれるファイルのセットが含まれています。 +それぞれの port スケルトンには、次のファイルおよびディレクトリが含まれています。 + +* [.filename]#Makefile#: このファイルにはアプリケーションのコンパイル方法やシステムのどこにインストールするかを指定する命令文が含まれています。 +* [.filename]#distinfo#: このファイルには、その port を構築するためにダウンロードする必要があるファイルのファイル名と、チェックサム情報が含まれています。 +* [.filename]#files#: このディレクトリには FreeBSD 上でプログラムをコンパイルし、インストールするための修正パッチが含まれています。このディレクトリには、その port の構築に必要なその他のファイルが入る場合もあります。 +* [.filename]#pkg-descr#: このファイルにはプログラムに関する、より詳しい説明文が含まれます。 +* [.filename]#pkg-plist#: これは、その port によってインストールされる全ファイルのリストです。これにはプログラムを削除する際に、どのファイルを削除すれば良いのかを ports システムに伝える役割もあります。 + +これらの他に [.filename]#pkg-message# や特殊な状況に対応するためのファイルを含む ports もあります。 +これらのファイルについての詳細および ports の一般的な説明については、link:{porters-handbook}[port 作成者のためのハンドブック] をご覧下さい。 + +port は実際のソースコード ([.filename]#distfile# とも呼ばれます) を含んではいません。 +port の構築の展開部で、ダウンロードされたソースは自動的に [.filename]#/usr/ports/distfiles# に保存されます。 + +[[ports-using-installation-methods]] +=== Ports Collection のインストール + port を用いてアプリケーションをコンパイルできるようにするには、 まず最初に Ports Collection をインストールする必要があります。 FreeBSD のインストール時に Ports Collection をインストールしていない場合には、 以下の方法のどれかを用いてインストールしてください。 [[ports-using-portsnap-method]] @@ -678,19 +698,6 @@ ports ツリーが利用できない場合や、 package の管理に pkg を使 .... ==== -Ports Collection は、ソフトウェアのカテゴリを表すディレクトリを持ちます。 各カテゴリには、各アプリケーションのサブディレクトリがあります。 各アプリケーションのサブディレクトリには、 プログラムを FreeBSD 上で正しくコンパイルしてインストールする方法を提供する、 _ports スケルトン_ と呼ばれるファイルのセットが含まれています。 それぞれの port スケルトンには、 次のファイルおよびディレクトリが含まれています。 - -* [.filename]#Makefile#: このファイルにはアプリケーションのコンパイル方法やシステムのどこにインストールするかを指定する命令文が含まれています。 -* [.filename]#distinfo#: このファイルには、その port を構築するためにダウンロードする必要があるファイルのファイル名と、 チェックサム情報が含まれています。 -* [.filename]#files#: このディレクトリには FreeBSD 上でプログラムをコンパイルし、 インストールするための修正パッチが含まれています。 このディレクトリには、その port の構築に必要なその他のファイルが入る場合もあります。 -* [.filename]#pkg-descr#: このファイルにはプログラムに関する、 より詳しい説明文が含まれます。 -* [.filename]#pkg-plist#: これは、その port によってインストールされる全ファイルのリストです。 これにはプログラムを削除する際に、 どのファイルを削除すれば良いのかを ports システムに伝える役割もあります。 - -これらの他に [.filename]#pkg-message# や特殊な状況に対応するためのファイルを含む ports もあります。 これらのファイルについての詳細および ports の一般的な説明については、 link:{porters-handbook}[port 作成者のためのハンドブック] をご覧下さい。 - -port は実際のソースコード ([.filename]#distfile# とも呼ばれます) を含んではいません。 port の構築の展開部で、ダウンロードされたソースは自動的に [.filename]#/usr/ports/distfiles# に保存されます。 - -[[ports-skeleton]] === ports のインストール この節では、Ports Collection を利用してプログラムをインストールしたり、 システムから削除したりする基本的な手順について説明します。 利用可能な `make` のターゲットや環境変数についての詳細は man:ports[7] をご覧ください。 From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 12:18: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 B934B5F171D for ; Wed, 28 Apr 2021 12:18: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 4FVd2x4t2kz4bt1; Wed, 28 Apr 2021 12:18: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 94F225BAC; Wed, 28 Apr 2021 12:18: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 13SCInXU079832; Wed, 28 Apr 2021 12:18:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13SCInAf079831; Wed, 28 Apr 2021 12:18:49 GMT (envelope-from git) Date: Wed, 28 Apr 2021 12:18:49 GMT Message-Id: <202104281218.13SCInAf079831@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 2c5c72aa54 - main - 989d921f5d -> 01f6f52805 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: 2c5c72aa549eef56c9c3ab35a83d847c101210c6 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, 28 Apr 2021 12:18:49 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=2c5c72aa549eef56c9c3ab35a83d847c101210c6 commit 2c5c72aa549eef56c9c3ab35a83d847c101210c6 Author: Ryusuke SUZUKI AuthorDate: 2021-04-28 12:18:36 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-28 12:18:36 +0000 989d921f5d -> 01f6f52805 --- website/content/ja/security/unsupported.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/website/content/ja/security/unsupported.adoc b/website/content/ja/security/unsupported.adoc index 51c7ea6aae..1f68dacbc5 100644 --- a/website/content/ja/security/unsupported.adoc +++ b/website/content/ja/security/unsupported.adoc @@ -50,4 +50,5 @@ sidenav: support |releng/11.2 |11.2-RELEASE |n/a |2018 年 6 月 28 日 |2019 年 10 月 31 日 |releng/11.3 |11.3-RELEASE |n/a |2019 年 7 月 9 日 |2020 年 9 月 30 日 |releng/12.0 |12.0-RELEASE |n/a |2018 年 12 月 11 日 |2020 年 2 月 29 日 +|releng/12.1 |12.1-RELEASE |n/a |2019 年 11 月 4 日 |2021 年 1 月 31 日 |=== From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 16:03: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 B42AA5F8CEE for ; Wed, 28 Apr 2021 16:03: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 4FVk1q4TTtz4psf; Wed, 28 Apr 2021 16:03: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 8C8DE1121B; Wed, 28 Apr 2021 16:03: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 13SG3BUl083830; Wed, 28 Apr 2021 16:03:11 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13SG3BC3083829; Wed, 28 Apr 2021 16:03:11 GMT (envelope-from git) Date: Wed, 28 Apr 2021 16:03:11 GMT Message-Id: <202104281603.13SG3BC3083829@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Marc Fonvieille Subject: git: a1aad57d6d - main - en/books/developers-handbook/sockets/: Fix figures caption. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: blackend X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a1aad57d6d7e30681c64e9925323472ed4134a0e 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, 28 Apr 2021 16:03:11 -0000 The branch main has been updated by blackend: URL: https://cgit.FreeBSD.org/doc/commit/?id=a1aad57d6d7e30681c64e9925323472ed4134a0e commit a1aad57d6d7e30681c64e9925323472ed4134a0e Author: Marc Fonvieille AuthorDate: 2021-04-28 16:01:27 +0000 Commit: Marc Fonvieille CommitDate: 2021-04-28 16:01:27 +0000 en/books/developers-handbook/sockets/: Fix figures caption. --- .../books/developers-handbook/sockets/_index.adoc | 33 ++++++++++++++-------- 1 file changed, 22 insertions(+), 11 deletions(-) diff --git a/documentation/content/en/books/developers-handbook/sockets/_index.adoc b/documentation/content/en/books/developers-handbook/sockets/_index.adoc index bea670b3d2..a224743a18 100644 --- a/documentation/content/en/books/developers-handbook/sockets/_index.adoc +++ b/documentation/content/en/books/developers-handbook/sockets/_index.adoc @@ -65,7 +65,8 @@ As the languages used in data communications are so terse, we usually refer to t As data travels from one computer to another, it always uses more than one protocol. These protocols are _layered_. The data can be compared to the inside of an onion: You have to peel off several layers of "skin" to get to the data. This is best illustrated with a picture: -image::layers.png[Protocol Layers] +.Protocol Layers +image::layers.png[] In this example, we are trying to get an image from a web page we are connected to via an Ethernet. @@ -117,7 +118,8 @@ Once you have received the data, it is up to you to figure out what to do with i To use an analogy, all the internetworking protocols become a gray area: Not so much because we do not understand how it works, but because we are no longer concerned about it. The sockets interface takes care of this gray area for us: -image::slayers.png[Sockets Covered Protocol Layers] +.Sockets Covered Protocol Layers +image::slayers.png[] We only need to understand any protocols that tell us how to _interpret the data_, not how to _receive_ it from another process, nor how to _send_ it to another process. @@ -272,13 +274,15 @@ struct sockaddr_in { We can visualize its organization this way: -image::sain.png[sockaddr_in] +.sockaddr_in structure +image::sain.png[] The three important fields are `sin_family`, which is byte 1 of the structure, `sin_port`, a 16-bit value found in bytes 2 and 3, and `sin_addr`, a 32-bit integer representation of the IP address, stored in bytes 4-7. Now, let us try to fill it out. Let us assume we are trying to write a client for the _daytime_ protocol, which simply states that its server will write a text string representing the current date and time to port 13. We want to use TCP/IP, so we need to specify `AF_INET` in the address family field. `AF_INET` is defined as `2`. Let us use the IP address of `192.43.244.18`, which is the time server of US federal government (`time.nist.gov`). -image::sainfill.png[Specific example of sockaddr_in] +.Specific example of sockaddr_in +image::sainfill.png[] By the way the `sin_addr` field is declared as being of the `struct in_addr` type, which is defined in [.filename]#netinet/in.h#: @@ -311,11 +315,13 @@ What would the result look like? Well, that depends, of course. On a Pentium(R), or other x86, based computer, it would look like this: -image::sainlsb.png[sockaddr_in on an Intel system] +.sockaddr_in on an Intel system +image::sainlsb.png[] On a different system, it might look like this: -image::sainmsb.png[sockaddr_in on an MSB system] +.sockaddr_in on an MSB system +image::sainmsb.png[] And on a PDP it might look different yet. But the above two are the most common ways in use today. @@ -345,11 +351,13 @@ There is a convention of sending the multi-byte data over IP _MSB first_. This, Now, if we compiled the above code for an Intel based computer, our _host byte order_ would produce: -image::sainlsb.png[Host byte order on an Intel system] +.Host byte order on an Intel system +image::sainlsb.png[] But the _network byte order_ requires that we store the data MSB first: -image::sainmsb.png[Network byte order] +.Network byte order +image::sainmsb.png[] Unfortunately, our _host order_ is the exact opposite of the _network order_. @@ -488,7 +496,8 @@ Beside specifying the port in `addr`, the server may include its IP address. How Suppose we were writing a server for the _daytime_ protocol over TCP/IP. Recall that it uses port 13. Our `sockaddr_in` structure would look like this: -image::sainserv.png[Example Server sockaddr_in] +.Example Server sockaddr_in +image::sainserv.png[] [[sockets-listen]] ===== `listen` @@ -648,7 +657,8 @@ Finally, the daemon starts an endless loop, which performs the following steps: We can _generalize_ this, and use it as a model for many other servers: -image::serv.png[Sequential Server] +.Sequential Server +image::serv.png[] This flowchart is good for _sequential servers_, i.e., servers that can serve one client at a time, just as we were able to with our _daytime_ server. This is only possible whenever there is no real "conversation" going on between the client and the server: As soon as the server detects a connection to the client, it sends out some data and closes the connection. The entire operation may take nanoseconds, and it is finished. @@ -867,7 +877,8 @@ Unlike a sequential server, a _concurrent server_ has to be able to serve more t This requires a significant change in our flowchart: -image::serv2.png[Concurrent Server] +.Concurrent Server +image::serv2.png[] We moved the _serve_ from the _daemon process_ to its own _server process_. However, because each child process inherits all open files (and a socket is treated just like a file), the new process inherits not only the _"accepted handle,"_ i.e., the socket returned by the `accept` call, but also the _top socket_, i.e., the one opened by the top process right at the beginning. From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 16:30: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 A889F5F98D7 for ; Wed, 28 Apr 2021 16:30: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 4FVkd64NpSz4r7d; Wed, 28 Apr 2021 16:30: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 8961711715; Wed, 28 Apr 2021 16:30: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 13SGUI4j017989; Wed, 28 Apr 2021 16:30:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13SGUIBs017980; Wed, 28 Apr 2021 16:30:18 GMT (envelope-from git) Date: Wed, 28 Apr 2021 16:30:18 GMT Message-Id: <202104281630.13SGUIBs017980@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Marc Fonvieille Subject: git: 8c4d527185 - main - en/books/developers-handbook: Fix imagesdir path to allow images embedding in PDF MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: blackend X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8c4d527185b83c829bd3f5473106704355d92824 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, 28 Apr 2021 16:30:18 -0000 The branch main has been updated by blackend: URL: https://cgit.FreeBSD.org/doc/commit/?id=8c4d527185b83c829bd3f5473106704355d92824 commit 8c4d527185b83c829bd3f5473106704355d92824 Author: Marc Fonvieille AuthorDate: 2021-04-28 16:28:24 +0000 Commit: Marc Fonvieille CommitDate: 2021-04-28 16:28:24 +0000 en/books/developers-handbook: Fix imagesdir path to allow images embedding in PDF --- documentation/content/en/books/developers-handbook/book.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/developers-handbook/book.adoc b/documentation/content/en/books/developers-handbook/book.adoc index c59bda0a3d..7953a77d83 100644 --- a/documentation/content/en/books/developers-handbook/book.adoc +++ b/documentation/content/en/books/developers-handbook/book.adoc @@ -44,7 +44,7 @@ include::../../../../shared/releases.adoc[] include::../../../../shared/en/mailing-lists.adoc[] include::../../../../shared/en/teams.adoc[] include::../../../../shared/en/urls.adoc[] -:imagesdir: ../../../static/images/books/developers-handbook/ +:imagesdir: ../../../../static/images/books/developers-handbook/ :chapters-path: endif::[] @@ -55,7 +55,7 @@ include::../../../../shared/releases.adoc[] include::../../../../shared/en/mailing-lists.adoc[] include::../../../../shared/en/teams.adoc[] include::../../../../shared/en/urls.adoc[] -:imagesdir: ../../../static/images/books/developers-handbook/ +:imagesdir: ../../../../static/images/books/developers-handbook/ :chapters-path: endif::[] From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 17:51: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 CCC915FC02D for ; Wed, 28 Apr 2021 17:51: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 4FVmQJ5VMSz3BpB; Wed, 28 Apr 2021 17:51: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 AFA5B12910; Wed, 28 Apr 2021 17:51: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 13SHp4w3027114; Wed, 28 Apr 2021 17:51:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13SHp4kH027113; Wed, 28 Apr 2021 17:51:04 GMT (envelope-from git) Date: Wed, 28 Apr 2021 17:51:04 GMT Message-Id: <202104281751.13SHp4kH027113@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Guangyuan Yang Subject: git: 339e2e4741 - main - Fix an incorrect link to the German docproj page MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ygy X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 339e2e4741f602e74e807106cae771e3c945638a 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, 28 Apr 2021 17:51:04 -0000 The branch main has been updated by ygy: URL: https://cgit.FreeBSD.org/doc/commit/?id=339e2e4741f602e74e807106cae771e3c945638a commit 339e2e4741f602e74e807106cae771e3c945638a Author: Guangyuan Yang AuthorDate: 2021-04-28 16:54:35 +0000 Commit: Guangyuan Yang CommitDate: 2021-04-28 16:54:35 +0000 Fix an incorrect link to the German docproj page PR: 255410 Reported by: Ceri Davies --- website/content/en/docs/books.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/docs/books.adoc b/website/content/en/docs/books.adoc index dfb9b50ca9..97ced33523 100644 --- a/website/content/en/docs/books.adoc +++ b/website/content/en/docs/books.adoc @@ -13,7 +13,7 @@ All the documentation on this site can be downloaded in a variety of different f Archived copies of the FreeBSD documentation (articles, books, and textinfo manuals) are also available online at http://docs.FreeBSD.org/doc/. -This documentation is provided and maintained by the link:https://www.FreeBSD.org/de/docproj[FreeBSD Documentation Project], and we are always looking for people to contribute new documentation and maintain existing documentation. +This documentation is provided and maintained by the link:https://www.FreeBSD.org/docproj[FreeBSD Documentation Project], and we are always looking for people to contribute new documentation and maintain existing documentation. Papers, presentations, and videos about FreeBSD are archived and catalogued on the https://papers.freebsd.org/[FreeBSD Papers] website. From owner-dev-commits-doc-all@freebsd.org Wed Apr 28 18:29: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 BB19D5FD0A4 for ; Wed, 28 Apr 2021 18:29: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 4FVnGW4ypwz3DCv; Wed, 28 Apr 2021 18:29: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 9D5A012E24; Wed, 28 Apr 2021 18:29: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 13SITNw3071960; Wed, 28 Apr 2021 18:29:23 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13SITNlc071959; Wed, 28 Apr 2021 18:29:23 GMT (envelope-from git) Date: Wed, 28 Apr 2021 18:29:23 GMT Message-Id: <202104281829.13SITNlc071959@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Dimitry Andric Subject: git: 14874cd74d - main - Fix minor typo: s/Exteral/External/. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dim X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 14874cd74d40dfb17bd41edc91b88d7ca0dd6990 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, 28 Apr 2021 18:29:23 -0000 The branch main has been updated by dim (src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=14874cd74d40dfb17bd41edc91b88d7ca0dd6990 commit 14874cd74d40dfb17bd41edc91b88d7ca0dd6990 Author: Dimitry Andric AuthorDate: 2021-04-28 18:29:18 +0000 Commit: Dimitry Andric CommitDate: 2021-04-28 18:29:18 +0000 Fix minor typo: s/Exteral/External/. --- 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 523a290408..a79443f48c 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -519,7 +519,7 @@ The branch names are different and the repositories are in different locations. The cgit repository web interface for use with web browsers is at https://cgit.FreeBSD.org/ports/ . The production Git repository is at https://git.FreeBSD.org/ports.git and at ssh://anongit@git.FreeBSD.org/ports.git (or anongit@git.FreeBSD.org:ports.git). -There is also a mirror on GitHub, see link:{handbook}mirrors/#mirrors[Exteral mirrors] for an overview. +There is also a mirror on GitHub, see link:{handbook}mirrors/#mirrors[External mirrors] for an overview. The 'current' branch is 'main' . The quarterly branches are named 'yyyyQn' for year 'yyyy' and quarter 'n'. From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 14:23:46 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 C2813629FD0 for ; Thu, 29 Apr 2021 14:23:46 +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 4FWHmf58Syz4hfh; Thu, 29 Apr 2021 14:23: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 A3B421D285; Thu, 29 Apr 2021 14:23: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 13TENkLr035058; Thu, 29 Apr 2021 14:23:46 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TENk5X035057; Thu, 29 Apr 2021 14:23:46 GMT (envelope-from git) Date: Thu, 29 Apr 2021 14:23:46 GMT Message-Id: <202104291423.13TENk5X035057@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lewis Cook Subject: git: cc7b0877fb - main - books/porters-handbook: Include fish-shell completion path MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: lcook X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: cc7b0877fbd2f7a0f89c8f1c5cc2705b2a9f333d 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, 29 Apr 2021 14:23:46 -0000 The branch main has been updated by lcook (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=cc7b0877fbd2f7a0f89c8f1c5cc2705b2a9f333d commit cc7b0877fbd2f7a0f89c8f1c5cc2705b2a9f333d Author: Lewis Cook AuthorDate: 2021-04-25 15:52:27 +0000 Commit: Lewis Cook CommitDate: 2021-04-29 14:20:46 +0000 books/porters-handbook: Include fish-shell completion path Approved by: 0mp, ygy Differential Revision: https://reviews.freebsd.org/D29973 --- documentation/content/en/books/porters-handbook/special/_index.adoc | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/documentation/content/en/books/porters-handbook/special/_index.adoc b/documentation/content/en/books/porters-handbook/special/_index.adoc index ca302cb9d2..71a35cd0ef 100644 --- a/documentation/content/en/books/porters-handbook/special/_index.adoc +++ b/documentation/content/en/books/porters-handbook/special/_index.adoc @@ -4307,7 +4307,7 @@ Just like in case of Go language, Ports must not package or install Haskell libr [[shell-completion]] == Shell Completion Files -Many modern shells (including bash, tcsh, and zsh) support parameter and/or option tab-completion. This support usually comes from completion files, which contain the definitions for how tab completion will work for a certain command. Ports sometimes ship with their own completion files, or porters may have created them themselves. +Many modern shells (including bash, fish, tcsh and zsh) support parameter and/or option tab-completion. This support usually comes from completion files, which contain the definitions for how tab completion will work for a certain command. Ports sometimes ship with their own completion files, or porters may have created them themselves. When available, completion files should always be installed. It is not necessary to make an option for it. If an option is used, though, always enable it in `OPTIONS_DEFAULT`. [[shell-completion-paths]] @@ -4317,6 +4317,9 @@ When available, completion files should always be installed. It is not necessary |`bash` |[.filename]#${PREFIX}/etc/bash_completion.d# +|`fish` +|[.filename]#${PREFIX}/share/fish/vendor_completions.d# + |`zsh` |[.filename]#${PREFIX}/share/zsh/site-functions# |=== From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 18:48: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 8018C6336C5 for ; Thu, 29 Apr 2021 18:48: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 4FWPfb3CNVz3C8h; Thu, 29 Apr 2021 18:48:55 +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 60DDB1F059; Thu, 29 Apr 2021 18:48:55 +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 13TImtQa081197; Thu, 29 Apr 2021 18:48:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TImtl3081196; Thu, 29 Apr 2021 18:48:55 GMT (envelope-from git) Date: Thu, 29 Apr 2021 18:48:55 GMT Message-Id: <202104291848.13TImtl3081196@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?U3RlZmFuIEXDn2Vy?= Subject: git: 582cf4227c - main - content/en/cgi: Fix paths in cgi-style.pl, man.cgi, and ports.cgi MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: se X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 582cf4227c03af60806e9c437703f3fe0b0ea374 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, 29 Apr 2021 18:48:55 -0000 The branch main has been updated by se (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=582cf4227c03af60806e9c437703f3fe0b0ea374 commit 582cf4227c03af60806e9c437703f3fe0b0ea374 Author: Stefan Eßer AuthorDate: 2021-04-29 18:01:32 +0000 Commit: Stefan Eßer CommitDate: 2021-04-29 18:01:32 +0000 content/en/cgi: Fix paths in cgi-style.pl, man.cgi, and ports.cgi Adjust paths to point at cgit.freebsd.org instead of svnweb. An attempt has been made to provide the same kind of information as before, but the layout and information displayed by cgit is different from that of svnweb. Reviewed by: wosch PR: 255215 Differential Revision: https://reviews.freebsd.org/D29829 --- website/content/en/cgi/cgi-style.pl | 2 +- website/content/en/cgi/man.cgi | 2 +- website/content/en/cgi/ports.cgi | 16 +++++++++------- 3 files changed, 11 insertions(+), 9 deletions(-) diff --git a/website/content/en/cgi/cgi-style.pl b/website/content/en/cgi/cgi-style.pl index 7a472103fc..2d02151496 100644 --- a/website/content/en/cgi/cgi-style.pl +++ b/website/content/en/cgi/cgi-style.pl @@ -151,7 +151,7 @@ $i_topbar = qq`
  • Developers
    • diff --git a/website/content/en/cgi/man.cgi b/website/content/en/cgi/man.cgi index 6f5acf4d5a..81bbe323d5 100755 --- a/website/content/en/cgi/man.cgi +++ b/website/content/en/cgi/man.cgi @@ -2002,7 +2002,7 @@ macros like `appeared in NetBSD version 1.2' are not supported.
  • Some OSs provide only formatted manual pages (catpages), e.g., NetBSD and OpenBSD. In this case it is not possible to create Postscript and troff output.
    • -
  • The +
  • The Unix family tree, BSD part.
  • The FreeBSD Ports Changes script.
    • diff --git a/website/content/en/cgi/ports.cgi b/website/content/en/cgi/ports.cgi index a927f2f46b..2162548251 100755 --- a/website/content/en/cgi/ports.cgi +++ b/website/content/en/cgi/ports.cgi @@ -110,7 +110,7 @@ sub init_variables { $remotePrefixHtml = "$hsty_base/ports"; # Web interface for the Ports tree - $remotePrefixRepo = 'https://svnweb.FreeBSD.org/ports/head'; + $remotePrefixRepo = 'https://cgit.FreeBSD.org/ports'; # Ports documentation $portsDesc = "$hsty_base/ports/"; @@ -317,7 +317,7 @@ sub out { if ( !$out_sec || $1 ne $out_sec ) { print "\n" if $counter > 0; print qq{\n

    } - . qq{Category $1} + . qq{Category $1} . "

    \n
    \n"; $out_sec = $1; } @@ -335,11 +335,13 @@ sub out { #$version =~ s/[\+,]/X/g; local ($l) = $path; - $l =~ s%^$remotePrefixFtp%$remotePrefixRepo%o; - $descfile =~ s%^$remotePrefixFtp%$remotePrefixRepo%o; + $l =~ s%^$remotePrefixFtp%$remotePrefixRepo/log%o; + local ($t) = $path; + $t =~ s%^$remotePrefixFtp%$remotePrefixRepo/tree%o; + $descfile =~ s%^$remotePrefixFtp%$remotePrefixRepo/plain%o; print - qq{
    $version
    \n}; + qq{
    $version
    \n}; print qq{
    }, &escapeHTML($comment), qq{
    \n}; print qq[Description :\n]; @@ -350,7 +352,7 @@ sub out { qq[Package :\n]; } - print qq[Changes
    \n]; + print qq[Changes
    \n]; print qq{Maintained by: 0 ) { print qq{Also listed in: }; foreach (@s) { - print qq{$_ } + print qq{$_ } if $_ ne $out_sec; } print "
    \n"; From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 18:48:57 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 C40E263374D for ; Thu, 29 Apr 2021 18:48:57 +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 4FWPfd5Dxsz3Bx0; Thu, 29 Apr 2021 18:48:57 +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 A73C11F29A; Thu, 29 Apr 2021 18:48:57 +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 13TImvaa081247; Thu, 29 Apr 2021 18:48:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TImvCK081246; Thu, 29 Apr 2021 18:48:57 GMT (envelope-from git) Date: Thu, 29 Apr 2021 18:48:57 GMT Message-Id: <202104291848.13TImvCK081246@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?U3RlZmFuIEXDn2Vy?= Subject: git: fecf75132b - main - content/nl: adjust paths to point at cgit.freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: se X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fecf75132b9894f6013c1a028617bfc95f9e8197 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, 29 Apr 2021 18:48:57 -0000 The branch main has been updated by se (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=fecf75132b9894f6013c1a028617bfc95f9e8197 commit fecf75132b9894f6013c1a028617bfc95f9e8197 Author: Stefan Eßer AuthorDate: 2021-04-29 18:33:29 +0000 Commit: Stefan Eßer CommitDate: 2021-04-29 18:33:29 +0000 content/nl: adjust paths to point at cgit.freebsd.org An attempt has been made to provide the same kind of information as before, but the layout and information displayed by cgit is different from that of svnweb in some cases. Reviewed by: wosch Differential Revision: https://reviews.freebsd.org/D29854 --- website/content/nl/art.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/content/nl/art.adoc b/website/content/nl/art.adoc index 169043f686..8cea8ad193 100644 --- a/website/content/nl/art.adoc +++ b/website/content/nl/art.adoc @@ -21,7 +21,7 @@ image:../../gifs/daemon-phk.png[BSD Daemon,width=191,height=208] [.center] Gemaakt door {phk-name} + -Bron: http://svnweb.freebsd.org/base/head/share/examples/BSD_daemon/[/usr/share/examples/BSD_daemon/] op FreeBSD systemen. +Bron: https://cgit.freebsd.org/src/tree/share/examples/BSD_daemon/[/usr/share/examples/BSD_daemon/] op FreeBSD systemen. [.center] link:../../gifs/daemon_hammer.jpg[image:../../gifs/daemon_hammer-tn25.jpg[BSD Daemon wielding a hammer,width=150,height=178]] image:../../gifs/power.jpg[BSD Daemon waiting tables,width=160,height=246] @@ -60,9 +60,9 @@ image:../../gifs/freebsd-advert.gif[Adv Banner1,width=455,height=60] image:../.. De bovenstaande "`Powered by FreeBSD`" logo's kunnen link:https://www.FreeBSD.org/gifs/powerlogo.gif[gedownload] worden en mogen worden weergegeven op persoonlijke en zakelijke webpagina's die worden geserveerd door FreeBSD machines. Voor het gebruik van dit logo of de verschijning van de link:https://www.FreeBSD.org/copyright/daemon/[BSD Daemons] met winstoogmerk is toestemming nodig van mailto:taob@risc.org[Brian Tao] (maker van het "`power`" logo) en mailto:mckusick@mckusick.com[Marshall Kirk McKusick] (houder van het copyright voor de afbeelding van de BSD Daemon). -{phk-name}'s afbeelding van de BSD Daemon is uitgebracht onder "`THE BEER-WARE LICENSE`". Zie de http://svnweb.freebsd.org/base/head/share/examples/BSD_daemon/README?view=markup[README] voor meer informatie. +{phk-name}'s afbeelding van de BSD Daemon is uitgebracht onder "`THE BEER-WARE LICENSE`". Zie de https://cgit.freebsd.org/src/plain/head/share/examples/BSD_daemon/README[README] voor meer informatie. [[trademark]] == Handelsmerken -De http://www.freebsdfoundation.org[FreeBSD Foundation] houdt verschillende handelsmerken gerelateerd aan FreeBSD (waaronder het handelsmerk voor de term "`FreeBSD`" zelf). Lees voor meer informatie over deze handelsmerken de http://www.freebsdfoundation.org/faqs.shtml#Trademark[FreeBSD Trademark Usage Terms and Conditions]. +De https://www.freebsdfoundation.org[FreeBSD Foundation] houdt verschillende handelsmerken gerelateerd aan FreeBSD (waaronder het handelsmerk voor de term "`FreeBSD`" zelf). Lees voor meer informatie over deze handelsmerken de https://www.freebsdfoundation.org/faqs.shtml#Trademark[FreeBSD Trademark Usage Terms and Conditions]. From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 18:48: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 1025E6335EB for ; Thu, 29 Apr 2021 18:48: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 4FWPff72j2z3BtR; Thu, 29 Apr 2021 18:48:58 +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 E33DD1EF62; Thu, 29 Apr 2021 18:48:58 +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 13TImwgG081272; Thu, 29 Apr 2021 18:48:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TImwsu081271; Thu, 29 Apr 2021 18:48:58 GMT (envelope-from git) Date: Thu, 29 Apr 2021 18:48:58 GMT Message-Id: <202104291848.13TImwsu081271@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?U3RlZmFuIEXDn2Vy?= Subject: git: 8dd049ade7 - main - content/ja: adjust paths to point at cgit.freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: se X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 8dd049ade770cbe1e4759ad7f1517e17fc35584d 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, 29 Apr 2021 18:48:59 -0000 The branch main has been updated by se (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=8dd049ade770cbe1e4759ad7f1517e17fc35584d commit 8dd049ade770cbe1e4759ad7f1517e17fc35584d Author: Stefan Eßer AuthorDate: 2021-04-29 18:34:21 +0000 Commit: Stefan Eßer CommitDate: 2021-04-29 18:34:21 +0000 content/ja: adjust paths to point at cgit.freebsd.org An attempt has been made to provide the same kind of information as before, but the layout and information displayed by cgit is different from that of svnweb in some cases. The reference to the commit log of Mk/bsd.port.subdir.mk did no longer lead to a description of the supported parameters of "make search". A translation of the english language language version of this file could be added to restore this information. Approved by: wosch Differential Revision: https://reviews.freebsd.org/D29855 --- website/content/ja/copyright/_index.adoc | 2 +- website/content/ja/java/_index.adoc | 2 +- website/content/ja/platforms/arm.adoc | 2 +- website/content/ja/platforms/mips.adoc | 2 +- website/content/ja/ports/references.adoc | 2 +- website/content/ja/ports/searching.adoc | 2 +- website/content/ja/ports/updating.adoc | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/website/content/ja/copyright/_index.adoc b/website/content/ja/copyright/_index.adoc index 46384fe1fc..7adf220d42 100644 --- a/website/content/ja/copyright/_index.adoc +++ b/website/content/ja/copyright/_index.adoc @@ -15,7 +15,7 @@ sidenav: about == link:daemon[BSD デーモン] -== http://svnweb.FreeBSD.org/ports/head/LEGAL?revision=HEAD&view=co[FreeBSD Ports を再配布する際の制限] +== https://cgit.FreeBSD.org/ports/plain/LEGAL[FreeBSD Ports を再配布する際の制限] == link:https://www.FreeBSD.org/copyright/COPYING[GNU GENERAL PUBLIC LICENSE] diff --git a/website/content/ja/java/_index.adoc b/website/content/ja/java/_index.adoc index a4d22a063b..fcd1cd4ccd 100644 --- a/website/content/ja/java/_index.adoc +++ b/website/content/ja/java/_index.adoc @@ -32,7 +32,7 @@ OpenJDK(R) プロジェクトは、Java(R) SE プラットフォームのネイ *powerpc64*: `openjdk8`, `openjdk11`, `openjdk12`, `openjdk13` -OpenJDK(R) は頻繁にアップデートされています。 詳細なリリースの変遷を知るには、 link:https://svnweb.freebsd.org/ports/head/java/[リビジョンログ] を参照してください。さらに、 link:https://www.freshports.org/search.php?query=openjdk&search=go&num=10&stype=name&method=match&deleted=excludedeleted&start=1&casesensitivity=caseinsensitive[FreshPorts] でより多くの情報をレビューすることもできます。 +OpenJDK(R) は頻繁にアップデートされています。 詳細なリリースの変遷を知るには、 link:https://cgit.freebsd.org/ports/tree/java/[リビジョンログ] を参照してください。さらに、 link:https://www.freshports.org/search.php?query=openjdk&search=go&num=10&stype=name&method=match&deleted=excludedeleted&start=1&casesensitivity=caseinsensitive[FreshPorts] でより多くの情報をレビューすることもできます。 OpenJDK(R) package をインストールするには、 link:https://www.FreeBSD.org/cgi/man.cgi?query=pkg[`pkg`] ユーティリティまたは ports システムを使用してください。 diff --git a/website/content/ja/platforms/arm.adoc b/website/content/ja/platforms/arm.adoc index f018f6b73f..041f013a72 100644 --- a/website/content/ja/platforms/arm.adoc +++ b/website/content/ja/platforms/arm.adoc @@ -33,7 +33,7 @@ include::shared/ja/urls.adoc[] FreeBSD/arm および FreeBSd/armv6 は、ARM CPU および開発用基板に幅広く対応しています。 すべての CPU もしくはボードがすべての周辺機器に対応しているわけではありませんが、 対応に向けた作業は続いており、貢献者はいつでも歓迎されます。 一方で、一覧にない CPU およびボードの多くは、 最小限の変更で動作するでしょう。 -このページですべての CPU およびボードが対応しているすべてのデバイスの一覧を提供することは現実的ではありません。 多くの情報は、メーリングリストおよびそのアーカイブ、 https://wiki.freebsd.org/FreeBSD/arm[FreeBSD/arm Wiki ページ] および https://svnweb.freebsd.org/base/head/sys/arm/conf/[カーネルコンフィグレーションファイル] で見つけることができます。 +このページですべての CPU およびボードが対応しているすべてのデバイスの一覧を提供することは現実的ではありません。 多くの情報は、メーリングリストおよびそのアーカイブ、 https://wiki.freebsd.org/FreeBSD/arm[FreeBSD/arm Wiki ページ] および https://cgit.freebsd.org/src/tree/sys/arm/conf/[カーネルコンフィグレーションファイル] で見つけることができます。 === 対応しているコア diff --git a/website/content/ja/platforms/mips.adoc b/website/content/ja/platforms/mips.adoc index 78091b4417..10d49b8e15 100644 --- a/website/content/ja/platforms/mips.adoc +++ b/website/content/ja/platforms/mips.adoc @@ -27,7 +27,7 @@ MIPS は link:{committers-guide}#archs[Tier 2] アーキテクチャであり、 FreeBSD/MIPS は、FreeBSD オペレーティングシステムの MIPS 系プロセッサを搭載したプラットフォームへの移植です。 現時点では、MIPS32 および MIPS64 development ボード、 組み込みプラットフォームが対象です。 -対応しているすべての CPU およびボードの一覧をこのページでまとめることは現実的ではありません。 多くの情報はメーリングリスト、アーカイブ、 http://wiki.freebsd.org/FreeBSD/mips[MIPS Wiki ページ] で見つけることができます。 https://svnweb.freebsd.org/base/head/sys/mips/conf/[カーネルコンフィグレーションファイル] にもあります。 +対応しているすべての CPU およびボードの一覧をこのページでまとめることは現実的ではありません。 多くの情報はメーリングリスト、アーカイブ、 https://wiki.freebsd.org/FreeBSD/mips[MIPS Wiki ページ] で見つけることができます。 https://cgit.freebsd.org/src/tree/sys/mips/conf/[カーネルコンフィグレーションファイル] にもあります。 === CPU diff --git a/website/content/ja/ports/references.adoc b/website/content/ja/ports/references.adoc index 9086500945..7f06f4292b 100644 --- a/website/content/ja/ports/references.adoc +++ b/website/content/ja/ports/references.adoc @@ -22,4 +22,4 @@ ports や packages についてもう少し詳しく知りたい場合には、 * https://www.FreshPorts.org[FreshPorts.org] は、 個々の ports について、 現在のバージョン、最後のチェックイン、および、他の有用な統計など、 詳細な情報を得るための有用なツールです。 メーリングリストを購読して、お気に入りの ports の最新の情報を得てください。 * link:https://www.FreeBSD.org/cgi/man.cgi?query=ftp[`ftp`], link:https://www.FreeBSD.org/cgi/man.cgi?query=pkg_add[`pkg_add`] link:https://www.FreeBSD.org/cgi/man.cgi?query=pkg&sektion=8[`pkg`] および link:https://www.FreeBSD.org/cgi/man.cgi?query=ports[`ports`] のマニュアルページ。 * link:https://www.FreeBSD.org/portmgr/[Ports Management Team] (portmgr) ページ。 -* https://svnweb.FreeBSD.org/ports[ソースリポジトリのウェブインタフェース] を使い、ソースリポジトリを閲覧できます。 port システム全体に影響するような変更は、 https://svnweb.FreeBSD.org/ports/head/CHANGES?view=markup[CHANGES] ファイルに記述されています。 ある特定の ports に影響するような変更は、 https://svnweb.FreeBSD.org/ports/head/UPDATING?view=markup[UPDATING] ファイルに記述されています。 しかしながら、すべての答えは https://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.mk?view=markup[bsd.port.mk] のソースコード、 および関連ファイルを読むことで確実に得られるできるでしょう。 +* https://cgit.FreeBSD.org/ports/tree[ソースリポジトリのウェブインタフェース] を使い、ソースリポジトリを閲覧できます。 port システム全体に影響するような変更は、 https://cgit.FreeBSD.org/ports/tree/CHANGES[CHANGES] ファイルに記述されています。 ある特定の ports に影響するような変更は、 https://cgit.FreeBSD.org/ports/tree/UPDATING[UPDATING] ファイルに記述されています。 しかしながら、すべての答えは https://cgit.FreeBSD.org/ports/tree/Mk/bsd.port.mk[bsd.port.mk] のソースコード、 および関連ファイルを読むことで確実に得られるできるでしょう。 diff --git a/website/content/ja/ports/searching.adoc b/website/content/ja/ports/searching.adoc index 5fe389d39d..1757178a24 100644 --- a/website/content/ja/ports/searching.adoc +++ b/website/content/ja/ports/searching.adoc @@ -11,6 +11,6 @@ sidenav: ports 上のフォームを利用して、本サイトの ports を検索できます。 検索を行うと link:https://www.FreeBSD.org/cgi/ports.cgi[より完全な検索ページ] が表示されます。 -しかしならが、もし、すでに Ports Collection をインストールしてあるのであれば、 `/usr/ports` ディレクトリに移動した後で、 `make search name=` __検索文字__ と実行すると検索が出来ます。 すべてのオプションは http://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.subdir.mk?view=log[bsd.port.subdir.mk] で確認できます。 +しかしならが、もし、すでに Ports Collection をインストールしてあるのであれば、 `/usr/ports` ディレクトリに移動した後で、 `make search name=` __検索文字__ と実行すると検索が出来ます。 または、 https://www.FreshPorts.org[FreshPorts.org] を訪れて、サイトを閲覧したり、ホストされているリストを購読してください。 diff --git a/website/content/ja/ports/updating.adoc b/website/content/ja/ports/updating.adoc index fc47d19a9f..b512255689 100644 --- a/website/content/ja/ports/updating.adoc +++ b/website/content/ja/ports/updating.adoc @@ -13,7 +13,7 @@ include::shared/ja/urls.adoc[] これらのウェブページの ports 一覧は、頻繁にアップデートされています。 (`japanese/` のように) 直感的には独立していると思われるものでも、 多くの ports はツリーの他の部分に依存しているので、 すべてのコレクションを最新に更新することが強く推奨されています。 -port システム全体に影響するような変更は、 http://svnweb.FreeBSD.org/ports/head/CHANGES?view=markup[CHANGES] ファイルに記述されています。 ある特定の ports に影響するような変更は、 http://svnweb.FreeBSD.org/ports/head/UPDATING?view=markup[UPDATING] ファイルに記述されています。 +port システム全体に影響するような変更は、 https://cgit.FreeBSD.org/ports/tree/CHANGES[CHANGES] ファイルに記述されています。 ある特定の ports に影響するような変更は、 https://cgit.FreeBSD.org/ports/tree/UPDATING[UPDATING] ファイルに記述されています。 ports/packages の追加、更新、削除についての情報や、 どのアプリケーションが ports/packages になっているかの検索については、 ページの上にあるフォームを利用してください。または、 https://www.FreshPorts.org[FreshPorts.org] を訪れて、サイトを閲覧したり、 ホストされているリストを購読してください。 From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 18:48: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 A25F463367F for ; Thu, 29 Apr 2021 18:48: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 4FWPfc3xNtz3C4M; Thu, 29 Apr 2021 18:48: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 78D851F318; Thu, 29 Apr 2021 18:48: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 13TImuII081222; Thu, 29 Apr 2021 18:48:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TImu7T081221; Thu, 29 Apr 2021 18:48:56 GMT (envelope-from git) Date: Thu, 29 Apr 2021 18:48:56 GMT Message-Id: <202104291848.13TImu7T081221@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?U3RlZmFuIEXDn2Vy?= Subject: git: b35d0e3d48 - main - content/en: adjust paths to point at cgit.freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: se X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b35d0e3d482143756f11bd26348d564010b9f1e1 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, 29 Apr 2021 18:48:56 -0000 The branch main has been updated by se (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=b35d0e3d482143756f11bd26348d564010b9f1e1 commit b35d0e3d482143756f11bd26348d564010b9f1e1 Author: Stefan Eßer AuthorDate: 2021-04-29 18:13:24 +0000 Commit: Stefan Eßer CommitDate: 2021-04-29 18:32:49 +0000 content/en: adjust paths to point at cgit.freebsd.org An attempt has been made to provide the same kind of information as before, but the layout and information displayed by cgit is different from that of svnweb in some cases. The reference to the commit log of Mk/bsd.port.subdir.mk did no longer lead to a description of the supported parameters of "make search". It has been replaced by an explicit description of all search modes. Reviewed by: wosch Differential Revision: https://reviews.freebsd.org/D29853 --- website/content/en/art.adoc | 4 ++-- website/content/en/copyright/_index.adoc | 2 +- website/content/en/gnome/docs/porting.adoc | 4 ++-- website/content/en/java/_index.adoc | 2 +- website/content/en/platforms/arm.adoc | 2 +- website/content/en/platforms/mips.adoc | 2 +- website/content/en/ports/references.adoc | 2 +- website/content/en/ports/searching.adoc | 2 +- website/content/en/ports/updating.adoc | 2 +- 9 files changed, 11 insertions(+), 11 deletions(-) diff --git a/website/content/en/art.adoc b/website/content/en/art.adoc index 9c4c1620e8..cdbfe371c4 100644 --- a/website/content/en/art.adoc +++ b/website/content/en/art.adoc @@ -22,7 +22,7 @@ image:../gifs/daemon-phk.png[BSD Daemon,width=191,height=208] [.center] Created by {phk-name} + -Source: https://svnweb.freebsd.org/base/head/share/examples/BSD_daemon/[/usr/share/examples/BSD_daemon/] on FreeBSD systems. +Source: https://cgit.freebsd.org/src/tree/share/examples/BSD_daemon/[/usr/share/examples/BSD_daemon/] on FreeBSD systems. [.center] link:../../gifs/daemon_hammer.jpg[image:../../gifs/daemon_hammer-tn25.jpg[BSD Daemon wielding a hammer,width=150,height=178]] image:../../gifs/power.jpg[BSD Daemon waiting tables,width=160,height=246] @@ -62,7 +62,7 @@ image:../gifs/freebsd-advert.gif[Adv Banner1,width=455,height=60] image:../gifs/ The "Powered by FreeBSD" logos above may be link:../gifs/powerlogo.gif[downloaded] and displayed on personal or commercial home pages served by FreeBSD machines. Use of this logo or the likeliness of the link:../copyright/daemon/[BSD Daemons] for profitable gain requires the consent of mailto:taob@risc.org[Brian Tao] (creator of the "power" logo) and mailto:mckusick@mckusick.com[Marshall Kirk McKusick] (copyright holder for the BSD Daemon image). -{phk-name}'s rendering of the BSD Daemon is released under "THE BEER-WARE LICENSE". See the https://svnweb.freebsd.org/base/head/share/examples/BSD_daemon/README?view=markup[README] for more information. +{phk-name}'s rendering of the BSD Daemon is released under "THE BEER-WARE LICENSE". See the https://cgit.freebsd.org/src/plain/share/examples/BSD_daemon/README[README] for more information. [[trademark]] == Trademarks diff --git a/website/content/en/copyright/_index.adoc b/website/content/en/copyright/_index.adoc index 82c154c68a..4d2111b28d 100644 --- a/website/content/en/copyright/_index.adoc +++ b/website/content/en/copyright/_index.adoc @@ -15,7 +15,7 @@ sidenav: about == link:daemon[The BSD Daemon] -== http://svnweb.FreeBSD.org/ports/head/LEGAL?revision=HEAD&view=co[FreeBSD Ports redistribution restrictions] +== https://cgit.FreeBSD.org/ports/plain/LEGAL[FreeBSD Ports redistribution restrictions] == link:COPYING[GNU GENERAL PUBLIC LICENSE] diff --git a/website/content/en/gnome/docs/porting.adoc b/website/content/en/gnome/docs/porting.adoc index 22977520c9..fb3b88c879 100644 --- a/website/content/en/gnome/docs/porting.adoc +++ b/website/content/en/gnome/docs/porting.adoc @@ -152,7 +152,7 @@ If your port install files like `application/x-portname.xml` in `share/mime`, yo Also make sure `shared-mime-info` is among the dependencies of your port. If your port use `gtk20`, you will have `shared-mime-info` indirectly. You can check indirect dependencies with `make describe`. -Example port to look at: https://svnweb.FreeBSD.org/ports/head/deskutils/drivel/[`deskutils/drivel`] +Example port to look at: https://cgit.FreeBSD.org/ports/tree/emulators/tilem/[`emulators/tilem`] == Desktop database @@ -169,7 +169,7 @@ Also add following to the `post-install` target in port's Makefile: -@update-desktop-database .... -Example port to look at: https://svnweb.FreeBSD.org/ports/head/editors/leafpad/[`editors/leafpad`] +Example port to look at: https://cgit.FreeBSD.org/ports/tree/editors/leafpad/[`editors/leafpad`] [[libtool]] == Libtool Issues diff --git a/website/content/en/java/_index.adoc b/website/content/en/java/_index.adoc index 71e77949db..8d528b6ae9 100644 --- a/website/content/en/java/_index.adoc +++ b/website/content/en/java/_index.adoc @@ -32,7 +32,7 @@ The OpenJDK(R) project provides a native open-source implementation of the Java( *powerpc64*: `openjdk8`, `openjdk11`, `openjdk12`, `openjdk13` -OpenJDK(R) is frequently updated, and it is suggested to refer to https://svnweb.freebsd.org/ports/head/java/[revision logs] for detailed release history. Additionally, one may choose to review more information at https://www.freshports.org/search.php?query=openjdk&search=go&num=10&stype=name&method=match&deleted=excludedeleted&start=1&casesensitivity=caseinsensitive[FreshPorts]. +OpenJDK(R) is frequently updated, and it is suggested to refer to https://cgit.freebsd.org/ports/log/java/[revision logs] for detailed release history. Additionally, one may choose to review more information at https://www.freshports.org/search.php?query=openjdk&search=go&num=10&stype=name&method=match&deleted=excludedeleted&start=1&casesensitivity=caseinsensitive[FreshPorts]. To install OpenJDK(R) package use the link:https://www.freebsd.org/cgi/man.cgi?query=pkg[`pkg`] utility or the ports system: diff --git a/website/content/en/platforms/arm.adoc b/website/content/en/platforms/arm.adoc index f990539a45..6531aa353e 100644 --- a/website/content/en/platforms/arm.adoc +++ b/website/content/en/platforms/arm.adoc @@ -33,7 +33,7 @@ Initial support for 64-bit ARM is complete. 64-bit ARM platforms follow a set of FreeBSD/arm and FreeBSD/armv6 support a large range of ARM CPUs and development boards. Not every peripheral is supported on every CPU or board, though work continues towards this and contributions are always welcome. Conversely, many CPUs and boards not listed may work with only minimal changes needed. -Listing all supported devices on all CPUs and boards is impractical here, however much information can be obtained from the mailing list and archives, https://wiki.freebsd.org/FreeBSD/arm[the FreeBSD/arm Wiki pages], and also from the https://svnweb.freebsd.org/base/head/sys/arm/conf/[Kernel Configuration files] +Listing all supported devices on all CPUs and boards is impractical here, however much information can be obtained from the mailing list and archives, https://wiki.freebsd.org/FreeBSD/arm[the FreeBSD/arm Wiki pages], and also from the https://cgit.freebsd.org/src/tree/sys/arm/conf/[Kernel Configuration files] === Cores Supported diff --git a/website/content/en/platforms/mips.adoc b/website/content/en/platforms/mips.adoc index ab29b40770..e70abddd0c 100644 --- a/website/content/en/platforms/mips.adoc +++ b/website/content/en/platforms/mips.adoc @@ -27,7 +27,7 @@ MIPS is a link:{committers-guide}#archs[Tier 2] architecture, and as such is not FreeBSD/MIPS is a port of the FreeBSD operating system to platforms based around MIPS processors. At the moment, several MIPS32 and MIPS64 development boards and embedded platforms are being targeted. -Listing all supported devices on all CPUs and boards is impractical here, however much information can be obtained from the mailing list and archives, https://wiki.freebsd.org/FreeBSD/MIPS[the FreeBSD/MIPS Wiki pages], and also from the https://svnweb.freebsd.org/base/head/sys/mips/conf/[Kernel Configuration files] +Listing all supported devices on all CPUs and boards is impractical here, however much information can be obtained from the mailing list and archives, https://wiki.freebsd.org/FreeBSD/MIPS[the FreeBSD/MIPS Wiki pages], and also from the https://cgit.freebsd.org/src/tree/sys/mips/conf/[Kernel Configuration files] === CPUs diff --git a/website/content/en/ports/references.adoc b/website/content/en/ports/references.adoc index 7b8725e310..d5417016cd 100644 --- a/website/content/en/ports/references.adoc +++ b/website/content/en/ports/references.adoc @@ -22,4 +22,4 @@ You may also find the following to be useful: * https://www.FreshPorts.org[FreshPorts.org] is a valuable tool for further information about individual ports, such as current version, last checkin, and many other useful statistics. You may subscribe to a mailing list to get the latest information about your favorite ports. * The manual pages for link:https://www.FreeBSD.org/cgi/man.cgi?query=ftp[`ftp`], link:https://www.FreeBSD.org/cgi/man.cgi?query=pkg&sektion=8[`pkg`], and link:https://www.FreeBSD.org/cgi/man.cgi?query=ports[`ports`]. * The link:../../portmgr/[Ports Management Team] (portmgr) pages. -* The https://svnweb.FreeBSD.org/ports[Web Interface to the Source Repository] allows you to browse the files in the source repository. Changes that affect the entire port system are now documented in the https://svnweb.FreeBSD.org/ports/head/CHANGES?view=markup[CHANGES] file. Changes that affect individual ports are now documented in the https://svnweb.FreeBSD.org/ports/head/UPDATING?view=markup[UPDATING] file. However, the definitive answer to any question is undoubtedly to read the source code of https://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.mk?view=markup[bsd.port.mk], and associated files. +* The https://cgit.FreeBSD.org/ports/tree[Web Interface to the Source Repository] allows you to browse the files in the source repository. Changes that affect the entire port system are now documented in the https://cgit.FreeBSD.org/ports/tree/CHANGES[CHANGES] file. Changes that affect individual ports are now documented in the https://cgit.FreeBSD.org/ports/tree/UPDATING[UPDATING] file. However, the definitive answer to any question is undoubtedly to read the source code of https://cgit.FreeBSD.org/ports/tree/Mk/bsd.port.mk[bsd.port.mk], and associated files. diff --git a/website/content/en/ports/searching.adoc b/website/content/en/ports/searching.adoc index 5fc81596d3..1eb385770e 100644 --- a/website/content/en/ports/searching.adoc +++ b/website/content/en/ports/searching.adoc @@ -11,6 +11,6 @@ sidenav: ports The form above will allow you to search for ports on this site. A completed search will take you to a link:https://www.FreeBSD.org/cgi/ports.cgi[more complete search page]. -However, if you already have the Ports Collection installed on your machine, you may also search by changing to the `/usr/ports` directory and performing `make search name=`__string__. See http://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.subdir.mk?view=log[bsd.port.subdir.mk] for all the options. +However, if you already have the Ports Collection installed on your machine, you may also search by changing to the `/usr/ports` directory and performing `make search name=`__string__. Instead of by `name` you can search by port path (`path`), port information (`info`), maintainer (`maint`), port category (`cat`), build dependencies (`bdeps`), run dependencies (`rdeps`), the project web site (`www`), or any of these fields (`key`). Use `make quicksearch ...` to only display the port name, port directory, and one line description of the port. Another option is to visit https://www.FreshPorts.org[FreshPorts.org] and either browse the site or subscribe to the lists hosted there. diff --git a/website/content/en/ports/updating.adoc b/website/content/en/ports/updating.adoc index 4c6bad0010..be8e8dabb4 100644 --- a/website/content/en/ports/updating.adoc +++ b/website/content/en/ports/updating.adoc @@ -13,7 +13,7 @@ include::shared/en/urls.adoc[] The ports listed on these web pages are continually being updated. It is strongly recommended that you refresh the entire collection together, as many ports depend on other parts of the tree, even where that might seem counterintuitive (e.g. `japanese/`.) -Changes that affect the entire port system are now documented in the http://svnweb.FreeBSD.org/ports/head/CHANGES?view=markup[CHANGES] file. Changes that affect individual ports are now documented in the http://svnweb.FreeBSD.org/ports/head/UPDATING?view=markup[UPDATING] file. +Changes that affect the entire port system are now documented in the https://cgit.FreeBSD.org/ports/tree/CHANGES[CHANGES] file. Changes that affect individual ports are now documented in the https://cgit.FreeBSD.org/ports/tree/UPDATING[UPDATING] file. For more information about new, changed or removed ports/packages, or if you wish to search for a specific application to see if it's available as a port/package, you may use the form above; alternatively, you may wish to visit https://www.FreshPorts.org[FreshPorts.org] and either browse the site or subscribe to the lists hosted there. From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 18:49: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 009566333DF for ; Thu, 29 Apr 2021 18:49: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 4FWPfg6YR8z3C4Z; Thu, 29 Apr 2021 18:48: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 D38801EF63; Thu, 29 Apr 2021 18:48: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 13TImxtl081299; Thu, 29 Apr 2021 18:48:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TImx5g081298; Thu, 29 Apr 2021 18:48:59 GMT (envelope-from git) Date: Thu, 29 Apr 2021 18:48:59 GMT Message-Id: <202104291848.13TImx5g081298@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?U3RlZmFuIEXDn2Vy?= Subject: git: 05c69919b5 - main - content/de: adjust paths to point at cgit.freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: se X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 05c69919b5f33fe525e60066e789fc28f2d3b382 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, 29 Apr 2021 18:49:00 -0000 The branch main has been updated by se (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=05c69919b5f33fe525e60066e789fc28f2d3b382 commit 05c69919b5f33fe525e60066e789fc28f2d3b382 Author: Stefan Eßer AuthorDate: 2021-04-29 18:41:31 +0000 Commit: Stefan Eßer CommitDate: 2021-04-29 18:41:31 +0000 content/de: adjust paths to point at cgit.freebsd.org An attempt has been made to provide the same kind of information as before, but the layout and information displayed by cgit is different from that of svnweb in some cases. The reference to the commit log of Mk/bsd.port.subdir.mk did no longer lead to a description of the supported parameters of "make search". It has been replaced by an explicit description of all search modes. Reviewed by: wosch Differential Revision: https://reviews.freebsd.org/D29856 --- website/content/de/art.adoc | 4 ++-- website/content/de/developers/cvs.adoc | 8 ++++---- website/content/de/java/_index.adoc | 2 +- website/content/de/platforms/arm.adoc | 2 +- website/content/de/platforms/mips.adoc | 2 +- website/content/de/ports/references.adoc | 2 +- website/content/de/ports/searching.adoc | 2 +- website/content/de/ports/updating.adoc | 2 +- 8 files changed, 12 insertions(+), 12 deletions(-) diff --git a/website/content/de/art.adoc b/website/content/de/art.adoc index a8d71ddd8d..05dfcac5dc 100644 --- a/website/content/de/art.adoc +++ b/website/content/de/art.adoc @@ -22,7 +22,7 @@ image:../../gifs/daemon-phk.png[Der BSD Daemon,width=191,height=208] [.center] Erstellt von {phk-name} + -Quellen: https://svnweb.freebsd.org/base/head/share/examples/BSD_daemon/[/usr/share/examples/BSD_daemon/] im FreeBSD-System. +Quellen: https://cgit.freebsd.org/src/tree/share/examples/BSD_daemon/[/usr/share/examples/BSD_daemon/] im FreeBSD-System. [.center] link:../../gifs/daemon_hammer.jpg[image:../../gifs/daemon_hammer-tn25.jpg[BSD Daemon schwingt einen Hammer,width=150,height=178]] image:../../gifs/power.jpg[BSD Daemon beim Servieren,width=160,height=246] @@ -64,7 +64,7 @@ image:../../gifs/freebsd_3.gif[Werbe Banner2,width=306,height=94] Die "`Powered by FreeBSD`"-Logos weiter oben dürfen link:../../gifs/powerlogo.gif[heruntergeladen] und auf privaten wie auch kommerziellen Webseiten angezeigt werden, die auf FreeBSD-Systemen laufen. Der Einsatz des Logos oder Abwandlungen des BSD-Daemons bedarf bei einer kommerziellen Gewinnerzielung der Bewilligung von mailto:taob@risc.org[Brian Tao] (Autor des "`Power`"-Logos) und mailto:mckusick@mckusick.com[Marshall Kirk McKusick] (Inhaber des Warenzeichens des BSD-Daemon-Bildes). -Das Rendering des BSD-Daemons von {phk-name} wurde unter der "`THE BEER-WARE LICENSE`" veröffentlicht. Informationen zu dieser Lizenz finden sich in der https://svnweb.freebsd.org/base/head/share/examples/BSD_daemon/README?view=markup[README]-Datei. +Das Rendering des BSD-Daemons von {phk-name} wurde unter der "`THE BEER-WARE LICENSE`" veröffentlicht. Informationen zu dieser Lizenz finden sich in der https://cgit.freebsd.org/src/plain/share/examples/BSD_daemon/README[README]-Datei. [[trademark]] == Warenzeichen diff --git a/website/content/de/developers/cvs.adoc b/website/content/de/developers/cvs.adoc index bed1586226..108faf781f 100644 --- a/website/content/de/developers/cvs.adoc +++ b/website/content/de/developers/cvs.adoc @@ -7,10 +7,10 @@ sidenav: developers == Subversion -Das FreeBSD Project verwendet http://subversion.tigris.org/[Subversion] (abgekürzt SVN), um den Quellcode zu verwalten. Jede Änderung wird (inklusive einem Logeintrag, der die Änderung beschreibt), in einem Repository gespeichert. Der Inhalt des Repositories kann über ein Webinterface betrachtet werden. +Das FreeBSD Project verwendet https://github.com/git/git[Git], um den Quellcode zu verwalten. Jede Änderung wird (inklusive einem Logeintrag, der die Änderung beschreibt), in einem Repository gespeichert. Der Inhalt des Repositories kann über ein Webinterface betrachtet werden. -Im Juni 2008 wurde der Quellcode für die Entwicklung des Basissystem vom bis dahin verwendeten CVS nach Subversion migriert. Über ein http://svnweb.FreeBSD.org/base/[Webinterface] ist es möglich, das Repostitory zu durchstöbern. +Im Juni 2008 wurde der Quellcode für die Entwicklung des Basissystem vom bis dahin verwendeten CVS nach Subversion migriert, das im Dezember 2020 wiederum nach GIT mirgiert worden ist. Über ein https://cgit.FreeBSD.org/src/tree[Webinterface] ist es möglich, das Repostitory zu durchstöbern. -Im Mai 2012 hat das FreeBSD Documentation Project seinen Quellcode von CVS nach Subversion migriert. Auch dieses Repository ist über ein http://svnweb.FreeBSD.org/doc/[Webinterface] erreichbar. +Im Mai 2012 hat das FreeBSD Documentation Project seinen Quellcode von CVS nach Subversion migriert, im Dezember 2020 dann noch einmal nach GIT. Auch dieses Repository ist über ein https://cgit.FreeBSD.org/doc/tree[Webinterface] erreichbar. -Im Juli 2012 wurde der FreeBSD Portsbaum von CVS nach SVN migriert, das ebenfalls über ein https://svnweb.FreeBSD.org/ports/[Webinterface] durchstöbert werden kann. +Im Juli 2012 wurde der FreeBSD Portsbaum von CVS nach SVN migriert, im April 2021 nach GIT, das ebenfalls über ein https://cgit.FreeBSD.org/ports/tree[Webinterface] durchstöbert werden kann. diff --git a/website/content/de/java/_index.adoc b/website/content/de/java/_index.adoc index d866800a54..d831900b2e 100644 --- a/website/content/de/java/_index.adoc +++ b/website/content/de/java/_index.adoc @@ -32,7 +32,7 @@ Das OpenJDK(R) Project bietet ihnen eine native Open Source-Implementierung der *powerpc64*: `openjdk8`, `openjdk11`, `openjdk12`, `openjdk13` -OpenJDK(R) wird regelmäßig aktualisiert. Lesen sie bitte das https://svnweb.freebsd.org/ports/head/java/[Revisionlog], um sich über Änderungen zu informieren. Weitere Informationen sind auf https://www.freshports.org/search.php?query=openjdk&search=go&num=10&stype=name&method=match&deleted=excludedeleted&start=1&casesensitivity=caseinsensitive[FreshPorts] verfügbar. +OpenJDK(R) wird regelmäßig aktualisiert. Lesen sie bitte das https://cgit.freebsd.org/ports/log/java/[Revisionlog], um sich über Änderungen zu informieren. Weitere Informationen sind auf https://www.freshports.org/search.php?query=openjdk&search=go&num=10&stype=name&method=match&deleted=excludedeleted&start=1&casesensitivity=caseinsensitive[FreshPorts] verfügbar. OpenJDK(R) kann über link:&enbase;/cgi/man.cgi?query=pkg[`pkg`] oder die Ports-Sammlung installiert werden: diff --git a/website/content/de/platforms/arm.adoc b/website/content/de/platforms/arm.adoc index 173bdb91ab..ef3211ae63 100644 --- a/website/content/de/platforms/arm.adoc +++ b/website/content/de/platforms/arm.adoc @@ -32,7 +32,7 @@ Bei FreeBSD/ARM handelt es sich um eine Portierung von FreeBSD auf die 32- und 6 FreeBSD/arm und FreeBSD/armv6 unterstützen eine große Anzahl von ARM-CPUs und Entwicklerboards. Nicht jedes Peripheriegerät wird mit jeder CPU oder jedem Board funktionieren, es wird aber ständig daran gearbeitet, weitere Geräte zu unterstützen. Ihr Beitrag ist hier jederzeit willkommen. Viele CPUs und Boards, die nicht aufgelistet sind, können vielleicht mit geringem Aufwand unterstützt werden. -Aus praktischen Gründen werden hier nicht alle unterstützten CPUs und Boards aufgelistet. Wenn Sie weitere Informationen benötigen, lesen Sie bitte die https://wiki.freebsd.org/FreeBSD/arm[FreeBSD/arm Wiki-Seiten] und sehen Sie sich die https://svnweb.freebsd.org/base/head/sys/arm/conf/[Kernel Konfigurationdateien] an. +Aus praktischen Gründen werden hier nicht alle unterstützten CPUs und Boards aufgelistet. Wenn Sie weitere Informationen benötigen, lesen Sie bitte die https://wiki.freebsd.org/FreeBSD/arm[FreeBSD/arm Wiki-Seiten] und sehen Sie sich die https://cgit.freebsd.org/src/tree/sys/arm/conf/[Kernel Konfigurationdateien] an. === Unterstützte Cores diff --git a/website/content/de/platforms/mips.adoc b/website/content/de/platforms/mips.adoc index 002a50fcf1..626ccc6fc0 100644 --- a/website/content/de/platforms/mips.adoc +++ b/website/content/de/platforms/mips.adoc @@ -27,7 +27,7 @@ FreeBSD/MIPS ist eine link:{committers-guide}#archs[Tier 2]-Architektur und wird Bei FreeBSD/MIPS handelt es sich um eine Portierung von FreeBSD auf Plattformen, dieauf MIPS-Prozessoren basieren. Derzeit wird an der Unterstützung verschiedener MIPS32- und MIPS64-Entwicklerboards gearbeitet. -Aus praktischen Gründen werden hier nicht alle unterstützten CPUs und Boards aufgelistet. Wenn Sie weitere Informationen benötigen, lesen Sie bitte die https://wiki.freebsd.org/FreeBSD/MIPS[FreeBSD/MIPS Wiki-Seiten] und sehen Sie sich die https://svnweb.freebsd.org/base/head/sys/mips/conf/[Kernel Konfigurationdateien] an. +Aus praktischen Gründen werden hier nicht alle unterstützten CPUs und Boards aufgelistet. Wenn Sie weitere Informationen benötigen, lesen Sie bitte die https://wiki.freebsd.org/FreeBSD/MIPS[FreeBSD/MIPS Wiki-Seiten] und sehen Sie sich die https://cgit.freebsd.org/src/tree/sys/mips/conf/[Kernel Konfigurationdateien] an. === CPUs diff --git a/website/content/de/ports/references.adoc b/website/content/de/ports/references.adoc index 2a5c9040b1..26bc30acf2 100644 --- a/website/content/de/ports/references.adoc +++ b/website/content/de/ports/references.adoc @@ -22,4 +22,4 @@ Folgende Ressourcen sollten ebenfalls hilfreich sein: * https://www.FreshPorts.org[FreshPorts.org] ist eine wertvolle Quelle für weitere Informationen zu einzelnen Ports wie der aktuellen Version, der letzten Änderung sowie vielen weiteren Statistiken. Sie können dort auch eine Mailingliste abonnieren, um sich über Änderungen Ihrer Lieblings-Ports zu informieren. * Die Manualpages für https://www.FreeBSD.org/cgi/man.cgi?query=ftp[`+ftp+`], https://www.FreeBSD.org/cgi/man.cgi?query=pkg&sektion=8[`+pkg+`] und https://www.FreeBSD.org/cgi/man.cgi?query=ports[`+ports+`]. * Die Seiten des https://www.FreeBSD.org/portmgr/[Ports Management Teams] (portmgr). -* Die Internet-Schnittstelle des https://svnweb.FreeBSD.org/ports[Subversion Repository] erlaubt es Ihnen, einzelne Dateien des Quellcode-Repository anzusehen. Änderungen, die die komplette Ports-Sammlung betreffen, werden in der Datei https://svnweb.FreeBSD.org/ports/head/CHANGES?view=markup[CHANGES] dokumentiert. Änderungen, die lediglich einzelne Ports betreffen, werden hingegen in der Datei https://svnweb.FreeBSD.org/ports/head/UPDATING?view=markup[UPDATING] dokumentiert. Vergessen Sie aber nicht, den Quellcode der Datei https://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.mk?view=markup[bsd.port.mk] sowie der damit in Verbindung stehenden Dateien zu lesen. +* Die Internet-Schnittstelle des https://cgit.FreeBSD.org/ports/tree[Subversion Repository] erlaubt es Ihnen, einzelne Dateien des Quellcode-Repository anzusehen. Änderungen, die die komplette Ports-Sammlung betreffen, werden in der Datei https://cgit.FreeBSD.org/ports/tree/CHANGES[CHANGES] dokumentiert. Änderungen, die lediglich einzelne Ports betreffen, werden hingegen in der Datei https://cgit.FreeBSD.org/ports/tree/UPDATING[UPDATING] dokumentiert. Vergessen Sie aber nicht, den Quellcode der Datei https://cgit.FreeBSD.org/ports/tree/Mk/bsd.port.mk[bsd.port.mk] sowie der damit in Verbindung stehenden Dateien zu lesen. diff --git a/website/content/de/ports/searching.adoc b/website/content/de/ports/searching.adoc index 869bf2b151..1a911a7e00 100644 --- a/website/content/de/ports/searching.adoc +++ b/website/content/de/ports/searching.adoc @@ -11,6 +11,6 @@ sidenav: ports Das Formular auf dieser Seite erlaubt es Ihnen, nach bestimmten Ports zu suchen. Wenn Sie eine Suche starten, werden Sie auf eine https://www.FreeBSD.org/cgi/ports.cgi[erweiterte Version der Suchfunktion] umgeleitet. -Haben Sie die Ports-Sammlung bereits installiert, können Sie die Suche auch lokal im Verzeichnis `/usr/ports` durchführen. Dazu geben Sie einfach `make search name=` __Suchbegriff__ ein. Die Datei http://svnweb.FreeBSD.org/ports/head/Mk/bsd.port.subdir.mk?view=log[bsd.port.subdir.mk] beschreibt alle möglichen Suchoptionen. +Haben Sie die Ports-Sammlung bereits installiert, können Sie die Suche auch lokal im Verzeichnis `/usr/ports` oder einem Unterverzeichnis davon durchführen. Dazu geben Sie einfach `make search name=` __Suchbegriff__ ein. Statt nach `name` können Sie auch nach `port` (Portname), `path` (Pfad im Ports-System), ìnfo` (einzeilige Beschreibung), `cat` (Kategorie), `maint`(Maintainer), `bdeps` (Abhängigkeiten beim Bauen), `rdeps` (Abhängigkeiten zur Laufzeit) oder `www` (Web-Site) suchen. Mit `make quicksearch ...` wird die Ausgabe auf Port, Pfad und einzeilige Beschreibung beschränkt. Alternativ können Sie auch die Seite https://www.FreshPorts.org[FreshPorts.org] besuchen oder die von den Betreibern angebotenen Mailinglisten abonnieren. diff --git a/website/content/de/ports/updating.adoc b/website/content/de/ports/updating.adoc index 1e7355444a..05d53e7814 100644 --- a/website/content/de/ports/updating.adoc +++ b/website/content/de/ports/updating.adoc @@ -13,7 +13,7 @@ include::shared/de/urls.adoc[] Die auf diesen Seiten aufgelisteten Ports werden ständig aktualisiert. Es daher sehr wichtig, dass Sie Ihre Ports-Sammlung regelmäßig aktualisieren, da viele Ports von anderen Ports abhängen, selbst wenn dies nicht offensichtlich ist (beispielsweise bei Ports der Kategorie `japanese`). -Änderungen, die die komplette Ports-Sammlung betreffen, werden in der Datei https://svnweb.FreeBSD.org/ports/head/CHANGES?view=markup[CHANGES] dokumentiert. Änderungen, die lediglich einzelne Ports betreffen, werden hingegen in der Datei https://svnweb.FreeBSD.org/ports/head/UPDATING?view=markup[UPDATING] dokumentiert. +Änderungen, die die komplette Ports-Sammlung betreffen, werden in der Datei https://cgit.FreeBSD.org/ports/tree/CHANGES[CHANGES] dokumentiert. Änderungen, die lediglich einzelne Ports betreffen, werden hingegen in der Datei https://cgit.FreeBSD.org/ports/tree/UPDATING[UPDATING] dokumentiert. Für weitere Informationen zu neuen, geänderten oder entfernten Ports oder Paketen können Sie das Formular auf dieser Seite verwenden. Alternativ können Sie auch die Seite https://www.FreshPorts.org[FreshPorts.org] besuchen oder die von den Betreibern der Seite angebotenen Mailinglisten abonnieren. From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 18:49:01 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 32CC7633A08 for ; Thu, 29 Apr 2021 18:49:01 +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 4FWPfj0tclz3C4k; Thu, 29 Apr 2021 18:49:01 +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 0F74A1F29B; Thu, 29 Apr 2021 18:49:01 +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 13TIn0T3081329; Thu, 29 Apr 2021 18:49:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TIn08b081328; Thu, 29 Apr 2021 18:49:00 GMT (envelope-from git) Date: Thu, 29 Apr 2021 18:49:00 GMT Message-Id: <202104291849.13TIn08b081328@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?B?U3RlZmFuIEXDn2Vy?= Subject: git: 9a0fb30847 - main - themes/beastie/static/js: add cgit.freebsd.org to RE MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: se X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9a0fb308473f4272035f7b441d23652adf8ef753 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, 29 Apr 2021 18:49:01 -0000 The branch main has been updated by se (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=9a0fb308473f4272035f7b441d23652adf8ef753 commit 9a0fb308473f4272035f7b441d23652adf8ef753 Author: Stefan Eßer AuthorDate: 2021-04-29 18:43:13 +0000 Commit: Stefan Eßer CommitDate: 2021-04-29 18:43:13 +0000 themes/beastie/static/js: add cgit.freebsd.org to RE The regular expression that matches the official FreeBSD hosts has been extended to cover cgit.freebsd.org. The match for svnweb.freebsd.org has not been removed at this time. Approved by: wosch Differential Revision: https://reviews.freebsd.org/D29857 --- website/content/en/layout/js/google.js | 2 +- website/themes/beastie/static/js/google.js | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/website/content/en/layout/js/google.js b/website/content/en/layout/js/google.js index d6aac94338..34bfefcc94 100644 --- a/website/content/en/layout/js/google.js +++ b/website/content/en/layout/js/google.js @@ -16,7 +16,7 @@ var h = document.location.hostname; * Check that the hosting domain is actually a FreeBSD.org domain, so * we don't accidentally obtain data from mirrors. */ -var fbsdregex = /((docs|security|svnweb|wiki|www)\.freebsd\.org|google\.com)$/i; +var fbsdregex = /((docs|security|svnweb|cgit|wiki|www)\.freebsd\.org|google\.com)$/i; if (typeof navigator.doNotTrack !== "undefined" && (navigator.doNotTrack == "yes" || navigator.doNotTrack == "1")) { allow_track = false; diff --git a/website/themes/beastie/static/js/google.js b/website/themes/beastie/static/js/google.js index d6aac94338..34bfefcc94 100644 --- a/website/themes/beastie/static/js/google.js +++ b/website/themes/beastie/static/js/google.js @@ -16,7 +16,7 @@ var h = document.location.hostname; * Check that the hosting domain is actually a FreeBSD.org domain, so * we don't accidentally obtain data from mirrors. */ -var fbsdregex = /((docs|security|svnweb|wiki|www)\.freebsd\.org|google\.com)$/i; +var fbsdregex = /((docs|security|svnweb|cgit|wiki|www)\.freebsd\.org|google\.com)$/i; if (typeof navigator.doNotTrack !== "undefined" && (navigator.doNotTrack == "yes" || navigator.doNotTrack == "1")) { allow_track = false; From owner-dev-commits-doc-all@freebsd.org Thu Apr 29 19:06:57 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 5A2C6633C54 for ; Thu, 29 Apr 2021 19:06:57 +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 4FWQ3P2785z3CZB; Thu, 29 Apr 2021 19:06:57 +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 3B7AD1F450; Thu, 29 Apr 2021 19:06:57 +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 13TJ6vH9008520; Thu, 29 Apr 2021 19:06:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13TJ6v2h008519; Thu, 29 Apr 2021 19:06:57 GMT (envelope-from git) Date: Thu, 29 Apr 2021 19:06:57 GMT Message-Id: <202104291906.13TJ6v2h008519@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Rene Ladan Subject: git: 646b610c49 - main - Mention Git instead of Subversion on the internal web pages. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: rene X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 646b610c49db90a36b71b6a37f9c11b1783079b6 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, 29 Apr 2021 19:06:57 -0000 The branch main has been updated by rene: URL: https://cgit.FreeBSD.org/doc/commit/?id=646b610c49db90a36b71b6a37f9c11b1783079b6 commit 646b610c49db90a36b71b6a37f9c11b1783079b6 Author: Rene Ladan AuthorDate: 2021-04-29 18:57:24 +0000 Commit: Rene Ladan CommitDate: 2021-04-29 19:06:44 +0000 Mention Git instead of Subversion on the internal web pages. --- website/content/en/internal/about.adoc | 2 +- website/content/en/internal/developer.adoc | 4 ++-- website/content/en/internal/doceng.adoc | 2 +- website/content/en/internal/new-account.adoc | 6 +++--- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/website/content/en/internal/about.adoc b/website/content/en/internal/about.adoc index 79b96eac19..3bab403728 100644 --- a/website/content/en/internal/about.adoc +++ b/website/content/en/internal/about.adoc @@ -37,7 +37,7 @@ The original page design was done by Megan McCormack. == link:{fdp-primer}#the-website-build[Building and updating the FreeBSD Web Pages] -This document describes how to build and update the FreeBSD Web pages from the Subversion repository by hand. +This document describes how to build and update the FreeBSD Web pages from the Git repository by hand. == Update of the FreeBSD Web Pages diff --git a/website/content/en/internal/developer.adoc b/website/content/en/internal/developer.adoc index 421d73c7b2..43cc11fe27 100644 --- a/website/content/en/internal/developer.adoc +++ b/website/content/en/internal/developer.adoc @@ -9,7 +9,7 @@ include::shared/en/urls.adoc[] == link:{committers-guide}[Committers Guide] -This document is an overall guide for all new committers, including both technical details and policy details. For the former, see the chapters on link:{committers-guide}#subversion-primer[the Subversion VCS], the link:{committers-guide}#bugzilla[Bugzilla] bug tracking system, and the link:{committers-guide}#ssh.guide[SSH Quick-Start Guide]. +This document is an overall guide for all new committers, including both technical details and policy details. For the former, see the chapters on link:{committers-guide}#git-primer[the Git VCS], the link:{committers-guide}#bugzilla[Bugzilla] bug tracking system, and the link:{committers-guide}#ssh.guide[SSH Quick-Start Guide]. It contains almost everything a new committer to the FreeBSD Project needs to know. See the Documentation Project Primer and the Ports Guide, below, for more info. @@ -23,7 +23,7 @@ A guide for FreeBSD ports committers. This includes the canonical link:{porters- == link:{fdp-primer}#the-website-build[How to build the FreeBSD Web Pages]. -This document describes how to build and update the FreeBSD Web pages from the SVN repository by hand. +This document describes how to build and update the FreeBSD Web pages from the Git repository by hand. == FreeBSD Projects diff --git a/website/content/en/internal/doceng.adoc b/website/content/en/internal/doceng.adoc index 1c393df1aa..d5ab9a97aa 100644 --- a/website/content/en/internal/doceng.adoc +++ b/website/content/en/internal/doceng.adoc @@ -12,7 +12,7 @@ The doceng@ team is a body to handle some of the meta-project issues associated * To grant approval for new documentation committers. Documentation includes articles and books, website pages, manual pages, release notes and translations of the above. There are two kinds of doc commit bits: translator commit bit, which is limited to translations in a particular language and full commit bit, which is only granted to aspirants, who have shown enough English writing skills. * To maintain the doc project primer, which documents best practices for the FreeBSD Documentation Project. * To manage the doc/ release process. This includes coordinating the release documentation updates with the various translation teams, coordinating with the release engineering team to tag the doc/ tree during the release cycle, and documenting these procedures. -* To ensure that the generated documentation (PDF, HTML, etc.) on the Web site and FTP site are up to date with respect to the versions of the documents in the SVN tree. This includes making sure the Web site build is functioning correctly, and also involves working with the admin team to ensure that the primary Web server has all of the requisite software installed (including build scripts). +* To ensure that the generated documentation (PDF, HTML, etc.) on the Web site and FTP site are up to date with respect to the versions of the documents in the Git tree. This includes making sure the Web site build is functioning correctly, and also involves working with the admin team to ensure that the primary Web server has all of the requisite software installed (including build scripts). * To act as MAINTAINER (when necessary) or to work in coordination with existing MAINTAINERs, to ensure that the documentation toolchains (DocBook, groff, etc.) are in good working order. * To maintain the sanctity of the FreeBSD doc/ tree. Due to the visibility of these files and documents to the outside world, doceng@ reserves the right to immediately backout (or fix without waiting for response from the original committer) changes that introduce broken links, cause the Web site build to break, or otherwise degrade the accessibility of the FreeBSD Web site and documentation. * To appoint and oversee a FreeBSD Webmaster Team that carries out daily maintenance of the Project web servers in collaboration with other teams. diff --git a/website/content/en/internal/new-account.adoc b/website/content/en/internal/new-account.adoc index 76d1f06ae5..530db544c1 100644 --- a/website/content/en/internal/new-account.adoc +++ b/website/content/en/internal/new-account.adoc @@ -55,7 +55,7 @@ accounts@ creates the new account with the above information on the FreeBSD.org == Mentor Activates New Committer's Commit Bit -After the new committer confirms that the account works, the mentor adds the new committer to the correct `access` file, using an appropriate commit message. The commit message should at least contain the committer's full name and username, the mentor's name and what area the new committer will start to work in. An entry should also be added to the `mentors` file in the respective Subversion repository to indicate the mentor relationship. Having done all that, the new committer and mentor jointly go through the first commit operations. +After the new committer confirms that the account works, the mentor adds the new committer to the correct `access` file, using an appropriate commit message. The commit message should at least contain the committer's full name and username, the mentor's name and what area the new committer will start to work in. An entry should also be added to the `mentors` file in the respective Git repository to indicate the mentor relationship. Having done all that, the new committer and mentor jointly go through the first commit operations. == Additional Services @@ -65,8 +65,8 @@ Reading the link:{committers-guide}[Committer's Guide] is considered a good firs == End Of Mentorship -There is no pre-set duration for a mentorship. Once the mentor feels the mentee is ready to 'fly solo' the mentor notifies the developer community by removing the entry from the `mentors` file in SVN. +There is no pre-set duration for a mentorship. Once the mentor feels the mentee is ready to 'fly solo' the mentor notifies the developer community by removing the entry from the `mentors` file in Git. == Transfer Of Mentorship -Should a need arise to transfer mentorship for a committer please email the responsible party, as described for a new account proposal. Typically this request is rubberstamped as-is. In Subversion, the `mentors` file should be updated. +Should a need arise to transfer mentorship for a committer please email the responsible party, as described for a new account proposal. Typically this request is rubberstamped as-is. In Git, the `mentors` file should be updated. From owner-dev-commits-doc-all@freebsd.org Fri Apr 30 06:57: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 CE3A85F1BA7 for ; Fri, 30 Apr 2021 06:57: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 4FWjq25WJHz3vwS; Fri, 30 Apr 2021 06:57: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 AFF0027AE4; Fri, 30 Apr 2021 06:57: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 13U6vItv041630; Fri, 30 Apr 2021 06:57:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13U6vI6G041629; Fri, 30 Apr 2021 06:57:18 GMT (envelope-from git) Date: Fri, 30 Apr 2021 06:57:18 GMT Message-Id: <202104300657.13U6vI6G041629@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Kirill Ponomarev Subject: git: 0d283be61e - main - Update my key. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: krion X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0d283be61e5eaa0ddee969aa6f99a77e7c371f7e 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, 30 Apr 2021 06:57:18 -0000 The branch main has been updated by krion (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=0d283be61e5eaa0ddee969aa6f99a77e7c371f7e commit 0d283be61e5eaa0ddee969aa6f99a77e7c371f7e Author: Kirill Ponomarev AuthorDate: 2021-04-30 06:57:05 +0000 Commit: Kirill Ponomarev CommitDate: 2021-04-30 06:57:05 +0000 Update my key. --- documentation/static/pgpkeys/krion.key | 52 ++++++++++++++++------------------ 1 file changed, 24 insertions(+), 28 deletions(-) diff --git a/documentation/static/pgpkeys/krion.key b/documentation/static/pgpkeys/krion.key index d6d8b609ec..9b0d881716 100644 --- a/documentation/static/pgpkeys/krion.key +++ b/documentation/static/pgpkeys/krion.key @@ -1,15 +1,12 @@ -// $FreeBSD: head/share/pgpkeys/krion.key 53139 2019-06-11 19:26:40Z krion $ -// // sh addkey.sh krion 0F223DFCB302CA45 ; - [.literal-block-margin] .... -pub rsa2048/0F223DFCB302CA45 2017-01-24 [SC] [expires: 2022-09-08] +pub rsa2048/0F223DFCB302CA45 2017-01-24 [SC] [expires: 2023-04-30] Key fingerprint = 2421 D116 1100 42E8 CA9E 2D69 0F22 3DFC B302 CA45 uid Kirill Ponomarev uid Kirill Ponomarev -sub rsa2048/689A26385A12AC21 2017-01-24 [E] [expires: 2022-09-08] +sub rsa2048/689A26385A12AC21 2017-01-24 [E] [expires: 2023-04-30] .... @@ -24,13 +21,13 @@ IwfSkmQmGfjMC3i9vySEZWF0o9PjqrMHvRZfd7uv2I5isJACD5bOV0HGwaW0U6Pm FKjMGJVJxgb4si1FxO/Zl8O6q0BDpCSbLjvqT/Y22m0q0/UuVj5bvSHzbaZX0253 J7t8unSoIwrLpZ2ISh4JeO29w5t7C+do3M/VABEBAAG0HktpcmlsbCBQb25vbWFy ZXYgPGtwQGtyaW9uLmNjPokBVwQTAQgAQQIbAwULCQgHAgYVCAkKCwIEFgIDAQIe -AQIXgAUJCpLJRhYhBCQh0RYRAELoyp4taQ8iPfyzAspFBQJaOZeNAhkBAAoJEA8i -PfyzAspFSXEH/110QIau6UoFtHs69UbcVH95Q6B0DqBs9azU8f00X/tHE8xZK+v1 -COsjGI2daYGh/UP4KQG1ZjoKdpLtp4GfcIu97fC5GDMI2+bSICqc9oh+u+KMynJU -7oKZhZastHc/TI97QdqfbsOlH6McR4IbqLD5IJbdCs0vemzqIOuClUXmaKVw1W4X -tjIrvy8/9cDGyDAbmTWA+dbLETuSkVdjs9xVvzYAJW/LamsLTZmMoKXjig0aPJ/X -6bYqbCgD9Zi5DGe5jsElCQBFoaWdTuFUrvHORJp0RwOM/5C8f3Ge4tEy1Zu6E8Kc -9IYryRgGrtx/ikJEHfWTW6Y0GL5CxibprPiJAVQEEwEIAD4WIQQkIdEWEQBC6Mqe +AQIXgAIZARYhBCQh0RYRAELoyp4taQ8iPfyzAspFBQJgi6mIBQkLxoSDAAoJEA8i +PfyzAspFn4sIAIfxLsAqAx67N9ffspqoaLDo5c61PdrLBJPR1eU79hscq6Kx5tYm +22A5uCj4tCFXa3xLfiB/9F/CdHUMAsm92qnQ32QVAzF526BGEM3VlrIhjEx7dFyA +qb5XX7tCZYV79vowD4c3X3K5fOpR1fnhMK1YQvL/fTAAdaVn+uDNoWaAOh4azteX +aeWRI4yDzbc8fHFYUarb3sdVZ3nD5oLulFiVFe8w9Zul3sBrXWPAg1egJFOgbpXS +7SYYgUuQurCTk5XMr9g9DE59b4sL+jcGIqy8Oo/Ls/f03fkTwTDwGwbg7mcJ4vlS +n6acTv1OddPiQeKfCAejyMQB5kG75ihZWJWJAVQEEwEIAD4WIQQkIdEWEQBC6Mqe LWkPIj38swLKRQUCWIeMBQIbAwUJA8JnAAULCQgHAgYVCAkKCwIEFgIDAQIeAQIX gAAKCRAPIj38swLKRV/2B/491bU3AWr1YMkh+5rwkkZSsR7AKWMn5isjQTyc6rDz Y9uL/nE7CCBfmk5akhW6/S+AWNNGiD1fHMsl46cAe3sRNIuC3ynpJnJ2MUDIQYWt @@ -54,13 +51,13 @@ FdMQRX69AZxXwoFxf0VRI6BWQl/59Aw8eOwBT7/4UVLt7DvKdHhkRQrWyjXMQKmQ pm/P7ECAXEglOOEbr7Z0KRL/GQkA103pLofEjFSj5Mp5WeEi6klW+pYgM8iqyT1j nxl/zx5D75NxYo0JNxVtiuPYdLQkS2lyaWxsIFBvbm9tYXJldiA8a3Jpb25ARnJl ZUJTRC5vcmc+iQFUBBMBCAA+AhsDBQsJCAcCBhUICQoLAgQWAgMBAh4BAheAFiEE -JCHRFhEAQujKni1pDyI9/LMCykUFAlm0U8sFCQqSyUYACgkQDyI9/LMCykXfgAf/ -bMaNXa68XcbUNoa7p/5WQpTYuTo+2YQE/lddl9+GSRDaFcZfb3rqgqTe9eXW9xZC -3stP1ZutDweXpHStc5MGek+xB1CvzNxj5deMSqU3ECdV2rjikyI1LIz/55e0+4M4 -S6+X1AL72y3eTR9D70RhItzf5UZkaH2YJ0sEyW8hQeP5rXE8ZJChukosRRXO50v6 -DfC4S0+VwY0YRIyshTW0e87x3iZl5BEUkPyzXbUv0JkNQ1Q8JtRTyYC3sXHFsclc -VSa8Pk6Bbl9JDmvB5SHQdTRc34kNbkJChhSyIhgj7LdISZmpNBSbM4ijlgVnUkSf -LujX+0k3kZ3H00jSZBCsWokBVAQTAQgAPhYhBCQh0RYRAELoyp4taQ8iPfyzAspF +JCHRFhEAQujKni1pDyI9/LMCykUFAmCLqYgFCQvGhIMACgkQDyI9/LMCykX3dQf/ +aundkY46Ru0bWikVhx+muDQFpmY1sMf2UfIUeIrJsKsbfQmmUMWOJ+Tt1wg8kn/U +JJuxSHNBA+lJwZuk8DIqDABwZ4/NdeNs+/56BAvT3I327MkZ/JjEP3qBAr5MU3Xw +L9hcM0oQ6baXK3+w3WyoqZzBS3otdI/x3bdo97si9JKzaB7nbtnwYUvbxEFpBVkI +lMmknFXKmoET3gh513rL3hefTo9khGTAvJQ8ce42gqTQyR8/29bfPBraIRZmdWQg +7SF30cSoubzFRgKVLm1LXO9T6MccwPR2rGOB1VPJMhTM4I6wmMMOwhV7wAUyWcGl +gaO9hAoJPzDpQi2XVXqM0okBVAQTAQgAPhYhBCQh0RYRAELoyp4taQ8iPfyzAspF BQJYnFItAhsDBQkDwmcABQsJCAcCBhUICQoLAgQWAgMBAh4BAheAAAoJEA8iPfyz AspFCnEH/3LGgXlpMsqUOPEnRvMZKA/+ZkufyFcPtpBjnu4kgZCVehSXuro28GZi YM1gAjHp5GntTiNjyPFuEgahnzy/MD/ZiLelwG3r1m6aCXNmf50KtIp61xyX29+0 @@ -88,14 +85,13 @@ t/DCvvLRGQ+ghL2MSftspskomN4eosieTQgx3/uLodkVcmVWLyckeII4tQmqmabG eJksvIxICyh+dCASofyKosak88SsrxDQIKAGdBzP0nQ+KdWOpoRx40qJnoYj6DtN qC1xWXUGpI2F4d6ElLj0vWPKEJRZUHb5Y4iYHfPy/IjyD8cuyHBax79Vya60ocwa Z5EOzXxu/HO2bewYXj0r3E7O3I3OyhQlfZvnsnkkproExcfVPqnDcwARAQABiQE8 -BBgBCAAmAhsMFiEEJCHRFhEAQujKni1pDyI9/LMCykUFAlm0U90FCQqSyVgACgkQ -DyI9/LMCykWf6wf+JVKAp+RHr6Zsh1lkcbg4jFk0KvFh/Dphm+T44ghR0VrHMRCZ -G8qyT187PpLzhBuGOkdDzxyovcgACvOpvl96KkURH/ipl3YM884lvFBvwJk3z/Or -60Nti1X483J1ea/c9edftD1XSX8OAMJbmox8BrDLGRLrzdj2mFeimplaA0Yg3YKB -X7GWcU2weu3QdOCEGDLPf4qgcz+mTtqW3hDrub+zUM7vZqmLVSk2O1KOW9SVxKwx -7LjR20uXCldLazBNYVOBqpyjLFS+ugKOcN8E73S6IyDfgWfD6v3OTSSWoAB459RT -VHk7OwIUP+dloMB/c4OUjB6B4ose/AO8kfkY3w== -=KQTp +BBgBCAAmAhsMFiEEJCHRFhEAQujKni1pDyI9/LMCykUFAmCLqZkFCQvGhJQACgkQ +DyI9/LMCykWq0ggAkzwV0PY3d4QuD2rjgUCW16636oyAHF06qvBK0696+oTEton3 +046jWeda5GokUVoDIUmoX/LTXcXJF7mtNc6ohPAaFBFzpyjk5NAmI/VGv1XxSdSP +cD7T3ZuOGIrNoM9XQrv0xB7pd0TBTuyi22GxByDwHQdVL2JasR8A7P3wnEyna5Jw +BO6PonzIxuLeKjUaavF8Ml7+kv9hcqgGVJLsD6qdGqo3y9UKeMtoi+45YyNw2SvT +MWT10vsZWbOPycAh5FwuPlXFWf0Sf9vyo4QxO3dFWwr9RGums701HI0zNktF3TxL +bxJEz6tQwGCnwUoZeigH0ZSV1Xp0cqUQVcquow== +=v6oe -----END PGP PUBLIC KEY BLOCK----- .... - From owner-dev-commits-doc-all@freebsd.org Fri Apr 30 13:31: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 7D4EB5FEA9C for ; Fri, 30 Apr 2021 13:31: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 4FWtZH37n2z4lhx; Fri, 30 Apr 2021 13:31:51 +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 5E8342CEBF; Fri, 30 Apr 2021 13:31:51 +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 13UDVpHj068705; Fri, 30 Apr 2021 13:31:51 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13UDVpLb068704; Fri, 30 Apr 2021 13:31:51 GMT (envelope-from git) Date: Fri, 30 Apr 2021 13:31:51 GMT Message-Id: <202104301331.13UDVpLb068704@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Oskar Holmlund Subject: git: e633f0b9df - main - Add committers entries for Oskar Holmlund (oh) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: oh X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e633f0b9dfa5d54dd4f329a19a57d53f9f50d0a6 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, 30 Apr 2021 13:31:51 -0000 The branch main has been updated by oh (src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=e633f0b9dfa5d54dd4f329a19a57d53f9f50d0a6 commit e633f0b9dfa5d54dd4f329a19a57d53f9f50d0a6 Author: Oskar Holmlund AuthorDate: 2021-04-30 12:12:09 +0000 Commit: Oskar Holmlund CommitDate: 2021-04-30 12:12:09 +0000 Add committers entries for Oskar Holmlund (oh) Step 7.1.[1-4] in committers guide. Reviewed by: manu, br, delphij Approved by: manu (mentor) Differential Revision: https://reviews.freebsd.org/D29996 --- .../articles/contributors/contrib-committers.adoc | 1 + .../content/en/articles/pgpkeys/_index.adoc | 3 ++ documentation/static/pgpkeys/oh.key | 55 ++++++++++++++++++++++ shared/authors.adoc | 4 ++ website/data/en/news/news.toml | 4 ++ 5 files changed, 67 insertions(+) diff --git a/documentation/content/en/articles/contributors/contrib-committers.adoc b/documentation/content/en/articles/contributors/contrib-committers.adoc index e05603d321..ae10679778 100644 --- a/documentation/content/en/articles/contributors/contrib-committers.adoc +++ b/documentation/content/en/articles/contributors/contrib-committers.adoc @@ -134,6 +134,7 @@ * {nhibma} * {jhixson} * {pho} +* {oh} * {mhorne} * {cognet} * {sunpoet} diff --git a/documentation/content/en/articles/pgpkeys/_index.adoc b/documentation/content/en/articles/pgpkeys/_index.adoc index 913ba949dd..a09cfe8fcd 100644 --- a/documentation/content/en/articles/pgpkeys/_index.adoc +++ b/documentation/content/en/articles/pgpkeys/_index.adoc @@ -647,6 +647,9 @@ include::static/pgpkeys/jhixson.key[] === `{pho}` include::static/pgpkeys/pho.key[] +=== `{oh}` +include::static/pgpkeys/oh.key[] + === `{mhorne}` include::static/pgpkeys/mhorne.key[] diff --git a/documentation/static/pgpkeys/oh.key b/documentation/static/pgpkeys/oh.key new file mode 100644 index 0000000000..f0515f43d1 --- /dev/null +++ b/documentation/static/pgpkeys/oh.key @@ -0,0 +1,55 @@ +// sh addkey.sh oh 0FC93F9A961123C1 ; + +[.literal-block-margin] +.... +pub rsa3072/0FC93F9A961123C1 2021-04-26 [SC] [expires: 2024-04-25] + Key fingerprint = 6E84 8E83 03F1 AD82 35F6 7CE8 0FC9 3F9A 9611 23C1 +uid Oskar Holmlund +sub rsa3072/54B1EA6302F9829F 2021-04-26 [E] [expires: 2024-04-25] + +.... + +[.literal-block-margin] +.... +-----BEGIN PGP PUBLIC KEY BLOCK----- + +mQGNBGCG/xsBDACvw2TfOIjrSKK9BnlzelOxJBzB9bFL+9xonQ+w08diJkUTfVMl +LuQgnW0yegUM1YRIrHAPJ19rw13J5FvsTUfDnBevS+d9jKQzVFmBFueeiEOFs1qu +2EDqnxtFTYYK2DTF0tdF4B5Cu3BJTNbzdSQCoOWtgZ+aQGGc0bog9YN9mL5C8cI9 +AVr2PALa/xjmhQZ5iaf/uVbJlZpMnX5ibpYvpqLhpqfg1nHXB+6YlEFrMhGDI3U2 +xoSIt3Dyncl3YLgXkD07c/8oE6lwc4dpA6GueA0ln1+ce8mzZbJZJcAuAqfibjfC ++32Z3RihMjAe+rltP+rBc0aplJy2qN3WC46FvNELSILHmCr2QGxfkiIocRvfpE3h +0OqSr9tzhoMagF+0T2A6f/P49zaitBibA06HacKHANGT3ljntuHEmA3yJ513dn8Q +1nzmwgbHZdc+DLkpq/jnJkqV1Fpv1hwyJJvvomrN4M8CI5UwGV/dAb0BY9gmLYBT +wP2hP8qPu8wopnkAEQEAAbQfT3NrYXIgSG9sbWx1bmQgPG9oQEZyZWVCU0Qub3Jn +PokB1AQTAQoAPhYhBG6EjoMD8a2CNfZ86A/JP5qWESPBBQJghv8bAhsDBQkFo5qA +BQsJCAcDBRUKCQgLBRYDAgEAAh4BAheAAAoJEA/JP5qWESPBH04L/0KJfTqart1t +IutPRpuTflW8GnUUb6V8y1lblDjmTLaQ/YcO7rK380/11Wik1zDJhQsDe0ItKpEV +YEh8scZbnsMJYqf2dvYstZ6kO7v3xEvu70Oo/KQx3f8fA7N7jEcMEfDGL2AkvEkh +4jNemafltRye91ZIA8NDCMc0yhJbwhpTZLKJpylUmJ6wxbDmEgKV7DTJaAsfNTHv +dYKuYFDe1sVv/g4gZimBfH9iKIomhKS1nV1PIeTzzfykPjy+cTA1oBPFeBzl7Dse +AjdFsGQ522juM2HlOnoXJ4+gV7IYZ16yWYbYw7V5zZ909vnla+Szyab1Ed6eltwt +CGkfvewOz/wnIORUWBTbX9k+WRjFFE46c34q7yKqkHEKLprBned4Q4gply56/MS2 +X+NMDRxHOK4e8M3wkTQNwrIn54dGHOUPpHdJ9v7n1FthF2aPkaxRSlPSGW1H3PbS +qaEd0u90XwxbvE0DVm6wjTYfEFsz+GMDLj7xILkFIVVmJedDzsGNjLkBjQRghv8b +AQwAq6vBZM6PhWVsWcfqqVkNLdgmFKeLpQtke1/fevXTjqX9sMXkjCfm2A936Th9 +ZiIEIEoyi9lKVbw6ErzMSCC9V+Vrx2jJIk/rug2WOAF74LGPQcGVi/pscJxA6vOY +OMCbqrFkP7FV1KmI5hQrDWmuIJtPqcuQC+NBmZlLKTZOJRlVdhn9pdo+r4SD72xX +5t/DHLa9IroyuHDH/rqIywWoTxttjYTGTxvt0E5DIjUylirtP2MqEWNHC5uwwtmj +DgFW12FYe6ZlFOoWAqLC6xiVgx7MGJ190JiPl1HK+GqKDDW151sLvTO9+mxmHzeH +AgmPOWzYrSiOYyTH5vixwkD8kRq14VxMfz5pETbhcwkk3fxc78LT4/ruMBmpqddl +pmYXfv+s4LipxvkCGQpyGhb5Zo4QcHC8WAFoFb0nzzSqrG1vaC7RSJzG1wzgnwxx +PgZxI2OOE/pzrTmFVRRJoTuHtmyz7xB3R13eAErv+KfFlMu2gOWxnkspTWV1QR/j +ZYxlABEBAAGJAbwEGAEKACYWIQRuhI6DA/GtgjX2fOgPyT+alhEjwQUCYIb/GwIb +DAUJBaOagAAKCRAPyT+alhEjwcNxC/sHj+7gxGUv8+KJ3u/T5slDylBKw3KkvY1Q +MqfUTlmWPh0kPoE90GxCq1KF9vQq7/Rw69R3PY0FYezgCmI18zeAs5uUu9HVYO4G +Q7znYWaumdgDqgMcX0MFphM1T/4cl/1yPjL8O8qZ7z/t1di1KhOOj53sqRAhgXSR ++qUMPKWs+s9BbHHGdT/mc+KWbLJ+CkRLJqJkTIENIh8tO58uWJjQcMhcr2Q2zIMf +eIwurQYqDDVYzZLxvxnbV399Nv1QOSIjwCJatNsDETpr6fsbCos3aIBJPQzrogii +sfxYdCyIjYeFHoiuqQY+AnTZCwv0tMWGD68sSlXZY0nIcartozrz8Y7/LEVFGYHI +CDx6juXzuXrbsrGl+wwPg9nWcXF7Drj7FwWnSP3axHUj9D12RRTyTRErW7rv2XMv +EzN7rc/SAwv0l8FPUyPFR9UiA42vGFnwXKAB/GofvLiroyjCDI15ES8pXzVVTY1q +ZF5zK/7v+f9tO+uOnVhHqdAqc3L0RqE= +=tX9F +-----END PGP PUBLIC KEY BLOCK----- +.... diff --git a/shared/authors.adoc b/shared/authors.adoc index 572601d6c6..4426c817b4 100644 --- a/shared/authors.adoc +++ b/shared/authors.adoc @@ -2447,6 +2447,10 @@ :obrien-email: obrien@FreeBSD.org :obrien: {obrien-name} <{obrien-email}> +:oh-name: Oskar Holmlund +:oh-email: oh@FreeBSD.org +:oh: {oh-name} <{oh-email}> + :ohauer-name: Oliver Hauer :ohauer-email: ohauer@FreeBSD.org :ohauer: {ohauer-name} <{ohauer-email}> diff --git a/website/data/en/news/news.toml b/website/data/en/news/news.toml index c7e75f0e89..bcb8fff542 100644 --- a/website/data/en/news/news.toml +++ b/website/data/en/news/news.toml @@ -1,5 +1,9 @@ # Sort news by year, month and day +[[news]] +date = "2021-04-21" +description = "New committer: Oskar Holmlund (src)" + [[news]] date = "2021-04-13" title = "FreeBSD 13.0-RELEASE Available" From owner-dev-commits-doc-all@freebsd.org Fri Apr 30 16:44: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 576FB624888 for ; Fri, 30 Apr 2021 16:44: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 4FWyr9245Wz4vt1; Fri, 30 Apr 2021 16:44: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 3A0402F981; Fri, 30 Apr 2021 16:44: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 13UGi9Jk026450; Fri, 30 Apr 2021 16:44:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13UGi90L026449; Fri, 30 Apr 2021 16:44:09 GMT (envelope-from git) Date: Fri, 30 Apr 2021 16:44:09 GMT Message-Id: <202104301644.13UGi90L026449@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: cfbdb9cfe4 - main - Translate sourceCodeRepositories entry and correct translation of gitMirror entry. 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: cfbdb9cfe425a8205a6d095a516d02900eeff05d 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, 30 Apr 2021 16:44:09 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=cfbdb9cfe425a8205a6d095a516d02900eeff05d commit cfbdb9cfe425a8205a6d095a516d02900eeff05d Author: Ryusuke SUZUKI AuthorDate: 2021-04-30 16:43:22 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-04-30 16:43:22 +0000 Translate sourceCodeRepositories entry and correct translation of gitMirror entry. --- website/themes/beastie/i18n/ja.toml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/website/themes/beastie/i18n/ja.toml b/website/themes/beastie/i18n/ja.toml index 464689be0e..5eebc3beec 100644 --- a/website/themes/beastie/i18n/ja.toml +++ b/website/themes/beastie/i18n/ja.toml @@ -116,7 +116,7 @@ other = "Subversion リポジトリ" other = "Git リポジトリ" [gitMirror] -other = "Git ミラー" +other = "GitHub ミラー" [phabricator] other = "コードレビュー (Phabricator)" @@ -288,6 +288,10 @@ other = "December" [misc] other = "その他" +# sidenav +[sourceCodeRepositories] +other = "ソースコードリポジトリ" + [releases] other = "リリース情報" From owner-dev-commits-doc-all@freebsd.org Fri Apr 30 18:32: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 5F97862636E for ; Fri, 30 Apr 2021 18:32:48 +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 4FX1FX2Hzgz3HMZ; Fri, 30 Apr 2021 18:32:48 +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 41C5AEEA; Fri, 30 Apr 2021 18:32:48 +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 13UIWmHC071734; Fri, 30 Apr 2021 18:32:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13UIWmN2071733; Fri, 30 Apr 2021 18:32:48 GMT (envelope-from git) Date: Fri, 30 Apr 2021 18:32:48 GMT Message-Id: <202104301832.13UIWmN2071733@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Rene Ladan Subject: git: 4dc93df8be - main - [rene.key] Refresh my GPG key, no actual changes. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: rene X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4dc93df8bef01197b1b37c0ceda52b88f09aa2be 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, 30 Apr 2021 18:32:48 -0000 The branch main has been updated by rene: URL: https://cgit.FreeBSD.org/doc/commit/?id=4dc93df8bef01197b1b37c0ceda52b88f09aa2be commit 4dc93df8bef01197b1b37c0ceda52b88f09aa2be Author: Rene Ladan AuthorDate: 2021-04-30 18:30:17 +0000 Commit: Rene Ladan CommitDate: 2021-04-30 18:32:32 +0000 [rene.key] Refresh my GPG key, no actual changes. --- documentation/static/pgpkeys/rene.key | 4 ---- 1 file changed, 4 deletions(-) diff --git a/documentation/static/pgpkeys/rene.key b/documentation/static/pgpkeys/rene.key index bded029e30..7c29228ccf 100644 --- a/documentation/static/pgpkeys/rene.key +++ b/documentation/static/pgpkeys/rene.key @@ -1,8 +1,5 @@ -// $FreeBSD: head/share/pgpkeys/rene.key 53780 2020-01-15 16:03:55Z rene $ -// // sh addkey.sh rene ADBBF8610A3789B7 ; - [.literal-block-margin] .... pub rsa4096/ADBBF8610A3789B7 2012-11-18 [SC] [expires: 2022-01-14] @@ -101,4 +98,3 @@ pZnS5ZzdhA== =J97u -----END PGP PUBLIC KEY BLOCK----- .... - From owner-dev-commits-doc-all@freebsd.org Fri Apr 30 18:32: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 8ACC6626900 for ; Fri, 30 Apr 2021 18:32: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 4FX1FY3Zgfz3H7F; Fri, 30 Apr 2021 18:32: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 6DB4DF3C; Fri, 30 Apr 2021 18:32: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 13UIWnuZ071755; Fri, 30 Apr 2021 18:32:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 13UIWnfX071754; Fri, 30 Apr 2021 18:32:49 GMT (envelope-from git) Date: Fri, 30 Apr 2021 18:32:49 GMT Message-Id: <202104301832.13UIWnfX071754@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Rene Ladan Subject: git: a66ed4de5c - main - [portmgr-secretary.key] refresh, it was outdated. MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: rene X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a66ed4de5c4dec7847ccaf8c0e1174d25af915f4 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, 30 Apr 2021 18:32:49 -0000 The branch main has been updated by rene: URL: https://cgit.FreeBSD.org/doc/commit/?id=a66ed4de5c4dec7847ccaf8c0e1174d25af915f4 commit a66ed4de5c4dec7847ccaf8c0e1174d25af915f4 Author: Rene Ladan AuthorDate: 2021-04-30 18:31:21 +0000 Commit: Rene Ladan CommitDate: 2021-04-30 18:32:32 +0000 [portmgr-secretary.key] refresh, it was outdated. --- documentation/static/pgpkeys/portmgr-secretary.key | 144 +++++++++++++-------- 1 file changed, 90 insertions(+), 54 deletions(-) diff --git a/documentation/static/pgpkeys/portmgr-secretary.key b/documentation/static/pgpkeys/portmgr-secretary.key index e91a0de0f0..0a8d48765c 100644 --- a/documentation/static/pgpkeys/portmgr-secretary.key +++ b/documentation/static/pgpkeys/portmgr-secretary.key @@ -1,14 +1,13 @@ -// $FreeBSD: head/share/pgpkeys/portmgr-secretary.key 48904 2016-06-09 20:16:47Z rene $ -// // sh addkey.sh portmgr-secretary D8294EC3BBC4D7D5 ; - [.literal-block-margin] .... pub rsa2048/D8294EC3BBC4D7D5 2012-07-24 [SC] Key fingerprint = FB37 45C8 6F15 E8ED AC81 32FC D829 4EC3 BBC4 D7D5 uid FreeBSD Ports Management Team Secretary sub rsa2048/5CC117965F65CFE7 2012-07-24 [E] +sub rsa4096/CA20328577064EB7 2013-10-05 [S] +sub rsa4096/8B114B3613867E00 2013-10-05 [E] .... @@ -31,56 +30,93 @@ u361rwM4DZ40HngYY9fdGc4SbXurGA5m+vLAURLzPv+QRQqHfaI1DZF6gzMgY49x qS1JBF4kPoicpgvs3o6CuX8MD9ewGFSAMM3EdzV6ZdC8pnpXC8+8Q+p6FjNqmtjk GpW39Zq/p8SJVg1RortCH6qWLe7dW7TaFYov7gF1V/DYwDN5iEYEEBECAAYFAlN2 WksACgkQtzkaJjSHbFtuMwCg0MXdQTcGMMOma7LC3L5b4MEoZ+wAn0WyUHpHwHnn -pn2oYDlfAbwTloWIiQEcBBABAgAGBQJQDuVrAAoJENk3EJekc8mQ3KwIAImNDMXA -F8ajPwCZFpM6KDi3F/jpwyBPISGY1oWuYPEi1zN94k5jS90aZb3W8Y8x4JTh35Ew -b6XODi3uGLSLCmnlqu2a80yPfXf5IuWmIQdFNQxvosj9UHrg+icZGFmm+f0hPJxM -TsZREv3AvivQfnb/N3xIICxW4SjKSYXQcq4hr4ObhUx7GKnjayq+ofU2cRlujr87 -uOH0fO3xhOJG4+cX5mI1HGK38k0Csc1zqYa/66Qe5dnIZz+sNXpEPMLAHIt1a45U -B967igJdZSDFN33bPl1QWmf3aUXU3d1VttiSyHkpm4kb9KgsDkUk1IJ5nUe9OXyd -WtoqNW5afDa5N0aIRgQQEQIABgUCUA7lwwAKCRB59uBxdBRinNh2AJ41+zfsaQSR -HWvSkqOXGcP/fgOduwCfUJDT+M1eXe2udmKof/9yzGYMirKJASIEEAECAAwFAlAa -IT8FAwASdQAACgkQlxC4m8pXrXwCHAf+J7l+L7AvRpqlQcezjnjFS/zG1098qkDf -lThHZlpVnrBMJZaXdvL6LzVgiIYVWZC5CSSazW9EWFjp9VjM7FBHdWFZNMV7GAuU -t0jzx6gGXOWwi+/v/hs1P11RyDZN5hICHdPNmyZVupciDxe+sIEP9aEbVxcaiccq -zM/pFzIVIMMP5tCiA42q6Mz3h0hy6hntUKptS8Uon6sje5cDVcVlKAUj1wO2cphC -qkYlwMQfZV5J9f/hcW5ODriD3cBwK8SocA2Cq5JYF8kYDL1+pXnUutGnvAHUYt87 -RWvQdKmfXjzBcMFJ2LlPUB1+IFvwQ13V9R8j9B/EdLmSWQYT9qRA2okCHAQTAQoA -BgUCV1XMpwAKCRCtu/hhCjeJt2CyD/9JLe+Ck23CJkeRSF8oC+4SFOUdSAmejSzn -klPwmEClffABYd/kckO1T6um+2FUcXuJZQE1nKKUNvZ8pBWwsm1RDHsyroKi/XB1 -0a1Tdx/rvlU88ytbeLfUCLzoCrf6pkMQWoU6/3qS6elV0WwOlDufk+XjD1sja2wu -sshG8y+1WCA5JjP3rZdD9NVdzo5DgkotTRUfuYN1LJIN4zlDgHj7FVP7wW7+R0cZ -FoOiNsLJCA0FN8SiyU98UysjawLiIY9dTJz6XVA0DgB0TZWO3mWiDjITeKrdGcqf -PNiJhmvUKBkn07YpTPNfkoTT/p/q5ChYmu0ubGeyS1ELKjmklJ+DzynfZLzvnXYX -Ngo5ckeuqEqUNxM0J63v8lmfhDRROFveqHWdp0XMxXVmR5bMunSldg5EZsoLyQbN -+ScIPnDTAEPGrCtf0t84RQxNQeET6/WBbZfzeSeAFmpBFCdicsZ6Mjwtwjr4+o15 -n1QMTZco1NaTqf8vXwzl9wM4aYtg1OkF4z8HdHuy50CHCet4mT5eJgwZUfFvXdbM -pHXprEI0Y9OOL4aMinC1egF3dXt/0n57i6CE+E2k3UJPNvMrtp0HaDEnKZ8cfkBU -EBzkUYi5wwqntHV2JRisqoRnHdvJT7ImlHMe7WaJsifBK874PnToaKg8P6K1Tph+ -FyLxULaYjYkCHAQSAQgABgUCVBg2zwAKCRDqsDxYv9xHj1klEADXYJdHC3zsdx7w -DsJsttWdykcZoOd/VUKUdN0BAU72nLV0tLn4uFjETA6MhHZVxzwIDTeLB8kqyEpc -fZnoVbqJIUJz1sJXMdOty7CwZzlZlAwmUaIfFiazJY1p398JbyYfSrVKNOpw9wCm -Db7WP9dBritwvjaLzu8HQsiztO0S/5ha/EDfTU3qocBUTjbCtGR9LqAmPE4X8+li -F2EfZMEoJd3rJWsYv2y/k6pSgC/MpQewnyr6f+JQ/781UoZB6PpxCxfu4D6xlOyd -ERBUg+FfDAWYR+KX+DGOalRlUyaSz8Nvxl8/b0Im/AQhx9afqyEZxIDpg52zt8jJ -t3wx23YP8EQGUgwF8pIrj3wFSBSG3a/cskiBNUIhChIR9hQrVPUahN/jx7DGAGxk -/Ka9qsRGYTHfSr9jjTUQ+htfeFBRDR0nkZKMo5+Wk/cAcBKVbPlBpwvnzT3fh+wL -cF3ErBbx5jp+BoFee8D6ATeUvQxMcgVbDPUkgMsy3EtKMVO10jhIoXoVV+Sg9GZ8 -zMEy1tORKn0zsd2ZgXC2sRJOm5ttCSdYQ4ddbM1A9jg6tiRx4hES16GDywvkL8P2 -M9+qyIfjQxjGU33f/r8zp9DyNT1VlrtwhFxtOoMdmrsbYOCTja4Xg14hK1hRac0k -GB7bj6w97p8uMrQT3PlSMtoyrRyo7bkBDQRQDs6mAQgAzNxJYpf5PrqV8pdRXkn3 -6Fe45q671YtbZ2WrT7D0CVZ8Z+AZsxnP/tiY1SrM2MepCeA2xBAhKGsWBWo1aRk5 -mfZOksKsiXsi2XeBVhdZlCkrOMKBTVian7I1lH59ZnNIMX0Nl0tlj3L1IjeWWNvf -ej43URV81S9EmSwpjaWboatr2A+1oJku5m7nPD9JIOckE1TzBsyhx7zIUN9w6MKr -7gFw8DCzypwUKyYgKYToVm8QlkT/L3B0fuQHWhT6ROGk4o8SC71ia5tc1TzUzGEZ -1AQO8bbnbmJLBDKveWHCoaeAkRzINzoD9wAn9z4pnilze59QtKC1cOqUksTvBSDh -6wARAQABiQEfBBgBAgAJBQJQDs6mAhsMAAoJENgpTsO7xNfVOHoH/i5VyggVdwpq -PX8YBmN5mXQziYZNQoiON8IhOsxpX4W2nXCj5m6MACV6nJDVV6wyUH8/VvDQC9nH -arCe1oaNsHXJz0HamYt5gHJ0G1bYuBcuJp/FEjLa48XFI7nXQjJHn8rlwZMjK/PW -j1lw2WZiekviuzTEDH8c3YStGJSa+gYe8Eyq3XJVAe2VQOhImoWgGDR3tWfgrya/ -IdEFb/jmjHSG5XUfbI0vNwqlf832BqSQKPG/Zix4MmBJgvAz4R71PH8WBmbmNFjD -elxVyfz80+iMgEb9aL91MfeBNC2KB1pFmg91mQTsiq7ajwVLVJK8NplHAkdLmkBC -O8MgMjzGhlE= -=iw7d +pn2oYDlfAbwTloWIiQEiBBABAgAMBQJQGiE/BQMAEnUAAAoJEJcQuJvKV618AhwH +/ie5fi+wL0aapUHHs454xUv8xtdPfKpA35U4R2ZaVZ6wTCWWl3by+i81YIiGFVmQ +uQkkms1vRFhY6fVYzOxQR3VhWTTFexgLlLdI88eoBlzlsIvv7/4bNT9dUcg2TeYS +Ah3TzZsmVbqXIg8XvrCBD/WhG1cXGonHKszP6RcyFSDDD+bQogONqujM94dIcuoZ +7VCqbUvFKJ+rI3uXA1XFZSgFI9cDtnKYQqpGJcDEH2VeSfX/4XFuTg64g93AcCvE +qHANgquSWBfJGAy9fqV51LrRp7wB1GLfO0Vr0HSpn148wXDBSdi5T1AdfiBb8ENd +1fUfI/QfxHS5klkGE/akQNqJAhwEEwEKAAYFAldVzKcACgkQrbv4YQo3ibdgsg// +SS3vgpNtwiZHkUhfKAvuEhTlHUgJno0s55JT8JhApX3wAWHf5HJDtU+rpvthVHF7 +iWUBNZyilDb2fKQVsLJtUQx7Mq6Cov1wddGtU3cf675VPPMrW3i31Ai86Aq3+qZD +EFqFOv96kunpVdFsDpQ7n5Pl4w9bI2tsLrLIRvMvtVggOSYz962XQ/TVXc6OQ4JK +LU0VH7mDdSySDeM5Q4B4+xVT+8Fu/kdHGRaDojbCyQgNBTfEoslPfFMrI2sC4iGP +XUyc+l1QNA4AdE2Vjt5log4yE3iq3RnKnzzYiYZr1CgZJ9O2KUzzX5KE0/6f6uQo +WJrtLmxnsktRCyo5pJSfg88p32S87512FzYKOXJHrqhKlDcTNCet7/JZn4Q0UThb +3qh1nadFzMV1ZkeWzLp0pXYORGbKC8kGzfknCD5w0wBDxqwrX9LfOEUMTUHhE+v1 +gW2X83kngBZqQRQnYnLGejI8LcI6+PqNeZ9UDE2XKNTWk6n/L18M5fcDOGmLYNTp +BeM/B3R7sudAhwnreJk+XiYMGVHxb13WzKR16axCNGPTji+GjIpwtXoBd3V7f9J+ +e4ughPhNpN1CTzbzK7adB2gxJymfHH5AVBAc5FGIucMKp7R1diUYrKqEZx3byU+y +JpRzHu1mibInwSvO+D506GioPD+itU6Yfhci8VC2mI2JAhwEEgEIAAYFAlQYNs8A +CgkQ6rA8WL/cR49ZJRAA12CXRwt87Hce8A7CbLbVncpHGaDnf1VClHTdAQFO9py1 +dLS5+LhYxEwOjIR2Vcc8CA03iwfJKshKXH2Z6FW6iSFCc9bCVzHTrcuwsGc5WZQM +JlGiHxYmsyWNad/fCW8mH0q1SjTqcPcApg2+1j/XQa4rcL42i87vB0LIs7TtEv+Y +WvxA301N6qHAVE42wrRkfS6gJjxOF/PpYhdhH2TBKCXd6yVrGL9sv5OqUoAvzKUH +sJ8q+n/iUP+/NVKGQej6cQsX7uA+sZTsnREQVIPhXwwFmEfil/gxjmpUZVMmks/D +b8ZfP29CJvwEIcfWn6shGcSA6YOds7fIybd8Mdt2D/BEBlIMBfKSK498BUgUht2v +3LJIgTVCIQoSEfYUK1T1GoTf48ewxgBsZPymvarERmEx30q/Y401EPobX3hQUQ0d +J5GSjKOflpP3AHASlWz5QacL580934fsC3BdxKwW8eY6fgaBXnvA+gE3lL0MTHIF +Wwz1JIDLMtxLSjFTtdI4SKF6FVfkoPRmfMzBMtbTkSp9M7HdmYFwtrESTpubbQkn +WEOHXWzNQPY4OrYkceIREtehg8sL5C/D9jPfqsiH40MYxlN93/6/M6fQ8jU9VZa7 +cIRcbTqDHZq7G2Dgk42uF4NeIStYUWnNJBge24+sPe6fLjK0E9z5UjLaMq0cqO25 +AQ0EUA7OpgEIAMzcSWKX+T66lfKXUV5J9+hXuOauu9WLW2dlq0+w9AlWfGfgGbMZ +z/7YmNUqzNjHqQngNsQQIShrFgVqNWkZOZn2TpLCrIl7Itl3gVYXWZQpKzjCgU1Y +mp+yNZR+fWZzSDF9DZdLZY9y9SI3lljb33o+N1EVfNUvRJksKY2lm6Gra9gPtaCZ +LuZu5zw/SSDnJBNU8wbMoce8yFDfcOjCq+4BcPAws8qcFCsmICmE6FZvEJZE/y9w +dH7kB1oU+kThpOKPEgu9YmubXNU81MxhGdQEDvG2525iSwQyr3lhwqGngJEcyDc6 +A/cAJ/c+KZ4pc3ufULSgtXDqlJLE7wUg4esAEQEAAYkBHwQYAQIACQUCUA7OpgIb +DAAKCRDYKU7Du8TX1Th6B/4uVcoIFXcKaj1/GAZjeZl0M4mGTUKIjjfCITrMaV+F +tp1wo+ZujAAlepyQ1VesMlB/P1bw0AvZx2qwntaGjbB1yc9B2pmLeYBydBtW2LgX +LiafxRIy2uPFxSO510IyR5/K5cGTIyvz1o9ZcNlmYnpL4rs0xAx/HN2ErRiUmvoG +HvBMqt1yVQHtlUDoSJqFoBg0d7Vn4K8mvyHRBW/45ox0huV1H2yNLzcKpX/N9gak +kCjxv2YseDJgSYLwM+Ee9Tx/FgZm5jRYw3pcVcn8/NPojIBG/Wi/dTH3gTQtigda +RZoPdZkE7Iqu2o8FS1SSvDaZRwJHS5pAQjvDIDI8xoZRuQINBFJPlYgBEAC5Ao/e +SZr5n4MrTsZ0dcPMZ0AblMbWMX/gVsKlNCHzjAcQJlw0X233vQXNww2coJo62dEQ +g3FSeDpgzUXP776E7LfO9LKOPXTNYdoumllIYQ+B8nDY5MdMACMmfY14nU9y8gIQ +k0n/xo7aXDkQr5gLF3CR84YWyeXjNkgZF5jXZ+DHgv4Qm31H8zeuH5rBkeLSiiJT +z2sskGkL/3Tj96HxIeElkXPCrYxAOriMh87VjFhCUCjf+50nlbsA6VSS/ZeMlBgd +E6pStKf53nKEJDqJZx1F+aCuxJop/U4z2AhqmABFrjNQW1l4mCHYr5RJt2VPr6qu +gm0sP0ig2dmbiuFMwxkJ1u1snLG16mdfGnsIdZnX/ufmAcXl2s0Sb3xWqQf1r7Va +ovOCzloqK9SATDINzwsgYgo4R8F76FeVejN5bYa51YMogk63i170yzYCCkEBVL8F +tibHLsGtx4QYJIZCQUgj5qVgCGfXgNUboLxUPPd14bfL8vs991qsYFM4Q/GaJygg +RGWtvWY+0niGF3GZlZsQm0beD2JIBaKulQvvd6rV7jmjrwvtG/apJjY+RKr6M0be +kjb9LA3vOOE9C2nEekEvT6v2DIwLPGqN4MNIsDgJVb6YmX6BG+qbq39E89If1EUR +1GZ4BAbBZoXImcbgoPYPxmg/KP/j19J8zlh+DwARAQABiQM+BBgBAgAJBQJST5WI +AhsCAikJENgpTsO7xNfVwV0gBBkBAgAGBQJST5WIAAoJEMogMoV3Bk63xfYP/Aui +Ybn8sZ2DtA5j1EQhVdHpt1o13MUJIUGtN7v7FPDhTcqdlDgfI8SN1wLBnuEZ3JTx +du9yuRuTn1ACdoY1hRqzKlxjS5bLibwyQlJnR5yOnLMNUbzp9psjM1Ek6sT0Mp5L +57boIaosl2xkGqMUCVVo67oaIHCJFWLzk+JzBlwspPUPrqKCzcPMac7GQcPN851o +Y483prvwWzn412396nSvTVjJAX3GkfbA4UQPmGOG3KO6EylxX4d4DDdaak7gDPHW +xnNP20uefMjULhWifnF95W0i18+aImyYupLnci/RPwpFbzBVky3EEFgj0uaytHXL +aHVtcfCZ8FZ2hvNLaxSMZkPsJOEteegnWME7/9S21hinFc/ToNXvcCC9i7FWiw/T +iEZ8eBvHS6mSc+KZhhBEuwl+q6ybkqV8TToOD7YYj7NM/6vXXqISiZFII+rZZ9Dg +oCPNtNxkki6txUwBXq9lUvptVzJANpqpNVr+rWXsmDJ2AGQgc3NehdszIOXVSpld +deGx5kU19G+UEDQeyVNwt+JHU2oIy6+Hc/+QYV4KH84z/R4FUCgqeyb03VE+zdMv +5PpkTJpyvL51nWzmR+PCDhCw4TJFOUCIih6CWl7MO8FaOvC7UkCLXyKAP5uhDkRm +cVFgov/BvpASujRBMUdXZQFvjPn0YczYKr6qC63H0eMIAJEBqtzNv4RnVP2dY+gg +yhLwNf4kkaZwZ31TPClEeutUKxHLZiKNWMElO8efoB+ZXw1I1NnCJQ/h4H8RESsJ +foW9imPTsi6tgFIYX/KwLxtnVPXYw6e01iLxd8HsS5YruAuhFnMJZxHnAqZD1GL+ +/zym9IdMQMd9lJm+nc5H3duJolmUyPxoO0dUMpdQwsATPZID0YBIZ1d7pprA9yj1 +3+VMMxz7JYalkztadojC+HsZ15ZJy+5iSo4+Hd4MouS8VVUs7dsYuTMgpBYYhxZE +nyLYoXEaR3c8bAVvu2FsNRC5XCjHjpGUHMgZt1aRP2Q+A0Cus8Bn5OMvFkuwOUiR +Iya5Ag0EUk+VvwEQAMG0+JaBKCu2WPH87fIcoXQYEm6VxVgAesnshg2KfbnBuMko +5X2SAHsPxDsyEf+vKSohsyBNPpMSo5b1Q3CaKln664KJqJ3RitqMit+ajrGDpWnu +rbGZu9yJybhkgvn2dVb9BwSJ/CWaSVxVe8+BaLWhuYmig3WQo8WsFRFg5e89Mw0i +yoDy7SuLkrBFbECIT6OWC0qk+5gp5XgqnTbt0uHLp7V2mZpkmZ3796p5IjzTTUmo +GazFCt+PX1Qnb5yeISg2zABIG8WVcBHgeBxYnI8ADVEEztaknPofG8JKzf0YGk9G +c952pPgyTjqykVeVVlnpseDstqE9PEqjEW4Yqf73iC761fqyh/pW/bsadL2Fp0b1 +qHTpRJWtDXgc38+kr/GSNg/sSydutJiAeH+AVGAgYkg7vFCkw332G2vudCPUYFff +rpidlk3KfzwOf+fTPXukdhd3XDNEHsvIVQ3H/qz2NrYV8pkvOSB3D2rg4746R6cd +cb4aBLtol9MicAQ1F/8VVsB/5Xouw09HHdXQdaSoj8zb1kqD6es4anAerVLxOvQi +0c6LZm9jogJBTkXhFZHAEy/mxvTwTdM1rUlybgki+VgG/rMkcwRsCwO/okDmNMlw +mfhLZegRvK7MkJAUcKUxuY18wylE5doZihhZlO9sXHD3jcYW6tbRjBnw1VZpABEB +AAGJAR8EGAECAAkFAlJPlb8CGwwACgkQ2ClOw7vE19XBDgf9FsF98hfzAvLqSNGA +G44bfihuHC4FOqqNcnWYEMh6QH/HLbc6v7gg7uMCxINAg5q3k16IjUfVtFC4ZJ9S +xZGUCOmdrkh/8KkFCaxOD/TqOtU1wpSM74waBLn5Et24N8LgCokOHA9V8ck4VBt6 +muJ2xlbyouHlmLrm6cyaH+0A++S7nR5i53mOJrQjQGYJoBFgNlLZ9BljdUDX6MtT +Rni7dJM2tFRY5upeinjHNvFC2Wc7YNCm7hZkCK3jfSR0Gya66l/Hr+e0qhLWp6D8 +l+CI8VSRRJk5+MVUpUV2NrhWWbZQdUrshD2Jq3Z426QzfWVIFTpP3PtPubvhtyQU +WLuj9Q== +=e71t -----END PGP PUBLIC KEY BLOCK----- .... - From owner-dev-commits-doc-all@freebsd.org Sat May 1 15:39: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 464EB62FBAD for ; Sat, 1 May 2021 15:39: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 4FXYMB1bT8z4dvV; Sat, 1 May 2021 15:39: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 29AD71A401; Sat, 1 May 2021 15:39: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 141FdYib039593; Sat, 1 May 2021 15:39:34 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141FdYi7039592; Sat, 1 May 2021 15:39:34 GMT (envelope-from git) Date: Sat, 1 May 2021 15:39:34 GMT Message-Id: <202105011539.141FdYi7039592@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 731e05fde1 - main - Add Table of Contents style MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 731e05fde11b8af827a9a4ce7d48dd2dcfac1bd8 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: Sat, 01 May 2021 15:39:34 -0000 The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=731e05fde11b8af827a9a4ce7d48dd2dcfac1bd8 commit 731e05fde11b8af827a9a4ce7d48dd2dcfac1bd8 Author: Sergio Carlavilla Delgado AuthorDate: 2021-05-01 15:39:09 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-05-01 15:39:09 +0000 Add Table of Contents style --- website/themes/beastie/static/css/layout.css | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/website/themes/beastie/static/css/layout.css b/website/themes/beastie/static/css/layout.css index 483916767b..0f1310340a 100644 --- a/website/themes/beastie/static/css/layout.css +++ b/website/themes/beastie/static/css/layout.css @@ -542,3 +542,13 @@ footer { img { border: 0; } + +/* Table of contents */ +#toctitle { + font-weight: bold; + line-height: 1.3; + margin: 1em 0; + margin-left: 0; + color: #990000; + font-size: 115%; +} From owner-dev-commits-doc-all@freebsd.org Sat May 1 16:54: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 E2CCA631CD9 for ; Sat, 1 May 2021 16:54:35 +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 4FXb1l5pcwz4hlZ; Sat, 1 May 2021 16:54:35 +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 BA3361B586; Sat, 1 May 2021 16:54:35 +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 141GsZBe044666; Sat, 1 May 2021 16:54:35 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141GsZUx044665; Sat, 1 May 2021 16:54:35 GMT (envelope-from git) Date: Sat, 1 May 2021 16:54:35 GMT Message-Id: <202105011654.141GsZUx044665@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: ff3df39394 - main - a67af5a97b -> e633f0b9df 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: ff3df39394cc4faf4300a4b19954f93a0fd46868 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: Sat, 01 May 2021 16:54:35 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=ff3df39394cc4faf4300a4b19954f93a0fd46868 commit ff3df39394cc4faf4300a4b19954f93a0fd46868 Author: Ryusuke SUZUKI AuthorDate: 2021-05-01 16:51:45 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-01 16:51:45 +0000 a67af5a97b -> e633f0b9df --- en_US.ISO8859-1/books/handbook/ports/chapter.xml | 1831 ++++++++++++++++++++++ website/data/ja/news/news.toml | 8 + 2 files changed, 1839 insertions(+) diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.xml b/en_US.ISO8859-1/books/handbook/ports/chapter.xml new file mode 100644 index 0000000000..110d47f3b6 --- /dev/null +++ b/en_US.ISO8859-1/books/handbook/ports/chapter.xml @@ -0,0 +1,1831 @@ + + + + + Installing Applications: Packages and Ports + + + Synopsis + + ports + packages + &os; is bundled with a rich collection of system tools as + part of the base system. In addition, &os; provides two + complementary technologies for installing third-party software: + the &os; Ports Collection, for installing from source, and + packages, for installing from pre-built binaries. Either + method may be used to install software from local media or + from the network. + + After reading this chapter, you will know: + + + + The difference between binary packages and ports. + + + + How to find third-party software that has been ported + to &os;. + + + + How to manage binary packages using + pkg. + + + + How to build third-party software from source using the + Ports Collection. + + + + How to find the files installed with the application + for post-installation configuration. + + + + What to do if a software installation fails. + + + + + + Overview of Software Installation + + The typical steps for installing third-party software on a + &unix; system include: + + + + Find and download the software, which might be + distributed in source code format or as a binary. + + + + Unpack the software from its distribution format. This + is typically a tarball compressed with a program such as + &man.compress.1;, &man.gzip.1;, &man.bzip2.1; or + &man.xz.1;. + + + + Locate the documentation in + INSTALL, README + or some file in a doc/ subdirectory and + read up on how to install the software. + + + + If the software was distributed in source format, + compile it. This may involve editing a + Makefile or running a + configure script. + + + + Test and install the software. + + + + A &os; port is a collection of files + designed to automate + the process of compiling an application from source code. The + files that comprise a port contain all the necessary information + to automatically download, extract, patch, compile, and install + the application. + + If the software has not already been adapted and tested + on &os;, the source code might need editing in + order for it to install and run properly. + + However, over &os.numports; + third-party applications have already been ported to &os;. When + feasible, these applications are made available for download as + pre-compiled packages. + + Packages + can be manipulated with the &os; package management + commands. + + Both packages and ports understand dependencies. If a + package or port is used to install an application and a + dependent library is not already installed, the library will + automatically be installed first. + + A &os; package contains pre-compiled copies of all the + commands for an application, as well as any configuration files + and documentation. A package can be manipulated with the + &man.pkg.8; commands, such as + pkg install. + + While the two technologies are similar, packages and + ports each have their own strengths. Select the technology that + meets your requirements for installing a particular + application. + + + Package Benefits + + + A compressed package tarball is typically smaller than + the compressed tarball containing the source code for the + application. + + + + Packages do not require compilation time. For large + applications, such as Mozilla, + KDE, or + GNOME, this can be important + on a slow system. + + + + Packages do not require any understanding of the process + involved in compiling software on &os;. + + + + + Port Benefits + + + Packages are normally compiled with conservative + options because they have to run on the maximum number of + systems. By compiling from the port, one can change the + compilation options. + + + + Some applications have compile-time options relating to + which features are installed. For example, + Apache can be configured with a + wide variety of different built-in options. + + In some cases, multiple packages will exist for the same + application to specify certain settings. For example, + Ghostscript is available as a + ghostscript package and a + ghostscript-nox11 package, depending on + whether or not Xorg is installed. + Creating multiple packages rapidly becomes impossible if an + application has more than one or two different compile-time + options. + + + + The licensing conditions of some software forbid binary + distribution. Such software must be distributed as source + code which must be compiled by the end-user. + + + + Some people do not trust binary distributions or prefer + to read through source code in order to look for potential + problems. + + + + Source code is needed in + order to apply custom patches. + + + + To keep track of updated ports, subscribe to the + &a.ports; and the &a.ports-bugs;. + + + Before installing any application, check + for security issues related to the application or type + pkg audit -F to check all installed + applications for known vulnerabilities. + + + The remainder of this chapter explains how to use packages + and ports to install and manage third-party software on + &os;. + + + + Finding Software + + &os;'s list of available applications is growing all the + time. There are a number of ways to find software to + install: + + + + The &os; web site maintains an up-to-date searchable + list of all the available applications, at https://www.FreeBSD.org/ports/. + The ports can be searched by application name or by + software category. + + + + FreshPorts + + Dan Langille maintains FreshPorts.org + which provides a comprehensive search utility and also + tracks changes to the applications in the Ports Collection. + Registered users can create a customized watch list in order + to receive an automated email when their watched ports are + updated. + + + + SourceForge + + If finding a particular application becomes challenging, + try searching a site like SourceForge.net + or GitHub.com then + check back at the &os; site + to see if the application has been ported. + + + + + pkg + search + + + To search the binary package + repository for an application: + + &prompt.root; pkg search subversion +git-subversion-1.9.2 +java-subversion-1.8.8_2 +p5-subversion-1.8.8_2 +py27-hgsubversion-1.6 +py27-subversion-1.8.8_2 +ruby-subversion-1.8.8_2 +subversion-1.8.8_2 +subversion-book-4515 +subversion-static-1.8.8_2 +subversion16-1.6.23_4 +subversion17-1.7.16_2 + + Package names include the version number and, in the + case of ports based on python, the version number of the + version of python the package was built with. Some ports + also have multiple versions available. In the case of + Subversion, there are different + versions available, as well as different compile options. + In this case, the statically linked version of + Subversion. When indicating + which package to install, it is best to specify the + application by the port origin, which is the path in the + ports tree. Repeat the pkg search with + to list the origin of each + package: + + &prompt.root; pkg search -o subversion +devel/git-subversion +java/java-subversion +devel/p5-subversion +devel/py-hgsubversion +devel/py-subversion +devel/ruby-subversion +devel/subversion16 +devel/subversion17 +devel/subversion +devel/subversion-book +devel/subversion-static + + Searching by shell globs, regular expressions, exact + match, by description, or any other field in the repository + database is also supported by pkg search. + After installing ports-mgmt/pkg or + ports-mgmt/pkg-devel, see + &man.pkg-search.8; for more details. + + + + If the Ports Collection is already installed, there are + several methods to query the local version of the ports + tree. To find out which category a port is in, type + whereis file, + where file is the program to be + installed: + + &prompt.root; whereis lsof +lsof: /usr/ports/sysutils/lsof + + Alternately, an &man.echo.1; statement can be + used: + + &prompt.root; echo /usr/ports/*/*lsof* +/usr/ports/sysutils/lsof + + Note that this will also return any matched files + downloaded into the + /usr/ports/distfiles directory. + + + + Another way to find software is by using the Ports + Collection's built-in search mechanism. To use the search + feature, cd to + /usr/ports then run make + search name=program-name where + program-name is the name of the + software. For example, to search for + lsof: + + &prompt.root; cd /usr/ports +&prompt.root; make search name=lsof +Port: lsof-4.88.d,8 +Path: /usr/ports/sysutils/lsof +Info: Lists information about open files (similar to fstat(1)) +Maint: ler@lerctr.org +Index: sysutils +B-deps: +R-deps: + + + The built-in search mechanism uses a file + of index information. If a message indicates that the + INDEX is required, run + make fetchindex to download the current + index file. With the INDEX present, + make search will be able to perform the + requested search. + + + The Path: line indicates where to find + the port. + + To receive less information, use the + quicksearch feature: + + &prompt.root; cd /usr/ports +&prompt.root; make quicksearch name=lsof +Port: lsof-4.88.d,8 +Path: /usr/ports/sysutils/lsof +Info: Lists information about open files (similar to fstat(1)) + + For more in-depth searching, use + make search + key=string or + make quicksearch + key=string, where + string is some text to search + for. The text can be in comments, descriptions, or + dependencies in order to find ports which relate to a + particular subject when the name of the program is + unknown. + + When using search or + quicksearch, the search string + is case-insensitive. Searching for LSOF will + yield the same results as searching for + lsof. + + + + + + Using <application>pkg</application> for Binary Package + Management + + pkg is the next generation + replacement for the traditional &os; package management tools, + offering many features that make dealing with binary packages + faster and easier. + + For sites wishing to only use prebuilt binary packages + from the &os; mirrors, managing packages with + pkg can be sufficient. + + However, for those sites building from source or using their + own repositories, a separate port management tool + will be needed. + + Since pkg only works with + binary packages, it + is not a replacement for such tools. Those tools can be + used to install software from both binary packages + and the Ports Collection, while + pkg installs only binary + packages. + + + Getting Started with + <application>pkg</application> + + &os; includes a bootstrap utility which can be used to + download and install pkg + and its manual pages. This utility is designed to work + with versions of &os; starting with + 10.X. + + + Not all &os; versions and architectures + support this bootstrap process. The current list is at + . + For other cases, + pkg must instead be installed + from the Ports Collection or as a binary package. + + + + To bootstrap the system, run: + + &prompt.root; /usr/sbin/pkg + + You must have a working Internet connection for the + bootstrap process to succeed. + + Otherwise, to install the port, run: + + &prompt.root; cd /usr/ports/ports-mgmt/pkg +&prompt.root; make +&prompt.root; make install clean + + When upgrading an existing system that originally used the + older pkg_* tools, the database must be converted to the + new format, so that the new tools are aware of the already + installed packages. Once pkg has + been installed, the + package database must be converted from the traditional format + to the new format by running this command: + + &prompt.root; pkg2ng + + This step is not required for new installations that + do not yet have any third-party software + installed. + + + This step is not reversible. Once the package database + has been converted to the pkg + format, the traditional pkg_* tools + should no longer be used. + + + + The package database conversion may emit errors as the + contents are converted to the new version. Generally, these + errors can be safely ignored. However, a list of + software that was not successfully converted + is shown after pkg2ng finishes. + These applications must be manually reinstalled. + + + To ensure that the Ports Collection registers + new software with pkg instead of + the traditional packages database, &os; versions earlier than + 10.X require this line in + /etc/make.conf: + + WITH_PKGNG= yes + + By default, pkg uses the + binary packages from the &os; + package mirrors (the repository). + For information about building a custom + package repository, see + . + + Additional pkg configuration + options are described in &man.pkg.conf.5;. + + Usage information for pkg is + available in the &man.pkg.8; manual page or by running + pkg without additional arguments. + + Each pkg command argument is + documented in a command-specific manual page. To read the + manual page for pkg install, for example, + run either of these commands: + + &prompt.root; pkg help install + + &prompt.root; man pkg-install + + The rest of this section demonstrates common binary + package management tasks which can be performed using + pkg. Each demonstrated command + provides many switches to customize its use. Refer to a + command's help or man page for details and more + examples. + + + + Quarterly and Latest Ports Branches + + The Quarterly branch provides users + with a more predictable and stable experience for port and + package installation and upgrades. This is done essentially + by only allowing non-feature updates. Quarterly branches aim + to receive security fixes (that may be version updates, or + backports of commits), bug fixes and ports compliance or + framework changes. The Quarterly branch is cut from HEAD at + the beginning of every (yearly) quarter in January, April, + July, and October. Branches are named according to the year + (YYYY) and quarter (Q1-4) they are created in. For example, + the quarterly branch created in January 2016, is named 2016Q1. + And the Latest branch provides the latest + versions of the packages to the users. + + To switch from quarterly to latest run the following + commands: + + &prompt.root; cp /etc/pkg/FreeBSD.conf /usr/local/etc/pkg/repos/FreeBSD.conf + + Edit the file + /usr/local/etc/pkg/repos/FreeBSD.conf + and change the string quarterly to + latest in the url: + line. + + The result should be similar to the following: + + FreeBSD: { + url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest", + mirror_type: "srv", + signature_type: "fingerprints", + fingerprints: "/usr/share/keys/pkg", + enabled: yes +} + + And finally run this command to update from the new + (latest) repository metadata. + + &prompt.root; pkg update -f + + + + + Obtaining Information About Installed Packages + + Information about the packages installed on a system + can be viewed by running pkg info which, + when run without any switches, will list the package version + for either all installed packages or the specified + package. + + For example, to see which version of + pkg is installed, run: + + &prompt.root; pkg info pkg +pkg-1.1.4_1 + + + + Installing and Removing Packages + + To install a binary package use the following command, + where packagename is the name of + the package to install: + + &prompt.root; pkg install packagename + + This command uses repository data to determine which + version of the software to install and if it has any + uninstalled dependencies. For example, to install + curl: + + &prompt.root; pkg install curl +Updating repository catalogue +/usr/local/tmp/All/curl-7.31.0_1.txz 100% of 1181 kB 1380 kBps 00m01s + +/usr/local/tmp/All/ca_root_nss-3.15.1_1.txz 100% of 288 kB 1700 kBps 00m00s + +Updating repository catalogue +The following 2 packages will be installed: + + Installing ca_root_nss: 3.15.1_1 + Installing curl: 7.31.0_1 + +The installation will require 3 MB more space + +0 B to be downloaded + +Proceed with installing packages [y/N]: y +Checking integrity... done +[1/2] Installing ca_root_nss-3.15.1_1... done +[2/2] Installing curl-7.31.0_1... done +Cleaning up cache files...Done + + The new package and any additional packages that were + installed as dependencies can be seen in the installed + packages list: + + &prompt.root; pkg info +ca_root_nss-3.15.1_1 The root certificate bundle from the Mozilla Project +curl-7.31.0_1 Non-interactive tool to get files from FTP, GOPHER, HTTP(S) servers +pkg-1.1.4_6 New generation package manager + + Packages that are no longer needed can be removed with + pkg delete. For example: + + &prompt.root; pkg delete curl +The following packages will be deleted: + + curl-7.31.0_1 + +The deletion will free 3 MB + +Proceed with deleting packages [y/N]: y +[1/1] Deleting curl-7.31.0_1... done + + + + Upgrading Installed Packages + + Installed packages can be upgraded to their latest + versions by running: + + &prompt.root; pkg upgrade + + This command will compare the installed versions with + those available in the repository catalogue and upgrade them + from the repository. + + + + Auditing Installed Packages + + Software vulnerabilities are regularly discovered + in third-party applications. To address this, + pkg includes a built-in auditing + mechanism. To determine if there are any known + vulnerabilities for the software installed on the system, + run: + + &prompt.root; pkg audit -F + + + + Automatically Removing Unused Packages + + Removing a package may leave behind dependencies which + are no longer required. Unneeded packages that were installed + as dependencies (leaf packages) can be automatically detected + and removed using: + + &prompt.root; pkg autoremove +Packages to be autoremoved: + ca_root_nss-3.15.1_1 + +The autoremoval will free 723 kB + +Proceed with autoremoval of packages [y/N]: y +Deinstalling ca_root_nss-3.15.1_1... done + + Packages installed as dependencies are + called automatic packages. Non-automatic + packages, i.e the packages that were explicity installed not + as a dependency to another package, can be listed + using: + + &prompt.root; pkg prime-list +nginx +openvpn +sudo + + pkg prime-list is an alias command + declared in /usr/local/etc/pkg.conf. + There are many others that can be used to query the package + database of the system. For instance, command + pkg prime-origins can be used to get the + origin port directory of the list mentioned above: + + &prompt.root; pkg prime-origins +www/nginx +security/openvpn +security/sudo + + This list can be used to rebuild all packages + installed on a system using build tools such as + ports-mgmt/poudriere or + ports-mgmt/synth. + + Marking an installed package as automatic can be + done using: + + &prompt.root; pkg set -A 1 devel/cmake + + Once a package is a leaf package and is marked + as automatic, it gets selected by + pkg autoremove. + + Marking an installed package as not + automatic can be done using: + + &prompt.root; pkg set -A 0 devel/cmake + + + + + Restoring the Package Database + + Unlike the traditional package management system, + pkg includes its own package + database backup mechanism. This functionality is enabled by + default. + + + To disable the periodic script from backing up the + package database, set + daily_backup_pkgdb_enable="NO" in + &man.periodic.conf.5;. + + + To restore the contents of a previous package database + backup, run the following command replacing + /path/to/pkg.sql with the location + of the backup: + + &prompt.root; pkg backup -r /path/to/pkg.sql + + + If restoring a backup taken by the periodic script, + it must be decompressed prior to being restored. + + + To run a manual backup of the + pkg database, run the following + command, replacing /path/to/pkg.sql + with a suitable file name and location: + + &prompt.root; pkg backup -d /path/to/pkg.sql + + + + Removing Stale Packages + + By default, pkg stores + binary packages in a cache directory defined by + PKG_CACHEDIR in &man.pkg.conf.5;. Only copies + of the latest installed packages are kept. Older versions of + pkg kept all previous packages. To + remove these outdated binary packages, run: + + &prompt.root; pkg clean + + The entire cache may be cleared by running: + + &prompt.root; pkg clean -a + + + + Modifying Package Metadata + + Software within the &os; Ports Collection can + undergo major version number changes. To address this, + pkg has a built-in command to + update package origins. This can be useful, for example, if + lang/php5 is renamed to + lang/php53 so that + lang/php5 can now + represent version 5.4. + + To change the package origin for the above example, + run: + + &prompt.root; pkg set -o lang/php5:lang/php53 + + As another example, to update + lang/ruby18 to + lang/ruby19, run: + + &prompt.root; pkg set -o lang/ruby18:lang/ruby19 + + As a final example, to change the origin of the + libglut shared libraries from + graphics/libglut to + graphics/freeglut, run: + + &prompt.root; pkg set -o graphics/libglut:graphics/freeglut + + + When changing package origins, it is important to + reinstall packages that are dependent on the package with + the modified origin. To force a reinstallation of dependent + packages, run: + + &prompt.root; pkg install -Rf graphics/freeglut + + + + + + Using the Ports Collection + + The Ports Collection is a set of + Makefiles, patches, and description files. + Each set of these files is used to compile and install an + individual application on &os;, and is called a + port. + + By default, the Ports Collection itself is stored as a + subdirectory of /usr/ports. + + 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 &os;, use one of the + following methods to install it: + + + Portsnap Method + + The base system of &os; includes + Portsnap. This is a fast and + user-friendly tool for retrieving the Ports Collection and + is the recommended choice for most users not running + &os.current;. This utility + connects to a &os; site, verifies the secure key, and + downloads a new copy of the Ports Collection. The key is used + to verify the integrity of all downloaded files. + + + To download a compressed snapshot of the Ports + Collection into + /var/db/portsnap: + + &prompt.root; portsnap fetch + + + + When running Portsnap for the + first time, extract the snapshot into + /usr/ports: + + &prompt.root; portsnap extract + + + + After the first use of + Portsnap has been completed as + shown above, /usr/ports can be updated + as needed by running: + + &prompt.root; portsnap fetch +&prompt.root; portsnap update + + When using fetch, the + extract or the update + operation may be run consecutively, like so: + + &prompt.root; portsnap fetch update + + + + + Subversion Method + + If more control over the ports tree is needed or if local + changes need to be maintained, or if running &os.current;, + Subversion can be used to obtain + the Ports Collection. Refer to the + Subversion Primer for a detailed description of + Subversion. + + + Subversion must be installed + before it can be used to check out the ports tree. If a + copy of the ports tree is already present, install + Subversion like this: + + &prompt.root; cd /usr/ports/devel/subversion +&prompt.root; make install clean + + If the ports tree is not available, or + pkg is being used to manage + packages, Subversion can be + installed as a package: + + &prompt.root; pkg install subversion + + + + + Check out a copy of the ports tree: + + &prompt.root; svn checkout https://svn.FreeBSD.org/ports/head /usr/ports + + + + As needed, update /usr/ports after + the initial Subversion + checkout: + + &prompt.root; svn update /usr/ports + + + + 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 &os; how to compile and install that program, + called a ports skeleton. Each port + skeleton includes these files and directories: + + + + Makefile: contains statements that + specify how the application should be compiled and where + its components should be installed. + + + + distinfo: contains the names and + checksums of the files that must be downloaded to build the + port. + + + + files/: this directory contains + any patches needed for the program to compile and install + on &os;. This directory may also contain other files used + to build the port. + + + + pkg-descr: provides a more detailed + description of the program. + *** 892 LINES SKIPPED *** From owner-dev-commits-doc-all@freebsd.org Sat May 1 16:55:06 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 2534D6319D8 for ; Sat, 1 May 2021 16:55:06 +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 4FXb2L0XBJz4hjs; Sat, 1 May 2021 16:55:06 +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 DE76E2BF1; Sat, 1 May 2021 16:55:05 +0000 (UTC) (envelope-from mat@freebsd.org) Received: from aching.in.mat.cc (unknown [IPv6:2a01:678:42:0:bdf4:2e83:8ff:e8ad]) (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 B1316942D80; Sat, 1 May 2021 16:55:04 +0000 (UTC) Date: Sat, 1 May 2021 18:55:03 +0200 From: Mathieu Arnold To: Ryusuke SUZUKI Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Subject: Re: git: fe72008903 - main - 989d921f5d -> f847aaeb60 Message-ID: <20210501165503.plbut2edsne5pzb2@aching.in.mat.cc> References: <202104271639.13RGdkSo011434@gitrepo.freebsd.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="hhf4adqmmacj3u2q" Content-Disposition: inline In-Reply-To: <202104271639.13RGdkSo011434@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: Sat, 01 May 2021 16:55:06 -0000 --hhf4adqmmacj3u2q Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Apr 27, 2021 at 04:39:46PM +0000, Ryusuke SUZUKI wrote: > The branch main has been updated by ryusuke: >=20 > URL: https://cgit.FreeBSD.org/doc/commit/?id=3Dfe720089030f8ae04e591261c4= 3e1bb0ac0b3e1d >=20 > commit fe720089030f8ae04e591261c43e1bb0ac0b3e1d > Author: Ryusuke SUZUKI > AuthorDate: 2021-04-27 16:39:23 +0000 > Commit: Ryusuke SUZUKI > CommitDate: 2021-04-27 16:39:23 +0000 >=20 > 989d921f5d -> f847aaeb60 I was wondering, would it be possible for you to add a prefix To your translations commits, something like `ja: 989d921f5d -> f847aaeb60`, or=20 `en->ja: 989d921f5d -> f847aaeb60`, so that we can tell from the commit message what is actually going on? --=20 Mathieu Arnold --hhf4adqmmacj3u2q Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEVhwchfRfuV0unqO5KesJApEdfgIFAmCNh+JfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDU2 MUMxQzg1RjQ1RkI5NUQyRTlFQTNCOTI5RUIwOTAyOTExRDdFMDIACgkQKesJApEd fgK0UQ//RwleHdNQvlfubohoprgl9guQHbQ0L5JV8ACDP1CcTLhvvIsg158e4DoB 2CImSI50ngOZ3fxo7ppRPQ3z6apI4EuvBqMoX1X2U76LLaDv3PLrQPY2U14nbp/3 d7UVxQ8GH0/Vz2zTlAJyF4MULQOc15oygboZTK/tfi+FxZjfDzc5pIxI/KTX96Nm AalTwC7ItNXbYyxmB/C9Cu+t0iCrt13LyMMa2A1HzTjsygej3I7gUgsgrBqZuyg5 BRA9IN+haoF/2a921TpUvLZQoxh0GJ/Ad3IPQrV3+gPIUtRvYzqY3z5JtLufFwcE naxdND6klzRFRgPuMsxiTCmyZ++bDufHGpesYcqdW/KVEfdnqbiMdTQ4vWkWXHg5 n8qsYUstaFngJ5QcXxwhTuoNM6GeU6DjT/MtKtE+E2AHd/1cnfabYd+RN4uZBRfK UlfyhSuETQznbQFv+PlGY3ZugOw3iv2GfxVJUxg4bNPKN81glzxnrk/ee8JCCpVw XIt6L2xTHt4gM/SyaSkvG+EnmrG6Z/Gf7sK+i6XDhsWPfVjcDW2ZGDNXj6Y1agPn xqYMqJQFKRdcnGFqOOFyn9gqYUEyfSnFmaRdyxOUQHTHPUDVo4RHWf3p5twxBSPK u4TMwt+S9MVF0KGJXXJnz6Tz6H/uCmcuq6wXNb4XJEy464IxI10= =DmIX -----END PGP SIGNATURE----- --hhf4adqmmacj3u2q-- From owner-dev-commits-doc-all@freebsd.org Sat May 1 16:57:27 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 D0959631C7E for ; Sat, 1 May 2021 16:57:27 +0000 (UTC) (envelope-from carlavilla@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 4FXb535Xrxz4j9d; Sat, 1 May 2021 16:57:27 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-ej1-f42.google.com (mail-ej1-f42.google.com [209.85.218.42]) (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 91A1C18EC; Sat, 1 May 2021 16:57:27 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-ej1-f42.google.com with SMTP id y7so1676001ejj.9; Sat, 01 May 2021 09:57:27 -0700 (PDT) X-Gm-Message-State: AOAM530+vz+9lTwZmGDwn6iLgmNZica8zkndUsPgSIxIiZnRR4BBm2XX Vg8O6elU4WMBDwqr7YeSNCZP058fvdSCnc440VQ= X-Google-Smtp-Source: ABdhPJyE15psxuHJKVx+lI+67045xioQN3qwa7P74Tic4+fxu4U3eRGBA+vcg2AJ+7s4lt65U1D35vl1I4jdClsMLEs= X-Received: by 2002:a17:906:2c55:: with SMTP id f21mr9840248ejh.41.1619888245906; Sat, 01 May 2021 09:57:25 -0700 (PDT) MIME-Version: 1.0 References: <202105011654.141GsZUx044665@gitrepo.freebsd.org> In-Reply-To: <202105011654.141GsZUx044665@gitrepo.freebsd.org> From: Sergio Carlavilla Date: Sat, 1 May 2021 18:57:14 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: git: ff3df39394 - main - a67af5a97b -> e633f0b9df To: Ryusuke SUZUKI Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Content-Type: text/plain; charset="UTF-8" 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: Sat, 01 May 2021 16:57:27 -0000 ,HOn Sat, 1 May 2021 at 18:54, Ryusuke SUZUKI wrote: > > The branch main has been updated by ryusuke: > > URL: https://cgit.FreeBSD.org/doc/commit/?id=ff3df39394cc4faf4300a4b19954f93a0fd46868 > > commit ff3df39394cc4faf4300a4b19954f93a0fd46868 > Author: Ryusuke SUZUKI > AuthorDate: 2021-05-01 16:51:45 +0000 > Commit: Ryusuke SUZUKI > CommitDate: 2021-05-01 16:51:45 +0000 > > a67af5a97b -> e633f0b9df > --- > en_US.ISO8859-1/books/handbook/ports/chapter.xml | 1831 ++++++++++++++++++++++ > website/data/ja/news/news.toml | 8 + > 2 files changed, 1839 insertions(+) > > diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.xml b/en_US.ISO8859-1/books/handbook/ports/chapter.xml > new file mode 100644 > index 0000000000..110d47f3b6 > --- /dev/null > +++ b/en_US.ISO8859-1/books/handbook/ports/chapter.xml > @@ -0,0 +1,1831 @@ > + > + > + + xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" > + xml:id="ports"> > + > + Installing Applications: Packages and Ports > + > + > + Synopsis > + > + ports > + packages > + &os; is bundled with a rich collection of system tools as > + part of the base system. In addition, &os; provides two > + complementary technologies for installing third-party software: > + the &os; Ports Collection, for installing from source, and > + packages, for installing from pre-built binaries. Either > + method may be used to install software from local media or > + from the network. > + > + After reading this chapter, you will know: > + > + > + > + The difference between binary packages and ports. > + > + > + > + How to find third-party software that has been ported > + to &os;. > + > + > + > + How to manage binary packages using > + pkg. > + > + > + > + How to build third-party software from source using the > + Ports Collection. > + > + > + > + How to find the files installed with the application > + for post-installation configuration. > + > + > + > + What to do if a software installation fails. > + > + > + > + > + > + Overview of Software Installation > + > + The typical steps for installing third-party software on a > + &unix; system include: > + > + > + > + Find and download the software, which might be > + distributed in source code format or as a binary. > + > + > + > + Unpack the software from its distribution format. This > + is typically a tarball compressed with a program such as > + &man.compress.1;, &man.gzip.1;, &man.bzip2.1; or > + &man.xz.1;. > + > + > + > + Locate the documentation in > + INSTALL, README > + or some file in a doc/ subdirectory and > + read up on how to install the software. > + > + > + > + If the software was distributed in source format, > + compile it. This may involve editing a > + Makefile or running a > + configure script. > + > + > + > + Test and install the software. > + > + > + > + A &os; port is a collection of files > + designed to automate > + the process of compiling an application from source code. The > + files that comprise a port contain all the necessary information > + to automatically download, extract, patch, compile, and install > + the application. > + > + If the software has not already been adapted and tested > + on &os;, the source code might need editing in > + order for it to install and run properly. > + > + However, over + xlink:href="&url.base;/ports/index.html">&os.numports; > + third-party applications have already been ported to &os;. When > + feasible, these applications are made available for download as > + pre-compiled packages. > + > + Packages > + can be manipulated with the &os; package management > + commands. > + > + Both packages and ports understand dependencies. If a > + package or port is used to install an application and a > + dependent library is not already installed, the library will > + automatically be installed first. > + > + A &os; package contains pre-compiled copies of all the > + commands for an application, as well as any configuration files > + and documentation. A package can be manipulated with the > + &man.pkg.8; commands, such as > + pkg install. > + > + While the two technologies are similar, packages and > + ports each have their own strengths. Select the technology that > + meets your requirements for installing a particular > + application. > + > + > + Package Benefits > + > + > + A compressed package tarball is typically smaller than > + the compressed tarball containing the source code for the > + application. > + > + > + > + Packages do not require compilation time. For large > + applications, such as Mozilla, > + KDE, or > + GNOME, this can be important > + on a slow system. > + > + > + > + Packages do not require any understanding of the process > + involved in compiling software on &os;. > + > + > + > + > + Port Benefits > + > + > + Packages are normally compiled with conservative > + options because they have to run on the maximum number of > + systems. By compiling from the port, one can change the > + compilation options. > + > + > + > + Some applications have compile-time options relating to > + which features are installed. For example, > + Apache can be configured with a > + wide variety of different built-in options. > + > + In some cases, multiple packages will exist for the same > + application to specify certain settings. For example, > + Ghostscript is available as a > + ghostscript package and a > + ghostscript-nox11 package, depending on > + whether or not Xorg is installed. > + Creating multiple packages rapidly becomes impossible if an > + application has more than one or two different compile-time > + options. > + > + > + > + The licensing conditions of some software forbid binary > + distribution. Such software must be distributed as source > + code which must be compiled by the end-user. > + > + > + > + Some people do not trust binary distributions or prefer > + to read through source code in order to look for potential > + problems. > + > + > + > + Source code is needed in > + order to apply custom patches. > + > + > + > + To keep track of updated ports, subscribe to the > + &a.ports; and the &a.ports-bugs;. > + > + > + Before installing any application, check + xlink:href="https://vuxml.freebsd.org/"> > + for security issues related to the application or type > + pkg audit -F to check all installed > + applications for known vulnerabilities. > + > + > + The remainder of this chapter explains how to use packages > + and ports to install and manage third-party software on > + &os;. > + > + > + > + Finding Software > + > + &os;'s list of available applications is growing all the > + time. There are a number of ways to find software to > + install: > + > + > + > + The &os; web site maintains an up-to-date searchable > + list of all the available applications, at + xlink:href="&url.base;/ports/index.html">https://www.FreeBSD.org/ports/. > + The ports can be searched by application name or by > + software category. > + > + > + > + FreshPorts > + > + Dan Langille maintains + xlink:href="http://www.FreshPorts.org/">FreshPorts.org > + which provides a comprehensive search utility and also > + tracks changes to the applications in the Ports Collection. > + Registered users can create a customized watch list in order > + to receive an automated email when their watched ports are > + updated. > + > + > + > + SourceForge > + > + If finding a particular application becomes challenging, > + try searching a site like + xlink:href="http://www.sourceforge.net/">SourceForge.net > + or + xlink:href="http://www.github.com/">GitHub.com then > + check back at the + xlink:href="&url.base;/ports/index.html">&os; site > + to see if the application has been ported. > + > + > + > + > + pkg > + search > + > + > + To search the binary package > + repository for an application: > + > + &prompt.root; pkg search subversion > +git-subversion-1.9.2 > +java-subversion-1.8.8_2 > +p5-subversion-1.8.8_2 > +py27-hgsubversion-1.6 > +py27-subversion-1.8.8_2 > +ruby-subversion-1.8.8_2 > +subversion-1.8.8_2 > +subversion-book-4515 > +subversion-static-1.8.8_2 > +subversion16-1.6.23_4 > +subversion17-1.7.16_2 > + > + Package names include the version number and, in the > + case of ports based on python, the version number of the > + version of python the package was built with. Some ports > + also have multiple versions available. In the case of > + Subversion, there are different > + versions available, as well as different compile options. > + In this case, the statically linked version of > + Subversion. When indicating > + which package to install, it is best to specify the > + application by the port origin, which is the path in the > + ports tree. Repeat the pkg search with > + to list the origin of each > + package: > + > + &prompt.root; pkg search -o subversion > +devel/git-subversion > +java/java-subversion > +devel/p5-subversion > +devel/py-hgsubversion > +devel/py-subversion > +devel/ruby-subversion > +devel/subversion16 > +devel/subversion17 > +devel/subversion > +devel/subversion-book > +devel/subversion-static > + > + Searching by shell globs, regular expressions, exact > + match, by description, or any other field in the repository > + database is also supported by pkg search. > + After installing ports-mgmt/pkg or > + ports-mgmt/pkg-devel, see > + &man.pkg-search.8; for more details. > + > + > + > + If the Ports Collection is already installed, there are > + several methods to query the local version of the ports > + tree. To find out which category a port is in, type > + whereis file, > + where file is the program to be > + installed: > + > + &prompt.root; whereis lsof > +lsof: /usr/ports/sysutils/lsof > + > + Alternately, an &man.echo.1; statement can be > + used: > + > + &prompt.root; echo /usr/ports/*/*lsof* > +/usr/ports/sysutils/lsof > + > + Note that this will also return any matched files > + downloaded into the > + /usr/ports/distfiles directory. > + > + > + > + Another way to find software is by using the Ports > + Collection's built-in search mechanism. To use the search > + feature, cd to > + /usr/ports then run make > + search name=program-name where > + program-name is the name of the > + software. For example, to search for > + lsof: > + > + &prompt.root; cd /usr/ports > +&prompt.root; make search name=lsof > +Port: lsof-4.88.d,8 > +Path: /usr/ports/sysutils/lsof > +Info: Lists information about open files (similar to fstat(1)) > +Maint: ler@lerctr.org > +Index: sysutils > +B-deps: > +R-deps: > + > + > + The built-in search mechanism uses a file > + of index information. If a message indicates that the > + INDEX is required, run > + make fetchindex to download the current > + index file. With the INDEX present, > + make search will be able to perform the > + requested search. > + > + > + The Path: line indicates where to find > + the port. > + > + To receive less information, use the > + quicksearch feature: > + > + &prompt.root; cd /usr/ports > +&prompt.root; make quicksearch name=lsof > +Port: lsof-4.88.d,8 > +Path: /usr/ports/sysutils/lsof > +Info: Lists information about open files (similar to fstat(1)) > + > + For more in-depth searching, use > + make search > + key=string or > + make quicksearch > + key=string, where > + string is some text to search > + for. The text can be in comments, descriptions, or > + dependencies in order to find ports which relate to a > + particular subject when the name of the program is > + unknown. > + > + When using search or > + quicksearch, the search string > + is case-insensitive. Searching for LSOF will > + yield the same results as searching for > + lsof. > + > + > + > + > + > + Using <application>pkg</application> for Binary Package > + Management > + > + pkg is the next generation > + replacement for the traditional &os; package management tools, > + offering many features that make dealing with binary packages > + faster and easier. > + > + For sites wishing to only use prebuilt binary packages > + from the &os; mirrors, managing packages with > + pkg can be sufficient. > + > + However, for those sites building from source or using their > + own repositories, a separate + linkend="ports-upgrading-tools">port management tool > + will be needed. > + > + Since pkg only works with > + binary packages, it > + is not a replacement for such tools. Those tools can be > + used to install software from both binary packages > + and the Ports Collection, while > + pkg installs only binary > + packages. > + > + > + Getting Started with > + <application>pkg</application> > + > + &os; includes a bootstrap utility which can be used to > + download and install pkg > + and its manual pages. This utility is designed to work > + with versions of &os; starting with > + 10.X. > + > + > + Not all &os; versions and architectures > + support this bootstrap process. The current list is at > + . > + For other cases, > + pkg must instead be installed > + from the Ports Collection or as a binary package. > + > + > + > + To bootstrap the system, run: > + > + &prompt.root; /usr/sbin/pkg > + > + You must have a working Internet connection for the > + bootstrap process to succeed. > + > + Otherwise, to install the port, run: > + > + &prompt.root; cd /usr/ports/ports-mgmt/pkg > +&prompt.root; make > +&prompt.root; make install clean > + > + When upgrading an existing system that originally used the > + older pkg_* tools, the database must be converted to the > + new format, so that the new tools are aware of the already > + installed packages. Once pkg has > + been installed, the > + package database must be converted from the traditional format > + to the new format by running this command: > + > + &prompt.root; pkg2ng > + > + This step is not required for new installations that > + do not yet have any third-party software > + installed. > + > + > + This step is not reversible. Once the package database > + has been converted to the pkg > + format, the traditional pkg_* tools > + should no longer be used. > + > + > + > + The package database conversion may emit errors as the > + contents are converted to the new version. Generally, these > + errors can be safely ignored. However, a list of > + software that was not successfully converted > + is shown after pkg2ng finishes. > + These applications must be manually reinstalled. > + > + > + To ensure that the Ports Collection registers > + new software with pkg instead of > + the traditional packages database, &os; versions earlier than > + 10.X require this line in > + /etc/make.conf: > + > + WITH_PKGNG= yes > + > + By default, pkg uses the > + binary packages from the &os; > + package mirrors (the repository). > + For information about building a custom > + package repository, see > + . > + > + Additional pkg configuration > + options are described in &man.pkg.conf.5;. > + > + Usage information for pkg is > + available in the &man.pkg.8; manual page or by running > + pkg without additional arguments. > + > + Each pkg command argument is > + documented in a command-specific manual page. To read the > + manual page for pkg install, for example, > + run either of these commands: > + > + &prompt.root; pkg help install > + > + &prompt.root; man pkg-install > + > + The rest of this section demonstrates common binary > + package management tasks which can be performed using > + pkg. Each demonstrated command > + provides many switches to customize its use. Refer to a > + command's help or man page for details and more > + examples. > + > + > + > + Quarterly and Latest Ports Branches > + > + The Quarterly branch provides users > + with a more predictable and stable experience for port and > + package installation and upgrades. This is done essentially > + by only allowing non-feature updates. Quarterly branches aim > + to receive security fixes (that may be version updates, or > + backports of commits), bug fixes and ports compliance or > + framework changes. The Quarterly branch is cut from HEAD at > + the beginning of every (yearly) quarter in January, April, > + July, and October. Branches are named according to the year > + (YYYY) and quarter (Q1-4) they are created in. For example, > + the quarterly branch created in January 2016, is named 2016Q1. > + And the Latest branch provides the latest > + versions of the packages to the users. > + > + To switch from quarterly to latest run the following > + commands: > + > + &prompt.root; cp /etc/pkg/FreeBSD.conf /usr/local/etc/pkg/repos/FreeBSD.conf > + > + Edit the file > + /usr/local/etc/pkg/repos/FreeBSD.conf > + and change the string quarterly to > + latest in the url: > + line. > + > + The result should be similar to the following: > + > + FreeBSD: { > + url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest", > + mirror_type: "srv", > + signature_type: "fingerprints", > + fingerprints: "/usr/share/keys/pkg", > + enabled: yes > +} > + > + And finally run this command to update from the new > + (latest) repository metadata. > + > + &prompt.root; pkg update -f > + > + > + > + > + Obtaining Information About Installed Packages > + > + Information about the packages installed on a system > + can be viewed by running pkg info which, > + when run without any switches, will list the package version > + for either all installed packages or the specified > + package. > + > + For example, to see which version of > + pkg is installed, run: > + > + &prompt.root; pkg info pkg > +pkg-1.1.4_1 > + > + > + > + Installing and Removing Packages > + > + To install a binary package use the following command, > + where packagename is the name of > + the package to install: > + > + &prompt.root; pkg install packagename > + > + This command uses repository data to determine which > + version of the software to install and if it has any > + uninstalled dependencies. For example, to install > + curl: > + > + &prompt.root; pkg install curl > +Updating repository catalogue > +/usr/local/tmp/All/curl-7.31.0_1.txz 100% of 1181 kB 1380 kBps 00m01s > + > +/usr/local/tmp/All/ca_root_nss-3.15.1_1.txz 100% of 288 kB 1700 kBps 00m00s > + > +Updating repository catalogue > +The following 2 packages will be installed: > + > + Installing ca_root_nss: 3.15.1_1 > + Installing curl: 7.31.0_1 > + > +The installation will require 3 MB more space > + > +0 B to be downloaded > + > +Proceed with installing packages [y/N]: y > +Checking integrity... done > +[1/2] Installing ca_root_nss-3.15.1_1... done > +[2/2] Installing curl-7.31.0_1... done > +Cleaning up cache files...Done > + > + The new package and any additional packages that were > + installed as dependencies can be seen in the installed > + packages list: > + > + &prompt.root; pkg info > +ca_root_nss-3.15.1_1 The root certificate bundle from the Mozilla Project > +curl-7.31.0_1 Non-interactive tool to get files from FTP, GOPHER, HTTP(S) servers > +pkg-1.1.4_6 New generation package manager > + > + Packages that are no longer needed can be removed with > + pkg delete. For example: > + > + &prompt.root; pkg delete curl > +The following packages will be deleted: > + > + curl-7.31.0_1 > + > +The deletion will free 3 MB > + > +Proceed with deleting packages [y/N]: y > +[1/1] Deleting curl-7.31.0_1... done > + > + > + > + Upgrading Installed Packages > + > + Installed packages can be upgraded to their latest > + versions by running: > + > + &prompt.root; pkg upgrade > + > + This command will compare the installed versions with > + those available in the repository catalogue and upgrade them > + from the repository. > + > + > + > + Auditing Installed Packages > + > + Software vulnerabilities are regularly discovered > + in third-party applications. To address this, > + pkg includes a built-in auditing > + mechanism. To determine if there are any known > + vulnerabilities for the software installed on the system, > + run: > + > + &prompt.root; pkg audit -F > + > + > + > + Automatically Removing Unused Packages > + > + Removing a package may leave behind dependencies which > + are no longer required. Unneeded packages that were installed > + as dependencies (leaf packages) can be automatically detected > + and removed using: > + > + &prompt.root; pkg autoremove > +Packages to be autoremoved: > + ca_root_nss-3.15.1_1 > + > +The autoremoval will free 723 kB > + > +Proceed with autoremoval of packages [y/N]: y > +Deinstalling ca_root_nss-3.15.1_1... done > + > + Packages installed as dependencies are > + called automatic packages. Non-automatic > + packages, i.e the packages that were explicity installed not > + as a dependency to another package, can be listed > + using: > + > + &prompt.root; pkg prime-list > +nginx > +openvpn > +sudo > + > + pkg prime-list is an alias command > + declared in /usr/local/etc/pkg.conf. > + There are many others that can be used to query the package > + database of the system. For instance, command > + pkg prime-origins can be used to get the > + origin port directory of the list mentioned above: > + > + &prompt.root; pkg prime-origins > +www/nginx > +security/openvpn > +security/sudo > + > + This list can be used to rebuild all packages > + installed on a system using build tools such as > + ports-mgmt/poudriere or > + ports-mgmt/synth. > + > + Marking an installed package as automatic can be > + done using: > + > + &prompt.root; pkg set -A 1 devel/cmake > + > + Once a package is a leaf package and is marked > + as automatic, it gets selected by > + pkg autoremove. > + > + Marking an installed package as not > + automatic can be done using: > + > + &prompt.root; pkg set -A 0 devel/cmake > + > + > + > + > + Restoring the Package Database > + > + Unlike the traditional package management system, > + pkg includes its own package > + database backup mechanism. This functionality is enabled by > + default. > + > + > + To disable the periodic script from backing up the > + package database, set > + daily_backup_pkgdb_enable="NO" in > + &man.periodic.conf.5;. > + > + > + To restore the contents of a previous package database > + backup, run the following command replacing > + /path/to/pkg.sql with the location > + of the backup: > + > + &prompt.root; pkg backup -r /path/to/pkg.sql > + > + > + If restoring a backup taken by the periodic script, > + it must be decompressed prior to being restored. > + > + > + To run a manual backup of the > + pkg database, run the following > + command, replacing /path/to/pkg.sql > + with a suitable file name and location: > + > + &prompt.root; pkg backup -d /path/to/pkg.sql > + > + > + > + Removing Stale Packages > + > + By default, pkg stores > + binary packages in a cache directory defined by > + PKG_CACHEDIR in &man.pkg.conf.5;. Only copies > + of the latest installed packages are kept. Older versions of > + pkg kept all previous packages. To > + remove these outdated binary packages, run: > + > + &prompt.root; pkg clean > + > + The entire cache may be cleared by running: > + > + &prompt.root; pkg clean -a > + > + > + > + Modifying Package Metadata > + > + Software within the &os; Ports Collection can > + undergo major version number changes. To address this, > + pkg has a built-in command to > + update package origins. This can be useful, for example, if > + lang/php5 is renamed to > + lang/php53 so that > + lang/php5 can now > + represent version 5.4. > + > + To change the package origin for the above example, > + run: > + > + &prompt.root; pkg set -o lang/php5:lang/php53 > + > + As another example, to update > + lang/ruby18 to > + lang/ruby19, run: > + > + &prompt.root; pkg set -o lang/ruby18:lang/ruby19 > + > + As a final example, to change the origin of the > + libglut shared libraries from > + graphics/libglut to > + graphics/freeglut, run: > + > + &prompt.root; pkg set -o graphics/libglut:graphics/freeglut > + > + > + When changing package origins, it is important to > + reinstall packages that are dependent on the package with > + the modified origin. To force a reinstallation of dependent > + packages, run: > + > + &prompt.root; pkg install -Rf graphics/freeglut > + > + > + > + > + > + Using the Ports Collection > + > + The Ports Collection is a set of > + Makefiles, patches, and description files. > + Each set of these files is used to compile and install an > + individual application on &os;, and is called a > + port. > + > + By default, the Ports Collection itself is stored as a > + subdirectory of /usr/ports. > + > + 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 &os;, use one of the > + following methods to install it: > + > + > + Portsnap Method > + > + The base system of &os; includes > + Portsnap. This is a fast and > + user-friendly tool for retrieving the Ports Collection and > + is the recommended choice for most users not running > + &os.current;. This utility > + connects to a &os; site, verifies the secure key, and > + downloads a new copy of the Ports Collection. The key is used > + to verify the integrity of all downloaded files. > + > + > + To download a compressed snapshot of the Ports > + Collection into > + /var/db/portsnap: > + > + &prompt.root; portsnap fetch > + > + > + > + When running Portsnap for the > + first time, extract the snapshot into > + /usr/ports: > + > + &prompt.root; portsnap extract > + > + > + > + After the first use of > + Portsnap has been completed as > + shown above, /usr/ports can be updated > + as needed by running: > + > + &prompt.root; portsnap fetch > +&prompt.root; portsnap update > + > + When using fetch, the > + extract or the update > + operation may be run consecutively, like so: > + > + &prompt.root; portsnap fetch update > + > + > + > + > + Subversion Method > + > + If more control over the ports tree is needed or if local > + changes need to be maintained, or if running &os.current;, > + Subversion can be used to obtain > + the Ports Collection. Refer to + xlink:href="&url.articles.committers-guide;/subversion-primer.html">the > + Subversion Primer for a detailed description of > + Subversion. > + > + > + Subversion must be installed > + before it can be used to check out the ports tree. If a > + copy of the ports tree is already present, install > + Subversion like this: > + > + &prompt.root; cd /usr/ports/devel/subversion > +&prompt.root; make install clean > + > + If the ports tree is not available, or > + pkg is being used to manage > + packages, Subversion can be > + installed as a package: > + > + &prompt.root; pkg install subversion > + > + > + > + > + Check out a copy of the ports tree: > + > + &prompt.root; svn checkout https://svn.FreeBSD.org/ports/head /usr/ports > + > + > + > + As needed, update /usr/ports after > + the initial Subversion > + checkout: > + > + &prompt.root; svn update /usr/ports > + > + > + > + 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 &os; how to compile and install that program, > + called a ports skeleton. Each port > + skeleton includes these files and directories: > + > + > + > + Makefile: contains statements that > + specify how the application should be compiled and where > + its components should be installed. > + > + > + > + distinfo: contains the names and > + checksums of the files that must be downloaded to build the > + port. > + > + > + > + files/: this directory contains > + any patches needed for the program to compile and install > + on &os;. This directory may also contain other files used > + to build the port. > + > + > + > + pkg-descr: provides a more detailed > + description of the program. > + > *** 892 LINES SKIPPED *** Hi Ryusuke Seems that you commited some old Docbook chapter. Bye. From owner-dev-commits-doc-all@freebsd.org Sat May 1 17:11: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 D83A6632685 for ; Sat, 1 May 2021 17:11: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 4FXbNn5lWTz4jdf; Sat, 1 May 2021 17:11: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 B82AE1B27A; Sat, 1 May 2021 17:11: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 141HB5EY068660; Sat, 1 May 2021 17:11:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141HB5O0068659; Sat, 1 May 2021 17:11:05 GMT (envelope-from git) Date: Sat, 1 May 2021 17:11:05 GMT Message-Id: <202105011711.141HB5O0068659@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: caff9acc27 - main - Delete file checkouted by mistake. 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: caff9acc27fa7d97f5b05f0220398da70e93c8ab 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: Sat, 01 May 2021 17:11:05 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=caff9acc27fa7d97f5b05f0220398da70e93c8ab commit caff9acc27fa7d97f5b05f0220398da70e93c8ab Author: Ryusuke SUZUKI AuthorDate: 2021-05-01 17:10:31 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-01 17:10:31 +0000 Delete file checkouted by mistake. --- en_US.ISO8859-1/books/handbook/ports/chapter.xml | 1831 ---------------------- 1 file changed, 1831 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.xml b/en_US.ISO8859-1/books/handbook/ports/chapter.xml deleted file mode 100644 index 110d47f3b6..0000000000 --- a/en_US.ISO8859-1/books/handbook/ports/chapter.xml +++ /dev/null @@ -1,1831 +0,0 @@ - - - - - Installing Applications: Packages and Ports - - - Synopsis - - ports - packages - &os; is bundled with a rich collection of system tools as - part of the base system. In addition, &os; provides two - complementary technologies for installing third-party software: - the &os; Ports Collection, for installing from source, and - packages, for installing from pre-built binaries. Either - method may be used to install software from local media or - from the network. - - After reading this chapter, you will know: - - - - The difference between binary packages and ports. - - - - How to find third-party software that has been ported - to &os;. - - - - How to manage binary packages using - pkg. - - - - How to build third-party software from source using the - Ports Collection. - - - - How to find the files installed with the application - for post-installation configuration. - - - - What to do if a software installation fails. - - - - - - Overview of Software Installation - - The typical steps for installing third-party software on a - &unix; system include: - - - - Find and download the software, which might be - distributed in source code format or as a binary. - - - - Unpack the software from its distribution format. This - is typically a tarball compressed with a program such as - &man.compress.1;, &man.gzip.1;, &man.bzip2.1; or - &man.xz.1;. - - - - Locate the documentation in - INSTALL, README - or some file in a doc/ subdirectory and - read up on how to install the software. - - - - If the software was distributed in source format, - compile it. This may involve editing a - Makefile or running a - configure script. - - - - Test and install the software. - - - - A &os; port is a collection of files - designed to automate - the process of compiling an application from source code. The - files that comprise a port contain all the necessary information - to automatically download, extract, patch, compile, and install - the application. - - If the software has not already been adapted and tested - on &os;, the source code might need editing in - order for it to install and run properly. - - However, over &os.numports; - third-party applications have already been ported to &os;. When - feasible, these applications are made available for download as - pre-compiled packages. - - Packages - can be manipulated with the &os; package management - commands. - - Both packages and ports understand dependencies. If a - package or port is used to install an application and a - dependent library is not already installed, the library will - automatically be installed first. - - A &os; package contains pre-compiled copies of all the - commands for an application, as well as any configuration files - and documentation. A package can be manipulated with the - &man.pkg.8; commands, such as - pkg install. - - While the two technologies are similar, packages and - ports each have their own strengths. Select the technology that - meets your requirements for installing a particular - application. - - - Package Benefits - - - A compressed package tarball is typically smaller than - the compressed tarball containing the source code for the - application. - - - - Packages do not require compilation time. For large - applications, such as Mozilla, - KDE, or - GNOME, this can be important - on a slow system. - - - - Packages do not require any understanding of the process - involved in compiling software on &os;. - - - - - Port Benefits - - - Packages are normally compiled with conservative - options because they have to run on the maximum number of - systems. By compiling from the port, one can change the - compilation options. - - - - Some applications have compile-time options relating to - which features are installed. For example, - Apache can be configured with a - wide variety of different built-in options. - - In some cases, multiple packages will exist for the same - application to specify certain settings. For example, - Ghostscript is available as a - ghostscript package and a - ghostscript-nox11 package, depending on - whether or not Xorg is installed. - Creating multiple packages rapidly becomes impossible if an - application has more than one or two different compile-time - options. - - - - The licensing conditions of some software forbid binary - distribution. Such software must be distributed as source - code which must be compiled by the end-user. - - - - Some people do not trust binary distributions or prefer - to read through source code in order to look for potential - problems. - - - - Source code is needed in - order to apply custom patches. - - - - To keep track of updated ports, subscribe to the - &a.ports; and the &a.ports-bugs;. - - - Before installing any application, check - for security issues related to the application or type - pkg audit -F to check all installed - applications for known vulnerabilities. - - - The remainder of this chapter explains how to use packages - and ports to install and manage third-party software on - &os;. - - - - Finding Software - - &os;'s list of available applications is growing all the - time. There are a number of ways to find software to - install: - - - - The &os; web site maintains an up-to-date searchable - list of all the available applications, at https://www.FreeBSD.org/ports/. - The ports can be searched by application name or by - software category. - - - - FreshPorts - - Dan Langille maintains FreshPorts.org - which provides a comprehensive search utility and also - tracks changes to the applications in the Ports Collection. - Registered users can create a customized watch list in order - to receive an automated email when their watched ports are - updated. - - - - SourceForge - - If finding a particular application becomes challenging, - try searching a site like SourceForge.net - or GitHub.com then - check back at the &os; site - to see if the application has been ported. - - - - - pkg - search - - - To search the binary package - repository for an application: - - &prompt.root; pkg search subversion -git-subversion-1.9.2 -java-subversion-1.8.8_2 -p5-subversion-1.8.8_2 -py27-hgsubversion-1.6 -py27-subversion-1.8.8_2 -ruby-subversion-1.8.8_2 -subversion-1.8.8_2 -subversion-book-4515 -subversion-static-1.8.8_2 -subversion16-1.6.23_4 -subversion17-1.7.16_2 - - Package names include the version number and, in the - case of ports based on python, the version number of the - version of python the package was built with. Some ports - also have multiple versions available. In the case of - Subversion, there are different - versions available, as well as different compile options. - In this case, the statically linked version of - Subversion. When indicating - which package to install, it is best to specify the - application by the port origin, which is the path in the - ports tree. Repeat the pkg search with - to list the origin of each - package: - - &prompt.root; pkg search -o subversion -devel/git-subversion -java/java-subversion -devel/p5-subversion -devel/py-hgsubversion -devel/py-subversion -devel/ruby-subversion -devel/subversion16 -devel/subversion17 -devel/subversion -devel/subversion-book -devel/subversion-static - - Searching by shell globs, regular expressions, exact - match, by description, or any other field in the repository - database is also supported by pkg search. - After installing ports-mgmt/pkg or - ports-mgmt/pkg-devel, see - &man.pkg-search.8; for more details. - - - - If the Ports Collection is already installed, there are - several methods to query the local version of the ports - tree. To find out which category a port is in, type - whereis file, - where file is the program to be - installed: - - &prompt.root; whereis lsof -lsof: /usr/ports/sysutils/lsof - - Alternately, an &man.echo.1; statement can be - used: - - &prompt.root; echo /usr/ports/*/*lsof* -/usr/ports/sysutils/lsof - - Note that this will also return any matched files - downloaded into the - /usr/ports/distfiles directory. - - - - Another way to find software is by using the Ports - Collection's built-in search mechanism. To use the search - feature, cd to - /usr/ports then run make - search name=program-name where - program-name is the name of the - software. For example, to search for - lsof: - - &prompt.root; cd /usr/ports -&prompt.root; make search name=lsof -Port: lsof-4.88.d,8 -Path: /usr/ports/sysutils/lsof -Info: Lists information about open files (similar to fstat(1)) -Maint: ler@lerctr.org -Index: sysutils -B-deps: -R-deps: - - - The built-in search mechanism uses a file - of index information. If a message indicates that the - INDEX is required, run - make fetchindex to download the current - index file. With the INDEX present, - make search will be able to perform the - requested search. - - - The Path: line indicates where to find - the port. - - To receive less information, use the - quicksearch feature: - - &prompt.root; cd /usr/ports -&prompt.root; make quicksearch name=lsof -Port: lsof-4.88.d,8 -Path: /usr/ports/sysutils/lsof -Info: Lists information about open files (similar to fstat(1)) - - For more in-depth searching, use - make search - key=string or - make quicksearch - key=string, where - string is some text to search - for. The text can be in comments, descriptions, or - dependencies in order to find ports which relate to a - particular subject when the name of the program is - unknown. - - When using search or - quicksearch, the search string - is case-insensitive. Searching for LSOF will - yield the same results as searching for - lsof. - - - - - - Using <application>pkg</application> for Binary Package - Management - - pkg is the next generation - replacement for the traditional &os; package management tools, - offering many features that make dealing with binary packages - faster and easier. - - For sites wishing to only use prebuilt binary packages - from the &os; mirrors, managing packages with - pkg can be sufficient. - - However, for those sites building from source or using their - own repositories, a separate port management tool - will be needed. - - Since pkg only works with - binary packages, it - is not a replacement for such tools. Those tools can be - used to install software from both binary packages - and the Ports Collection, while - pkg installs only binary - packages. - - - Getting Started with - <application>pkg</application> - - &os; includes a bootstrap utility which can be used to - download and install pkg - and its manual pages. This utility is designed to work - with versions of &os; starting with - 10.X. - - - Not all &os; versions and architectures - support this bootstrap process. The current list is at - . - For other cases, - pkg must instead be installed - from the Ports Collection or as a binary package. - - - - To bootstrap the system, run: - - &prompt.root; /usr/sbin/pkg - - You must have a working Internet connection for the - bootstrap process to succeed. - - Otherwise, to install the port, run: - - &prompt.root; cd /usr/ports/ports-mgmt/pkg -&prompt.root; make -&prompt.root; make install clean - - When upgrading an existing system that originally used the - older pkg_* tools, the database must be converted to the - new format, so that the new tools are aware of the already - installed packages. Once pkg has - been installed, the - package database must be converted from the traditional format - to the new format by running this command: - - &prompt.root; pkg2ng - - This step is not required for new installations that - do not yet have any third-party software - installed. - - - This step is not reversible. Once the package database - has been converted to the pkg - format, the traditional pkg_* tools - should no longer be used. - - - - The package database conversion may emit errors as the - contents are converted to the new version. Generally, these - errors can be safely ignored. However, a list of - software that was not successfully converted - is shown after pkg2ng finishes. - These applications must be manually reinstalled. - - - To ensure that the Ports Collection registers - new software with pkg instead of - the traditional packages database, &os; versions earlier than - 10.X require this line in - /etc/make.conf: - - WITH_PKGNG= yes - - By default, pkg uses the - binary packages from the &os; - package mirrors (the repository). - For information about building a custom - package repository, see - . - - Additional pkg configuration - options are described in &man.pkg.conf.5;. - - Usage information for pkg is - available in the &man.pkg.8; manual page or by running - pkg without additional arguments. - - Each pkg command argument is - documented in a command-specific manual page. To read the - manual page for pkg install, for example, - run either of these commands: - - &prompt.root; pkg help install - - &prompt.root; man pkg-install - - The rest of this section demonstrates common binary - package management tasks which can be performed using - pkg. Each demonstrated command - provides many switches to customize its use. Refer to a - command's help or man page for details and more - examples. - - - - Quarterly and Latest Ports Branches - - The Quarterly branch provides users - with a more predictable and stable experience for port and - package installation and upgrades. This is done essentially - by only allowing non-feature updates. Quarterly branches aim - to receive security fixes (that may be version updates, or - backports of commits), bug fixes and ports compliance or - framework changes. The Quarterly branch is cut from HEAD at - the beginning of every (yearly) quarter in January, April, - July, and October. Branches are named according to the year - (YYYY) and quarter (Q1-4) they are created in. For example, - the quarterly branch created in January 2016, is named 2016Q1. - And the Latest branch provides the latest - versions of the packages to the users. - - To switch from quarterly to latest run the following - commands: - - &prompt.root; cp /etc/pkg/FreeBSD.conf /usr/local/etc/pkg/repos/FreeBSD.conf - - Edit the file - /usr/local/etc/pkg/repos/FreeBSD.conf - and change the string quarterly to - latest in the url: - line. - - The result should be similar to the following: - - FreeBSD: { - url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest", - mirror_type: "srv", - signature_type: "fingerprints", - fingerprints: "/usr/share/keys/pkg", - enabled: yes -} - - And finally run this command to update from the new - (latest) repository metadata. - - &prompt.root; pkg update -f - - - - - Obtaining Information About Installed Packages - - Information about the packages installed on a system - can be viewed by running pkg info which, - when run without any switches, will list the package version - for either all installed packages or the specified - package. - - For example, to see which version of - pkg is installed, run: - - &prompt.root; pkg info pkg -pkg-1.1.4_1 - - - - Installing and Removing Packages - - To install a binary package use the following command, - where packagename is the name of - the package to install: - - &prompt.root; pkg install packagename - - This command uses repository data to determine which - version of the software to install and if it has any - uninstalled dependencies. For example, to install - curl: - - &prompt.root; pkg install curl -Updating repository catalogue -/usr/local/tmp/All/curl-7.31.0_1.txz 100% of 1181 kB 1380 kBps 00m01s - -/usr/local/tmp/All/ca_root_nss-3.15.1_1.txz 100% of 288 kB 1700 kBps 00m00s - -Updating repository catalogue -The following 2 packages will be installed: - - Installing ca_root_nss: 3.15.1_1 - Installing curl: 7.31.0_1 - -The installation will require 3 MB more space - -0 B to be downloaded - -Proceed with installing packages [y/N]: y -Checking integrity... done -[1/2] Installing ca_root_nss-3.15.1_1... done -[2/2] Installing curl-7.31.0_1... done -Cleaning up cache files...Done - - The new package and any additional packages that were - installed as dependencies can be seen in the installed - packages list: - - &prompt.root; pkg info -ca_root_nss-3.15.1_1 The root certificate bundle from the Mozilla Project -curl-7.31.0_1 Non-interactive tool to get files from FTP, GOPHER, HTTP(S) servers -pkg-1.1.4_6 New generation package manager - - Packages that are no longer needed can be removed with - pkg delete. For example: - - &prompt.root; pkg delete curl -The following packages will be deleted: - - curl-7.31.0_1 - -The deletion will free 3 MB - -Proceed with deleting packages [y/N]: y -[1/1] Deleting curl-7.31.0_1... done - - - - Upgrading Installed Packages - - Installed packages can be upgraded to their latest - versions by running: - - &prompt.root; pkg upgrade - - This command will compare the installed versions with - those available in the repository catalogue and upgrade them - from the repository. - - - - Auditing Installed Packages - - Software vulnerabilities are regularly discovered - in third-party applications. To address this, - pkg includes a built-in auditing - mechanism. To determine if there are any known - vulnerabilities for the software installed on the system, - run: - - &prompt.root; pkg audit -F - - - - Automatically Removing Unused Packages - - Removing a package may leave behind dependencies which - are no longer required. Unneeded packages that were installed - as dependencies (leaf packages) can be automatically detected - and removed using: - - &prompt.root; pkg autoremove -Packages to be autoremoved: - ca_root_nss-3.15.1_1 - -The autoremoval will free 723 kB - -Proceed with autoremoval of packages [y/N]: y -Deinstalling ca_root_nss-3.15.1_1... done - - Packages installed as dependencies are - called automatic packages. Non-automatic - packages, i.e the packages that were explicity installed not - as a dependency to another package, can be listed - using: - - &prompt.root; pkg prime-list -nginx -openvpn -sudo - - pkg prime-list is an alias command - declared in /usr/local/etc/pkg.conf. - There are many others that can be used to query the package - database of the system. For instance, command - pkg prime-origins can be used to get the - origin port directory of the list mentioned above: - - &prompt.root; pkg prime-origins -www/nginx -security/openvpn -security/sudo - - This list can be used to rebuild all packages - installed on a system using build tools such as - ports-mgmt/poudriere or - ports-mgmt/synth. - - Marking an installed package as automatic can be - done using: - - &prompt.root; pkg set -A 1 devel/cmake - - Once a package is a leaf package and is marked - as automatic, it gets selected by - pkg autoremove. - - Marking an installed package as not - automatic can be done using: - - &prompt.root; pkg set -A 0 devel/cmake - - - - - Restoring the Package Database - - Unlike the traditional package management system, - pkg includes its own package - database backup mechanism. This functionality is enabled by - default. - - - To disable the periodic script from backing up the - package database, set - daily_backup_pkgdb_enable="NO" in - &man.periodic.conf.5;. - - - To restore the contents of a previous package database - backup, run the following command replacing - /path/to/pkg.sql with the location - of the backup: - - &prompt.root; pkg backup -r /path/to/pkg.sql - - - If restoring a backup taken by the periodic script, - it must be decompressed prior to being restored. - - - To run a manual backup of the - pkg database, run the following - command, replacing /path/to/pkg.sql - with a suitable file name and location: - - &prompt.root; pkg backup -d /path/to/pkg.sql - - - - Removing Stale Packages - - By default, pkg stores - binary packages in a cache directory defined by - PKG_CACHEDIR in &man.pkg.conf.5;. Only copies - of the latest installed packages are kept. Older versions of - pkg kept all previous packages. To - remove these outdated binary packages, run: - - &prompt.root; pkg clean - - The entire cache may be cleared by running: - - &prompt.root; pkg clean -a - - - - Modifying Package Metadata - - Software within the &os; Ports Collection can - undergo major version number changes. To address this, - pkg has a built-in command to - update package origins. This can be useful, for example, if - lang/php5 is renamed to - lang/php53 so that - lang/php5 can now - represent version 5.4. - - To change the package origin for the above example, - run: - - &prompt.root; pkg set -o lang/php5:lang/php53 - - As another example, to update - lang/ruby18 to - lang/ruby19, run: - - &prompt.root; pkg set -o lang/ruby18:lang/ruby19 - - As a final example, to change the origin of the - libglut shared libraries from - graphics/libglut to - graphics/freeglut, run: - - &prompt.root; pkg set -o graphics/libglut:graphics/freeglut - - - When changing package origins, it is important to - reinstall packages that are dependent on the package with - the modified origin. To force a reinstallation of dependent - packages, run: - - &prompt.root; pkg install -Rf graphics/freeglut - - - - - - Using the Ports Collection - - The Ports Collection is a set of - Makefiles, patches, and description files. - Each set of these files is used to compile and install an - individual application on &os;, and is called a - port. - - By default, the Ports Collection itself is stored as a - subdirectory of /usr/ports. - - 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 &os;, use one of the - following methods to install it: - - - Portsnap Method - - The base system of &os; includes - Portsnap. This is a fast and - user-friendly tool for retrieving the Ports Collection and - is the recommended choice for most users not running - &os.current;. This utility - connects to a &os; site, verifies the secure key, and - downloads a new copy of the Ports Collection. The key is used - to verify the integrity of all downloaded files. - - - To download a compressed snapshot of the Ports - Collection into - /var/db/portsnap: - - &prompt.root; portsnap fetch - - - - When running Portsnap for the - first time, extract the snapshot into - /usr/ports: - - &prompt.root; portsnap extract - - - - After the first use of - Portsnap has been completed as - shown above, /usr/ports can be updated - as needed by running: - - &prompt.root; portsnap fetch -&prompt.root; portsnap update - - When using fetch, the - extract or the update - operation may be run consecutively, like so: - - &prompt.root; portsnap fetch update - - - - - Subversion Method - - If more control over the ports tree is needed or if local - changes need to be maintained, or if running &os.current;, - Subversion can be used to obtain - the Ports Collection. Refer to the - Subversion Primer for a detailed description of - Subversion. - - - Subversion must be installed - before it can be used to check out the ports tree. If a - copy of the ports tree is already present, install - Subversion like this: - - &prompt.root; cd /usr/ports/devel/subversion -&prompt.root; make install clean - - If the ports tree is not available, or - pkg is being used to manage - packages, Subversion can be - installed as a package: - - &prompt.root; pkg install subversion - - - - - Check out a copy of the ports tree: - - &prompt.root; svn checkout https://svn.FreeBSD.org/ports/head /usr/ports - - - - As needed, update /usr/ports after - the initial Subversion - checkout: - - &prompt.root; svn update /usr/ports - - - - 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 &os; how to compile and install that program, - called a ports skeleton. Each port - skeleton includes these files and directories: - - - - Makefile: contains statements that - specify how the application should be compiled and where - its components should be installed. - - - - distinfo: contains the names and - checksums of the files that must be downloaded to build the - port. - - - - files/: this directory contains - any patches needed for the program to compile and install - on &os;. This directory may also contain other files used - to build the port. - - - - pkg-descr: provides a more detailed - description of the program. - - *** 865 LINES SKIPPED *** From owner-dev-commits-doc-all@freebsd.org Sat May 1 17:18:07 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 93E716328B5 for ; Sat, 1 May 2021 17:18:07 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from mail.allbsd.org (mx.allbsd.org [IPv6:2001:2f0:104:e001::41]) (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 ECDSA (P-384) client-digest SHA384) (Client CN "mail.allbsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FXbXv10TNz4k99; Sat, 1 May 2021 17:18:06 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from localhost (home.allbsd.org [IPv6:2001:2f0:104:e001:0:0:0:42]) (authenticated bits=0) by mail.allbsd.org (8.16.1/8.16.1) with ESMTPA id 141HHkoq090947; Sun, 2 May 2021 02:17:57 +0900 (JST) (envelope-from ryusuke@FreeBSD.org) Date: Sun, 02 May 2021 02:17:42 +0900 (JST) Message-Id: <20210502.021742.549742518323772043.ryusuke@home.allbsd.org> To: carlavilla@freebsd.org, mat@freebsd.org Cc: ryusuke@freebsd.org, doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Subject: Re: git: ff3df39394 - main - a67af5a97b -> e633f0b9df From: Ryusuke SUZUKI In-Reply-To: References: <202105011654.141GsZUx044665@gitrepo.freebsd.org> X-Mailer: Mew version 6.8 on Emacs 27.1 Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.6.4 (mail.allbsd.org [IPv6:2001:2f0:104:e001:0:0:0:41]); Sun, 02 May 2021 02:17:57 +0900 (JST) X-Rspamd-Queue-Id: 4FXbXv10TNz4k99 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: Sat, 01 May 2021 17:18:07 -0000 Hi, Mathieu-san, Sergio-san > Seems that you commited some old Docbook chapter. Fixed. From owner-dev-commits-doc-all@freebsd.org Sat May 1 18:04:27 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 837F663342D for ; Sat, 1 May 2021 18:04:27 +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 4FXcZM2tWLz4lkb; Sat, 1 May 2021 18:04: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 55BB91C2FD; Sat, 1 May 2021 18:04: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 141I4Rhd037891; Sat, 1 May 2021 18:04:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141I4Rih037890; Sat, 1 May 2021 18:04:27 GMT (envelope-from git) Date: Sat, 1 May 2021 18:04:27 GMT Message-Id: <202105011804.141I4Rih037890@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Daniel Ebdrup Jensen Subject: git: 7e8ef67b71 - main - status: Add the 2021q1 status report MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: debdrup X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7e8ef67b718aa3e8c30117e47f5bb71e4ee7c214 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: Sat, 01 May 2021 18:04:27 -0000 The branch main has been updated by debdrup: URL: https://cgit.FreeBSD.org/doc/commit/?id=7e8ef67b718aa3e8c30117e47f5bb71e4ee7c214 commit 7e8ef67b718aa3e8c30117e47f5bb71e4ee7c214 Author: Daniel Ebdrup Jensen AuthorDate: 2021-05-01 17:51:18 +0000 Commit: Daniel Ebdrup Jensen CommitDate: 2021-05-01 18:04:08 +0000 status: Add the 2021q1 status report This document has had a lot of different fingers on it, as is the case with all status reports, so it'd be quite an effort to credit everyone. There's a full log to be found on the freebsd-quarterly github repo under the freebsd organization, and the commit log should contain the full list. Please note that all files for any given report, except _index.adoc, aren't under explicit maintainership, so if anyone notices problems, feel free to submit/commit fixes. --- .../en/status/report-2021-01-2021-03/_index.adoc | 176 +++++++++++++++++++++ .../en/status/report-2021-01-2021-03/cbsd.adoc | 17 ++ .../en/status/report-2021-01-2021-03/ci.adoc | 60 +++++++ .../status/report-2021-01-2021-03/clusteradm.adoc | 46 ++++++ .../en/status/report-2021-01-2021-03/discord.adoc | 38 +++++ .../en/status/report-2021-01-2021-03/docng.adoc | 17 ++ .../en/status/report-2021-01-2021-03/ena.adoc | 30 ++++ .../report-2021-01-2021-03/freebsd-foundation.adoc | 121 ++++++++++++++ .../en/status/report-2021-01-2021-03/git.adoc | 42 +++++ .../status/report-2021-01-2021-03/hellosystem.adoc | 27 ++++ .../en/status/report-2021-01-2021-03/iwlwifi.adoc | 21 +++ .../en/status/report-2021-01-2021-03/kde.adoc | 30 ++++ .../report-2021-01-2021-03/kernel-sanitizers.adoc | 23 +++ .../status/report-2021-01-2021-03/linuxulator.adoc | 19 +++ .../en/status/report-2021-01-2021-03/lldb.adoc | 34 ++++ .../en/status/report-2021-01-2021-03/marvell.adoc | 30 ++++ .../status/report-2021-01-2021-03/mitigations.adoc | 35 ++++ .../status/report-2021-01-2021-03/nv-sndstat.adoc | 19 +++ .../en/status/report-2021-01-2021-03/office.adoc | 23 +++ .../en/status/report-2021-01-2021-03/openbsm.adoc | 20 +++ .../report-2021-01-2021-03/pkgbase.live.adoc | 26 +++ .../en/status/report-2021-01-2021-03/portmgr.adoc | 51 ++++++ .../en/status/report-2021-01-2021-03/potluck.adoc | 24 +++ .../en/status/report-2021-01-2021-03/releng.adoc | 29 ++++ .../sysctl-improvements.adoc | 53 +++++++ .../status/report-2021-01-2021-03/virtualbox.adoc | 16 ++ .../en/status/report-2021-01-2021-03/weblate.adoc | 24 +++ .../en/status/report-2021-01-2021-03/www.adoc | 23 +++ 28 files changed, 1074 insertions(+) diff --git a/website/content/en/status/report-2021-01-2021-03/_index.adoc b/website/content/en/status/report-2021-01-2021-03/_index.adoc new file mode 100644 index 0000000000..529e4ada2c --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/_index.adoc @@ -0,0 +1,176 @@ +--- +title: "Introduction" +sidenav: about +--- + += Introduction +:doctype: article +:toc: macro +:toclevels: 2 +:icons: font +:!sectnums: +:source-highlighter: rouge +:experimental: +:reports-path: content/en/status/report-2021-01-2021-03 + +This report covers FreeBSD related projects for the period between January and March, and is the first of four planned reports for 2021. + +The first quarter of 2021 has been very active in both FreeBSD-CURRENT and -STABLE, with 13.0-RELEASE work starting in January and finishing up mid-April. +It provides lots of new features, and there's even a good chance that some workloads will experience performance improvements. + +The number of entries is slightly down, and this is probably due to a combination of factors like code slush as well as the ongoing issues with COVID-19, but we naturally hope that things will look up next quarter. +This combined with a switch-over to AsciiDoctor and a decision to make full use of the status report work schedule to avoid stress, means that the report can now be expected to come out at the end of the first month after the quarter has finished, rather than in the middle. + +This report in particular includes a number of interesting entries, covering everything from the linuxulator, various mitigation work, long-awaited work on OpenBSM, work on kernel sanitizers, and many more things that it is hoped you will enjoy reading about. + +Yours, + +Daniel Ebdrup Jensen, with a status hat on. + +''' + +toc::[] + +''' + +[[FreeBSD-Team-Reports]] +== FreeBSD Team Reports + +Entries from the various official and semi-official teams, as found in the link:../../administration/[Administration Page]. + +include::{reports-path}/freebsd-foundation.adoc[] + +''' + +include::{reports-path}/releng.adoc[] + +''' + +include::{reports-path}/clusteradm.adoc[] + +''' + +include::{reports-path}/ci.adoc[] + +''' + +include::{reports-path}/portmgr.adoc[] + +''' + +[[projects]] +== Projects + +Projects that span multiple categories, from the kernel and userspace to the Ports Collection or external projects. + +include::{reports-path}/git.adoc[] + +''' + +include::{reports-path}/lldb.adoc[] + +''' + +include::{reports-path}/linuxulator.adoc[] + +''' + +include::{reports-path}/mitigations.adoc[] + +''' + +include::{reports-path}/openbsm.adoc[] + +''' + +[[kernel]] +== Kernel + +Updates to kernel subsystems/features, driver support, filesystems, and more. + +include::{reports-path}/ena.adoc[] + +''' + +include::{reports-path}/iwlwifi.adoc[] + +''' + +include::{reports-path}/kernel-sanitizers.adoc[] + +''' + +include::{reports-path}/marvell.adoc[] + +''' + +include::{reports-path}/nv-sndstat.adoc[] + +''' + +[[ports]] +== Ports + +Changes affecting the Ports Collection, whether sweeping changes that touch most of the tree, or individual ports themselves. + +include::{reports-path}/kde.adoc[] + +''' + +include::{reports-path}/office.adoc[] + +''' + +include::{reports-path}/virtualbox.adoc[] + +''' + +[[documentation]] +== Documentation + +Noteworthy changes in the documentation tree, in manpages, or in external books/documents. + +include::{reports-path}/docng.adoc[] + +''' + +include::{reports-path}/weblate.adoc[] + +''' + +include::{reports-path}/www.adoc[] + +''' + +[[miscellaneous]] +== Miscellaneous + +Objects that defy categorization. + +include::{reports-path}/discord.adoc[] + +''' + +[[third-Party-Projects]] +== Third-Party Projects + +Many projects build upon FreeBSD or incorporate components of FreeBSD into their project. +As these projects may be of interest to the broader FreeBSD community, we sometimes include brief updates submitted by these projects in our quarterly report. +The FreeBSD project makes no representation as to the accuracy or veracity of any claims in these submissions. + +include::{reports-path}/cbsd.adoc[] + +''' + +include::{reports-path}/hellosystem.adoc[] + +''' + +include::{reports-path}/pkgbase.live.adoc[] + +''' + +include::{reports-path}/potluck.adoc[] + +''' + +include::{reports-path}/sysctl-improvements.adoc[] diff --git a/website/content/en/status/report-2021-01-2021-03/cbsd.adoc b/website/content/en/status/report-2021-01-2021-03/cbsd.adoc new file mode 100644 index 0000000000..992d139ff0 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/cbsd.adoc @@ -0,0 +1,17 @@ +=== CBSD Project + +Links: + +link:https://www.bsdstore.ru/en/cbsd_api_ssi.html[CBSD API module] URL: link:https://www.bsdstore.ru/en/cbsd_api_ssi.html[https://www.bsdstore.ru/en/cbsd_api_ssi.html] + +Contact: Oleg Ginzburg + +==== What is CBSD? + +CBSD is a management layer written for the FreeBSD man:jail[8] subsystem, man:bhyve[8] and man:xen[4]. +CBSD allows users to manage jail/bhyve/xen environments at different levels of abstraction by providing a varied number of unified methods: vagrant-like `CBSDfiles`, `CLI` and via man:dialog[1]. + +==== CBSD 2021Q1 Status Report + +A RestAPI service layer was added during last quarter, enabling creation of programmable cloud solutions. +In addition, work has been done to support RestAPI through a `CBSDfile`, allowing for private cloud environments deployment. +In such cases the local CBSD layer acts as a thin client. diff --git a/website/content/en/status/report-2021-01-2021-03/ci.adoc b/website/content/en/status/report-2021-01-2021-03/ci.adoc new file mode 100644 index 0000000000..cef02d5887 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/ci.adoc @@ -0,0 +1,60 @@ +=== Continuous Integration + +Links: + +link:https://ci.FreeBSD.org[FreeBSD Jenkins Instance] URL: link:https://ci.FreeBSD.org[https://ci.FreeBSD.org] + +link:https://ci.FreeBSD.org/hwlab[FreeBSD Hardware Testing Lab] URL: link:https://ci.FreeBSD.org/hwlab[https://ci.FreeBSD.org/hwlab] + +link:https://artifact.ci.FreeBSD.org[FreeBSD CI artifact archive] URL: link:https://artifact.ci.FreeBSD.org[https://artifact.ci.FreeBSD.org] + +link:https://hackmd.io/@FreeBSD-CI[FreeBSD CI weekly report] URL: link:https://hackmd.io/@FreeBSD-CI[https://hackmd.io/@FreeBSD-CI] + +link:https://wiki.freebsd.org/Jenkins[FreeBSD Jenkins wiki] URL: link:https://wiki.freebsd.org/Jenkins[https://wiki.freebsd.org/Jenkins] + +link:https://wiki.freebsd.org/HostedCI[Hosted CI wiki] URL: link:https://wiki.freebsd.org/HostedCI[https://wiki.freebsd.org/HostedCI] + +link:https://wiki.freebsd.org/3rdPartySoftwareCI[3rd Party Software CI] URL: link:https://wiki.freebsd.org/3rdPartySoftwareCI[https://wiki.freebsd.org/3rdPartySoftwareCI] + +link:https://preview.tinyurl.com/y9maauwg[Tickets related to freebsd-testing@] URL: link:https://preview.tinyurl.com/y9maauwg[https://preview.tinyurl.com/y9maauwg] + +link:https://github.com/freebsd/freebsd-ci[FreeBSD CI Repository] URL: link:https://github.com/freebsd/freebsd-ci[https://github.com/freebsd/freebsd-ci] + +Contact: Jenkins Admin + +Contact: Li-Wen Hsu + +Contact: link:https://lists.FreeBSD.org/mailman/listinfo/freebsd-testing[freebsd-testing Mailing List] + +Contact: IRC #freebsd-ci channel on EFNet + +The FreeBSD CI team maintains the continuous integration system of the FreeBSD project. +The CI system firstly checks the committed changes can be successfully built, then performs various tests and analysis over the newly built results. +The artifacts from those builds are archived in the artifact server for further testing and debugging needs. +The CI team members examine the failing builds and unstable tests and work with the experts in that area to fix the code or adjust test infrastructure. +The details of these efforts are available in the link:https://hackmd.io/@FreeBSD-CI[weekly CI reports]. + +During the first quarter of 2021, we continued working with the contributors and developers in the project to fulfil their testing needs and also keep collaborating with external projects and companies to improve their products and FreeBSD. + +Important changes: + +* All src jobs were changed to use git to follow VCS migration. +Thanks Brandon Bergren (bdragon@) again. +* Doc job was updated for following the AsciiDoc migration. + +New jobs added: + +* link:https://ci.freebsd.org/job/FreeBSD-main-amd64-test_tcptestsuite[TCP test suite for main on amd64] +* link:https://ci.freebsd.org/job/FreeBSD-main-amd64-gcc9_build[GCC 9 build for main on amd64] + +Work in progress and open tasks: + +* Designing and implementing pre-commit CI building and testing +* Designing and implementing use of CI cluster to build release artifacts as release engineering does +* Collecting and sorting CI tasks and ideas link:https://hackmd.io/@FreeBSD-CI/freebsd-ci-todo[here] +* Testing and merging pull requests in link:https://github.com/freebsd/freebsd-ci/pulls[the FreeBSD-ci repo] +* Reducing the procedures of CI/test environment setting up for contributors and +developers +* Setting up the CI stage environment and putting the experimental jobs on it +* Setting up public network access for the VM guest running tests +* Implementing automatic tests on bare metal hardware +* Adding drm ports building tests against -CURRENT +* Planning to run ztest and network stack tests +* Adding more external toolchain related jobs +* Improving the hardware lab to be more mature and adding more hardware +* Helping more software get FreeBSD support in their CI pipeline +Wiki pages: link:https://wiki.freebsd.org/3rdPartySoftwareCI[3rdPartySoftwareCI], link:https://wiki.freebsd.org/HostedCI[HostedCI] +* Working with hosted CI providers to have better FreeBSD support +* The build and test results will be sent to the link:https://lists.freebsd.org/mailman/listinfo/dev-ci[dev-ci mailing list] soon. Feedback and help with analysis is very appreciated! + +Please see link:https://bugs.freebsd.org/bugzilla/buglist.cgi?bug_status=__open__&email1=testing%40FreeBSD.org&emailassigned_to1=1&emailcc1=1&emailreporter1=1&emailtype1=substring&query_format=advanced[freebsd-testing@ related tickets] for more WIP information, and don't hesitate to join the effort! + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-01-2021-03/clusteradm.adoc b/website/content/en/status/report-2021-01-2021-03/clusteradm.adoc new file mode 100644 index 0000000000..53e4e9266f --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/clusteradm.adoc @@ -0,0 +1,46 @@ +=== Cluster Administration Team + +Contact: Cluster Administration Team + +Links: + +link:https://www.freebsd.org/administration/#t-clusteradm[Cluster Administration Team members] URL: link:https://www.freebsd.org/administration/#t-clusteradm[https://www.freebsd.org/administration/#t-clusteradm] + +The FreeBSD Cluster Administration Team consists of the people responsible for administering the machines that the Project relies on for its distributed work and communications to be synchronised. In this quarter, the team has worked on the following: + +* Installed a new package builder +* Added Git support to cluster management scripts +* Put local Git mirrors on the universe machines +* Replaced disks in the UK mirror +* Replaced a disk in pointyhat (https://pkg-status.freebsd.org) +* Recycled some old dead-weight servers eating up rackspace and power at our primary cluster site +* Upgraded developer reference platforms +** ref{11,12,13,14}-{amd64,i386} +** universe* +* Installed two new aarch64 machines +** ref12-aarch64, ref13-aarch64, ref14-aarch64 +** security-officer aarch64 freebsd-update builder +* Worked with asciidoc project to update https://www.freebsd.org and https://docs.freebsd.org +* Installed a new mirror server in Brazil, sponsored by link:https://nic.br[nic.br] +** gdns points everyone from South America to this mirror +** complete {download,ftp,pkg}.freebsd.org mirror +* Helped rmacklem@ participate in this year's link:http://www.nfsv4bat.org/Events/2021/Feb/BAT/index.html[NFS Bakeathon] interoperability testing event by providing a cluster machine to the testing VPN +* Ongoing day to day cluster management activity +** Putting out fires +** Babysitting pkgsync + +Work in progress: + +* Move pkg-master.nyi to new hardware +* Fix git fallouts +* Upgrade cluster hardware +* Upgrade developer-facing machines to 14-CURRENT +** Install ref14* machines +* Improve to the package building infrastructure +* Research and test migration away from mailman2 +* Work with Git migration working group for ports tree migration +* Review the service jails and service administrators operation +* Improve the web service architecture +* Improve the cluster backup plan +* Setup powerpc pkgbuilder/ref/universal machines +* Prepare for a new mirror site in Australia, to be hosted by link:https://www.ix.asn.au[IX Australia] +* Search for more providers that can fit the requirements for a link:https://wiki.freebsd.org/Teams/clusteradm/generic-mirror-layout[generic mirrored layout] or a link:https://wiki.freebsd.org/Teams/clusteradm/tiny-mirror[tiny mirror] diff --git a/website/content/en/status/report-2021-01-2021-03/discord.adoc b/website/content/en/status/report-2021-01-2021-03/discord.adoc new file mode 100644 index 0000000000..284f87ad69 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/discord.adoc @@ -0,0 +1,38 @@ +=== Discord Server & Community Growth + +Links: + +link:https://wiki.freebsd.org/Discord[Discord Wiki Page] URL: link:https://wiki.freebsd.org/Discord[https://wiki.freebsd.org/Discord] + +link:https://discord.gg/RHprKbvWJN[Discord Invitation Link] URL: link:https://discord.gg/RHprKbvWJN[https://discord.gg/RHprKbvWJN] + +Contact: Lewis Cook + +Contact: Vincent Milum Jr + +Contact: Kubilay Kocak + +The FreeBSD project and community continues to grow, and in the last 2 quarters, we established an official FreeBSD server on the popular Discord platform, as a complementary means for out-reach, support, collaboration and social connection for and between members of the FreeBSD community, new and old. + +Discord boasts broad accessibility and unique features that the the community can enjoy without the steeper learning curves associated with other support and social mediums, that can often deter or overwhelm newcomers. +It also provides an opportunity to broaden FreeBSD's reach outside traditional spaces and audiences. + +We currently have a respectable 480 members, with that number growing daily, and have established baseline community guidelines and moderation processes consistent with and complementary to other support channels and the FreeBSD Code of Conduct. + +While it's early days, events have already been successfully hosted on the platform. +In January, Tom Jones (thj@) announced and ran an online Bugathon focusing on issues related to the branching of FreeBSD 13. +We've also created dedicated text and voice channels to facilitate more of these kinds of events in the future. +We hope to see more events like these run as examples of how we can utilize Discord constructively and in ways we haven't as a community or project before. + +With the future in mind, we have plans to: + +* Automatically announce news, updates and advisories in Discord. +* Verify and enable additional Discord features designed for large communities. +* Set up bots with unique features, including moderation and interactive features for members. We welcome ideas in this regard. + +We are keen on project and community members to reach out to talk about how we can best leverage Discord. +Some ideas we'd love people to get involved with include: + +* Brainstorm/Suggest unique and creative ideas or features. +* Provide bug reports and user experience feedback and suggestions. +* Actively promote Discord in other social media spaces, particularly those that maybe new or curious to learn more about FreeBSD. +* Contribute to the Wiki page and its content. +* Participate and support other members on Discord. +* Run a live stream on a FreeBSD-related topic. +* Hang out in our live audio and video channels if you're comfortable doing so. diff --git a/website/content/en/status/report-2021-01-2021-03/docng.adoc b/website/content/en/status/report-2021-01-2021-03/docng.adoc new file mode 100644 index 0000000000..de2615cea0 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/docng.adoc @@ -0,0 +1,17 @@ +=== DOCNG on FreeBSD + +Contact: Sergio Carlavilla + +The Doc New Generation project is finished. +The switch-over date was Saturday, January 23rd. + +But there's a list of remaining tasks: + +* Convert the Python scripts to Ruby using the AsciiDoctor API +* Convert from releases from 4.4 to 9.0 to AsciiDoctor +* Use rouge in the source sections instead of the CSS hack +* Split the news page to reduce the total size of the page +* Split the books +* Improve the FDP book + +If you want to reduce the TODO list, give me a ping :) diff --git a/website/content/en/status/report-2021-01-2021-03/ena.adoc b/website/content/en/status/report-2021-01-2021-03/ena.adoc new file mode 100644 index 0000000000..f96cbaafa7 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/ena.adoc @@ -0,0 +1,30 @@ +=== ENA FreeBSD Driver Update + +Links: + +link:https://github.com/amzn/amzn-drivers/blob/master/kernel/fbsd/ena/README[ENA README] URL: link:https://github.com/amzn/amzn-drivers/blob/master/kernel/fbsd/ena/README[https://github.com/amzn/amzn-drivers/blob/master/kernel/fbsd/ena/README] + +Contact: Michal Krawczyk + +Contact: Artur Rojek + +Contact: Marcin Wojtas + +ENA (Elastic Network Adapter) is the smart NIC available in the virtualized environment of Amazon Web Services (AWS). +The ENA driver supports multiple transmit and receive queues and can handle up to 100 Gb/s of network traffic, depending on the instance type on which it is used. + +Completed since the last update: + +* Update ENA driver to v2.3.1 +* Determine location of the MSIx vector table on the device and allocate it dynamically - this enables driver usage on instances like c5gn. +* MFC of the ENA v2.3.1 driver to the FreeBSD 11/12/13-STABLE branches +* ENA v2.3.1 will be a part of the FreeBSD 13.0-RELEASE + +Work in progress: + +* Internal review ongoing: +* Introduce full kernel RSS API support +* Allow reconfiguration of the RSS indirection table and hash key +* Adjust iflib framework for the ENA requirements +* Add DMA width configuration field link:https://cgit.freebsd.org/src/commit/?id=6dd69f0064f1e54671cdb46ce5975a332fb761e8[commit 6dd69f0064f1] +* Add support for admin completion queues link:https://cgit.freebsd.org/src/commit/?id=09c3f04ff3be97ef442f2484396b1f963565b259[commit 09c3f04ff3be] +* Prototype the driver port to the iflib framework + +Sponsor: Amazon.com Inc diff --git a/website/content/en/status/report-2021-01-2021-03/freebsd-foundation.adoc b/website/content/en/status/report-2021-01-2021-03/freebsd-foundation.adoc new file mode 100644 index 0000000000..f69d5df32a --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/freebsd-foundation.adoc @@ -0,0 +1,121 @@ +=== FreeBSD Foundation + +Contact: Deb Goodkin + +The FreeBSD Foundation is a 501(c)(3) non-profit organization dedicated to supporting and promoting the FreeBSD Project and community worldwide. +Funding comes from individual and corporate donations and is used to fund and manage software development projects, conferences and developer summits, and provide travel grants to FreeBSD contributors. +The Foundation purchases and supports hardware to improve and maintain FreeBSD infrastructure and provides resources to improve security, quality assurance, and release engineering efforts; publishes marketing material to promote, educate, and advocate for the FreeBSD Project; facilitates collaboration between commercial vendors and FreeBSD developers; and finally, represents the FreeBSD Project in executing contracts, license agreements, and other legal arrangements that require a recognized legal entity. + +Here are some highlights of what we did to help FreeBSD last quarter: + +==== COVID-19 Impact to the Foundation + +Like most organizations, our team continued to work from home. +Our temporary ban on travel for staff members remains in effect, but continues to not affect our output too much, since most conferences are still virtual. +We continued supporting the community and Project, even though some of our work and responses may have been delayed because of changes in some of our priorities and the impact of limited childcare for a few of our staff members. + +==== Partnerships and Commercial User Support + +We help facilitate collaboration between commercial users and FreeBSD developers. +We also meet with companies to discuss their needs and bring that information back to the Project. +Not surprisingly, the stay at home orders, combined with our company ban on travel during Q1 made in-person meetings non-existent. +However, the team was able to continue meeting with our partners and commercial users virtually. +These meetings help us understand some of the applications where FreeBSD is used. + +We were thrilled for the opportunity to work with AMD early on to ensure FreeBSD worked on their recently released third generation EPYC series. +You can read more about that here: https://freebsdfoundation.org/news-and-events/latest-news/freebsd-well-prepared-for-amd-epyc-7003-series-processors/. + +==== Fundraising Efforts + +First, we’d like to say thank you to everyone who has given us a financial contribution this year! Last quarter we raised $88,237, which includes donations from organizations like Facebook and Tarsnap, as well as many individuals. +We also have a few donation commitments for this quarter. + +Going forward this quarter, we will be reaching out to FreeBSD commercial users to help support our growing efforts. +At the beginning of 2021, we opened two job positions in our software development team, to increase the amount of support we are able to provide in this area. +That includes increasing the amount of code reviews and bug fixes we do and adding some major features to FreeBSD, to help keep FreeBSD the innovative, secure, and reliable operating system you rely on. + +You’ll find out how we used your donations for Q1 in our report, as well as individual reports throughout this status report. + +We are excited about our plans for 2021, which include more FreeBSD online advocacy and training, operating system course content, and the software development work mentioned above. +While we are still in this pandemic, we’re working hard to help connect folks within the community with more virtual opportunities. + +Please consider making a donation to help us continue and increase our support for FreeBSD in 2021: https://www.freebsdfoundation.org/donate/. + +We also have the Partnership Program, to provide more benefits for our larger commercial donors. +Find out more information and share with your companies! https://www.freebsdfoundation.org/FreeBSD-foundation-partnership-program/ + +==== OS Improvements + +Over the quarter a total of 264 base system commits, 63 ports commits, and 10 doc tree commits were tagged as sponsored by the FreeBSD Foundation. +The Foundation also sponsored work that was committed to third-party repositories, including 26 commits to LLDB (the LLVM project debugger). +This includes work from staff members, interns, and grant recipients. +In other quarterly report entries you can read more about some of these sponsored projects, such as LLDB and other kernel debugging improvements, and kernel sanitizers. + +As usual, staff members committed numerous bug fixes, minor improvements, and security patches. +Focus areas in the kernel included virtual memory, x86 pmap, uma, tmpfs, nullfs, ffs and ufs, and job control improvements. + +User space work included changes to the libc, libcasper, and libthr libraries, the run-time linker, as well as the ldd, cmp, diff, makefs, elfctl, growfs, and bhyve utilities. + +Foundation staff also participated in many Phabricator code reviews, supported bug triage, integrated a number of submissions from third parties, and supported the Git transition working group. + +Foundation staff also supported the promotion of the AArch64 (arm64) architecture to Tier-1 status. +Work included additions to freebsd-update, integration of various bug fixes, and test run issue triage. + +==== Continuous Integration and Quality Assurance + +The Foundation provides a full-time staff member and funds projects on improving continuous integration, automated testing, and overall quality assurance efforts for the FreeBSD Project. + +During the first quarter of 2021, the work was focused on pre-commit tests and building release artifacts in the CI staging environment. + +The other main working item is following the VCS migration to change the src source from Subversion to Git and doc changed to AsciiDoc format. + +See the FreeBSD CI section of this report for completed work items and detailed information. + +==== Supporting FreeBSD Infrastructure + +The Foundation provides hardware and support to improve the FreeBSD infrastructure. +Last quarter, we continued supporting FreeBSD hardware located around the world. +We coordinated efforts between the new NYI Chicago facility and clusteradm to start working on getting the facility prepared for some of the new FreeBSD hardware we are planning on purchasing. +NYI generously provides this for free to the Project. +We also worked on connecting with the new owners of the NYI Bridgewater site, where most of the FreeBSD infrastructure is located. + +==== FreeBSD Advocacy and Education + +A large part of our efforts are dedicated to advocating for the Project. +This includes promoting work being done by others with FreeBSD; producing advocacy literature to teach people about FreeBSD and help make the path to starting using FreeBSD or contributing to the Project easier; and attending and getting other FreeBSD contributors to volunteer to run FreeBSD events, staff FreeBSD tables, and give FreeBSD presentations. + +The FreeBSD Foundation sponsors many conferences, events, and summits around the globe. +These events can be BSD-related, open source, or technology events geared towards underrepresented groups. +We support the FreeBSD-focused events to help provide a venue for sharing knowledge, to work together on projects, and to facilitate collaboration between developers and commercial users. +This all helps provide a healthy ecosystem. +We support the non-FreeBSD events to promote and raise awareness of FreeBSD, to increase the use of FreeBSD in different applications, and to recruit more contributors to the Project. +While we were still unable to attend in-person meetings due to covid-19, we were able to attend virtual events and began planning for the online Spring FreeBSD Developer Summit. +In addition to attending and planning virtual events, we are continually working on new training initiatives and updating our selection of how-to guides to facilitate getting more folks to try out FreeBSD. https://www.freebsdfoundation.org/freebsd/how-to-guides/ + +Check out some of the advocacy and education work we did last quarter: + +* Presented a workshop at Apricot 2021 +* Staffed a virtual stand at FOSDEM 2021 and created a what’s new in 13.0 video to accompany the stand +* Staffed a virtual booth and was a community sponsor for FOSSASIA 2021 +* Participated as an Industry Partner for USENIX FAST ‘21 +* Committed to be an Industry Partner for USENIX Annual Tech, USENIX OSDI, USENIX Security and USENIX LISA +* Continued to promote the FreeBSD Office Hours series Videos from the one hour sessions can be found on the Project’s YouTube Channel: https://www.youtube.com/c/FreeBSDProject. +See the Office Hours section of this report for more information. +* Worked with the organizing committee to begin planning the Spring FreeBSD Developers Summit. +* Continued recruiting for the FreeBSD Fridays series. The series will return in May. +* Participated in an interview with The Register about FreeBSD 13.0 highlights. https://www.theregister.com/2021/03/10/the_state_of_freebsd/ + +Keep up to date with our latest work in our newsletters: https://freebsdfoundation.org/our-work/latest-updates/?filter=newsletter + +We help educate the world about FreeBSD by publishing the professionally produced FreeBSD Journal. +As we mentioned previously, the FreeBSD Journal is now a free publication. +Find out more and access the latest issues at https://www.freebsdfoundation.org/journal/. + +You can find out more about events we attended and upcoming events at https://www.freebsdfoundation.org/news-and-events/. + +==== Legal/FreeBSD IP + +The Foundation owns the FreeBSD trademarks, and it is our responsibility to protect them. +We also provide legal support for the core team to investigate questions that arise. + +Go to http://www.freebsdfoundation.org to find out how we support FreeBSD and how we can help you! diff --git a/website/content/en/status/report-2021-01-2021-03/git.adoc b/website/content/en/status/report-2021-01-2021-03/git.adoc new file mode 100644 index 0000000000..bb6f99e923 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/git.adoc @@ -0,0 +1,42 @@ +=== Git Migration Working Group + +Links: + +link:https://wiki.freebsd.org/git[Git transition wiki] URL: link:https://wiki.freebsd.org/git[https://wiki.freebsd.org/git] + +link:https://cgit.FreeBSD.org/doc[doc git repo] URL: link:https://cgit.FreeBSD.org/doc[https://cgit.FreeBSD.org/doc] + +link:https://cgit.FreeBSD.org/ports[ports git repo] URL: https://cgit.FreeBSD.org/ports[https://cgit.FreeBSD.org/ports] + +link:https://cgit.FreeBSD.org/src[src (base system) git repo] URL: link:https://cgit.FreeBSD.org/src[https://cgit.FreeBSD.org/src] + +link:https://docs.freebsd.org/en/articles/committers-guide/#git-primer[Committers guide Git primer] URL: link:https://docs.freebsd.org/en/articles/committers-guide/#git-primer[https://docs.freebsd.org/en/articles/committers-guide/#git-primer] + +link:https://docs.freebsd.org/en/books/handbook/mirrors/#git[Handbook Using Git appendix] URL: link:https://docs.freebsd.org/en/books/handbook/mirrors/#git[https://docs.freebsd.org/en/books/handbook/mirrors/#git] + +link:http://gameoftrees.org/[Game of Trees] URL: link:http://gameoftrees.org/[http://gameoftrees.org/] + +link:https://github.com/johnmehr/gitup[gitup] URL: link:https://github.com/johnmehr/gitup[https://github.com/johnmehr/gitup] + +Contact: Li-Wen Hsu + +Contact: Warner Losh + +Contact: Ed Maste + +Contact: Ulrich Spörlein + +Contact: link:https://lists.freebsd.org/mailman/listinfo/freebsd-git[FreeBSD-git mailing list] + +Contact IRC #gitcvt channel on EFnet + +The doc and src trees were migrated from Subversion to Git at the end of 2020, with some additional work extending into the first quarter of 2021. +The Git Working Group implemented or updated commit hooks, and prepared for FreeBSD 13 to be built from Git. +We converted draft documentation from Markdown to AsciiDoc and merged it into the committer's guide and handbook. + +The ports repository migration to Git started at the end of the quarter, beginning with a final Subversion commit on March 31st to indicate that the conversion started. +We are working on portsnap and other ports infrastructure and they will be finished before or soon after the migration. + +The Git Working Group continues to track progress on two permissively-licensed git compatible tools: Gitup and Game of Trees. +Gitup is a small, dependency-free tool to clone and update git repositories. +It is used only to keep a local tree up-to-date, and has no support for local commits. + +Game of Trees is a version control client that is compatible with Git repositories. +It provides a user interface and workflow that is distinct from that of Git. +It is in no way intended to be a drop-in replacement for git, but can be used to develop software maintained in a Git repository. + +Gitup and Game of Trees are currently available as ports and packages. +Future work will evaluate them as candidates for the base system. + +In the second quarter of 2021 we expect to complete some minor remaining migration tasks. +This will complete the initial phase of the Git migration, and the working group will wind down. +The core team will then begin a new effort to investigate and evaluate new workflow changes. + +Sponsor: The FreeBSD Foundation (in part) diff --git a/website/content/en/status/report-2021-01-2021-03/hellosystem.adoc b/website/content/en/status/report-2021-01-2021-03/hellosystem.adoc new file mode 100644 index 0000000000..ee47cd5981 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/hellosystem.adoc @@ -0,0 +1,27 @@ +=== helloSystem + +Links: + +link:https://hellosystem.github.io/docs/[Documentation] URL: link:https://hellosystem.github.io/docs/[https://hellosystem.github.io/docs/] + +Contact: Simon Peter + +Contact: `\#helloSystem` on `irc.freenode.net`, mirrored to link:https://matrix.to/#/%23helloSystem:matrix.org?via=matrix.org[`#helloSystem:matrix.org` on Matrix] + +==== What is helloSystem? + +helloSystem is FreeBSD preconfigured as a desktop operating system with a focus on simplicity, elegance, and usability. +Its design follows the “Less, but better” philosophy. + +==== Q1 2021 Status + +* helloSystem and some of the motivations and core ideas behind it were presented at the FOSDEM 2021 BSD Devroom in the talk link:https://fosdem.org/2021/schedule/event/hello_bsd/["hello... again? Simplicity, elegance, and usability for the desktop"]. Video recordings of the talk and Q&A session are available link:https://video.fosdem.org/2021/D.bsd/hello_bsd.webm[WebM/VP9], link:https://video.fosdem.org/2021/D.bsd/hello_bsd.mp4[mp4] +* Version 0.4.0 of helloSystem was published. Installable Live ISO images are available. +* Work has started towards 0.5.0. We are beginning to see contributed features and bugfixes +** System menu reflects changes made in Applications immediately +** Filer file manager brings already-open windows to the front rather than opening multiple windows for the same folder +** Initial spatial mode option (each folder opens in its own window in the file manager that remembers its on-screen location) + +Experimental and release builds of the Live ISO are available at https://github.com/helloSystem/ISO/releases. + +==== Contributing + +link:https://github.com/helloSystem/hello/blob/master/CONTRIBUTING.md[Help is wanted in a number of areas], especially in the areas of the FreeBSD core OS and kernel, and Qt/C++. diff --git a/website/content/en/status/report-2021-01-2021-03/iwlwifi.adoc b/website/content/en/status/report-2021-01-2021-03/iwlwifi.adoc new file mode 100644 index 0000000000..4a64046f43 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/iwlwifi.adoc @@ -0,0 +1,21 @@ +=== Intel wireless update + +Links: + +link:https://lists.freebsd.org/mailman/listinfo/freebsd-wireless[The freebsd-wireless mailing list] URL: link:https://lists.freebsd.org/mailman/listinfo/freebsd-wireless[https://lists.freebsd.org/mailman/listinfo/freebsd-wireless] + +Contact: Bjoern A. Zeeb + +==== Newer Intel Wireless device support + +The Intel Wireless driver update project aims to bring support for newer chipsets. + +During the first quarter the driver and firmware were synched from upstream so that we will have support for all modern cards currently supported in Linux. +Some iwlwifi driver changes were also submitted back upstream. + +Several conflicts with the original implementation of LinuxKPI were or are being resolved and more LinuxKPI code was upstreamed to FreeBSD HEAD. + +LinuxKPI 802.11 compat code was improved and as of the day of writing we have data packets going over 11a. + +The plan for the next weeks is to clean things up, land as much as possible in HEAD, provide the code for testing and work on stability based on feedback before filling gaps in the LinuxKPI 802.11 compat code to enhance support for more standards and features. + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-01-2021-03/kde.adoc b/website/content/en/status/report-2021-01-2021-03/kde.adoc new file mode 100644 index 0000000000..dbb9f095f3 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/kde.adoc @@ -0,0 +1,30 @@ +=== KDE on FreeBSD + +Links: + +link:https://freebsd.kde.org/[KDE FreeBSD] URL: link:https://freebsd.kde.org/[https://freebsd.kde.org/] + +link:https://community.kde.org/FreeBSD[KDE Community FreeBSD] URL: link:https://community.kde.org/FreeBSD[https://community.kde.org/FreeBSD] + +Contact: Adriaan de Groot + +The KDE on FreeBSD project aims to package all of the software produced by the KDE Community for the FreeBSD ports tree. +The software includes a full desktop environment called KDE Plasma, graphics applications, instant-messengers, a video-editing suite, as well as a tea timer and hundreds of other applications that can be used on any FreeBSD machine. + +The KDE team (kde@) is part of desktop@ and x11@ as well, building the software stack to make FreeBSD beautiful and usable as a daily-driver graphics-based desktop machine. + +The KDE Frameworks have a monthly release cycle; KDE Plasma and the rest of KDE software run on a quarterly cycle plus monthly bugfixes. +All of those releases landed in ports in a timely manner. +Around KDE there are several hundred other applications with their own releases, of which notable or new ones are: + +* `deskutils/calindori`, `deskutils/kongress`, `net-im/kaidan`, `deskutils/semantik` and `graphics/kgeotag` +* `net-im/ruqola` and `net-im/neochat` for Rocket and Matrix instant-messaging, respectively +* `audio/amarok`, the one-time favorite KDE music player + +Infrastructure work improved the way Qt5 ports install- and un-install changes to the global header `qconfig-modules.h`. +CMake releases landed with distressing regularity, and various low-level things like `devel/libphonenumber` and `graphics/poppler` were updated as needed. + +The big issue in the Qt stack on FreeBSD is Qt5-WebEngine, which is based on Chromium. +Like Chromium itself (upstream), it has a tangled mess of a build system based on Python 2.7. +The scheduled removal of Python 2.7 and ports that depend on it is a sword looming over a large chunk of the Qt and KDE stack. +Some resolution may be forthcoming in the form of WebEngine-less ports, but the real effort is in trying to get WebEngine to build with Python3. + +More detailed descriptions of the updates in this quarter are available link:https://euroquis.nl/kde/2021/02/13/freebsd.html[here (part 1)] and link:https://euroquis.nl/kde/2021/03/26/freebsd2021o2.html[here (part 2)]. diff --git a/website/content/en/status/report-2021-01-2021-03/kernel-sanitizers.adoc b/website/content/en/status/report-2021-01-2021-03/kernel-sanitizers.adoc new file mode 100644 index 0000000000..041a734cee --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/kernel-sanitizers.adoc @@ -0,0 +1,23 @@ +=== Kernel Sanitizers + +Contact: Mark Johnston + +Work has been ongoing to port a pair of kernel sanitizers from NetBSD to FreeBSD. +Sanitizers are debugging tools which make use of compiler instrumentation to validate memory accesses. +They can automatically detect many classes of C programming bugs, such as use-after-frees and loads of uninitialized variables. +When combined with link:https://github.com/google/syzkaller[syzkaller] or other testing tools, they are effective at detecting kernel bugs that may otherwise require a great deal of manual effort to identify. + +Two sanitizers are being ported, KASAN (link:https://clang.llvm.org/docs/AddressSanitizer.html[AddressSanitizer]) and KMSAN (link:https://clang.llvm.org/docs/MemorySanitizer.html[MemorySanitizer]). +KASAN checks the validity of all memory accesses within the kernel map and triggers a panic upon an out-of-bounds access or a use-after-free. +Various kernel memory allocators annotate regions of memory to denote whether corresponding accesses are valid. +The initial port of KASAN is complete and is planned to appear in the FreeBSD development branch in mid-April. +KMSAN detects uses of uninitialized memory and can detect bugs that result in the contents of kernel memory being leaked to userspace. +Both sanitizers incur considerable memory and CPU overhead. +They are intended to be used mainly in conjunction with test frameworks, though it is certainly possible to boot and run sanitizer-enabled kernels in a desktop or laptop environment. +Currently this work is amd64-only. +It should be possible to port it to arm64 and riscv with relatively little effort. + +Future work in this area consists of finishing the KMSAN port, fixing bugs found by the combination of KASAN and syzkaller, and making sure that sanitizers can validate accesses to the direct map. +This may consist of an option to disable usage of the direct map, or introducing a shadow for the direct map. + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-01-2021-03/linuxulator.adoc b/website/content/en/status/report-2021-01-2021-03/linuxulator.adoc new file mode 100644 index 0000000000..bb0a36c2f1 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/linuxulator.adoc @@ -0,0 +1,19 @@ +=== Linux compatibility layer update + +Contact: Edward Tomasz Napierala, + +Linuxulator improvements have been ongoing for the last two years, with support from the FreeBSD Foundation over a few distinct project grants as well as contributions from the community. +The goal of this project is to improve FreeBSD's ability to execute unmodified Linux binaries. +Current support status of specific Linux applications is being tracked at the link:https://wiki.freebsd.org/LinuxApps[Linux app status Wiki page]. + +The work this quarter focused on making sure the 13.0-RELEASE ships with Linuxulator in a good shape, and fixing problems reported by users. +There are some new directories provided by `linsysfs(5)`, the lack of which, through a curious chain of events, broke installation of make(1) in Ubuntu Focal. +The `getcwd(2)` syscall was fixed to no longer return the wrong error value for certain conditions, which was breaking Mono. +The `getsockopt(2)` syscall now supports `SO_PEERSEC` and `SO_PEERGROUPS`, which are being used by su(8) and sudo(8). +Other fixes include flag handling for 32-bit `send(2)` syscall, and several ptrace(2) problems, which were affecting Steam games. The kernel version was bumped to 3.17.0 to unbreak Qt applications from Focal. +The `sysutils/debootstrap` port, and its corresponding `debootstrap` package, now correctly handle Ubuntu's GPG keys. +The debootstrap utility now installs the `mremap(2)` workaround for `apt(8)`. +This reduces the number of steps required to set up Linux chroot or jail. +Finally there have been some improvements to the startup scripts. + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-01-2021-03/lldb.adoc b/website/content/en/status/report-2021-01-2021-03/lldb.adoc new file mode 100644 index 0000000000..6b3294dc1e --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/lldb.adoc @@ -0,0 +1,34 @@ +=== LLDB Debugger Improvements + +Links: + +link:https://www.moritz.systems/blog/lldb-freebsd-cpu-target-support-and-userland-debugging-improvements/[Moritz Systems Project Description] URL: link:https://www.moritz.systems/blog/lldb-freebsd-cpu-target-support-and-userland-debugging-improvements/[https://www.moritz.systems/blog/lldb-freebsd-cpu-target-support-and-userland-debugging-improvements/] + +link:https://www.moritz.systems/blog/freebsd-remote-process-plugin-on-non-x86-architectures/[Progress Report 1] URL: link:https://www.moritz.systems/blog/freebsd-remote-process-plugin-on-non-x86-architectures/[https://www.moritz.systems/blog/freebsd-remote-process-plugin-on-non-x86-architectures/] + +link:https://www.moritz.systems/blog/freebsd-legacy-process-plugin-removed/[Progress Report 2] URL: link:https://www.moritz.systems/blog/freebsd-legacy-process-plugin-removed/[https://www.moritz.systems/blog/freebsd-legacy-process-plugin-removed/] + +link:https://www.moritz.systems/blog/lldb-support-for-fork-and-vfork/[Progress Report 3] URL: https://www.moritz.systems/blog/lldb-support-for-fork-and-vfork/[https://www.moritz.systems/blog/lldb-support-for-fork-and-vfork/] + +link:https://github.com/moritz-systems/llvm-project[Git Repository] URL: link:https://github.com/moritz-systems/llvm-project[https://github.com/moritz-systems/llvm-project] + +Contact: Kamil Rytarowski + +Contact: Michał Górny + +The LLDB project builds on libraries provided by LLVM and Clang to provide a great modern debugger. +It uses the Clang ASTs and the expression parser, LLVM JIT, LLVM disassembler, etc so that it provides an experience that “just works”. +It is also blazingly fast and more permissively licensed than GDB, the GNU Debugger. + +FreeBSD includes LLDB in the base system. At present, it has some limitations in comparison with the GNU GDB debugger, and does not yet provide a complete replacement. +This project aimed to finish porting the FreeBSD platform support in LLDB to the modern client-server model on all architectures originally supported by LLDB on FreeBSD and removing the obsolete plugin. + +After switching to the new process model, the project focused on implementing support for tracing ``fork(2)`` and ``vfork(2)`` syscalls. +The proposed model is compatible with the ``follow-fork-mode`` setting from GDB. +On fork, the debugger can either continuing tracing the parent and detach the child, or switch to tracing the child and detach the parent. +The new code makes it possible to debug child processes. +It also prevents software breakpoints from leaking to child processes and causing them to crash. + +The introduced changes are expected to be shipped with LLDB 13.0. + +The overall experience of FreeBSD/LLDB developers and advanced users on this rock solid Operating System reached the state known from other environments. +Furthermore, the FreeBSD-focused work also resulted in generic improvements, enhancing the LLDB support for Linux and NetBSD. + +TODO: we are currently working on adding a ``ptrace(2)`` request to create a core dump of the stopped program without crashing it. +Afterwards, we are planning to improve LLDB test coverage for core dump support and work on any issues we might hit. + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-01-2021-03/marvell.adoc b/website/content/en/status/report-2021-01-2021-03/marvell.adoc new file mode 100644 index 0000000000..587a04e706 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/marvell.adoc @@ -0,0 +1,30 @@ +=== Marvell ARM64 SoCs support + +Contact: Zyta Szpak + +Contact: Kornel Dulęba + +Contact: Marcin Wojtas + +The Semihalf team is working on improving the FreeBSD support for the +link:https://www.marvell.com/content/dam/marvell/en/public-collateral/embedded-processors/marvell-infrastructure-processors-octeon-tx2-cn913x-product-brief-2020-02.pdf[Marvell Octeon TX2 CN913x] and link:https://www.marvell.com/content/dam/marvell/en/public-collateral/embedded-processors/marvell-embedded-processors-armada-7040-product-brief-2017-12.pdf[Armada 7k]/link:http://wiki.macchiatobin.net/tiki-index.php?page=Armada+8040[8k] SoC families. + +Marvell Armada 7k8k and Octeon TX2 CN913x SoC families are quad-core 64-bit ARMv8 Cortex-A72 processors with high speed peripherals including 10 Gb Ethernet, PCIe 3.0, SATA 3.0 and USB 3.0 for a wide range of networking, storage, security and industrial applications. + +Although the mentioned SoCs are mostly supported in FreeBSD HEAD, some pieces required improvements. + +Applied changes: + +* Add missing frequency modes in ap806_clock driver (link:https://cgit.freebsd.org/src/commit/?id=a86b0839d7bf3fc06b1ae[commit a86b0839d7bf]) +* Multiple fixes in mvebu_gpio driver - in cooperation with mmel (link:https://cgit.freebsd.org/src/commit/?id=a5dce53b75d8750ba[commit a5dce53b75d8]) +* Fix device tree data parsing in mv\_ap806\_gicp interrupt controller driver (link:https://cgit.freebsd.org/src/commit/?id=622d17da46eb360c3d684[commit 622d17da46eb]) +* Rework the ICU interrupt controller (mv\_cp110\_icu) and its parent (mv\_ap806\_gicp), so that they no longer rely on the data provided by firmware, which fixes booting the OS from the newer U-Boot/TF-A revisions (link:https://reviews.freebsd.org/D28803[D28803]) +* PCIE Designware driver (pci_dw) fixes: +** Correct setting of outbound I/O ATU window. +** Allow mapping ATU windows bigger than 4GB. +* Generic improvements that enable proper user-space mapping and access of the PCI BARs + +TODO: + +* Upstream PCIE improvements. +* Improve and merge ICU support rework. + +Sponsor: Marvell diff --git a/website/content/en/status/report-2021-01-2021-03/mitigations.adoc b/website/content/en/status/report-2021-01-2021-03/mitigations.adoc new file mode 100644 index 0000000000..3089c2e81b --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/mitigations.adoc @@ -0,0 +1,35 @@ +=== Vulnerability Mitigations + +Contact: Ed Maste + +Contact: Konstantin Belousov + +Contact: Marcin Wojtas + +Contact: Dawid Górecki + +We added support for enforcing a https://cgit.freebsd.org/src/commit/?id=2e1c94aa1fd582fb8ae0522f0827be719ff5fb67[write XOR execute] mapping policy. +It is enabled by setting the `kern.elf64.allow_wx` and/or `kern.elf32.allow_wx` sysctls to 0 (for 64-bit and 32-bit binaries, respectively). +Binaries can indicate that they requre writeable and executable mappings by setting the `NT_FREEBSD_FCTL_WXNEEDED` ELF feature bit, set via elfctl. + +In addition, elfctl received a few usability improvements to support use by ports, targeting different FreeBSD base system versions. +We added a https://cgit.freebsd.org/src/commit/?id=f6d95a01103a49a94c876d5a51bb4be25c06d964[`-i` flag] to ignore unknown flags (so that the same elfctl invocation could be used on older FreeBSD versions) as well as the ability to https://cgit.freebsd.org/src/commit/?id=86f33b5fcf6087bf4439881011b920ff99e6e300[specify features by value]. + +Flags that request opt-out of a mitigation now have a `no` prefix to make the sense clearer. +For example, the flag to indicate that the binary is not compatible with ASLR is now named `noaslr`. +Unprefixed flag names are still supported, for backwards compatibility, but will emit a warning and will be removed in a later version. + +The next step is to introduce ports infrastructure to support tagging binaries in ports that require special flags. +Details can be found in https://bugs.freebsd.org/252629[PR252629]. + +Another update is that the base system binaries are now built as position-independent executable (PIE) https://cgit.freebsd.org/src/commit/?id=9a227a2fd642ec057a0ec70d67d5699d65553294[by default], for 64-bit architectures. +PIE executables are used in conjunction with address randomization (ASLR) as a mitigation for certain types of security vulnerabilities. +The ASLR feature still remains opt-in, however the described change allows enabling it using only sysctl knobs, without a need to rebuild the image. +Enabling PIE results in no material performance impact for most workloads. + +It is also worth mentioning that a certain number of ports inherit the base systems /usr/share/mk infrastructure, and some initially failed to build after toggling the PIE setting. +All issues detected by executing the exp-run were addressed. +The details can be found in https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=253275[PR253275]. + +The next step is to try enabling ASLR by default for 64-bit architectures. +The https://reviews.freebsd.org/D27666[patch] is under discussion. + +Sponsor: The FreeBSD Foundation +Sponsor: Stormshield diff --git a/website/content/en/status/report-2021-01-2021-03/nv-sndstat.adoc b/website/content/en/status/report-2021-01-2021-03/nv-sndstat.adoc new file mode 100644 index 0000000000..fb4e9550c2 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/nv-sndstat.adoc @@ -0,0 +1,19 @@ +=== nv(9)-based audio device enumeration + +Links: + +link:https://reviews.freebsd.org/D26884[D26884 Implement sndstat nvlist-based enumeration ioctls.] URL: link:https://reviews.freebsd.org/D26884[https://reviews.freebsd.org/D26884] + +link:https://cgit.freebsd.org/src/commit/?id=c96151d33509655efb7fb26768cb56a041c176f1[commit c96151d33509655efb7fb26768cb56a041c176f1] URL: link:https://cgit.freebsd.org/src/commit/?id=c96151d33509655efb7fb26768cb56a041c176f1[https://cgit.freebsd.org/src/commit/?id=c96151d33509655efb7fb26768cb56a041c176f1] + +Contact: Ka Ho Ng + +This work presents a number of ioctl commands on [.underline]#/dev/sndstat# using nv(9) to expose all available audio device nodes. +nv(9) is used to generate a serialized binary stream representation of the information of audio device nodes presented in the running system. +The documented nvlist structure in sndstat(4) manual page is stable for programming use. + +For a long time, enumerating the audio device node interface required parsing content of [.underline]#/dev/sndstat#. +It is tedious to write such a parser and handle different `hw.snd.verbose` levels correctly. +Using nv(9) eliminates the need to write a text parser to do audio device nodes enumeration. + +This work has been link:https://cgit.freebsd.org/src/commit/?id=c96151d33509655efb7fb26768cb56a041c176f1[committed] and is available in FreeBSD 14-CURRENT. + +Sponsor: The FreeBSD Foundation diff --git a/website/content/en/status/report-2021-01-2021-03/office.adoc b/website/content/en/status/report-2021-01-2021-03/office.adoc new file mode 100644 index 0000000000..8a3389329a --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/office.adoc @@ -0,0 +1,23 @@ +=== FreeBSD Office team 2021Q1 status report + +Links: + +link:https://wiki.freebsd.org/Office[The FreeBSD Office project] URL: link:https://wiki.freebsd.org/Office[https://wiki.freebsd.org/Office] + +Contact: FreeBSD Office team ML + +Contact: Dima Panov + +Contact: Li-Wen Hsu + +The FreeBSD Office team works on a number of office-related software suites and tools such as OpenOffice and LibreOffice. + +Work during this quarter was focused on providing the latest stable release of LibreOffice suite and companion apps to all FreeBSD users. + +Latest and quarterly ports branches got a new branch (7.1) of the LibreOffice suite and updated to 7.1.1 release. + +Meanwhile, our link:https://github.org/freebsd/freebsd-ports-libreoffice[WIP repository] got back a working CI instance again, thanks to Li-Wen Hsu. + +We are looking for people to help with the open tasks: + +* The link:https://bugs.freebsd.org/bugzilla/buglist.cgi?bug_status=open&email1=office%40FreeBSD.org&emailassigned_to1=1&emailcc1=1&emailreporter1=1&emailtype1=substring&query_format=advanced&list_id=374316[open bugs list] contains all filed issues which need some attention +* Upstream local patches in ports + +Patches, comments and objections are always welcome in the mailing list and bugzilla. diff --git a/website/content/en/status/report-2021-01-2021-03/openbsm.adoc b/website/content/en/status/report-2021-01-2021-03/openbsm.adoc new file mode 100644 index 0000000000..e909ae1a95 --- /dev/null +++ b/website/content/en/status/report-2021-01-2021-03/openbsm.adoc @@ -0,0 +1,20 @@ +=== OpenBSM Synchronisation + +Links: + +link:http://www.trustedbsd.org/openbsm.html[TrustedBSD / OpenBSM] URL: link:http://www.trustedbsd.org/openbsm.html[http://www.trustedbsd.org/openbsm.html] + +link:https://github.com/openbsm/openbsm[OpenBSM Github Sources] URL: link:https://github.com/openbsm/openbsm[https://github.com/openbsm/openbsm] + +link:https://github.com/openbsm/openbsm/commit/54a0c07cf8bac71554130e8f6760ca68e5f36c7f[Synchronisation with macOS Catalina] URL: link:https://github.com/openbsm/openbsm/commit/54a0c07cf8bac71554130e8f6760ca68e5f36c7f[https://github.com/openbsm/openbsm/commit/54a0c07cf8bac71554130e8f6760ca68e5f36c7f] + +link:https://opensource.apple.com[Apple OpenSource] URL: link:https://opensource.apple.com[https://opensource.apple.com] *** 307 LINES SKIPPED *** From owner-dev-commits-doc-all@freebsd.org Sat May 1 18:04: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 97CE46331D1 for ; Sat, 1 May 2021 18:04: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 4FXcZN3sZfz4lkc; Sat, 1 May 2021 18:04:28 +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 77A4F1C2FE; Sat, 1 May 2021 18:04: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 141I4S9c037912; Sat, 1 May 2021 18:04:28 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141I4Sff037911; Sat, 1 May 2021 18:04:28 GMT (envelope-from git) Date: Sat, 1 May 2021 18:04:28 GMT Message-Id: <202105011804.141I4Sff037911@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Daniel Ebdrup Jensen Subject: git: 1a966ab954 - main - status: Bump deadline for new submissions MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: debdrup X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1a966ab954ad9553f297dacad0de211e6c5dcd2d 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: Sat, 01 May 2021 18:04:28 -0000 The branch main has been updated by debdrup: URL: https://cgit.FreeBSD.org/doc/commit/?id=1a966ab954ad9553f297dacad0de211e6c5dcd2d commit 1a966ab954ad9553f297dacad0de211e6c5dcd2d Author: Daniel Ebdrup Jensen AuthorDate: 2021-05-01 18:02:15 +0000 Commit: Daniel Ebdrup Jensen CommitDate: 2021-05-01 18:04:09 +0000 status: Bump deadline for new submissions --- website/content/en/status/_index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/status/_index.adoc b/website/content/en/status/_index.adoc index d7ed76a673..906bf219fb 100644 --- a/website/content/en/status/_index.adoc +++ b/website/content/en/status/_index.adoc @@ -5,7 +5,7 @@ sidenav: about = FreeBSD Status Reports -== Next Quarterly Status Report submissions (January - March) due: March 31st, 2021 +== Next Quarterly Status Report submissions (April - July) due: June 30th, 2021 Submit your entries as Pull Requests from your fork of link:https://github.com/freebsd/freebsd-quarterly[FreeBSD Status Report GitHub repo] or submit them via e-mail to quarterly-submissions@FreeBSD.org, using the link:https://github.com/freebsd/freebsd-quarterly/blob/master/report-sample.adoc[report-sample.adoc template]. From owner-dev-commits-doc-all@freebsd.org Sat May 1 18:23:57 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 2B859633CE8 for ; Sat, 1 May 2021 18:23:57 +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 4FXd0s0lSXz4lvr; Sat, 1 May 2021 18:23:57 +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 0C9861C326; Sat, 1 May 2021 18:23:57 +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 141INup1063644; Sat, 1 May 2021 18:23:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141INuTw063643; Sat, 1 May 2021 18:23:56 GMT (envelope-from git) Date: Sat, 1 May 2021 18:23:56 GMT Message-Id: <202105011823.141INuTw063643@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Wolfram Schneider Subject: git: 5e3248fdb3 - main - Update copyright year MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: wosch X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 5e3248fdb356cadd995690ac8a8f29b37b3f530c 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: Sat, 01 May 2021 18:23:57 -0000 The branch main has been updated by wosch: URL: https://cgit.FreeBSD.org/doc/commit/?id=5e3248fdb356cadd995690ac8a8f29b37b3f530c commit 5e3248fdb356cadd995690ac8a8f29b37b3f530c Author: Wolfram Schneider AuthorDate: 2021-05-01 18:22:12 +0000 Commit: Wolfram Schneider CommitDate: 2021-05-01 18:22:12 +0000 Update copyright year --- website/content/en/cgi/ports.cgi | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/content/en/cgi/ports.cgi b/website/content/en/cgi/ports.cgi index 2162548251..a1ed4330c7 100755 --- a/website/content/en/cgi/ports.cgi +++ b/website/content/en/cgi/ports.cgi @@ -1,6 +1,6 @@ #!/usr/bin/perl -T # -# Copyright (c) 1996-2017 Wolfram Schneider +# Copyright (c) 1996-2021 Wolfram Schneider # All rights reserved. # # Redistribution and use in source and binary forms, with or without @@ -496,7 +496,7 @@ sub footer { print qq{ Powered by FreeBSD -© 1996-2017 by Wolfram Schneider. All rights reserved.
    +© 1996-2021 by Wolfram Schneider. All rights reserved.
    }; #print q{$FreeBSD$} . "
    \n"; From owner-dev-commits-doc-all@freebsd.org Sat May 1 19:14:01 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 2CEBF634B67 for ; Sat, 1 May 2021 19:14:01 +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 4FXf6d0sCdz4pTy; Sat, 1 May 2021 19:14:01 +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 0FEA81CBCB; Sat, 1 May 2021 19:14:01 +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 141JE0k2031049; Sat, 1 May 2021 19:14:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141JE0uc031048; Sat, 1 May 2021 19:14:00 GMT (envelope-from git) Date: Sat, 1 May 2021 19:14:00 GMT Message-Id: <202105011914.141JE0uc031048@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Wolfram Schneider Subject: git: e1f5165f70 - main - add OpenBSD 6.9 manual pages MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: wosch X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e1f5165f70cdc0f1a63284eca99ceefd440e1eb9 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: Sat, 01 May 2021 19:14:01 -0000 The branch main has been updated by wosch: URL: https://cgit.FreeBSD.org/doc/commit/?id=e1f5165f70cdc0f1a63284eca99ceefd440e1eb9 commit e1f5165f70cdc0f1a63284eca99ceefd440e1eb9 Author: Wolfram Schneider AuthorDate: 2021-05-01 19:11:24 +0000 Commit: Wolfram Schneider CommitDate: 2021-05-01 19:11:24 +0000 add OpenBSD 6.9 manual pages --- website/content/en/cgi/man.cgi | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/website/content/en/cgi/man.cgi b/website/content/en/cgi/man.cgi index 81bbe323d5..39146a350a 100755 --- a/website/content/en/cgi/man.cgi +++ b/website/content/en/cgi/man.cgi @@ -171,6 +171,7 @@ $sectionpath = { 'OpenBSD 6.6' => { 'path' => '1:2:3:3p:4:5:6:7:8:9', }, 'OpenBSD 6.7' => { 'path' => '1:2:3:3p:4:5:6:7:8:9', }, 'OpenBSD 6.8' => { 'path' => '1:2:3:3p:4:5:6:7:8:9', }, + 'OpenBSD 6.9' => { 'path' => '1:2:3:3p:4:5:6:7:8:9', }, 'CentOS 3.9' => { 'path' => '1:2:3:3p:4:5:6:7:8:9:n', }, 'CentOS 4.8' => { 'path' => '1:1p:2:3:3p:4:5:6:7:8:9:n:0p', }, @@ -575,6 +576,7 @@ $manPathDefault = 'FreeBSD 12.2-RELEASE and Ports'; 'OpenBSD 6.6', "$manLocalDir/OpenBSD-6.6", 'OpenBSD 6.7', "$manLocalDir/OpenBSD-6.7", 'OpenBSD 6.8', "$manLocalDir/OpenBSD-6.8", + 'OpenBSD 6.9', "$manLocalDir/OpenBSD-6.9", #'NetBSD 0.9', "$manLocalDir/NetBSD-0.9", 'NetBSD 1.0', "$manLocalDir/NetBSD-1.0", @@ -876,6 +878,7 @@ my %arch = ( 'OpenBSD 6.6' => { 'arch' => [qw/alpha amd64 armv7 hppa i386 landisk loongson luna88k macppc octeon sgi socppc sparc64/] }, 'OpenBSD 6.7' => { 'arch' => [qw/alpha amd64 armv7 hppa i386 landisk loongson luna88k macppc octeon sgi socppc sparc64/] }, 'OpenBSD 6.8' => { 'arch' => [qw/alpha amd64 arm64 armv7 hppa i386 landisk loongson luna88k macppc octeon powerpc64 sgi sparc64/] }, +'OpenBSD 6.9' => { 'arch' => [qw/alpha amd64 arm64 armv7 hppa i386 landisk loongson luna88k macppc octeon powerpc64 sgi sparc64/] }, ); # delete not existing releases @@ -919,7 +922,7 @@ while ( ( $key, $val ) = each %manPath ) { 'macosx', 'Darwin 8.0.1/ppc', 'netbsd', 'NetBSD 9.1', - 'openbsd', 'OpenBSD 6.8', + 'openbsd', 'OpenBSD 6.9', 'v7', 'Unix Seventh Edition', 'v7man', 'Unix Seventh Edition', 'x11', 'X11R7.4', From owner-dev-commits-doc-all@freebsd.org Sat May 1 22:54: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 96E7163BE98 for ; Sat, 1 May 2021 22:54: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 4FXl1V3p4Hz3G68; Sat, 1 May 2021 22:54: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 74B7B1FD39; Sat, 1 May 2021 22:54: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 141MssdB024883; Sat, 1 May 2021 22:54:54 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 141Mss97024882; Sat, 1 May 2021 22:54:54 GMT (envelope-from git) Date: Sat, 1 May 2021 22:54:54 GMT Message-Id: <202105012254.141Mss97024882@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 0d9894b11e - main - Improve the SEO of the documentation portal MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 0d9894b11e0e94cde952b0112782e68e27c893da 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: Sat, 01 May 2021 22:54:54 -0000 The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=0d9894b11e0e94cde952b0112782e68e27c893da commit 0d9894b11e0e94cde952b0112782e68e27c893da Author: Sergio Carlavilla Delgado AuthorDate: 2021-05-01 22:51:46 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-05-01 22:54:35 +0000 Improve the SEO of the documentation portal Changes: - Add the description meta tag in the index, articles and books - Add a brief description in each article and book. - Remove the SVN expansion tag --- documentation/config/_default/config.toml | 3 +- .../content/en/articles/bsdl-gpl/_index.adoc | 2 +- .../en/articles/building-products/_index.adoc | 2 +- .../en/articles/committers-guide/_index.adoc | 2 +- .../content/en/articles/contributing/_index.adoc | 2 +- .../content/en/articles/contributors/_index.adoc | 2 +- documentation/content/en/articles/cups/_index.adoc | 2 +- .../content/en/articles/explaining-bsd/_index.adoc | 2 +- .../en/articles/filtering-bridges/_index.adoc | 2 +- .../content/en/articles/fonts/_index.adoc | 2 +- .../en/articles/freebsd-questions/_index.adoc | 2 +- .../content/en/articles/freebsd-releng/_index.adoc | 1 + .../en/articles/freebsd-update-server/_index.adoc | 2 +- .../content/en/articles/geom-class/_index.adoc | 2 +- .../en/articles/gjournal-desktop/_index.adoc | 2 +- documentation/content/en/articles/hubs/_index.adoc | 2 +- .../content/en/articles/ipsec-must/_index.adoc | 2 +- .../content/en/articles/ldap-auth/_index.adoc | 2 +- .../content/en/articles/leap-seconds/_index.adoc | 2 +- .../en/articles/linux-emulation/_index.adoc | 2 +- .../content/en/articles/linux-users/_index.adoc | 2 +- .../en/articles/mailing-list-faq/_index.adoc | 4 +- .../content/en/articles/nanobsd/_index.adoc | 2 +- .../content/en/articles/new-users/_index.adoc | 2 +- documentation/content/en/articles/pam/_index.adoc | 2 +- .../content/en/articles/pgpkeys/_index.adoc | 2 +- .../en/articles/port-mentor-guidelines/_index.adoc | 2 +- .../content/en/articles/pr-guidelines/_index.adoc | 2 +- .../en/articles/problem-reports/_index.adoc | 2 +- .../content/en/articles/rc-scripting/_index.adoc | 2 +- .../content/en/articles/releng/_index.adoc | 1 + .../content/en/articles/remote-install/_index.adoc | 4 +- .../content/en/articles/serial-uart/_index.adoc | 2 +- .../content/en/articles/solid-state/_index.adoc | 4 +- .../content/en/articles/vinum/_index.adoc | 1 + .../content/en/articles/vm-design/_index.adoc | 2 +- .../content/en/books/arch-handbook/_index.adoc | 4 +- .../books/arch-handbook/bibliography/_index.adoc | 1 + .../content/en/books/arch-handbook/book.adoc | 34 +++++----- .../en/books/arch-handbook/boot/_index.adoc | 1 + .../books/arch-handbook/driverbasics/_index.adoc | 1 + .../content/en/books/arch-handbook/isa/_index.adoc | 1 + .../en/books/arch-handbook/jail/_index.adoc | 1 + .../en/books/arch-handbook/kobj/_index.adoc | 1 + .../en/books/arch-handbook/locking/_index.adoc | 1 + .../content/en/books/arch-handbook/mac/_index.adoc | 1 + .../en/books/arch-handbook/newbus/_index.adoc | 1 + .../en/books/arch-handbook/pccard/_index.adoc | 1 + .../content/en/books/arch-handbook/pci/_index.adoc | 1 + .../en/books/arch-handbook/scsi/_index.adoc | 1 + .../content/en/books/arch-handbook/smp/_index.adoc | 1 + .../en/books/arch-handbook/sound/_index.adoc | 1 + .../en/books/arch-handbook/sysinit/_index.adoc | 1 + .../content/en/books/arch-handbook/usb/_index.adoc | 1 + .../content/en/books/arch-handbook/vm/_index.adoc | 1 + .../content/en/books/design-44bsd/_index.adoc | 2 +- .../content/en/books/dev-model/_index.adoc | 2 +- .../en/books/developers-handbook/_index.adoc | 4 +- .../developers-handbook/bibliography/_index.adoc | 1 + .../content/en/books/developers-handbook/book.adoc | 24 +++---- .../developers-handbook/introduction/_index.adoc | 1 + .../en/books/developers-handbook/ipv6/_index.adoc | 1 + .../developers-handbook/kernelbuild/_index.adoc | 1 + .../developers-handbook/kerneldebug/_index.adoc | 1 + .../en/books/developers-handbook/l10n/_index.adoc | 1 + .../books/developers-handbook/policies/_index.adoc | 1 + .../books/developers-handbook/secure/_index.adoc | 1 + .../books/developers-handbook/sockets/_index.adoc | 1 + .../books/developers-handbook/testing/_index.adoc | 1 + .../en/books/developers-handbook/tools/_index.adoc | 1 + .../en/books/developers-handbook/x86/_index.adoc | 1 + documentation/content/en/books/faq/_index.adoc | 4 +- .../content/en/books/fdp-primer/_index.adoc | 3 +- .../fdp-primer/asciidoctor-primer/_index.adoc | 1 + .../content/en/books/fdp-primer/book.adoc | 33 +++++----- .../en/books/fdp-primer/doc-build/_index.adoc | 1 + .../en/books/fdp-primer/editor-config/_index.adoc | 1 + .../en/books/fdp-primer/examples/_index.adoc | 1 + .../en/books/fdp-primer/manual-pages/_index.adoc | 1 + .../en/books/fdp-primer/overview/_index.adoc | 1 + .../books/fdp-primer/po-translations/_index.adoc | 1 + .../en/books/fdp-primer/preface/_index.adoc | 1 + .../en/books/fdp-primer/rosetta/_index.adoc | 1 + .../en/books/fdp-primer/see-also/_index.adoc | 1 + .../en/books/fdp-primer/structure/_index.adoc | 1 + .../content/en/books/fdp-primer/tools/_index.adoc | 1 + .../en/books/fdp-primer/translations/_index.adoc | 1 + .../en/books/fdp-primer/working-copy/_index.adoc | 1 + .../en/books/fdp-primer/writing-style/_index.adoc | 1 + .../content/en/books/handbook/_index.adoc | 2 +- .../books/handbook/advanced-networking/_index.adoc | 1 + .../content/en/books/handbook/audit/_index.adoc | 1 + .../content/en/books/handbook/basics/_index.adoc | 1 + .../en/books/handbook/bibliography/_index.adoc | 1 + documentation/content/en/books/handbook/book.adoc | 76 +++++++++++----------- .../content/en/books/handbook/boot/_index.adoc | 1 + .../en/books/handbook/bsdinstall/_index.adoc | 1 + .../content/en/books/handbook/colophon.adoc | 1 + .../content/en/books/handbook/config/_index.adoc | 1 + .../en/books/handbook/cutting-edge/_index.adoc | 1 + .../content/en/books/handbook/desktop/_index.adoc | 1 + .../content/en/books/handbook/disks/_index.adoc | 1 + .../content/en/books/handbook/dtrace/_index.adoc | 1 + .../en/books/handbook/eresources/_index.adoc | 1 + .../en/books/handbook/filesystems/_index.adoc | 1 + .../en/books/handbook/firewalls/_index.adoc | 1 + .../content/en/books/handbook/geom/_index.adoc | 1 + .../content/en/books/handbook/glossary.adoc | 1 + .../en/books/handbook/introduction/_index.adoc | 1 + .../content/en/books/handbook/jails/_index.adoc | 1 + .../en/books/handbook/kernelconfig/_index.adoc | 1 + .../content/en/books/handbook/l10n/_index.adoc | 1 + .../content/en/books/handbook/linuxemu/_index.adoc | 1 + .../content/en/books/handbook/mail/_index.adoc | 1 + .../content/en/books/handbook/mirrors/_index.adoc | 1 + .../en/books/handbook/multimedia/_index.adoc | 1 + .../en/books/handbook/network-servers/_index.adoc | 1 + .../content/en/books/handbook/pgpkeys/_index.adoc | 1 + .../content/en/books/handbook/ports/_index.adoc | 1 + .../en/books/handbook/ppp-and-slip/_index.adoc | 1 + .../content/en/books/handbook/preface/_index.adoc | 1 + .../content/en/books/handbook/printing/_index.adoc | 1 + .../content/en/books/handbook/security/_index.adoc | 1 + .../en/books/handbook/serialcomms/_index.adoc | 1 + .../en/books/handbook/usb-device-mode/_index.adoc | 1 + .../en/books/handbook/virtualization/_index.adoc | 1 + .../content/en/books/handbook/wine/_index.adoc | 1 + .../content/en/books/handbook/x11/_index.adoc | 1 + .../content/en/books/handbook/zfs/_index.adoc | 1 + .../content/en/books/porters-handbook/_index.adoc | 3 +- .../content/en/books/porters-handbook/book.adoc | 39 +++++------ .../en/books/porters-handbook/flavors/_index.adoc | 1 + .../books/porters-handbook/keeping-up/_index.adoc | 1 + .../books/porters-handbook/makefiles/_index.adoc | 1 + .../en/books/porters-handbook/new-port/_index.adoc | 1 + .../en/books/porters-handbook/order/_index.adoc | 1 + .../books/porters-handbook/pkg-files/_index.adoc | 1 + .../en/books/porters-handbook/plist/_index.adoc | 1 + .../porters-handbook/porting-dads/_index.adoc | 1 + .../porters-handbook/porting-samplem/_index.adoc | 1 + .../books/porters-handbook/porting-why/_index.adoc | 1 + .../porters-handbook/quick-porting/_index.adoc | 1 + .../en/books/porters-handbook/security/_index.adoc | 1 + .../porters-handbook/slow-porting/_index.adoc | 1 + .../en/books/porters-handbook/special/_index.adoc | 1 + .../en/books/porters-handbook/testing/_index.adoc | 1 + .../books/porters-handbook/upgrading/_index.adoc | 1 + .../en/books/porters-handbook/uses/_index.adoc | 1 + .../en/books/porters-handbook/versions/_index.adoc | 1 + .../themes/beastie/layouts/articles/baseof.html | 6 +- .../themes/beastie/layouts/books/baseof.html | 6 +- .../themes/beastie/layouts/partials/site-head.html | 8 +-- 152 files changed, 269 insertions(+), 157 deletions(-) diff --git a/documentation/config/_default/config.toml b/documentation/config/_default/config.toml index fd4b3983fc..9fbd8c26a0 100644 --- a/documentation/config/_default/config.toml +++ b/documentation/config/_default/config.toml @@ -2,7 +2,7 @@ # $FreeBSD$ baseURL = "https://docs.freebsd.org/" -title = "The FreeBSD Project" +title = "FreeBSD Documentation Portal" copyright = "BSD 2-clause 'Simplified' License" DefaultContentLanguage = "en" defaultContentLanguageInSubdir = true @@ -16,6 +16,7 @@ enableRobotsTXT = true [params] websiteURL = "https://www.FreeBSD.org/" + description = "FreeBSD Documentation Portal" [markup.asciidocExt] preserveTOC = true diff --git a/documentation/content/en/articles/bsdl-gpl/_index.adoc b/documentation/content/en/articles/bsdl-gpl/_index.adoc index 01b9cbebec..53872bcc2b 100644 --- a/documentation/content/en/articles/bsdl-gpl/_index.adoc +++ b/documentation/content/en/articles/bsdl-gpl/_index.adoc @@ -3,8 +3,8 @@ title: Why you should use a BSD style license for your Open Source Project authors: - author: Bruce Montague email: brucem@alumni.cse.ucsc.edu -releaseinfo: "$FreeBSD$" trademarks: ["freebsd", "intel", "general"] +description: Why you should use a BSD style license for your Open Source Project --- = Why you should use a BSD style license for your Open Source Project diff --git a/documentation/content/en/articles/building-products/_index.adoc b/documentation/content/en/articles/building-products/_index.adoc index 8538aea5e8..577b1d3d42 100644 --- a/documentation/content/en/articles/building-products/_index.adoc +++ b/documentation/content/en/articles/building-products/_index.adoc @@ -5,7 +5,7 @@ authors: email: jkoshy@FreeBSD.org organizations: - organization: The FreeBSD Project -releaseinfo: "$FreeBSD$" +description: Building Products with FreeBSD trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index a79443f48c..7aad6a68ef 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -3,7 +3,7 @@ title: Committer's Guide authors: - author: The FreeBSD Documentation Project copyright: 1999-2021 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +description: FreeBSD Committer's Guide trademarks: ["freebsd", "coverity", "ibm", "intel", "general"] --- diff --git a/documentation/content/en/articles/contributing/_index.adoc b/documentation/content/en/articles/contributing/_index.adoc index 208b019e6b..c7d61004ec 100644 --- a/documentation/content/en/articles/contributing/_index.adoc +++ b/documentation/content/en/articles/contributing/_index.adoc @@ -4,7 +4,7 @@ authors: - author: Jordan Hubbard - author: Sam Lawrance - author: Mark Linimon -releaseinfo: "$FreeBSD$" +description: Contributing to the FreeBSD Project trademarks: ["freebsd", "ieee", "general"] --- diff --git a/documentation/content/en/articles/contributors/_index.adoc b/documentation/content/en/articles/contributors/_index.adoc index 1919f846c6..afd0f120b4 100644 --- a/documentation/content/en/articles/contributors/_index.adoc +++ b/documentation/content/en/articles/contributors/_index.adoc @@ -1,6 +1,6 @@ --- title: Contributors to FreeBSD -releaseinfo: "$FreeBSD$" +description: Contributors to FreeBSD trademarks: ["freebsd", "sun", "general"] --- diff --git a/documentation/content/en/articles/cups/_index.adoc b/documentation/content/en/articles/cups/_index.adoc index 008369f0ad..1bd26b5da6 100644 --- a/documentation/content/en/articles/cups/_index.adoc +++ b/documentation/content/en/articles/cups/_index.adoc @@ -3,7 +3,7 @@ title: CUPS on FreeBSD authors: - author: Chess Griffin email: chess@chessgriffin.com -releaseinfo: "$FreeBSD$" +description: How to install and use CUPS on FreeBSD trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/explaining-bsd/_index.adoc b/documentation/content/en/articles/explaining-bsd/_index.adoc index ce636eb968..a4c56fa7fd 100644 --- a/documentation/content/en/articles/explaining-bsd/_index.adoc +++ b/documentation/content/en/articles/explaining-bsd/_index.adoc @@ -3,7 +3,7 @@ title: Explaining BSD authors: - author: Greg Lehey email: grog@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: Brief explanation about BSD trademarks: ["freebsd", "amd", "apple", "intel", "linux", "opengroup", "sun", "unix", "general"] --- diff --git a/documentation/content/en/articles/filtering-bridges/_index.adoc b/documentation/content/en/articles/filtering-bridges/_index.adoc index d880fb95f6..7a3647c0fb 100644 --- a/documentation/content/en/articles/filtering-bridges/_index.adoc +++ b/documentation/content/en/articles/filtering-bridges/_index.adoc @@ -3,7 +3,7 @@ title: Filtering Bridges authors: - author: Alex Dupre email: ale@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: Filtering Bridges in FreeBSD trademarks: ["freebsd", "3com", "intel", "general"] --- diff --git a/documentation/content/en/articles/fonts/_index.adoc b/documentation/content/en/articles/fonts/_index.adoc index 498371dfcb..70e52a1a91 100644 --- a/documentation/content/en/articles/fonts/_index.adoc +++ b/documentation/content/en/articles/fonts/_index.adoc @@ -4,7 +4,7 @@ subtitle: A Tutorial authors: - author: Dave Bodenstab email: imdave@synet.net -releaseinfo: "$FreeBSD$" +description: Description of the various font files that may be used with FreeBSD trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "general"] --- diff --git a/documentation/content/en/articles/freebsd-questions/_index.adoc b/documentation/content/en/articles/freebsd-questions/_index.adoc index 95774ce2c6..51d18e0cef 100644 --- a/documentation/content/en/articles/freebsd-questions/_index.adoc +++ b/documentation/content/en/articles/freebsd-questions/_index.adoc @@ -3,7 +3,7 @@ title: How to get Best Results from the FreeBSD-questions Mailing List authors: - author: Greg Lehey email: grog@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: How to get Best Results from the FreeBSD-questions Mailing List trademarks: ["freebsd", "microsoft", "opengroup", "qualcomm", "general"] --- diff --git a/documentation/content/en/articles/freebsd-releng/_index.adoc b/documentation/content/en/articles/freebsd-releng/_index.adoc index 65410cf4a0..5615986124 100644 --- a/documentation/content/en/articles/freebsd-releng/_index.adoc +++ b/documentation/content/en/articles/freebsd-releng/_index.adoc @@ -8,6 +8,7 @@ organizations: webpage: https://www.freebsdfoundation.org/ - organization: Rubicon Communications, LLC (Netgate) webpage: https://www.netgate.com/ +description: FreeBSD Release Engineering trademarks: ["freebsd", "intel", "general"] --- diff --git a/documentation/content/en/articles/freebsd-update-server/_index.adoc b/documentation/content/en/articles/freebsd-update-server/_index.adoc index 394836d40e..6ee32d4eee 100644 --- a/documentation/content/en/articles/freebsd-update-server/_index.adoc +++ b/documentation/content/en/articles/freebsd-update-server/_index.adoc @@ -4,7 +4,7 @@ authors: - author: Jason Helfman email: jgh@FreeBSD.org copyright: 2009-2011, 2013 Jason Helfman -releaseinfo: "$FreeBSD$" +description: Build Your Own FreeBSD Update Server trademarks: ["freebsd", "amd", "intel", "general"] --- diff --git a/documentation/content/en/articles/geom-class/_index.adoc b/documentation/content/en/articles/geom-class/_index.adoc index 81795771fd..8c93697afb 100644 --- a/documentation/content/en/articles/geom-class/_index.adoc +++ b/documentation/content/en/articles/geom-class/_index.adoc @@ -3,7 +3,7 @@ title: Writing a GEOM Class authors: - author: Ivan Voras email: ivoras@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: Writing a GEOM Class in FreeBSD trademarks: ["freebsd", "intel", "general"] --- diff --git a/documentation/content/en/articles/gjournal-desktop/_index.adoc b/documentation/content/en/articles/gjournal-desktop/_index.adoc index 320a0b2295..99f51b0ac9 100644 --- a/documentation/content/en/articles/gjournal-desktop/_index.adoc +++ b/documentation/content/en/articles/gjournal-desktop/_index.adoc @@ -3,7 +3,7 @@ title: Implementing UFS Journaling on a Desktop PC authors: - author: Manolis Kiagias email: manolis@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: Implementing UFS Journaling on a Desktop PC trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/hubs/_index.adoc b/documentation/content/en/articles/hubs/_index.adoc index 07bcdc840b..3819b76d71 100644 --- a/documentation/content/en/articles/hubs/_index.adoc +++ b/documentation/content/en/articles/hubs/_index.adoc @@ -9,7 +9,7 @@ authors: email: dl@leo.org - author: Ken Smith email: kensmith@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: How to mirror FreeBSD trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/ipsec-must/_index.adoc b/documentation/content/en/articles/ipsec-must/_index.adoc index 04bbab552c..f514789fd4 100644 --- a/documentation/content/en/articles/ipsec-must/_index.adoc +++ b/documentation/content/en/articles/ipsec-must/_index.adoc @@ -3,7 +3,7 @@ title: Independent Verification of IPsec Functionality in FreeBSD authors: - author: David Honig email: honig@sprynet.com -releaseinfo: "$FreeBSD$" +description: Independent Verification of IPsec Functionality in FreeBSD trademarks: ["freebsd", "opengroup", "general"] --- diff --git a/documentation/content/en/articles/ldap-auth/_index.adoc b/documentation/content/en/articles/ldap-auth/_index.adoc index d848ae896e..206a6d4ed6 100644 --- a/documentation/content/en/articles/ldap-auth/_index.adoc +++ b/documentation/content/en/articles/ldap-auth/_index.adoc @@ -4,7 +4,7 @@ authors: - author: Toby Burress email: kurin@causa-sui.net copyright: 2007-2008 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +description: Guide for the configuration of an LDAP server for authentication on FreeBSD trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/leap-seconds/_index.adoc b/documentation/content/en/articles/leap-seconds/_index.adoc index 64271ff340..8ad3c6154e 100644 --- a/documentation/content/en/articles/leap-seconds/_index.adoc +++ b/documentation/content/en/articles/leap-seconds/_index.adoc @@ -1,6 +1,6 @@ --- title: FreeBSD Support for Leap Seconds -releaseinfo: "$FreeBSD$" +description: FreeBSD Support for Leap Seconds --- = FreeBSD Support for Leap Seconds diff --git a/documentation/content/en/articles/linux-emulation/_index.adoc b/documentation/content/en/articles/linux-emulation/_index.adoc index f19362a9d0..701bf524cc 100644 --- a/documentation/content/en/articles/linux-emulation/_index.adoc +++ b/documentation/content/en/articles/linux-emulation/_index.adoc @@ -3,7 +3,7 @@ title: Linux® emulation in FreeBSD authors: - author: Roman Divacky email: rdivacky@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: Linux® emulation in FreeBSD trademarks: ["freebsd", "ibm", "adobe", "netbsd", "realnetworks", "oracle", "linux", "sun", "general"] --- diff --git a/documentation/content/en/articles/linux-users/_index.adoc b/documentation/content/en/articles/linux-users/_index.adoc index 2198e6d09d..5406d0b7bb 100644 --- a/documentation/content/en/articles/linux-users/_index.adoc +++ b/documentation/content/en/articles/linux-users/_index.adoc @@ -3,7 +3,7 @@ title: FreeBSD Quickstart Guide for Linux® Users authors: - author: John Ferrell copyright: 2008 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +description: This document is intended to quickly familiarize intermediate to advanced Linux® users with the basics of FreeBSD. trademarks: ["freebsd", "intel", "redhat", "linux", "unix", "general"] --- diff --git a/documentation/content/en/articles/mailing-list-faq/_index.adoc b/documentation/content/en/articles/mailing-list-faq/_index.adoc index c4430812bd..81bb9f2b07 100644 --- a/documentation/content/en/articles/mailing-list-faq/_index.adoc +++ b/documentation/content/en/articles/mailing-list-faq/_index.adoc @@ -2,8 +2,8 @@ title: Frequently Asked Questions About The FreeBSD Mailing Lists authors: - author: The FreeBSD Documentation Project -copyright: 2004-2005 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +copyright: 2004-2021 The FreeBSD Documentation Project +description: Frequently Asked Questions About The FreeBSD Mailing Lists --- = Frequently Asked Questions About The FreeBSD Mailing Lists diff --git a/documentation/content/en/articles/nanobsd/_index.adoc b/documentation/content/en/articles/nanobsd/_index.adoc index a006140591..016fa739a8 100644 --- a/documentation/content/en/articles/nanobsd/_index.adoc +++ b/documentation/content/en/articles/nanobsd/_index.adoc @@ -3,7 +3,7 @@ title: Introduction to NanoBSD authors: - author: Daniel Gerzo copyright: 2006 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +description: This document provides information about the NanoBSD tools, which can be used to create FreeBSD system images for embedded applications, suitable for use on a USB key, memory card or other mass storage media. trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/new-users/_index.adoc b/documentation/content/en/articles/new-users/_index.adoc index ff1de0b682..93588811b9 100644 --- a/documentation/content/en/articles/new-users/_index.adoc +++ b/documentation/content/en/articles/new-users/_index.adoc @@ -3,7 +3,7 @@ title: For People New to Both FreeBSD and UNIX® authors: - author: Annelise Anderson email: andrsn@andrsn.stanford.edu -releaseinfo: "$FreeBSD$" +description: Introduction for people new to both FreeBSD and UNIX® trademarks: ["freebsd", "ibm", "microsoft", "opengroup", "general"] --- diff --git a/documentation/content/en/articles/pam/_index.adoc b/documentation/content/en/articles/pam/_index.adoc index 82bd501ba2..6f3d5a22d6 100644 --- a/documentation/content/en/articles/pam/_index.adoc +++ b/documentation/content/en/articles/pam/_index.adoc @@ -3,7 +3,7 @@ title: Pluggable Authentication Modules authors: - author: Dag-Erling Smørgrav copyright: 2001-2003 Networks Associates Technology, Inc. -releaseinfo: "$FreeBSD$" +description: Pluggable Authentication Modules (PAM) in FreeBSD trademarks: ["pam", "freebsd", "linux", "opengroup", "sun", "general"] --- diff --git a/documentation/content/en/articles/pgpkeys/_index.adoc b/documentation/content/en/articles/pgpkeys/_index.adoc index a09cfe8fcd..f55d39fe46 100644 --- a/documentation/content/en/articles/pgpkeys/_index.adoc +++ b/documentation/content/en/articles/pgpkeys/_index.adoc @@ -1,6 +1,6 @@ --- title: OpenPGP Keys -releaseinfo: "$FreeBSD$" +description: List of OpenPGP keys that can be used to verify a signature or send encrypted email to FreeBSD.org officers or developers. --- = OpenPGP Keys diff --git a/documentation/content/en/articles/port-mentor-guidelines/_index.adoc b/documentation/content/en/articles/port-mentor-guidelines/_index.adoc index 1d9d5f4cbe..a8a50b05bc 100644 --- a/documentation/content/en/articles/port-mentor-guidelines/_index.adoc +++ b/documentation/content/en/articles/port-mentor-guidelines/_index.adoc @@ -3,7 +3,7 @@ title: Port Mentor Guidelines organizations: - organization: The FreeBSD Ports Management Team copyright: 2011 Thomas Abthorpe, Chris Rees -releaseinfo: "$FreeBSD$" +description: Port Mentor Guidelines for FreeBSD Mentors --- = Port Mentor Guidelines diff --git a/documentation/content/en/articles/pr-guidelines/_index.adoc b/documentation/content/en/articles/pr-guidelines/_index.adoc index deea48608d..50a0159802 100644 --- a/documentation/content/en/articles/pr-guidelines/_index.adoc +++ b/documentation/content/en/articles/pr-guidelines/_index.adoc @@ -3,7 +3,7 @@ title: Problem Report Handling Guidelines authors: - author: Dag-Erling Smørgrav - author: Hiten Pandya -releaseinfo: "$FreeBSD$" +description: These guidelines describe recommended handling practices for FreeBSD Problem Reports (PRs). trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/problem-reports/_index.adoc b/documentation/content/en/articles/problem-reports/_index.adoc index 3294a5266e..d61055bdfc 100644 --- a/documentation/content/en/articles/problem-reports/_index.adoc +++ b/documentation/content/en/articles/problem-reports/_index.adoc @@ -3,7 +3,7 @@ title: Writing FreeBSD Problem Reports authors: - author: Dag-Erling Smørgrav - author: Mark Linimon -releaseinfo: "$FreeBSD$" +description: Writing FreeBSD Problem Reports trademarks: ["freebsd", "ibm", "intel", "sun", "general"] --- diff --git a/documentation/content/en/articles/rc-scripting/_index.adoc b/documentation/content/en/articles/rc-scripting/_index.adoc index 336f5c03c2..72e71bffbd 100644 --- a/documentation/content/en/articles/rc-scripting/_index.adoc +++ b/documentation/content/en/articles/rc-scripting/_index.adoc @@ -4,7 +4,7 @@ authors: - author: Yar Tikhiy email: yar@FreeBSD.org copyright: 2005-2006, 2012 The FreeBSD Project -releaseinfo: "$FreeBSD$" +description: Practical rc.d scripting in BSD trademarks: ["freebsd", "netbsd", "general"] --- diff --git a/documentation/content/en/articles/releng/_index.adoc b/documentation/content/en/articles/releng/_index.adoc index 51a1b647c8..665c3cea45 100644 --- a/documentation/content/en/articles/releng/_index.adoc +++ b/documentation/content/en/articles/releng/_index.adoc @@ -4,6 +4,7 @@ authors: - author: Murray Stokely email: murray@FreeBSD.org webpage: https://people.FreeBSD.org/~murray/ +description: This paper describes the approach used by the FreeBSD release engineering team to make production quality releases of the FreeBSD Operating System trademarks: ["freebsd", "intel", "general"] --- diff --git a/documentation/content/en/articles/remote-install/_index.adoc b/documentation/content/en/articles/remote-install/_index.adoc index bf97ed25e6..e5343b75a9 100644 --- a/documentation/content/en/articles/remote-install/_index.adoc +++ b/documentation/content/en/articles/remote-install/_index.adoc @@ -3,8 +3,8 @@ title: Remote Installation of the FreeBSD Operating System Without a Remote Cons authors: - author: Daniel Gerzo email: danger@FreeBSD.org -copyright: 2008 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +copyright: 2008-2021 The FreeBSD Documentation Project +description: Remote Installation of the FreeBSD Operating System Without a Remote Console trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/serial-uart/_index.adoc b/documentation/content/en/articles/serial-uart/_index.adoc index aed42baa0f..9bd53781e0 100644 --- a/documentation/content/en/articles/serial-uart/_index.adoc +++ b/documentation/content/en/articles/serial-uart/_index.adoc @@ -3,7 +3,7 @@ title: Serial and UART Tutorial authors: - author: Frank Durda email: uhclem@FreeBSD.org -releaseinfo: "$FreeBSD$" +description: How to use serial hardware and UART with FreeBSD trademarks: ["freebsd", "microsoft", "general"] --- diff --git a/documentation/content/en/articles/solid-state/_index.adoc b/documentation/content/en/articles/solid-state/_index.adoc index 988a7e5aad..4a1b022fdb 100644 --- a/documentation/content/en/articles/solid-state/_index.adoc +++ b/documentation/content/en/articles/solid-state/_index.adoc @@ -3,8 +3,8 @@ title: FreeBSD and Solid State Devices authors: - author: John Kozubik email: john@kozubik.com -copyright: 2001, 2009 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +copyright: 2001 - 2021 The FreeBSD Documentation Project +description: FreeBSD and Solid State Devices trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/vinum/_index.adoc b/documentation/content/en/articles/vinum/_index.adoc index 20d786ab5a..329a417bcc 100644 --- a/documentation/content/en/articles/vinum/_index.adoc +++ b/documentation/content/en/articles/vinum/_index.adoc @@ -2,6 +2,7 @@ title: The vinum Volume Manager authors: - author: Greg Lehey +description: The vinum Volume Manager in FreeBSD --- = The vinum Volume Manager diff --git a/documentation/content/en/articles/vm-design/_index.adoc b/documentation/content/en/articles/vm-design/_index.adoc index 2b7163da83..12a60f6962 100644 --- a/documentation/content/en/articles/vm-design/_index.adoc +++ b/documentation/content/en/articles/vm-design/_index.adoc @@ -3,7 +3,7 @@ title: Design elements of the FreeBSD VM system authors: - author: Matthew Dillon email: dillon@apollo.backplane.com -releaseinfo: "$FreeBSD$" +description: Design elements of the FreeBSD VM system trademarks: ["freebsd", "linux", "microsoft", "opengroup", "daemon-news", "general"] --- diff --git a/documentation/content/en/books/arch-handbook/_index.adoc b/documentation/content/en/books/arch-handbook/_index.adoc index 2ae3066029..a5cefc4616 100644 --- a/documentation/content/en/books/arch-handbook/_index.adoc +++ b/documentation/content/en/books/arch-handbook/_index.adoc @@ -2,8 +2,8 @@ title: FreeBSD Architecture Handbook authors: - author: The FreeBSD Documentation Project -copyright: Copyright © 2000-2006, 2012-2013 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD$" +copyright: Copyright © 2000-2006, 2012-2021 The FreeBSD Documentation Project +description: FreeBSD Architecture Handbook Index trademarks: ["freebsd", "apple", "microsoft", "unix", "general"] next: books/arch-handbook/parti --- diff --git a/documentation/content/en/books/arch-handbook/bibliography/_index.adoc b/documentation/content/en/books/arch-handbook/bibliography/_index.adoc index a33b858ee5..1ba9e79298 100644 --- a/documentation/content/en/books/arch-handbook/bibliography/_index.adoc +++ b/documentation/content/en/books/arch-handbook/bibliography/_index.adoc @@ -1,6 +1,7 @@ --- title: Bibliography prev: books/arch-handbook/partiii +description: Bibliography of the FreeBSD Architecture Handbook --- [appendix] diff --git a/documentation/content/en/books/arch-handbook/book.adoc b/documentation/content/en/books/arch-handbook/book.adoc index 4fbb953a12..2de998232c 100644 --- a/documentation/content/en/books/arch-handbook/book.adoc +++ b/documentation/content/en/books/arch-handbook/book.adoc @@ -70,28 +70,28 @@ toc::[] // Section one include::{chapters-path}parti.adoc[lines=7..8] -include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}locking/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}kobj/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}jail/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}sysinit/_index.adoc[leveloffset=+1], lines=7..21;32..-1] -include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=12..26;37..-1] -include::{chapters-path}vm/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}smp/_index.adoc[leveloffset=+1, lines=7..21;32..-1] +include::{chapters-path}boot/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}locking/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}kobj/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}jail/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}sysinit/_index.adoc[leveloffset=+1], lines=8..22;33..-1] +include::{chapters-path}mac/_index.adoc[leveloffset=+1, lines=13..27;38..-1] +include::{chapters-path}vm/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}smp/_index.adoc[leveloffset=+1, lines=8..22;33..-1] // Section two include::{chapters-path}partii.adoc[lines=7..8] -include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}isa/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}pci/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}scsi/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}usb/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}newbus/_index.adoc[leveloffset=+1, lines=12..26;37..-1] -include::{chapters-path}sound/_index.adoc[leveloffset=+1, lines=7..21;32..-1] -include::{chapters-path}pccard/_index.adoc[leveloffset=+1, lines=7..21;32..-1] +include::{chapters-path}driverbasics/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}isa/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}pci/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}scsi/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}usb/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}newbus/_index.adoc[leveloffset=+1, lines=13..27;38..-1] +include::{chapters-path}sound/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}pccard/_index.adoc[leveloffset=+1, lines=8..22;33..-1] // Section three include::{chapters-path}partiii.adoc[lines=7..8] -include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=6..19;28..-1] +include::{chapters-path}bibliography/_index.adoc[leveloffset=+1, lines=7..20;29..-1] diff --git a/documentation/content/en/books/arch-handbook/boot/_index.adoc b/documentation/content/en/books/arch-handbook/boot/_index.adoc index 44b4e3c1be..e98c7114fe 100644 --- a/documentation/content/en/books/arch-handbook/boot/_index.adoc +++ b/documentation/content/en/books/arch-handbook/boot/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 1. Bootstrapping and Kernel Initialization prev: books/arch-handbook/parti next: books/arch-handbook/locking +description: Bootstrapping and Kernel Initialization --- [[boot]] diff --git a/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc b/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc index 07732d34bb..46c08ba0aa 100644 --- a/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc +++ b/documentation/content/en/books/arch-handbook/driverbasics/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 9. Writing FreeBSD Device Drivers prev: books/arch-handbook/partii next: books/arch-handbook/isa +description: Writing FreeBSD Device Drivers --- [[driverbasics]] diff --git a/documentation/content/en/books/arch-handbook/isa/_index.adoc b/documentation/content/en/books/arch-handbook/isa/_index.adoc index a51c91ad1d..454f973fb0 100644 --- a/documentation/content/en/books/arch-handbook/isa/_index.adoc +++ b/documentation/content/en/books/arch-handbook/isa/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 10. ISA Device Drivers prev: books/arch-handbook/driverbasics next: books/arch-handbook/pci +description: ISA Device Drivers --- [[isa-driver]] diff --git a/documentation/content/en/books/arch-handbook/jail/_index.adoc b/documentation/content/en/books/arch-handbook/jail/_index.adoc index 4ea78c7bb8..46bbf2565b 100644 --- a/documentation/content/en/books/arch-handbook/jail/_index.adoc +++ b/documentation/content/en/books/arch-handbook/jail/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 4. The Jail Subsystem prev: books/arch-handbook/kobj next: books/arch-handbook/sysinit +description: The Jail Subsystem --- [[jail]] diff --git a/documentation/content/en/books/arch-handbook/kobj/_index.adoc b/documentation/content/en/books/arch-handbook/kobj/_index.adoc index bd11946acd..f2760e2252 100644 --- a/documentation/content/en/books/arch-handbook/kobj/_index.adoc +++ b/documentation/content/en/books/arch-handbook/kobj/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 3. Kernel Objects prev: books/arch-handbook/locking next: books/arch-handbook/jail +description: Kernel Objects --- [[kernel-objects]] diff --git a/documentation/content/en/books/arch-handbook/locking/_index.adoc b/documentation/content/en/books/arch-handbook/locking/_index.adoc index 517c615b99..fdbdd70d4e 100644 --- a/documentation/content/en/books/arch-handbook/locking/_index.adoc +++ b/documentation/content/en/books/arch-handbook/locking/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 2. Locking Notes prev: books/arch-handbook/boot next: books/arch-handbook/kobj +description: Locking Notes --- [[locking]] diff --git a/documentation/content/en/books/arch-handbook/mac/_index.adoc b/documentation/content/en/books/arch-handbook/mac/_index.adoc index f33be4228e..b6d2903530 100644 --- a/documentation/content/en/books/arch-handbook/mac/_index.adoc +++ b/documentation/content/en/books/arch-handbook/mac/_index.adoc @@ -7,6 +7,7 @@ authors: email: rwatson@FreeBSD.org prev: books/arch-handbook/sysinit next: books/arch-handbook/vm +description: The TrustedBSD MAC Framework --- [[mac]] diff --git a/documentation/content/en/books/arch-handbook/newbus/_index.adoc b/documentation/content/en/books/arch-handbook/newbus/_index.adoc index 797011d3f8..69a4109ec4 100644 --- a/documentation/content/en/books/arch-handbook/newbus/_index.adoc +++ b/documentation/content/en/books/arch-handbook/newbus/_index.adoc @@ -7,6 +7,7 @@ authors: email: hiten@uk.FreeBSD.org prev: books/arch-handbook/usb next: books/arch-handbook/sound +description: Newbus --- [[newbus]] diff --git a/documentation/content/en/books/arch-handbook/pccard/_index.adoc b/documentation/content/en/books/arch-handbook/pccard/_index.adoc index 1b7be9e711..6690023a19 100644 --- a/documentation/content/en/books/arch-handbook/pccard/_index.adoc +++ b/documentation/content/en/books/arch-handbook/pccard/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 16. PC Card prev: books/arch-handbook/sound next: books/arch-handbook/partiii +description: PC Card --- [[pccard]] diff --git a/documentation/content/en/books/arch-handbook/pci/_index.adoc b/documentation/content/en/books/arch-handbook/pci/_index.adoc index b4a7b72c9c..5adb945dd5 100644 --- a/documentation/content/en/books/arch-handbook/pci/_index.adoc +++ b/documentation/content/en/books/arch-handbook/pci/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 11. PCI Devices prev: books/arch-handbook/isa next: books/arch-handbook/scsi +description: PCI Devices --- [[pci]] diff --git a/documentation/content/en/books/arch-handbook/scsi/_index.adoc b/documentation/content/en/books/arch-handbook/scsi/_index.adoc index 6192c65cbd..49fcd635d4 100644 --- a/documentation/content/en/books/arch-handbook/scsi/_index.adoc +++ b/documentation/content/en/books/arch-handbook/scsi/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 12. Common Access Method SCSI Controllers prev: books/arch-handbook/pci next: books/arch-handbook/usb +description: Common Access Method SCSI Controllers --- [[scsi]] diff --git a/documentation/content/en/books/arch-handbook/smp/_index.adoc b/documentation/content/en/books/arch-handbook/smp/_index.adoc index a47de5f260..b3f9f87ccb 100644 --- a/documentation/content/en/books/arch-handbook/smp/_index.adoc +++ b/documentation/content/en/books/arch-handbook/smp/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 8. SMPng Design Document prev: books/arch-handbook/vm next: books/arch-handbook/partii +description: SMPng Design Document --- [[smp]] diff --git a/documentation/content/en/books/arch-handbook/sound/_index.adoc b/documentation/content/en/books/arch-handbook/sound/_index.adoc index a7b6567206..94c43f0172 100644 --- a/documentation/content/en/books/arch-handbook/sound/_index.adoc +++ b/documentation/content/en/books/arch-handbook/sound/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 15. Sound Subsystem prev: books/arch-handbook/newbus next: books/arch-handbook/pccard +description: FreeBSD Sound Subsystem --- [[oss]] diff --git a/documentation/content/en/books/arch-handbook/sysinit/_index.adoc b/documentation/content/en/books/arch-handbook/sysinit/_index.adoc index dab2239d7a..401dfc4c71 100644 --- a/documentation/content/en/books/arch-handbook/sysinit/_index.adoc +++ b/documentation/content/en/books/arch-handbook/sysinit/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 5. The SYSINIT Framework prev: books/arch-handbook/jail next: books/arch-handbook/mac +description: The SYSINIT Framework --- [[sysinit]] diff --git a/documentation/content/en/books/arch-handbook/usb/_index.adoc b/documentation/content/en/books/arch-handbook/usb/_index.adoc index 18a06c4a0b..f7b3d9c69a 100644 --- a/documentation/content/en/books/arch-handbook/usb/_index.adoc +++ b/documentation/content/en/books/arch-handbook/usb/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 13. USB Devices prev: books/arch-handbook/scsi next: books/arch-handbook/newbus +description: USB Devices in FreeBSD --- [[usb]] diff --git a/documentation/content/en/books/arch-handbook/vm/_index.adoc b/documentation/content/en/books/arch-handbook/vm/_index.adoc index 12b9bf56e6..5593eb4322 100644 --- a/documentation/content/en/books/arch-handbook/vm/_index.adoc +++ b/documentation/content/en/books/arch-handbook/vm/_index.adoc @@ -2,6 +2,7 @@ title: Chapter 7. Virtual Memory System prev: books/arch-handbook/mac next: books/arch-handbook/smp +description: Virtual Memory System in FreeBSD --- [[vm]] diff --git a/documentation/content/en/books/design-44bsd/_index.adoc b/documentation/content/en/books/design-44bsd/_index.adoc index 1c730ed3b2..bab937e2fc 100644 --- a/documentation/content/en/books/design-44bsd/_index.adoc +++ b/documentation/content/en/books/design-44bsd/_index.adoc @@ -6,7 +6,7 @@ authors: - author: Michael J. Karels - author: John S. Quarterman copyright: 1996 Addison-Wesley Longman, Inc -releaseinfo: "$FreeBSD$" +description: The Design and Implementation of the 4.4BSD Operating System. Second chapter. trademarks: ["design-44bsd"] --- diff --git a/documentation/content/en/books/dev-model/_index.adoc b/documentation/content/en/books/dev-model/_index.adoc index 887493f584..c5b4061159 100644 --- a/documentation/content/en/books/dev-model/_index.adoc +++ b/documentation/content/en/books/dev-model/_index.adoc @@ -3,7 +3,7 @@ title: A project model for the FreeBSD Project authors: - author: Niklas Saers copyright: Copyright © 2002-2005 Niklas Saers -releaseinfo: "$FreeBSD$" +description: A project model for the FreeBSD Project trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"] --- diff --git a/documentation/content/en/books/developers-handbook/_index.adoc b/documentation/content/en/books/developers-handbook/_index.adoc index 3082156c0f..c7407e78d1 100644 --- a/documentation/content/en/books/developers-handbook/_index.adoc +++ b/documentation/content/en/books/developers-handbook/_index.adoc @@ -2,8 +2,8 @@ title: FreeBSD Developers' Handbook authors: - author: The FreeBSD Documentation Project -copyright: 1995-2020 The FreeBSD Documentation Project -releaseinfo: "$FreeBSD: head/en_US.ISO8859-1/books/developers-handbook/book.xml 54255 2020-06-15 08:13:08Z bcr $" +copyright: 1995-2021 The FreeBSD Documentation Project +description: FreeBSD Developers' Handbook Index trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"] next: books/developers-handbook/parti --- diff --git a/documentation/content/en/books/developers-handbook/bibliography/_index.adoc b/documentation/content/en/books/developers-handbook/bibliography/_index.adoc index fa861831c5..b4cc86fc48 100644 --- a/documentation/content/en/books/developers-handbook/bibliography/_index.adoc +++ b/documentation/content/en/books/developers-handbook/bibliography/_index.adoc @@ -1,6 +1,7 @@ --- title: Appendices prev: books/developers-handbook/partv +description: FreeBSD Developers Handbook Bibliography --- [appendix] diff --git a/documentation/content/en/books/developers-handbook/book.adoc b/documentation/content/en/books/developers-handbook/book.adoc index 7953a77d83..a9e497d499 100644 --- a/documentation/content/en/books/developers-handbook/book.adoc +++ b/documentation/content/en/books/developers-handbook/book.adoc @@ -73,27 +73,27 @@ toc::[] // Section one include::{chapters-path}parti.adoc[lines=7..8] -include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=10..24;35..-1] -include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=10..26;37..-1] -include::{chapters-path}secure/_index.adoc[leveloffset=+1, lines=9..23;34..-1] -include::{chapters-path}l10n/_index.adoc[leveloffset=+1, lines=8..22;33..-1] -include::{chapters-path}policies/_index.adoc[leveloffset=+1, lines=10..24;35..-1] -include::{chapters-path}testing/_index.adoc[leveloffset=+1, lines=8..22;33..-1] +include::{chapters-path}introduction/_index.adoc[leveloffset=+1, lines=11..25;36..-1] +include::{chapters-path}tools/_index.adoc[leveloffset=+1, lines=11..27;38..-1] +include::{chapters-path}secure/_index.adoc[leveloffset=+1, lines=10..24;35..-1] *** 1395 LINES SKIPPED *** From owner-dev-commits-doc-all@freebsd.org Sun May 2 08:24: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 F1B9C5FC9CA for ; Sun, 2 May 2021 08:24: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 4FXzfQ6VV8z4S1J; Sun, 2 May 2021 08:24: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 C738F2783A; Sun, 2 May 2021 08:24: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 1428OEXm079221; Sun, 2 May 2021 08:24:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1428OEgl079220; Sun, 2 May 2021 08:24:14 GMT (envelope-from git) Date: Sun, 2 May 2021 08:24:14 GMT Message-Id: <202105020824.1428OEgl079220@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: c639301c3a - main - Fix html lang, add canonical link and add theme-color meta tag MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c639301c3a5f0176c2d57c0b72fe7701ee5120da 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: Sun, 02 May 2021 08:24:15 -0000 The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=c639301c3a5f0176c2d57c0b72fe7701ee5120da commit c639301c3a5f0176c2d57c0b72fe7701ee5120da Author: Sergio Carlavilla Delgado AuthorDate: 2021-05-02 08:21:06 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2021-05-02 08:21:06 +0000 Fix html lang, add canonical link and add theme-color meta tag --- documentation/themes/beastie/layouts/_default/baseof.html | 2 +- documentation/themes/beastie/layouts/articles/baseof.html | 5 ++--- documentation/themes/beastie/layouts/books/baseof.html | 5 ++--- documentation/themes/beastie/layouts/partials/site-head.html | 12 ++++++++++++ 4 files changed, 17 insertions(+), 7 deletions(-) diff --git a/documentation/themes/beastie/layouts/_default/baseof.html b/documentation/themes/beastie/layouts/_default/baseof.html index 46d88a99a9..2e4abf1ff6 100644 --- a/documentation/themes/beastie/layouts/_default/baseof.html +++ b/documentation/themes/beastie/layouts/_default/baseof.html @@ -1,5 +1,5 @@ - + {{ partial "site-head.html" . }}
    diff --git a/documentation/themes/beastie/layouts/articles/baseof.html b/documentation/themes/beastie/layouts/articles/baseof.html index f0dc57dcc3..b8be735562 100644 --- a/documentation/themes/beastie/layouts/articles/baseof.html +++ b/documentation/themes/beastie/layouts/articles/baseof.html @@ -1,13 +1,12 @@ - + - - + {{ block "title" . }}{{ with .Params.Title }} {{ . }}{{ end }}{{ end }} diff --git a/documentation/themes/beastie/layouts/books/baseof.html b/documentation/themes/beastie/layouts/books/baseof.html index f0dc57dcc3..b8be735562 100644 --- a/documentation/themes/beastie/layouts/books/baseof.html +++ b/documentation/themes/beastie/layouts/books/baseof.html @@ -1,13 +1,12 @@ - + - - + {{ block "title" . }}{{ with .Params.Title }} {{ . }}{{ end }}{{ end }} diff --git a/documentation/themes/beastie/layouts/partials/site-head.html b/documentation/themes/beastie/layouts/partials/site-head.html index 5242f76004..5a9485afee 100644 --- a/documentation/themes/beastie/layouts/partials/site-head.html +++ b/documentation/themes/beastie/layouts/partials/site-head.html @@ -4,11 +4,23 @@ + {{ block "title" . }}{{ .Site.Title }}{{ with .Params.Title }} | {{ . }}{{ end }}{{ end }} + + + + + + + + + + + From owner-dev-commits-doc-all@freebsd.org Sun May 2 12:12: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 7586F62361F for ; Sun, 2 May 2021 12:12: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 4FY4jX2vpWz4cqF; Sun, 2 May 2021 12:12: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 56A562738; Sun, 2 May 2021 12:12: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 142CCGcY083941; Sun, 2 May 2021 12:12:16 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142CCGuH083940; Sun, 2 May 2021 12:12:16 GMT (envelope-from git) Date: Sun, 2 May 2021 12:12:16 GMT Message-Id: <202105021212.142CCGuH083940@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: a974b5d618 - main - a9a9e66105 -> 16ca20a527 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: a974b5d6181721963b3a8b7df1a1d19d4865fc82 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: Sun, 02 May 2021 12:12:16 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=a974b5d6181721963b3a8b7df1a1d19d4865fc82 commit a974b5d6181721963b3a8b7df1a1d19d4865fc82 Author: Ryusuke SUZUKI AuthorDate: 2021-05-02 12:11:56 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-02 12:11:56 +0000 a9a9e66105 -> 16ca20a527 --- .../content/ja/books/handbook/mirrors/_index.adoc | 375 +++++++++++++++++++-- 1 file changed, 351 insertions(+), 24 deletions(-) diff --git a/documentation/content/ja/books/handbook/mirrors/_index.adoc b/documentation/content/ja/books/handbook/mirrors/_index.adoc index 91cb928fc8..afd192b374 100644 --- a/documentation/content/ja/books/handbook/mirrors/_index.adoc +++ b/documentation/content/ja/books/handbook/mirrors/_index.adoc @@ -62,15 +62,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 サイト @@ -390,25 +381,32 @@ In case of problems, please contact the hostmaster `<{mirrors-us-email}>` for th * {mirrors-us-ftp14} (ftp / {mirrors-us-ftp14-http}) * {mirrors-us-ftp15} (ftp) -[[svn]] -== Subversion を使う +[[git]] +== Git の利用 -[[svn-intro]] +[[git-intro]] === はじめに -2012 年 7 月から、FreeBSD はすべてのソースコード、ドキュメント、Ports Collection を管理するバージョン管理システムに Subversion を使っています。 +2020 年 12 月から、FreeBSD はソースコード、ドキュメントのすべてを管理するメインのバージョン管理システムに git を使っています。 [NOTE] ==== -一般的には Subversion は開発者向けのツールです。 ユーザは、FreeBSD のベースシステムのアップデートに `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,「FreeBSD Update」])、 Ports Collection のアップデートには `portsnap` (crossref:ports[ports-using,「Ports Collection の利用」]) を使うことを好むでしょう。 +一般的には Git は開発用ツールです。 +ユーザによっては、FreeBSD ベースシステムのアップデートに `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,“FreeBSD Update”])、 +FreeBSD Ports Collection のアップデートに `portsnap` (crossref:ports[ports-using,“Ports Collection の利用”]) を好んで使用するでしょう。 ==== -この節では、FreeBSD システムへの Subversion のインストール方法、および FreeBSD リポジトリをローカルに作成する方法について説明します。 さらに Subversion を利用するための情報についても紹介します。 +この章では、FreeBSD 上への Git のインストール方法および、 +FreeBSD リポジトリのローカルコピーの作成方法について説明します。 +Git の使用方法についても紹介します。 -[[svn-ssl-certificates]] +[[git-ssl-certificates]] === ルート SSL 証明書 -package:security/ca_root_nss[] をインストールすることで、 Subversion は、 HTTPS リポジトリサーバを検証できます。 ルート SSL 証明書は、 port からインストールできます。 +12._x_ より前の古い FreeBSD システムは、適切なルート証明書を持っていません。 +これらのシステムに package:security/ca_root_nss[] をインストールすることで、 +Git は HTTPS リポジトリサーバを検証できるようになります。 +ルート SSL 証明書は port からインストールできます。 [source,shell] .... @@ -423,6 +421,330 @@ package:security/ca_root_nss[] をインストールすることで、 Subversio # pkg install ca_root_nss .... +[[git-install]] +=== インストール + +package を使って Git をインストールできます。 + +[source,shell] +.... +# pkg install git +.... + +Ports Collection からも Git をインストールできます。 + +[source,shell] +.... +# cd /usr/ports/devel/git +# make install clean +.... + +[[git-usage]] +=== Git の実行 + +ソースコードをローカルディレクトリに新しくコピーするには、`git` を使ってください。 +このファイルのあるディレクトリのことを _ワークツリー_ と呼びます。 + +[WARNING] +==== + +コピー先のディレクトリが既に存在する場合は、`git clone` をはじめて使う前にディレクトリを移動するか削除してください。 +git 以外の方法で用意されたディレクトリに対するリポジトリのクローンは失敗するでしょう。 +==== + +Git は、リポジトリの指定に _protocol://hostname/path_ 形式の URL を用います。 +path の最初でアクセスする FreeBSD リポジトリを指定します。 +リポジトリには `base`, `doc` および `ports` の 3 種類あります。 +`base` は FreeBSD ベースシステムのソースコード、`doc` はドキュメント、そして `ports` は FreeBSD Ports Collection のリポジトリです。 +たとえば、`https://git.FreeBSD.org/src.git` という URL は、`https` プロトコルによる src リポジトリの main ブランチを示します。 + +[[git-url-table]] +.FreeBSD Git リポジトリの URL テーブル +[options="header,foooter"] +|======================================================= +|項目 | Git URL +| ウェブベースの src リポジトリブラウザ | `https://cgit.freebsd.org/src` +| HTTPS 経由の読み取り専用 src リポジトリ | `https://git.freebsd.org/src.git` +| Anonymous ssh による読み取り専用 src リポジトリ | `ssh://anongit@git.freebsd.org/src.git` +| コミッタのための読み取り/書き込み用 src リポジトリ | `ssh://git@gitrepo.freebsd.org/src.git` (*) +| ウェブベースの doc リポジトリブラウザ | `https://cgit.freebsd.org/doc` +| HTTPS 経由の読み取り専用 doc リポジトリ | `https://git.freebsd.org/doc.git` +| Anonymous ssh による読み取り専用 doc リポジトリ | `ssh://anongit@git.freebsd.org/doc.git` +| コミッタのための読み取り/書き込み用 doc リポジトリ | `ssh://git@gitrepo.freebsd.org/doc.git` (*) +| ウェブベースの ports リポジトリブラウザ | `https://cgit.freebsd.org/ports` +| HTTPS 経由の読み取り専用 ports リポジトリ| `https://git.freebsd.org/ports.git` +| Anonymous ssh による読み取り専用 ports リポジトリ | `ssh://anongit@git.freebsd.org/ports.git` +| コミッタのための読み取り/書き込み用 ports リポジトリ | `ssh://git@gitrepo.freebsd.org/ports.git` (*) +|======================================================= + - (*) `git` は、リポジトリサーバ上の特別なユーザです。 +リポジトリサーバは、FreeBSD.org に登録されている ssh 鍵からユーザを識別するので、変更する必要はありません。 + +[WARNING] +==== + +git への移行完了後、`gitrepo.freebsd.org` は単純な `repo.freebsd.org` に変更される予定です。 +==== + + +利用開始には、FreeBSD リポジトリを clone してください。 + +[source,shell] +.... +# git clone -o freebsd [ -b branch ] https://git.FreeBSD.org/repo.git wcdir +.... + +ここで + +* _repo_ は、プロジェクトリポジトリの `src`, `ports`, または `doc` のどれかになります。 +* _branch_ は、使用しているリポジトリに依存します。 +`ports` および `doc` では、ほとんどの変更が `main` ブランチで行われる一方で、`src` では -CURRENT の最新版を `main` で管理し、各 -STABLE ブランチの最新版を `stable/12` (12._x_) および `stable/13` (13._x_) で管理しています。 +* _wcdir_ は、指定したブランチの内容が置かれるターゲットディレクトリです。 +通常、`ports` では [.filename]#/usr/ports#、 `src` では [.filename]#/usr/src#、そして `doc` では [.filename]#/usr/doc# です。 +* _freebsd_ は、使用する origin の名前です。 +FreeBSD のドキュメントの慣例で、origin は `freebsd` とします。 + +この例では、FreeBSD リポジトリからシステムのソースの 'main' ブランチを HTTPS プロトコルを用いてチェックアウトし、ローカルのワーキングコピーを [.filename]#/usr/src# に作成します。 +もし、[.filename]#/usr/src# がすでに存在していて、`git` により作成されたものでなければ、チェックアウトの前に、名前を変更するか削除しておいてください。 +そうでなければ、git は何も行わないでしょう。 + +[source,shell] +.... +# git clone -o freebsd https://git.FreeBSD.org/src.git /usr/src +.... + +初めてチェックアウトする際には、リモートリポジトリのすべてのブランチをダウンロードするので時間がかかります。 + +初めてのチェックアウト後は、 以下を実行することでローカルのワーキングコピーをアップデートできます。 + +[source,shell] +.... +# cd wcdir +# git pull --rebase +.... + +この例で作成された [.filename]#/usr/src# をアップデートするには、以下のようになります。 + +[source,shell] +.... +# cd /usr/src +# git pull --rebase +.... + +チェックアウトと比較すると、このアップデートでは変更点のあるファイルのみが転送されるので高速です。 + +プロジェクトのメンバーが管理する外部のミラーも存在します。 +<> の節を参照してください。 + +=== SSH 関連情報 + +* `ssh://${user}@${url}/${repo}.git` は、`${user}@${url}:${repo}.git` と書くこともできます。すなわち git 上では以下の二つの URL は両方とも使えます。 +-- +** `ssh://anongit@git.freebsd.org/${repo}.git` +** `anongit@git.freebsd.org:${repo}.git` + +読み書き用リポジトリでも同様です。 + +** `ssh://git@(git)repo.freebsd.org/${repo}.git` +** `git@(git)repo.freebsd.org:${repo}.git` +-- + +* gitrepo.FreeBSD.org ホスト鍵のフィンガープリントは以下です。 +** ECDSA 鍵のフィンガープリントは `SHA256:seWO5D27ySURcx4bknTNKlC1mgai0whP443PAKEvvZA` です。 +** ED25519 鍵のフィンガープリントは `SHA256:lNR6i4BEOaaUhmDHBA1WJsO7H3KtvjE2r5q4sOxtIWo` です。 +** RSA 鍵のフィンガープリントは `SHA256:f453CUEFXEJAXlKeEHV+ajJfeEfx9MdKQUD7lIscnQI` です。 + +* git.FreeBSD.org ホスト鍵のフィンガープリントは以下です。 +** ECDSA 鍵のフィンガープリントは `SHA256:/UlirUAsGiitupxmtsn7f9b7zCWd0vCs4Yo/tpVWP9w` です。 +** ED25519 鍵のフィンガープリントは `SHA256:y1ljKrKMD3lDObRUG3xJ9gXwEIuqnh306tSyFd1tuZE` です。 +** RSA 鍵のフィンガープリントは `SHA256:jBe6FQGoH4HjvrIVM23dcnLZk9kmpdezR/CvQzm7rJM` です。 + +これらは DNS の SSHFP レコードとしても公開されています。 + +=== ウェブベースのリポジトリブラウザ + +FreeBSD プロジェクトは、現在 cgit をウェブベースのリポジトリブラウザ (https://cgit.freebsd.org/) として使用しています。 +各リポジトリの URL は、<> にまとめられています。 + +=== ユーザ向けの説明 + +公式の配布用のミラーから`git clone` および `git pull` することが推奨されています。 +GeoDNS により、近くの利用可能なミラーがユーザに提供されます。 + +=== 開発者向けの説明 + +この節では、コミッタがリモートリポジトリに読み書きアクセスし、開発者や貢献者からのコミットをリモートリポジトリに反映する方法について説明します。 +読み取り専用のアクセスについては、上記のユーザ向けの説明を参照してください。 + +==== 日々の利用 + +* リポジトリを clone してください。 ++ +[source,shell] +.... +% git clone -o freebsd --config remote.freebsd.fetch='+refs/notes/*:refs/notes/*' https://git.freebsd.org/${repo}.git +.... ++ +実行すると、公式ミラーがリモートリポジトリに設定されます。 ++ +[source,shell] +.... +% git remote -v +freebsd https://git.freebsd.org/${repo}.git (fetch) +freebsd https://git.freebsd.org/${repo}.git (push) +.... + +* FreeBSD コミッタ情報の設定 ++ +repo.freebsd.org のコミットのフックは、"Commit" フィールドが FreeBSD.org のコミッタ情報にマッチするかを確認します。 +freefall 上で `/usr/local/bin/gen-gitconfig.sh` スクリプトを実行すると、これらの設定を簡単に行うことができます。 ++ +[source,shell] +.... +% gen-gitconfig.sh +[...] +% git config user.name (your name in gecos) +% git config user.email (your login)@FreeBSD.org +.... + +* push 先の URL を設定してください。 ++ +[source,shell] +.... +% git remote set-url --push freebsd git@gitrepo.freebsd.org:${repo}.git +.... ++ +実行すると、最も効率的な fetch と push が別の URL に設定されます。 ++ +[source,shell] +.... +% git remote -v +freebsd https://git.freebsd.org/${repo}.git (fetch) +freebsd git@gitrepo.freebsd.org:${repo}.git (push) +.... ++ +繰り返しになりますが、将来的に、`gitrepo.freebsd.org` は `repo.freebsd.org` に正規化される予定です。 + +* コミットメッセージのテンプレートのフックをインストールしてください。 ++ +[source,shell] +.... +% fetch https://cgit.freebsd.org/src/plain/tools/tools/git/hooks/prepare-commit-msg -o .git/hooks +% chmod 755 .git/hooks/prepare-commit-msg +.... + +==== "admin" ブランチ + +`access` および `mentors` ファイルは、各リポジトリの orphan ブランチ `internal/admin` で管理されています。 + +以下の例では、`internal/admin` ブランチをローカルブランチ `admin` にチェックアウトする方法を示しています。 + +[source,shell] +.... +% git config --add remote.freebsd.fetch '+refs/internal/*:refs/internal/*' +% git fetch +% git checkout -b admin internal/admin +.... +または、`admin` ブランチ用にワークツリーを追加する方法もあります。 + +[source,shell] +.... +git worktree add -b admin ../${repo}-admin internal/admin +.... + +`internal/admin` ブランチはウェブブラウザを使って +https://cgit.freebsd.org/${repo}/log/?h=internal/admin +で閲覧できます。 + +push の際には、以下のように完全な refspec を指定するか + +[source,shell] +.... +git push freebsd HEAD:refs/internal/admin +.... + +または、`push.default` を `upstream` に設定してください。 +この設定を行うと、`git push` は、現在のブランチをデフォルトで upstream に push します。 +このこれは、プロジェクトのワークフローにより適しています。 + +[source,shell] +.... +git config push.default upstream +.... + +[WARNING] +==== +この節で説明した内部の詳細は頻繁に変更されます。 +==== + + +[[external-mirrors]] +=== 外部ミラー + +FreeBSD.org は以下のミラーを管理しておらず、プロジェクトのメンバーが現在も維持しています。 +ユーザおよび開発者は自由にこれらのミラーのリポジトリを pull したりブラウザで見ることができます。 +これらのミラーとのプロジェクトワークフローは議論中です。 + +==== Codeberg + - doc: https://codeberg.org/FreeBSD/freebsd-doc + - ports: https://codeberg.org/FreeBSD/freebsd-ports + - src: https://codeberg.org/FreeBSD/freebsd-src + +==== GitHub + - doc: https://github.com/freebsd/freebsd-doc + - ports: https://github.com/freebsd/freebsd-ports + - src: https://github.com/freebsd/freebsd-src + +==== GitLab + - doc: https://gitlab.com/FreeBSD/freebsd-doc + - ports: https://gitlab.com/FreeBSD/freebsd-ports + - src: https://gitlab.com/FreeBSD/freebsd-src + +=== メーリングリスト + +FreeBSD プロジェクトにおける git の一般的な使用方法や質問について: [freebsd-git](https://lists.freebsd.org/mailman/listinfo/freebsd-git) + +コミットメッセージは以下のメーリングリストに送信されます。 + +- https://lists.freebsd.org/mailman/listinfo/dev-commits-doc-all[dev-commits-doc-all]: doc リポジトリに対するすべての変更 +- https://lists.freebsd.org/mailman/listinfo/dev-commits-ports-all[dev-commits-ports-all]: ports リポジトリに対するすべての変更 +- https://lists.freebsd.org/mailman/listinfo/dev-commits-ports-main[dev-commits-ports-main]: ports リポジトリの "main" ブランチに対するすべての変更 +- https://lists.freebsd.org/mailman/listinfo/dev-commits-ports-branches[dev-commits-ports-branches]: ports リポジトリの quarterly ブランチに対するすべての変更 +- https://lists.freebsd.org/mailman/listinfo/dev-commits-src-all[dev-commits-src-all]: src リポジトリに対するすべての変更 +- https://lists.freebsd.org/mailman/listinfo/dev-commits-src-main[dev-commits-src-main]: src リポジトリの "main" ブランチ (FreeBSD-CURRENT ブランチ) に対するすべての変更 +- https://lists.freebsd.org/mailman/listinfo/dev-commits-src-branches[dev-commits-src-branches]: src リポジトリの stable ブランチに対するすべての変更 + +詳細については、ハンドブックの C.2. 「メーリングリスト」 https://www.freebsd.org/doc/ja/books/handbook/eresources-mail.html の "コミットメッセージリスト" の節を参照してください。 + +[[svn]] +== Subversion の利用 + +[[svn-intro]] +=== はじめに + +2020 年 12 月より、FreeBSD のソースコード、ドキュメントのすべてを管理するメインのバージョン管理システムは git に移行しました。 +git リポジトリの `stable/11`, `stable/12` および関連するリリースのブランチは、subversion リポジトリにエクスポートされます。 +このエクスポートは、各ブランチの保守終了予定日まで行われる予定です。 +2012 年 7 月から 2021 年 3 月までの間 FreeBSD は、FreeBSD Ports Collection のすべてを管理するバージョン管理システムに Subversion を使用していました。 +2021 年 4 月より、FreeBSD の Ports Collection のすべてを管理するメインのバージョン管理システムは git に移行しました。 + +[NOTE] +==== +-一般的には Subversion は開発者向けのツールです。 +ユーザは好みに応じて、FreeBSD のベースシステムのアップデートに `freebsd-update` (crossref:cutting-edge[updating-upgrading-freebsdupdate,「FreeBSD Update」])、Ports Collection のアップデートには `portsnap` (crossref:ports[ports-using,「Ports Collection の利用」]) を使用できます。 +2021 年 3 月以降、subversion はレガシーブランチ (`stable/11` および `stable/12`) でのみ使用されます。 +==== + +この節では、FreeBSD システムへの Subversion のインストール方法、および FreeBSD リポジトリをローカルに作成する方法について説明します。 +さらに Subversion を利用するための情報についても紹介します。 + +[[svn-ssl-certificates]] +=== ルート SSL 証明書 + +12._x_ より前の古い FreeBSD システムは、適切なルート証明書を持っていません。 +これらのシステムに package:security/ca_root_nss[] をインストールすることで、 +Subversion は HTTPS リポジトリサーバを検証できるようになります。 +インストールの手順については、<> で説明されています。 + [[svn-svnlite]] === Svnlite @@ -457,13 +779,14 @@ package を使って Subversion をインストールすることもできます [WARNING] ==== - `checkout` をはじめて使う前に、 ローカルディレクトリを移動するか削除してください。 - `svn` 以外の方法で用意されたディレクトリでチェックアウトすると、 すでに存在するファイルと、 リポジトリから持ってきたファイルとの間で衝突が起きてしまいます。 ==== -Subversion では、リポジトリの指定に _protocol://hostname/path_ 形式の URL を用います。 以下に記載されているように、 アクセスする FreeBSD リポジトリは、パス (path) の最初で指定します。 リポジトリは 3 つあります。 `base` は FreeBSD ベースシステムのソースコード、 `ports` は Ports Collection、 そして `doc` はドキュメントのリポジトリです。 たとえば、 `https://svn.FreeBSD.org/ports/head/` という URL は、`https` プロトコルによる ports リポジトリのメインブランチを示しています。 +Subversion では、リポジトリの指定に _protocol://hostname/path_ 形式の URL を用います。 以下に記載されているように、 アクセスする FreeBSD リポジトリは、パス (path) の最初で指定します。 +リポジトリは 3 つあります。 +`base` は FreeBSD ベースシステムのソースコード、`ports` は Ports Collection、 そして `doc` はドキュメントのリポジトリです。 +たとえば、`https://svn.FreeBSD.org/base/head/` という URL は、`https` プロトコルによる ports リポジトリのメインブランチを示しています。 以下のように入力して、リポジトリからチェックアウトしてください。 @@ -478,11 +801,13 @@ Subversion では、リポジトリの指定に _protocol://hostname/path_ 形 * _branch_ は、使うリポジトリによります。 `ports` および `doc` では、ほとんどの変更が `head` ブランチで行われます。 `base` リポジトリでは、`head` ブランチで -CURRENT の最新バージョンを管理しています。 -STABLE ブランチの最新バージョンは、 9._x_ は `stable/9`, そして 10._x_ は `stable/10` で管理しています。 * _lwcdir_ は、 指定したブランチの中身が置かれるターゲットのディレクトリです。 通常 `ports` は [.filename]#/usr/ports#、 `base` は [.filename]#/usr/src#、 そして `doc` では [.filename]#/usr/doc# と指定します。 -以下の例では、Ports Collection を HTTPS プロトコルを使って、 FreeBSD リポジトリからチェックアウトします。 そしてそれらは、 [.filename]#/usr/ports# のローカル作業コピーに置かれます。 もし [.filename]#/usr/ports# がすでに存在して、 それが `svn` によって生成されたものでなければ、 チェックアウトする前に、名前を変更するか削除してください。 +以下の例では、ソースツリーを FreeBSD リポジトリから HTTPS プロトコルを使ってチェックアウトします。 +それらは、[.filename]#/usr/src# のローカル作業コピーに置かれます。 +もし [.filename]#/usr/src# がすでに存在していて、それが `svn` によって生成されたものでなければ、チェックアウトする前に、名前を変更するか削除してください。 [source,shell] .... -# svn checkout https://svn.FreeBSD.org/ports/head /usr/ports +# svn checkout https://svn.FreeBSD.org/base/head /usr/src .... 初めてチェックアウトする際には、 リモートリポジトリのすべてのブランチをダウンロードする必要があるので、 時間がかかります。 我慢してください。 @@ -498,7 +823,7 @@ Subversion では、リポジトリの指定に _protocol://hostname/path_ 形 [source,shell] .... -# svn update /usr/ports +# svn update /usr/src .... アップデートはチェックアウトにくらべ、 変更点のあるファイルのみが転送されるので高速です。 @@ -588,9 +913,11 @@ rsync://ftp-master.FreeBSD.org/ このサーバは、FreeBSD の一次ミラーサイトとしてのみ使われています。 + 提供しているコレクション: - ++ +-- ** FreeBSD: FreeBSD FTP サーバのマスタアーカイブ ** acl: The FreeBSD マスタ ACL リスト +-- + rsync://ftp13.FreeBSD.org/ + From owner-dev-commits-doc-all@freebsd.org Sun May 2 13:52: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 4F720626257 for ; Sun, 2 May 2021 13:52: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 4FY6xB1pGxz4j9h; Sun, 2 May 2021 13:52: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 3119D4078; Sun, 2 May 2021 13:52: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 142DqU3I016371; Sun, 2 May 2021 13:52:30 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142DqUk9016370; Sun, 2 May 2021 13:52:30 GMT (envelope-from git) Date: Sun, 2 May 2021 13:52:30 GMT Message-Id: <202105021352.142DqUk9016370@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: c637715280 - main - 16ca20a527 -> 0d9894b11e 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: c637715280eb0bd5c765fcb5237af218b85d0aa8 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: Sun, 02 May 2021 13:52:30 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=c637715280eb0bd5c765fcb5237af218b85d0aa8 commit c637715280eb0bd5c765fcb5237af218b85d0aa8 Author: Ryusuke SUZUKI AuthorDate: 2021-05-02 13:52:00 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-02 13:52:00 +0000 16ca20a527 -> 0d9894b11e --- documentation/content/ja/books/handbook/mirrors/_index.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/content/ja/books/handbook/mirrors/_index.adoc b/documentation/content/ja/books/handbook/mirrors/_index.adoc index afd192b374..be16ec79dc 100644 --- a/documentation/content/ja/books/handbook/mirrors/_index.adoc +++ b/documentation/content/ja/books/handbook/mirrors/_index.adoc @@ -3,6 +3,7 @@ title: 付録A FreeBSD の入手方法 part: パートV. 付録 prev: books/handbook/partv next: books/handbook/bibliography +description: "FreeBSD の入手方法: CD および DVD セット, FTP サイト, Git のインストールおよび利用方法" --- [appendix] From owner-dev-commits-doc-all@freebsd.org Sun May 2 14:34: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 75E7B6273E9 for ; Sun, 2 May 2021 14:34: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 4FY7sj2vnGz4kRH; Sun, 2 May 2021 14:34: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 565EA4B9B; Sun, 2 May 2021 14:34: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 142EYX9j069477; Sun, 2 May 2021 14:34:33 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142EYXlD069476; Sun, 2 May 2021 14:34:33 GMT (envelope-from git) Date: Sun, 2 May 2021 14:34:33 GMT Message-Id: <202105021434.142EYXlD069476@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 0c1e7b73ba - main - Correct target directory (/usr/ports/ -> /usr/src) in the svn update example. 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: 0c1e7b73bae786e7a701baf23c39559c38306864 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: Sun, 02 May 2021 14:34:33 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=0c1e7b73bae786e7a701baf23c39559c38306864 commit 0c1e7b73bae786e7a701baf23c39559c38306864 Author: Ryusuke SUZUKI AuthorDate: 2021-05-02 14:33:56 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-02 14:33:56 +0000 Correct target directory (/usr/ports/ -> /usr/src) in the svn update example. --- 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 2f1f895a81..f28a6b6201 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -802,7 +802,7 @@ After the initial checkout, the local working copy can be updated by running: # svn update lwcdir .... -To update [.filename]#/usr/ports# created in the example above, use: +To update [.filename]#/usr/src# created in the example above, use: [source,shell] .... From owner-dev-commits-doc-all@freebsd.org Sun May 2 15:06: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 289AD6285E8 for ; Sun, 2 May 2021 15:06: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 4FY8ZT0j0Yz4m2X; Sun, 2 May 2021 15:06: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 0AF9448F1; Sun, 2 May 2021 15:06: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 142F6OkY010569; Sun, 2 May 2021 15:06:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142F6O7p010568; Sun, 2 May 2021 15:06:24 GMT (envelope-from git) Date: Sun, 2 May 2021 15:06:24 GMT Message-Id: <202105021506.142F6O7p010568@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 5f34386a8b - main - Add description about ports migration to Git in the Git chapter. 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: 5f34386a8b15171c9bca1a195788478b60804f0e 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: Sun, 02 May 2021 15:06:25 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=5f34386a8b15171c9bca1a195788478b60804f0e commit 5f34386a8b15171c9bca1a195788478b60804f0e Author: Ryusuke SUZUKI AuthorDate: 2021-05-02 15:06:08 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-02 15:06:08 +0000 Add description about ports migration to Git in the Git chapter. --- documentation/content/en/books/handbook/mirrors/_index.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc index f28a6b6201..e15d256b0d 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -385,6 +385,7 @@ In case of problems, please contact the hostmaster `<{mirrors-us-email}>` for th === Introduction As of December 2020, FreeBSD uses git as the primary version control system for storing all of FreeBSD's base source code and documentation. +As of April 2021, FreeBSD uses git as the only version control system for storing all of FreeBSD's Ports Collection. [NOTE] ==== From owner-dev-commits-doc-all@freebsd.org Sun May 2 15:26:32 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 ABB77628EAF for ; Sun, 2 May 2021 15:26:32 +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 4FY91h4L29z4ms2; Sun, 2 May 2021 15:26:32 +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 87A0B5275; Sun, 2 May 2021 15:26:32 +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 142FQWBL036799; Sun, 2 May 2021 15:26:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142FQWiC036798; Sun, 2 May 2021 15:26:32 GMT (envelope-from git) Date: Sun, 2 May 2021 15:26:32 GMT Message-Id: <202105021526.142FQWiC036798@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: d33336d548 - main - Bump latest version number of -STABLE branches (9.x and 10.x -> 11.x and 12.x). 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: d33336d54867a9e61f5751fbaf28e287519859e2 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: Sun, 02 May 2021 15:26:32 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=d33336d54867a9e61f5751fbaf28e287519859e2 commit d33336d54867a9e61f5751fbaf28e287519859e2 Author: Ryusuke SUZUKI AuthorDate: 2021-05-02 15:26:15 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-02 15:26:15 +0000 Bump latest version number of -STABLE branches (9.x and 10.x -> 11.x and 12.x). --- 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 e15d256b0d..518daf5493 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -784,7 +784,7 @@ A checkout from a given repository is performed with a command like this: where: * _repository_ is one of the Project repositories: `base`, `ports`, or `doc`. -* _branch_ depends on the repository used. `ports` and `doc` are mostly updated in the `head` branch, while `base` maintains the latest version of -CURRENT under `head` and the respective latest versions of the -STABLE branches under `stable/9` (9._x_) and `stable/10` (10._x_). +* _branch_ depends on the repository used. `ports` and `doc` are mostly updated in the `head` branch, while `base` maintains the latest version of -CURRENT under `head` and the respective latest versions of the -STABLE branches under `stable/11` (11._x_) and `stable/12` (12._x_). * _lwcdir_ is the target directory where the contents of the specified branch should be placed. This is usually [.filename]#/usr/ports# for `ports`, [.filename]#/usr/src# for `base`, and [.filename]#/usr/doc# for `doc`. This example checks out the Source Tree from the FreeBSD repository using the HTTPS protocol, placing the local working copy in [.filename]#/usr/src#. If [.filename]#/usr/src# is already present but was not created by `svn`, remember to rename or delete it before the checkout. From owner-dev-commits-doc-all@freebsd.org Sun May 2 15:36: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 6959062938D for ; Sun, 2 May 2021 15:36: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 4FY9Dn2ZFVz4mjC; Sun, 2 May 2021 15:36: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 4B18254A7; Sun, 2 May 2021 15:36: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 142Fa90j050256; Sun, 2 May 2021 15:36:09 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142Fa964050255; Sun, 2 May 2021 15:36:09 GMT (envelope-from git) Date: Sun, 2 May 2021 15:36:09 GMT Message-Id: <202105021536.142Fa964050255@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: a2e74741dc - main - Correct the explanation of https://svn.FreeBSD.org/base/head/ (ports -> src). 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: a2e74741dc2880be35f032b036cee569a1a9f489 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: Sun, 02 May 2021 15:36:09 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=a2e74741dc2880be35f032b036cee569a1a9f489 commit a2e74741dc2880be35f032b036cee569a1a9f489 Author: Ryusuke SUZUKI AuthorDate: 2021-05-02 15:35:31 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-02 15:35:31 +0000 Correct the explanation of https://svn.FreeBSD.org/base/head/ (ports -> src). --- 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 518daf5493..b25baa66f5 100644 --- a/documentation/content/en/books/handbook/mirrors/_index.adoc +++ b/documentation/content/en/books/handbook/mirrors/_index.adoc @@ -772,7 +772,7 @@ Move or delete an existing destination directory before using `checkout` for the Checkout over an existing non-`svn` directory can cause conflicts between the existing files and those brought in from the repository. ==== -Subversion 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 three different repositories, `base` for the FreeBSD base system source code, `ports` for the Ports Collection, and `doc` for documentation. For example, the URL `https://svn.FreeBSD.org/base/head/` specifies the main branch of the ports repository, using the `https` protocol. +Subversion 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 three different repositories, `base` for the FreeBSD base system source code, `ports` for the Ports Collection, and `doc` for documentation. For example, the URL `https://svn.FreeBSD.org/base/head/` specifies the main branch of the src repository, using the `https` protocol. A checkout from a given repository is performed with a command like this: From owner-dev-commits-doc-all@freebsd.org Sun May 2 16:01: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 2FACF629ACE for ; Sun, 2 May 2021 16:01: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 4FY9pV0pxqz4nvS; Sun, 2 May 2021 16:01: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 0E5075E0D; Sun, 2 May 2021 16:01: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 142G1rcn087004; Sun, 2 May 2021 16:01:53 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142G1rYw087003; Sun, 2 May 2021 16:01:53 GMT (envelope-from git) Date: Sun, 2 May 2021 16:01:53 GMT Message-Id: <202105021601.142G1rYw087003@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ryusuke SUZUKI Subject: git: 9b466b179d - main - 0d9894b11e -> a2e74741dc 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: 9b466b179d46c3fd7ec38d8b61a2ee68dbe20caa 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: Sun, 02 May 2021 16:01:54 -0000 The branch main has been updated by ryusuke: URL: https://cgit.FreeBSD.org/doc/commit/?id=9b466b179d46c3fd7ec38d8b61a2ee68dbe20caa commit 9b466b179d46c3fd7ec38d8b61a2ee68dbe20caa Author: Ryusuke SUZUKI AuthorDate: 2021-05-02 16:01:34 +0000 Commit: Ryusuke SUZUKI CommitDate: 2021-05-02 16:01:34 +0000 0d9894b11e -> a2e74741dc --- documentation/content/ja/books/handbook/mirrors/_index.adoc | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/documentation/content/ja/books/handbook/mirrors/_index.adoc b/documentation/content/ja/books/handbook/mirrors/_index.adoc index be16ec79dc..bb36436def 100644 --- a/documentation/content/ja/books/handbook/mirrors/_index.adoc +++ b/documentation/content/ja/books/handbook/mirrors/_index.adoc @@ -389,6 +389,7 @@ In case of problems, please contact the hostmaster `<{mirrors-us-email}>` for th === はじめに 2020 年 12 月から、FreeBSD はソースコード、ドキュメントのすべてを管理するメインのバージョン管理システムに git を使っています。 +2021 年 4 月から、FreeBSD は Ports Collection のすべてを管理するバージョン管理システムに git を使っています。 [NOTE] ==== @@ -787,7 +788,7 @@ package を使って Subversion をインストールすることもできます Subversion では、リポジトリの指定に _protocol://hostname/path_ 形式の URL を用います。 以下に記載されているように、 アクセスする FreeBSD リポジトリは、パス (path) の最初で指定します。 リポジトリは 3 つあります。 `base` は FreeBSD ベースシステムのソースコード、`ports` は Ports Collection、 そして `doc` はドキュメントのリポジトリです。 -たとえば、`https://svn.FreeBSD.org/base/head/` という URL は、`https` プロトコルによる ports リポジトリのメインブランチを示しています。 +たとえば、`https://svn.FreeBSD.org/base/head/` という URL は、`https` プロトコルによる src リポジトリのメインブランチを示しています。 以下のように入力して、リポジトリからチェックアウトしてください。 @@ -799,7 +800,7 @@ Subversion では、リポジトリの指定に _protocol://hostname/path_ 形 ここで、_repository_, _branch_ および _root_ は以下のとおりです。 * _repository_ には、 プロジェクトリポジトリの `base`, `ports` または `doc` のどれかひとつを指定します。 -* _branch_ は、使うリポジトリによります。 `ports` および `doc` では、ほとんどの変更が `head` ブランチで行われます。 `base` リポジトリでは、`head` ブランチで -CURRENT の最新バージョンを管理しています。 -STABLE ブランチの最新バージョンは、 9._x_ は `stable/9`, そして 10._x_ は `stable/10` で管理しています。 +* _branch_ は、使うリポジトリによります。 `ports` および `doc` では、ほとんどの変更が `head` ブランチで行われます。 `base` リポジトリでは、`head` ブランチで -CURRENT の最新バージョンを管理しています。 -STABLE ブランチの最新バージョンは、 11._x_ は `stable/11`, そして 12._x_ は `stable/12` で管理しています。 * _lwcdir_ は、 指定したブランチの中身が置かれるターゲットのディレクトリです。 通常 `ports` は [.filename]#/usr/ports#、 `base` は [.filename]#/usr/src#、 そして `doc` では [.filename]#/usr/doc# と指定します。 以下の例では、ソースツリーを FreeBSD リポジトリから HTTPS プロトコルを使ってチェックアウトします。 @@ -820,7 +821,7 @@ Subversion では、リポジトリの指定に _protocol://hostname/path_ 形 # svn update lwcdir .... -この例で作成された [.filename]#/usr/ports# をアップデートするには、 以下のようにしてください。 +この例で作成された [.filename]#/usr/src# をアップデートするには、 以下のようにしてください。 [source,shell] .... From owner-dev-commits-doc-all@freebsd.org Sun May 2 16:54: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 4DC9B62AABA for ; Sun, 2 May 2021 16:54: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 4FYBz81gtHz4qJv; Sun, 2 May 2021 16:54:28 +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 2BB17645A; Sun, 2 May 2021 16:54: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 142GsSCm055414; Sun, 2 May 2021 16:54:28 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142GsST9055413; Sun, 2 May 2021 16:54:28 GMT (envelope-from git) Date: Sun, 2 May 2021 16:54:28 GMT Message-Id: <202105021654.142GsST9055413@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Allan Jude Subject: git: 2c5bff688d - main - Improve descriptions for some books and articles MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: allanjude X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2c5bff688d8653c4306a2f6fdbb2c966eaee5a1c 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: Sun, 02 May 2021 16:54:28 -0000 The branch main has been updated by allanjude: URL: https://cgit.FreeBSD.org/doc/commit/?id=2c5bff688d8653c4306a2f6fdbb2c966eaee5a1c commit 2c5bff688d8653c4306a2f6fdbb2c966eaee5a1c Author: Allan Jude AuthorDate: 2021-05-02 16:10:56 +0000 Commit: Allan Jude CommitDate: 2021-05-02 16:53:24 +0000 Improve descriptions for some books and articles Also add weights to some, to define the sort order in the index Put the more commonly used items at the top of their respective lists The improved descriptions were taken from the old books/articles list: https://www.freebsd.org/docs/books/ Sponsored-By: Klara Inc. --- .../content/en/articles/building-products/_index.adoc | 2 +- .../content/en/articles/committers-guide/_index.adoc | 3 ++- documentation/content/en/articles/contributing/_index.adoc | 3 ++- documentation/content/en/articles/contributors/_index.adoc | 2 +- .../content/en/articles/filtering-bridges/_index.adoc | 2 +- documentation/content/en/articles/fonts/_index.adoc | 2 +- documentation/content/en/articles/freebsd-releng/_index.adoc | 2 +- .../content/en/articles/freebsd-update-server/_index.adoc | 2 +- documentation/content/en/articles/geom-class/_index.adoc | 2 +- documentation/content/en/articles/hubs/_index.adoc | 2 +- documentation/content/en/articles/leap-seconds/_index.adoc | 2 +- .../content/en/articles/linux-emulation/_index.adoc | 2 +- .../content/en/articles/mailing-list-faq/_index.adoc | 2 +- documentation/content/en/articles/pam/_index.adoc | 2 +- .../content/en/articles/problem-reports/_index.adoc | 2 +- documentation/content/en/articles/rc-scripting/_index.adoc | 2 +- documentation/content/en/articles/releng/_index.adoc | 4 ++-- documentation/content/en/articles/remote-install/_index.adoc | 2 +- documentation/content/en/articles/serial-uart/_index.adoc | 2 +- documentation/content/en/articles/solid-state/_index.adoc | 2 +- documentation/content/en/articles/vm-design/_index.adoc | 2 +- documentation/content/en/books/arch-handbook/_index.adoc | 3 ++- documentation/content/en/books/design-44bsd/_index.adoc | 3 ++- documentation/content/en/books/dev-model/_index.adoc | 3 ++- .../content/en/books/developers-handbook/_index.adoc | 3 ++- documentation/content/en/books/faq/_index.adoc | 3 ++- documentation/content/en/books/fdp-primer/_index.adoc | 3 ++- documentation/content/en/books/handbook/_index.adoc | 3 ++- documentation/content/en/books/porters-handbook/_index.adoc | 3 ++- documentation/themes/beastie/layouts/index.html | 12 ++++++++---- 30 files changed, 48 insertions(+), 34 deletions(-) diff --git a/documentation/content/en/articles/building-products/_index.adoc b/documentation/content/en/articles/building-products/_index.adoc index 577b1d3d42..6c9a001278 100644 --- a/documentation/content/en/articles/building-products/_index.adoc +++ b/documentation/content/en/articles/building-products/_index.adoc @@ -5,7 +5,7 @@ authors: email: jkoshy@FreeBSD.org organizations: - organization: The FreeBSD Project -description: Building Products with FreeBSD +description: How FreeBSD can help you build a better product trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 7aad6a68ef..13cbb0c6a2 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -3,8 +3,9 @@ title: Committer's Guide authors: - author: The FreeBSD Documentation Project copyright: 1999-2021 The FreeBSD Documentation Project -description: FreeBSD Committer's Guide +description: Introductory information for FreeBSD committers trademarks: ["freebsd", "coverity", "ibm", "intel", "general"] +weight: 25 --- = Committer's Guide diff --git a/documentation/content/en/articles/contributing/_index.adoc b/documentation/content/en/articles/contributing/_index.adoc index c7d61004ec..6dab1d5096 100644 --- a/documentation/content/en/articles/contributing/_index.adoc +++ b/documentation/content/en/articles/contributing/_index.adoc @@ -4,8 +4,9 @@ authors: - author: Jordan Hubbard - author: Sam Lawrance - author: Mark Linimon -description: Contributing to the FreeBSD Project +description: How to contribute to the FreeBSD Project trademarks: ["freebsd", "ieee", "general"] +weight: 15 --- = Contributing to FreeBSD diff --git a/documentation/content/en/articles/contributors/_index.adoc b/documentation/content/en/articles/contributors/_index.adoc index afd0f120b4..fecc0e6fe6 100644 --- a/documentation/content/en/articles/contributors/_index.adoc +++ b/documentation/content/en/articles/contributors/_index.adoc @@ -1,6 +1,6 @@ --- title: Contributors to FreeBSD -description: Contributors to FreeBSD +description: A list of organizations and individuals who have contributed to FreeBSD trademarks: ["freebsd", "sun", "general"] --- diff --git a/documentation/content/en/articles/filtering-bridges/_index.adoc b/documentation/content/en/articles/filtering-bridges/_index.adoc index 7a3647c0fb..9ae472d44e 100644 --- a/documentation/content/en/articles/filtering-bridges/_index.adoc +++ b/documentation/content/en/articles/filtering-bridges/_index.adoc @@ -3,7 +3,7 @@ title: Filtering Bridges authors: - author: Alex Dupre email: ale@FreeBSD.org -description: Filtering Bridges in FreeBSD +description: Configuring firewalls and filtering on FreeBSD hosts acting as bridges rather than routers trademarks: ["freebsd", "3com", "intel", "general"] --- diff --git a/documentation/content/en/articles/fonts/_index.adoc b/documentation/content/en/articles/fonts/_index.adoc index 70e52a1a91..34b12ba906 100644 --- a/documentation/content/en/articles/fonts/_index.adoc +++ b/documentation/content/en/articles/fonts/_index.adoc @@ -4,7 +4,7 @@ subtitle: A Tutorial authors: - author: Dave Bodenstab email: imdave@synet.net -description: Description of the various font files that may be used with FreeBSD +description: A description of the various font technologies in FreeBSD, and how to use them with different programs trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengroup", "general"] --- diff --git a/documentation/content/en/articles/freebsd-releng/_index.adoc b/documentation/content/en/articles/freebsd-releng/_index.adoc index 5615986124..bbb3f86ff9 100644 --- a/documentation/content/en/articles/freebsd-releng/_index.adoc +++ b/documentation/content/en/articles/freebsd-releng/_index.adoc @@ -8,7 +8,7 @@ organizations: webpage: https://www.freebsdfoundation.org/ - organization: Rubicon Communications, LLC (Netgate) webpage: https://www.netgate.com/ -description: FreeBSD Release Engineering +description: Describes the approach used by the FreeBSD release engineering team to make production quality releases of the FreeBSD Operating System. It describes the tools available for those interested in producing customized FreeBSD releases for corporate rollouts or commercial productization trademarks: ["freebsd", "intel", "general"] --- diff --git a/documentation/content/en/articles/freebsd-update-server/_index.adoc b/documentation/content/en/articles/freebsd-update-server/_index.adoc index 6ee32d4eee..527067e752 100644 --- a/documentation/content/en/articles/freebsd-update-server/_index.adoc +++ b/documentation/content/en/articles/freebsd-update-server/_index.adoc @@ -4,7 +4,7 @@ authors: - author: Jason Helfman email: jgh@FreeBSD.org copyright: 2009-2011, 2013 Jason Helfman -description: Build Your Own FreeBSD Update Server +description: Building your own freebsd-update server allows a system administrator to perform fast updates for a number of machines from a local mirror trademarks: ["freebsd", "amd", "intel", "general"] --- diff --git a/documentation/content/en/articles/geom-class/_index.adoc b/documentation/content/en/articles/geom-class/_index.adoc index 8c93697afb..902720e465 100644 --- a/documentation/content/en/articles/geom-class/_index.adoc +++ b/documentation/content/en/articles/geom-class/_index.adoc @@ -3,7 +3,7 @@ title: Writing a GEOM Class authors: - author: Ivan Voras email: ivoras@FreeBSD.org -description: Writing a GEOM Class in FreeBSD +description: A guide to GEOM internals, and writing your own GEOM class trademarks: ["freebsd", "intel", "general"] --- diff --git a/documentation/content/en/articles/hubs/_index.adoc b/documentation/content/en/articles/hubs/_index.adoc index 3819b76d71..55f3b50f0e 100644 --- a/documentation/content/en/articles/hubs/_index.adoc +++ b/documentation/content/en/articles/hubs/_index.adoc @@ -9,7 +9,7 @@ authors: email: dl@leo.org - author: Ken Smith email: kensmith@FreeBSD.org -description: How to mirror FreeBSD +description: The all in one guide for mirroring the FreeBSD website, FTP servers, and more trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/leap-seconds/_index.adoc b/documentation/content/en/articles/leap-seconds/_index.adoc index 8ad3c6154e..9dc11b3483 100644 --- a/documentation/content/en/articles/leap-seconds/_index.adoc +++ b/documentation/content/en/articles/leap-seconds/_index.adoc @@ -1,6 +1,6 @@ --- title: FreeBSD Support for Leap Seconds -description: FreeBSD Support for Leap Seconds +description: A short description of how leap seconds are handled on FreeBSD --- = FreeBSD Support for Leap Seconds diff --git a/documentation/content/en/articles/linux-emulation/_index.adoc b/documentation/content/en/articles/linux-emulation/_index.adoc index 701bf524cc..d5c6d985ed 100644 --- a/documentation/content/en/articles/linux-emulation/_index.adoc +++ b/documentation/content/en/articles/linux-emulation/_index.adoc @@ -3,7 +3,7 @@ title: Linux® emulation in FreeBSD authors: - author: Roman Divacky email: rdivacky@FreeBSD.org -description: Linux® emulation in FreeBSD +description: A technical description about the internals of the Linux emulation layer in FreeBSD trademarks: ["freebsd", "ibm", "adobe", "netbsd", "realnetworks", "oracle", "linux", "sun", "general"] --- diff --git a/documentation/content/en/articles/mailing-list-faq/_index.adoc b/documentation/content/en/articles/mailing-list-faq/_index.adoc index 81bb9f2b07..f5b4eb064d 100644 --- a/documentation/content/en/articles/mailing-list-faq/_index.adoc +++ b/documentation/content/en/articles/mailing-list-faq/_index.adoc @@ -3,7 +3,7 @@ title: Frequently Asked Questions About The FreeBSD Mailing Lists authors: - author: The FreeBSD Documentation Project copyright: 2004-2021 The FreeBSD Documentation Project -description: Frequently Asked Questions About The FreeBSD Mailing Lists +description: How to best use the mailing lists, such as how to help avoid frequently-repeated discussions --- = Frequently Asked Questions About The FreeBSD Mailing Lists diff --git a/documentation/content/en/articles/pam/_index.adoc b/documentation/content/en/articles/pam/_index.adoc index 6f3d5a22d6..03672f1ba2 100644 --- a/documentation/content/en/articles/pam/_index.adoc +++ b/documentation/content/en/articles/pam/_index.adoc @@ -3,7 +3,7 @@ title: Pluggable Authentication Modules authors: - author: Dag-Erling Smørgrav copyright: 2001-2003 Networks Associates Technology, Inc. -description: Pluggable Authentication Modules (PAM) in FreeBSD +description: A guide to the PAM system and modules under FreeBSD trademarks: ["pam", "freebsd", "linux", "opengroup", "sun", "general"] --- diff --git a/documentation/content/en/articles/problem-reports/_index.adoc b/documentation/content/en/articles/problem-reports/_index.adoc index d61055bdfc..ac334b78b4 100644 --- a/documentation/content/en/articles/problem-reports/_index.adoc +++ b/documentation/content/en/articles/problem-reports/_index.adoc @@ -3,7 +3,7 @@ title: Writing FreeBSD Problem Reports authors: - author: Dag-Erling Smørgrav - author: Mark Linimon -description: Writing FreeBSD Problem Reports +description: How to best formulate and submit a problem report to the FreeBSD Project trademarks: ["freebsd", "ibm", "intel", "sun", "general"] --- diff --git a/documentation/content/en/articles/rc-scripting/_index.adoc b/documentation/content/en/articles/rc-scripting/_index.adoc index 72e71bffbd..50507c8412 100644 --- a/documentation/content/en/articles/rc-scripting/_index.adoc +++ b/documentation/content/en/articles/rc-scripting/_index.adoc @@ -4,7 +4,7 @@ authors: - author: Yar Tikhiy email: yar@FreeBSD.org copyright: 2005-2006, 2012 The FreeBSD Project -description: Practical rc.d scripting in BSD +description: A guide to writing new rc.d scripts and understanding those already written trademarks: ["freebsd", "netbsd", "general"] --- diff --git a/documentation/content/en/articles/releng/_index.adoc b/documentation/content/en/articles/releng/_index.adoc index 665c3cea45..ef1c6c5035 100644 --- a/documentation/content/en/articles/releng/_index.adoc +++ b/documentation/content/en/articles/releng/_index.adoc @@ -1,10 +1,10 @@ --- -title: FreeBSD Release Engineering +title: Legacy FreeBSD Release Engineering authors: - author: Murray Stokely email: murray@FreeBSD.org webpage: https://people.FreeBSD.org/~murray/ -description: This paper describes the approach used by the FreeBSD release engineering team to make production quality releases of the FreeBSD Operating System +description: This paper describes the approach used by past the FreeBSD release engineering team to make production quality releases of the FreeBSD Operating System trademarks: ["freebsd", "intel", "general"] --- diff --git a/documentation/content/en/articles/remote-install/_index.adoc b/documentation/content/en/articles/remote-install/_index.adoc index e5343b75a9..03d62cad6a 100644 --- a/documentation/content/en/articles/remote-install/_index.adoc +++ b/documentation/content/en/articles/remote-install/_index.adoc @@ -4,7 +4,7 @@ authors: - author: Daniel Gerzo email: danger@FreeBSD.org copyright: 2008-2021 The FreeBSD Documentation Project -description: Remote Installation of the FreeBSD Operating System Without a Remote Console +description: Describes the remote installation of the FreeBSD operating system when the console of the remote system is unavailable trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/serial-uart/_index.adoc b/documentation/content/en/articles/serial-uart/_index.adoc index 9bd53781e0..4a9d5b783f 100644 --- a/documentation/content/en/articles/serial-uart/_index.adoc +++ b/documentation/content/en/articles/serial-uart/_index.adoc @@ -3,7 +3,7 @@ title: Serial and UART Tutorial authors: - author: Frank Durda email: uhclem@FreeBSD.org -description: How to use serial hardware and UART with FreeBSD +description: Detailed information about the use of serial ports and UART with FreeBSD trademarks: ["freebsd", "microsoft", "general"] --- diff --git a/documentation/content/en/articles/solid-state/_index.adoc b/documentation/content/en/articles/solid-state/_index.adoc index 4a1b022fdb..7238aa8dad 100644 --- a/documentation/content/en/articles/solid-state/_index.adoc +++ b/documentation/content/en/articles/solid-state/_index.adoc @@ -4,7 +4,7 @@ authors: - author: John Kozubik email: john@kozubik.com copyright: 2001 - 2021 The FreeBSD Documentation Project -description: FreeBSD and Solid State Devices +description: The use of solid state disk devices in FreeBSD trademarks: ["freebsd", "general"] --- diff --git a/documentation/content/en/articles/vm-design/_index.adoc b/documentation/content/en/articles/vm-design/_index.adoc index 12a60f6962..884e88bd76 100644 --- a/documentation/content/en/articles/vm-design/_index.adoc +++ b/documentation/content/en/articles/vm-design/_index.adoc @@ -3,7 +3,7 @@ title: Design elements of the FreeBSD VM system authors: - author: Matthew Dillon email: dillon@apollo.backplane.com -description: Design elements of the FreeBSD VM system +description: An easy to follow description of the design of the FreeBSD virtual memory system trademarks: ["freebsd", "linux", "microsoft", "opengroup", "daemon-news", "general"] --- diff --git a/documentation/content/en/books/arch-handbook/_index.adoc b/documentation/content/en/books/arch-handbook/_index.adoc index a5cefc4616..59041a32d6 100644 --- a/documentation/content/en/books/arch-handbook/_index.adoc +++ b/documentation/content/en/books/arch-handbook/_index.adoc @@ -3,9 +3,10 @@ title: FreeBSD Architecture Handbook authors: - author: The FreeBSD Documentation Project copyright: Copyright © 2000-2006, 2012-2021 The FreeBSD Documentation Project -description: FreeBSD Architecture Handbook Index +description: For FreeBSD system developers. This book covers the architectural details of many important FreeBSD kernel subsystems trademarks: ["freebsd", "apple", "microsoft", "unix", "general"] next: books/arch-handbook/parti +weight: 50 --- = FreeBSD Architecture Handbook diff --git a/documentation/content/en/books/design-44bsd/_index.adoc b/documentation/content/en/books/design-44bsd/_index.adoc index bab937e2fc..596a138529 100644 --- a/documentation/content/en/books/design-44bsd/_index.adoc +++ b/documentation/content/en/books/design-44bsd/_index.adoc @@ -6,8 +6,9 @@ authors: - author: Michael J. Karels - author: John S. Quarterman copyright: 1996 Addison-Wesley Longman, Inc -description: The Design and Implementation of the 4.4BSD Operating System. Second chapter. +description: Donated by Addison-Wesley, provides a design overview of 4.4BSD, from which FreeBSD was originally derived trademarks: ["design-44bsd"] +weight: 60 --- = The Design and Implementation of the 4.4BSD Operating System diff --git a/documentation/content/en/books/dev-model/_index.adoc b/documentation/content/en/books/dev-model/_index.adoc index c5b4061159..8d3b9ed4db 100644 --- a/documentation/content/en/books/dev-model/_index.adoc +++ b/documentation/content/en/books/dev-model/_index.adoc @@ -3,8 +3,9 @@ title: A project model for the FreeBSD Project authors: - author: Niklas Saers copyright: Copyright © 2002-2005 Niklas Saers -description: A project model for the FreeBSD Project +description: A formal study of the organization of the FreeBSD project trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"] +weight: 45 --- = A project model for the FreeBSD Project diff --git a/documentation/content/en/books/developers-handbook/_index.adoc b/documentation/content/en/books/developers-handbook/_index.adoc index c7407e78d1..30c5d158f8 100644 --- a/documentation/content/en/books/developers-handbook/_index.adoc +++ b/documentation/content/en/books/developers-handbook/_index.adoc @@ -3,9 +3,10 @@ title: FreeBSD Developers' Handbook authors: - author: The FreeBSD Documentation Project copyright: 1995-2021 The FreeBSD Documentation Project -description: FreeBSD Developers' Handbook Index +description: For people who want to develop software for FreeBSD (and not just people who are developing FreeBSD itself) trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "microsoft", "opengroup", "sun", "general"] next: books/developers-handbook/parti +weight: 25 --- = FreeBSD Developers' Handbook diff --git a/documentation/content/en/books/faq/_index.adoc b/documentation/content/en/books/faq/_index.adoc index cf3d7379df..70690a9837 100644 --- a/documentation/content/en/books/faq/_index.adoc +++ b/documentation/content/en/books/faq/_index.adoc @@ -3,8 +3,9 @@ title: Frequently Asked Questions for FreeBSD 11.X, 12.X, and 13.X authors: - author: The FreeBSD Documentation Project copyright: 1995-2021 The FreeBSD Documentation Project -description: Frequently Asked Questions (FAQ) for FreeBSD 11.X, 12.X, and 13.X +description: Frequently Asked Questions, and answers, covering all aspects of FreeBSD trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "microsoft", "opengroup", "sun", "netbsd", "general"] +weight: 5 --- = Frequently Asked Questions for FreeBSD {rel2-relx} and {rel-relx} diff --git a/documentation/content/en/books/fdp-primer/_index.adoc b/documentation/content/en/books/fdp-primer/_index.adoc index 403e249f11..fb703561d5 100644 --- a/documentation/content/en/books/fdp-primer/_index.adoc +++ b/documentation/content/en/books/fdp-primer/_index.adoc @@ -4,8 +4,9 @@ authors: - author: The FreeBSD Documentation Project copyright: 1998-2021 DocEng trademarks: ["general"] -description: FreeBSD Documentation Project Primer for New Contributors Index +description: Everything you need to know in order to start contributing to the FreeBSD Documentation Project next: books/fdp-primer/preface +weight: 10 --- = FreeBSD Documentation Project Primer for New Contributors diff --git a/documentation/content/en/books/handbook/_index.adoc b/documentation/content/en/books/handbook/_index.adoc index 0fdd49727d..f1f246dd93 100644 --- a/documentation/content/en/books/handbook/_index.adoc +++ b/documentation/content/en/books/handbook/_index.adoc @@ -3,9 +3,10 @@ title: FreeBSD Handbook authors: - author: The FreeBSD Documentation Project copyright: 1995-2021 The FreeBSD Documentation Project -description: FreeBSD Handbook Index +description: A constantly evolving, comprehensive resource for FreeBSD users trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "oracle", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilogic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree86", "general"] next: books/handbook/preface +weight: 1 --- = FreeBSD Handbook diff --git a/documentation/content/en/books/porters-handbook/_index.adoc b/documentation/content/en/books/porters-handbook/_index.adoc index 60a9df7f8a..a82db8f052 100644 --- a/documentation/content/en/books/porters-handbook/_index.adoc +++ b/documentation/content/en/books/porters-handbook/_index.adoc @@ -3,9 +3,10 @@ title: FreeBSD Porter's Handbook authors: - author: The FreeBSD Documentation Project copyright: 2000-2021 The FreeBSD Documentation Project -description: FreeBSD Porter's Handbook Index +description: Essential reading if you plan on providing a port of a third party piece of software trademarks: ["freebsd", "sun", "unix", "general"] next: books/porters-handbook/porting-why +weight: 15 --- = FreeBSD Porter's Handbook diff --git a/documentation/themes/beastie/layouts/index.html b/documentation/themes/beastie/layouts/index.html index 1ba57c710a..8b56f7c484 100644 --- a/documentation/themes/beastie/layouts/index.html +++ b/documentation/themes/beastie/layouts/index.html @@ -30,11 +30,13 @@ {{ end }}
      - {{ range sort $books "path" }} + {{ range sort $books "weight" "path" }} {{ if in .path "_index.adoc" }} {{ $bookPath := replaceRE "/_index.adoc" "" .path }} {{ $bookName := replaceRE "books/" "" $bookPath }} -
    • {{ .page.Title }}
      • +
    • {{ .page.Title }} +

      {{ .page.Params.description }}

      +
      • {{ end }} {{ end }}
    @@ -50,11 +52,13 @@ {{ end }}
      - {{ range sort $articles "path" }} + {{ range sort $articles "weight" "path" }} {{ if in .path "_index.adoc" }} {{ $articlePath := replaceRE "/_index.adoc" "" .path }} {{ $articleName := replaceRE "articles/" "" $articlePath }} -
    • {{ .page.Title }}
      • +
    • {{ .page.Title }} +

      {{ .page.Params.description }}

      +
      • {{ end }} {{ end }}
    From owner-dev-commits-doc-all@freebsd.org Sun May 2 16:54: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 7528662ACC2 for ; Sun, 2 May 2021 16:54: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 4FYBz92kfFz4qmN; Sun, 2 May 2021 16:54: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 4F10665C1; Sun, 2 May 2021 16:54:29 +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 142GsTRt055442; Sun, 2 May 2021 16:54:29 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142GsTLu055441; Sun, 2 May 2021 16:54:29 GMT (envelope-from git) Date: Sun, 2 May 2021 16:54:29 GMT Message-Id: <202105021654.142GsTLu055441@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Allan Jude Subject: git: e4ff28d8d7 - main - Add links to the committer's guide in the obvious places MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: allanjude X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e4ff28d8d77fe6a70496539a87e282deb613424c 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: Sun, 02 May 2021 16:54:29 -0000 The branch main has been updated by allanjude: URL: https://cgit.FreeBSD.org/doc/commit/?id=e4ff28d8d77fe6a70496539a87e282deb613424c commit e4ff28d8d77fe6a70496539a87e282deb613424c Author: Allan Jude AuthorDate: 2021-05-02 16:25:34 +0000 Commit: Allan Jude CommitDate: 2021-05-02 16:53:24 +0000 Add links to the committer's guide in the obvious places Sponsored-By: Klara Inc. --- documentation/themes/beastie/i18n/en.toml | 3 +++ website/themes/beastie/i18n/en.toml | 3 +++ website/themes/beastie/layouts/partials/sidenav.html | 1 + website/themes/beastie/layouts/partials/site-navigation.html | 3 +++ 4 files changed, 10 insertions(+) diff --git a/documentation/themes/beastie/i18n/en.toml b/documentation/themes/beastie/i18n/en.toml index 7cabfd089a..f3dbde951c 100644 --- a/documentation/themes/beastie/i18n/en.toml +++ b/documentation/themes/beastie/i18n/en.toml @@ -73,6 +73,9 @@ other = "Porter's Handbook" [developerHandbook] other = "Developer's Handbook" +[committersGuide] +other = "Committer's Guide" + [manualPages] other = "Manual Pages" diff --git a/website/themes/beastie/i18n/en.toml b/website/themes/beastie/i18n/en.toml index 15572dfe8a..5aa6b40440 100644 --- a/website/themes/beastie/i18n/en.toml +++ b/website/themes/beastie/i18n/en.toml @@ -73,6 +73,9 @@ other = "Porter's Handbook" [developerHandbook] other = "Developer's Handbook" +[committersGuide] +other = "Committer's Guide" + [manualPages] other = "Manual Pages" diff --git a/website/themes/beastie/layouts/partials/sidenav.html b/website/themes/beastie/layouts/partials/sidenav.html index 715c923b7c..d3f1f9d29b 100644 --- a/website/themes/beastie/layouts/partials/sidenav.html +++ b/website/themes/beastie/layouts/partials/sidenav.html @@ -33,6 +33,7 @@
    • {{ i18n "Developers" }}
    • {{ i18n "developerHandbook" }}
      • +
    • {{ i18n "committersGuide" }}
    • {{ i18n "porterHandbook" }}
    • {{ i18n "sourceCodeRepositories" }}
    • {{ i18n "releng" }}
      • diff --git a/website/themes/beastie/layouts/partials/site-navigation.html b/website/themes/beastie/layouts/partials/site-navigation.html index aa5e4f0af8..7d5ad7f62e 100644 --- a/website/themes/beastie/layouts/partials/site-navigation.html +++ b/website/themes/beastie/layouts/partials/site-navigation.html @@ -56,6 +56,9 @@
    • {{ i18n "developerHandbook" }}
      • +
    • + {{ i18n "committersGuide" }} +
    • {{ i18n "manualPages" }}
      • From owner-dev-commits-doc-all@freebsd.org Sun May 2 16:54: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 9827662A760 for ; Sun, 2 May 2021 16:54: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 4FYBzB3z3yz4qy0; Sun, 2 May 2021 16:54: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 716F1645B; Sun, 2 May 2021 16:54: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 142GsUdw055463; Sun, 2 May 2021 16:54:30 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142GsUSJ055462; Sun, 2 May 2021 16:54:30 GMT (envelope-from git) Date: Sun, 2 May 2021 16:54:30 GMT Message-Id: <202105021654.142GsUSJ055462@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Allan Jude Subject: git: aa0aa34d92 - main - Improve links to "docs" and "books and articles" MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: allanjude X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: aa0aa34d9265094bcecbf95bc1d7eb1e5b69c3b9 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: Sun, 02 May 2021 16:54:30 -0000 The branch main has been updated by allanjude: URL: https://cgit.FreeBSD.org/doc/commit/?id=aa0aa34d9265094bcecbf95bc1d7eb1e5b69c3b9 commit aa0aa34d9265094bcecbf95bc1d7eb1e5b69c3b9 Author: Allan Jude AuthorDate: 2021-05-02 16:26:04 +0000 Commit: Allan Jude CommitDate: 2021-05-02 16:53:24 +0000 Improve links to "docs" and "books and articles" Some of the links went to empty pages, or only to books, no articles Reported-By: des Sponsored-By: Klara Inc. --- website/themes/beastie/layouts/partials/sidenav.html | 4 ++-- website/themes/beastie/layouts/partials/site-navigation.html | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/website/themes/beastie/layouts/partials/sidenav.html b/website/themes/beastie/layouts/partials/sidenav.html index d3f1f9d29b..1f7e35a340 100644 --- a/website/themes/beastie/layouts/partials/sidenav.html +++ b/website/themes/beastie/layouts/partials/sidenav.html @@ -43,12 +43,12 @@
    {{ else if eq .sidenavType "docs" }}
    • - {{ i18n "documentation" }} + {{ i18n "documentation" }}
      • From owner-dev-commits-doc-all@freebsd.org Sun May 2 17:10: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 2979F62AEFE for ; Sun, 2 May 2021 17:10:58 +0000 (UTC) (envelope-from carlavilla@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 4FYCLB0bmDz4rQT; Sun, 2 May 2021 17:10:58 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-ed1-f46.google.com (mail-ed1-f46.google.com [209.85.208.46]) (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 E5124DE4B; Sun, 2 May 2021 17:10:57 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-ed1-f46.google.com with SMTP id j28so3679576edy.9; Sun, 02 May 2021 10:10:57 -0700 (PDT) X-Gm-Message-State: AOAM532dTVGMltak7hjeNbC19OHOPIfFe0w+ZkF5pRSOI/jd/5/gIF/d Ah0F7vsO0FBg+Ehy8JHq5Rf8EEhLtgW8Ux+2oDU= X-Google-Smtp-Source: ABdhPJwTfgtcI69uGwFKD3QmOJYcOc1qP1sjnLY6dW41b/vhFCsEhmefK5cH5qVFcfjj+uxMB6CvTr916oJhxDPXl80= X-Received: by 2002:aa7:c34b:: with SMTP id j11mr16630838edr.188.1619975456216; Sun, 02 May 2021 10:10:56 -0700 (PDT) MIME-Version: 1.0 References: <202105021654.142GsST9055413@gitrepo.freebsd.org> In-Reply-To: <202105021654.142GsST9055413@gitrepo.freebsd.org> From: Sergio Carlavilla Date: Sun, 2 May 2021 19:10:44 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: git: 2c5bff688d - main - Improve descriptions for some books and articles To: Allan Jude Cc: doc-committers@freebsd.org, dev-commits-doc-all@freebsd.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable 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: Sun, 02 May 2021 17:10:58 -0000 On Sun, 2 May 2021 at 18:54, Allan Jude wrote: > > The branch main has been updated by allanjude: > > URL: https://cgit.FreeBSD.org/doc/commit/?id=3D2c5bff688d8653c4306a2f6fdb= b2c966eaee5a1c > > commit 2c5bff688d8653c4306a2f6fdbb2c966eaee5a1c > Author: Allan Jude > AuthorDate: 2021-05-02 16:10:56 +0000 > Commit: Allan Jude > CommitDate: 2021-05-02 16:53:24 +0000 > > Improve descriptions for some books and articles > > Also add weights to some, to define the sort order in the index > Put the more commonly used items at the top of their respective lists > > The improved descriptions were taken from the old books/articles list= : > https://www.freebsd.org/docs/books/ > > Sponsored-By: Klara Inc. > --- > .../content/en/articles/building-products/_index.adoc | 2 +- > .../content/en/articles/committers-guide/_index.adoc | 3 ++- > documentation/content/en/articles/contributing/_index.adoc | 3 ++- > documentation/content/en/articles/contributors/_index.adoc | 2 +- > .../content/en/articles/filtering-bridges/_index.adoc | 2 +- > documentation/content/en/articles/fonts/_index.adoc | 2 +- > documentation/content/en/articles/freebsd-releng/_index.adoc | 2 +- > .../content/en/articles/freebsd-update-server/_index.adoc | 2 +- > documentation/content/en/articles/geom-class/_index.adoc | 2 +- > documentation/content/en/articles/hubs/_index.adoc | 2 +- > documentation/content/en/articles/leap-seconds/_index.adoc | 2 +- > .../content/en/articles/linux-emulation/_index.adoc | 2 +- > .../content/en/articles/mailing-list-faq/_index.adoc | 2 +- > documentation/content/en/articles/pam/_index.adoc | 2 +- > .../content/en/articles/problem-reports/_index.adoc | 2 +- > documentation/content/en/articles/rc-scripting/_index.adoc | 2 +- > documentation/content/en/articles/releng/_index.adoc | 4 ++-- > documentation/content/en/articles/remote-install/_index.adoc | 2 +- > documentation/content/en/articles/serial-uart/_index.adoc | 2 +- > documentation/content/en/articles/solid-state/_index.adoc | 2 +- > documentation/content/en/articles/vm-design/_index.adoc | 2 +- > documentation/content/en/books/arch-handbook/_index.adoc | 3 ++- > documentation/content/en/books/design-44bsd/_index.adoc | 3 ++- > documentation/content/en/books/dev-model/_index.adoc | 3 ++- > .../content/en/books/developers-handbook/_index.adoc | 3 ++- > documentation/content/en/books/faq/_index.adoc | 3 ++- > documentation/content/en/books/fdp-primer/_index.adoc | 3 ++- > documentation/content/en/books/handbook/_index.adoc | 3 ++- > documentation/content/en/books/porters-handbook/_index.adoc | 3 ++- > documentation/themes/beastie/layouts/index.html | 12 ++++++= ++---- > 30 files changed, 48 insertions(+), 34 deletions(-) > > diff --git a/documentation/content/en/articles/building-products/_index.a= doc b/documentation/content/en/articles/building-products/_index.adoc > index 577b1d3d42..6c9a001278 100644 > --- a/documentation/content/en/articles/building-products/_index.adoc > +++ b/documentation/content/en/articles/building-products/_index.adoc > @@ -5,7 +5,7 @@ authors: > email: jkoshy@FreeBSD.org > organizations: > - organization: The FreeBSD Project > -description: Building Products with FreeBSD > +description: How FreeBSD can help you build a better product > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/committers-guide/_index.ad= oc b/documentation/content/en/articles/committers-guide/_index.adoc > index 7aad6a68ef..13cbb0c6a2 100644 > --- a/documentation/content/en/articles/committers-guide/_index.adoc > +++ b/documentation/content/en/articles/committers-guide/_index.adoc > @@ -3,8 +3,9 @@ title: Committer's Guide > authors: > - author: The FreeBSD Documentation Project > copyright: 1999-2021 The FreeBSD Documentation Project > -description: FreeBSD Committer's Guide > +description: Introductory information for FreeBSD committers > trademarks: ["freebsd", "coverity", "ibm", "intel", "general"] > +weight: 25 > --- > > =3D Committer's Guide > diff --git a/documentation/content/en/articles/contributing/_index.adoc b= /documentation/content/en/articles/contributing/_index.adoc > index c7d61004ec..6dab1d5096 100644 > --- a/documentation/content/en/articles/contributing/_index.adoc > +++ b/documentation/content/en/articles/contributing/_index.adoc > @@ -4,8 +4,9 @@ authors: > - author: Jordan Hubbard > - author: Sam Lawrance > - author: Mark Linimon > -description: Contributing to the FreeBSD Project > +description: How to contribute to the FreeBSD Project > trademarks: ["freebsd", "ieee", "general"] > +weight: 15 > --- > > =3D Contributing to FreeBSD > diff --git a/documentation/content/en/articles/contributors/_index.adoc b= /documentation/content/en/articles/contributors/_index.adoc > index afd0f120b4..fecc0e6fe6 100644 > --- a/documentation/content/en/articles/contributors/_index.adoc > +++ b/documentation/content/en/articles/contributors/_index.adoc > @@ -1,6 +1,6 @@ > --- > title: Contributors to FreeBSD > -description: Contributors to FreeBSD > +description: A list of organizations and individuals who have contribute= d to FreeBSD > trademarks: ["freebsd", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/filtering-bridges/_index.a= doc b/documentation/content/en/articles/filtering-bridges/_index.adoc > index 7a3647c0fb..9ae472d44e 100644 > --- a/documentation/content/en/articles/filtering-bridges/_index.adoc > +++ b/documentation/content/en/articles/filtering-bridges/_index.adoc > @@ -3,7 +3,7 @@ title: Filtering Bridges > authors: > - author: Alex Dupre > email: ale@FreeBSD.org > -description: Filtering Bridges in FreeBSD > +description: Configuring firewalls and filtering on FreeBSD hosts acting= as bridges rather than routers > trademarks: ["freebsd", "3com", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/fonts/_index.adoc b/docume= ntation/content/en/articles/fonts/_index.adoc > index 70e52a1a91..34b12ba906 100644 > --- a/documentation/content/en/articles/fonts/_index.adoc > +++ b/documentation/content/en/articles/fonts/_index.adoc > @@ -4,7 +4,7 @@ subtitle: A Tutorial > authors: > - author: Dave Bodenstab > email: imdave@synet.net > -description: Description of the various font files that may be used with= FreeBSD > +description: A description of the various font technologies in FreeBSD, = and how to use them with different programs > trademarks: ["freebsd", "adobe", "apple", "linux", "microsoft", "opengro= up", "general"] > --- > > diff --git a/documentation/content/en/articles/freebsd-releng/_index.adoc= b/documentation/content/en/articles/freebsd-releng/_index.adoc > index 5615986124..bbb3f86ff9 100644 > --- a/documentation/content/en/articles/freebsd-releng/_index.adoc > +++ b/documentation/content/en/articles/freebsd-releng/_index.adoc > @@ -8,7 +8,7 @@ organizations: > webpage: https://www.freebsdfoundation.org/ > - organization: Rubicon Communications, LLC (Netgate) > webpage: https://www.netgate.com/ > -description: FreeBSD Release Engineering > +description: Describes the approach used by the FreeBSD release engineer= ing team to make production quality releases of the FreeBSD Operating Syste= m. It describes the tools available for those interested in producing custo= mized FreeBSD releases for corporate rollouts or commercial productization > trademarks: ["freebsd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/freebsd-update-server/_ind= ex.adoc b/documentation/content/en/articles/freebsd-update-server/_index.ad= oc > index 6ee32d4eee..527067e752 100644 > --- a/documentation/content/en/articles/freebsd-update-server/_index.adoc > +++ b/documentation/content/en/articles/freebsd-update-server/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: Jason Helfman > email: jgh@FreeBSD.org > copyright: 2009-2011, 2013 Jason Helfman > -description: Build Your Own FreeBSD Update Server > +description: Building your own freebsd-update server allows a system adm= inistrator to perform fast updates for a number of machines from a local mi= rror > trademarks: ["freebsd", "amd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/geom-class/_index.adoc b/d= ocumentation/content/en/articles/geom-class/_index.adoc > index 8c93697afb..902720e465 100644 > --- a/documentation/content/en/articles/geom-class/_index.adoc > +++ b/documentation/content/en/articles/geom-class/_index.adoc > @@ -3,7 +3,7 @@ title: Writing a GEOM Class > authors: > - author: Ivan Voras > email: ivoras@FreeBSD.org > -description: Writing a GEOM Class in FreeBSD > +description: A guide to GEOM internals, and writing your own GEOM class > trademarks: ["freebsd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/hubs/_index.adoc b/documen= tation/content/en/articles/hubs/_index.adoc > index 3819b76d71..55f3b50f0e 100644 > --- a/documentation/content/en/articles/hubs/_index.adoc > +++ b/documentation/content/en/articles/hubs/_index.adoc > @@ -9,7 +9,7 @@ authors: > email: dl@leo.org > - author: Ken Smith > email: kensmith@FreeBSD.org > -description: How to mirror FreeBSD > +description: The all in one guide for mirroring the FreeBSD website, FTP= servers, and more > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/leap-seconds/_index.adoc b= /documentation/content/en/articles/leap-seconds/_index.adoc > index 8ad3c6154e..9dc11b3483 100644 > --- a/documentation/content/en/articles/leap-seconds/_index.adoc > +++ b/documentation/content/en/articles/leap-seconds/_index.adoc > @@ -1,6 +1,6 @@ > --- > title: FreeBSD Support for Leap Seconds > -description: FreeBSD Support for Leap Seconds > +description: A short description of how leap seconds are handled on Free= BSD > --- > > =3D FreeBSD Support for Leap Seconds > diff --git a/documentation/content/en/articles/linux-emulation/_index.ado= c b/documentation/content/en/articles/linux-emulation/_index.adoc > index 701bf524cc..d5c6d985ed 100644 > --- a/documentation/content/en/articles/linux-emulation/_index.adoc > +++ b/documentation/content/en/articles/linux-emulation/_index.adoc > @@ -3,7 +3,7 @@ title: Linux=C2=AE emulation in FreeBSD > authors: > - author: Roman Divacky > email: rdivacky@FreeBSD.org > -description: Linux=C2=AE emulation in FreeBSD > +description: A technical description about the internals of the Linux em= ulation layer in FreeBSD > trademarks: ["freebsd", "ibm", "adobe", "netbsd", "realnetworks", "oracl= e", "linux", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/mailing-list-faq/_index.ad= oc b/documentation/content/en/articles/mailing-list-faq/_index.adoc > index 81bb9f2b07..f5b4eb064d 100644 > --- a/documentation/content/en/articles/mailing-list-faq/_index.adoc > +++ b/documentation/content/en/articles/mailing-list-faq/_index.adoc > @@ -3,7 +3,7 @@ title: Frequently Asked Questions About The FreeBSD Maili= ng Lists > authors: > - author: The FreeBSD Documentation Project > copyright: 2004-2021 The FreeBSD Documentation Project > -description: Frequently Asked Questions About The FreeBSD Mailing Lists > +description: How to best use the mailing lists, such as how to help avoi= d frequently-repeated discussions > --- > > =3D Frequently Asked Questions About The FreeBSD Mailing Lists > diff --git a/documentation/content/en/articles/pam/_index.adoc b/document= ation/content/en/articles/pam/_index.adoc > index 6f3d5a22d6..03672f1ba2 100644 > --- a/documentation/content/en/articles/pam/_index.adoc > +++ b/documentation/content/en/articles/pam/_index.adoc > @@ -3,7 +3,7 @@ title: Pluggable Authentication Modules > authors: > - author: Dag-Erling Sm=C3=B8rgrav > copyright: 2001-2003 Networks Associates Technology, Inc. > -description: Pluggable Authentication Modules (PAM) in FreeBSD > +description: A guide to the PAM system and modules under FreeBSD > trademarks: ["pam", "freebsd", "linux", "opengroup", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/problem-reports/_index.ado= c b/documentation/content/en/articles/problem-reports/_index.adoc > index d61055bdfc..ac334b78b4 100644 > --- a/documentation/content/en/articles/problem-reports/_index.adoc > +++ b/documentation/content/en/articles/problem-reports/_index.adoc > @@ -3,7 +3,7 @@ title: Writing FreeBSD Problem Reports > authors: > - author: Dag-Erling Sm=C3=B8rgrav > - author: Mark Linimon > -description: Writing FreeBSD Problem Reports > +description: How to best formulate and submit a problem report to the Fr= eeBSD Project > trademarks: ["freebsd", "ibm", "intel", "sun", "general"] > --- > > diff --git a/documentation/content/en/articles/rc-scripting/_index.adoc b= /documentation/content/en/articles/rc-scripting/_index.adoc > index 72e71bffbd..50507c8412 100644 > --- a/documentation/content/en/articles/rc-scripting/_index.adoc > +++ b/documentation/content/en/articles/rc-scripting/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: Yar Tikhiy > email: yar@FreeBSD.org > copyright: 2005-2006, 2012 The FreeBSD Project > -description: Practical rc.d scripting in BSD > +description: A guide to writing new rc.d scripts and understanding those= already written > trademarks: ["freebsd", "netbsd", "general"] > --- > > diff --git a/documentation/content/en/articles/releng/_index.adoc b/docum= entation/content/en/articles/releng/_index.adoc > index 665c3cea45..ef1c6c5035 100644 > --- a/documentation/content/en/articles/releng/_index.adoc > +++ b/documentation/content/en/articles/releng/_index.adoc > @@ -1,10 +1,10 @@ > --- > -title: FreeBSD Release Engineering > +title: Legacy FreeBSD Release Engineering > authors: > - author: Murray Stokely > email: murray@FreeBSD.org > webpage: https://people.FreeBSD.org/~murray/ > -description: This paper describes the approach used by the FreeBSD relea= se engineering team to make production quality releases of the FreeBSD Oper= ating System > +description: This paper describes the approach used by past the FreeBSD = release engineering team to make production quality releases of the FreeBSD= Operating System > trademarks: ["freebsd", "intel", "general"] > --- > > diff --git a/documentation/content/en/articles/remote-install/_index.adoc= b/documentation/content/en/articles/remote-install/_index.adoc > index e5343b75a9..03d62cad6a 100644 > --- a/documentation/content/en/articles/remote-install/_index.adoc > +++ b/documentation/content/en/articles/remote-install/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: Daniel Gerzo > email: danger@FreeBSD.org > copyright: 2008-2021 The FreeBSD Documentation Project > -description: Remote Installation of the FreeBSD Operating System Without= a Remote Console > +description: Describes the remote installation of the FreeBSD operating = system when the console of the remote system is unavailable > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/serial-uart/_index.adoc b/= documentation/content/en/articles/serial-uart/_index.adoc > index 9bd53781e0..4a9d5b783f 100644 > --- a/documentation/content/en/articles/serial-uart/_index.adoc > +++ b/documentation/content/en/articles/serial-uart/_index.adoc > @@ -3,7 +3,7 @@ title: Serial and UART Tutorial > authors: > - author: Frank Durda > email: uhclem@FreeBSD.org > -description: How to use serial hardware and UART with FreeBSD > +description: Detailed information about the use of serial ports and UART= with FreeBSD > trademarks: ["freebsd", "microsoft", "general"] > --- > > diff --git a/documentation/content/en/articles/solid-state/_index.adoc b/= documentation/content/en/articles/solid-state/_index.adoc > index 4a1b022fdb..7238aa8dad 100644 > --- a/documentation/content/en/articles/solid-state/_index.adoc > +++ b/documentation/content/en/articles/solid-state/_index.adoc > @@ -4,7 +4,7 @@ authors: > - author: John Kozubik > email: john@kozubik.com > copyright: 2001 - 2021 The FreeBSD Documentation Project > -description: FreeBSD and Solid State Devices > +description: The use of solid state disk devices in FreeBSD > trademarks: ["freebsd", "general"] > --- > > diff --git a/documentation/content/en/articles/vm-design/_index.adoc b/do= cumentation/content/en/articles/vm-design/_index.adoc > index 12a60f6962..884e88bd76 100644 > --- a/documentation/content/en/articles/vm-design/_index.adoc > +++ b/documentation/content/en/articles/vm-design/_index.adoc > @@ -3,7 +3,7 @@ title: Design elements of the FreeBSD VM system > authors: > - author: Matthew Dillon > email: dillon@apollo.backplane.com > -description: Design elements of the FreeBSD VM system > +description: An easy to follow description of the design of the FreeBSD = virtual memory system > trademarks: ["freebsd", "linux", "microsoft", "opengroup", "daemon-news"= , "general"] > --- > > diff --git a/documentation/content/en/books/arch-handbook/_index.adoc b/d= ocumentation/content/en/books/arch-handbook/_index.adoc > index a5cefc4616..59041a32d6 100644 > --- a/documentation/content/en/books/arch-handbook/_index.adoc > +++ b/documentation/content/en/books/arch-handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Architecture Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: Copyright =C2=A9 2000-2006, 2012-2021 The FreeBSD Documentati= on Project > -description: FreeBSD Architecture Handbook Index > +description: For FreeBSD system developers. This book covers the archite= ctural details of many important FreeBSD kernel subsystems > trademarks: ["freebsd", "apple", "microsoft", "unix", "general"] > next: books/arch-handbook/parti > +weight: 50 > --- > > =3D FreeBSD Architecture Handbook > diff --git a/documentation/content/en/books/design-44bsd/_index.adoc b/do= cumentation/content/en/books/design-44bsd/_index.adoc > index bab937e2fc..596a138529 100644 > --- a/documentation/content/en/books/design-44bsd/_index.adoc > +++ b/documentation/content/en/books/design-44bsd/_index.adoc > @@ -6,8 +6,9 @@ authors: > - author: Michael J. Karels > - author: John S. Quarterman > copyright: 1996 Addison-Wesley Longman, Inc > -description: The Design and Implementation of the 4.4BSD Operating Syste= m. Second chapter. > +description: Donated by Addison-Wesley, provides a design overview of 4.= 4BSD, from which FreeBSD was originally derived > trademarks: ["design-44bsd"] > +weight: 60 > --- > > =3D The Design and Implementation of the 4.4BSD Operating System > diff --git a/documentation/content/en/books/dev-model/_index.adoc b/docum= entation/content/en/books/dev-model/_index.adoc > index c5b4061159..8d3b9ed4db 100644 > --- a/documentation/content/en/books/dev-model/_index.adoc > +++ b/documentation/content/en/books/dev-model/_index.adoc > @@ -3,8 +3,9 @@ title: A project model for the FreeBSD Project > authors: > - author: Niklas Saers > copyright: Copyright =C2=A9 2002-2005 Niklas Saers > -description: A project model for the FreeBSD Project > +description: A formal study of the organization of the FreeBSD project > trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "micro= soft", "opengroup", "sun", "netbsd", "general"] > +weight: 45 > --- > > =3D A project model for the FreeBSD Project > diff --git a/documentation/content/en/books/developers-handbook/_index.ad= oc b/documentation/content/en/books/developers-handbook/_index.adoc > index c7407e78d1..30c5d158f8 100644 > --- a/documentation/content/en/books/developers-handbook/_index.adoc > +++ b/documentation/content/en/books/developers-handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Developers' Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: 1995-2021 The FreeBSD Documentation Project > -description: FreeBSD Developers' Handbook Index > +description: For people who want to develop software for FreeBSD (and no= t just people who are developing FreeBSD itself) > trademarks: ["freebsd", "apple", "ibm", "ieee", "intel", "linux", "micro= soft", "opengroup", "sun", "general"] > next: books/developers-handbook/parti > +weight: 25 > --- > > =3D FreeBSD Developers' Handbook > diff --git a/documentation/content/en/books/faq/_index.adoc b/documentati= on/content/en/books/faq/_index.adoc > index cf3d7379df..70690a9837 100644 > --- a/documentation/content/en/books/faq/_index.adoc > +++ b/documentation/content/en/books/faq/_index.adoc > @@ -3,8 +3,9 @@ title: Frequently Asked Questions for FreeBSD 11.X, 12.X,= and 13.X > authors: > - author: The FreeBSD Documentation Project > copyright: 1995-2021 The FreeBSD Documentation Project > -description: Frequently Asked Questions (FAQ) for FreeBSD 11.X, 12.X, an= d 13.X > +description: Frequently Asked Questions, and answers, covering all aspec= ts of FreeBSD > trademarks: ["freebsd", "ibm", "ieee", "adobe", "intel", "linux", "micro= soft", "opengroup", "sun", "netbsd", "general"] > +weight: 5 > --- > > =3D Frequently Asked Questions for FreeBSD {rel2-relx} and {rel-relx} > diff --git a/documentation/content/en/books/fdp-primer/_index.adoc b/docu= mentation/content/en/books/fdp-primer/_index.adoc > index 403e249f11..fb703561d5 100644 > --- a/documentation/content/en/books/fdp-primer/_index.adoc > +++ b/documentation/content/en/books/fdp-primer/_index.adoc > @@ -4,8 +4,9 @@ authors: > - author: The FreeBSD Documentation Project > copyright: 1998-2021 DocEng > trademarks: ["general"] > -description: FreeBSD Documentation Project Primer for New Contributors I= ndex > +description: Everything you need to know in order to start contributing = to the FreeBSD Documentation Project > next: books/fdp-primer/preface > +weight: 10 > --- > > =3D FreeBSD Documentation Project Primer for New Contributors > diff --git a/documentation/content/en/books/handbook/_index.adoc b/docume= ntation/content/en/books/handbook/_index.adoc > index 0fdd49727d..f1f246dd93 100644 > --- a/documentation/content/en/books/handbook/_index.adoc > +++ b/documentation/content/en/books/handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: 1995-2021 The FreeBSD Documentation Project > -description: FreeBSD Handbook Index > +description: A constantly evolving, comprehensive resource for FreeBSD u= sers > trademarks: ["freebsd", "ibm", "ieee", "redhat", "3com", "adobe", "apple= ", "intel", "linux", "microsoft", "opengroup", "sun", "realnetworks", "orac= le", "3ware", "arm", "adaptec", "google", "heidelberger", "intuit", "lsilog= ic", "themathworks", "thomson", "vmware", "wolframresearch", "xiph", "xfree= 86", "general"] > next: books/handbook/preface > +weight: 1 > --- > > =3D FreeBSD Handbook > diff --git a/documentation/content/en/books/porters-handbook/_index.adoc = b/documentation/content/en/books/porters-handbook/_index.adoc > index 60a9df7f8a..a82db8f052 100644 > --- a/documentation/content/en/books/porters-handbook/_index.adoc > +++ b/documentation/content/en/books/porters-handbook/_index.adoc > @@ -3,9 +3,10 @@ title: FreeBSD Porter's Handbook > authors: > - author: The FreeBSD Documentation Project > copyright: 2000-2021 The FreeBSD Documentation Project > -description: FreeBSD Porter's Handbook Index > +description: Essential reading if you plan on providing a port of a thir= d party piece of software > trademarks: ["freebsd", "sun", "unix", "general"] > next: books/porters-handbook/porting-why > +weight: 15 > --- > > =3D FreeBSD Porter's Handbook > diff --git a/documentation/themes/beastie/layouts/index.html b/documentat= ion/themes/beastie/layouts/index.html > index 1ba57c710a..8b56f7c484 100644 > --- a/documentation/themes/beastie/layouts/index.html > +++ b/documentation/themes/beastie/layouts/index.html > @@ -30,11 +30,13 @@ > {{ end }} > >
        > - {{ range sort $books "path" }} > + {{ range sort $books "weight" "path" }} > {{ if in .path "_index.adoc" }} > {{ $bookPath :=3D replaceRE "/_index.adoc" "" .path }} > {{ $bookName :=3D replaceRE "books/" "" $bookPath }} > -
      • {{ .page.Title }}
        • > +
      • {{ .page.Title }} > +

        {{ .page.Params.description }}

        > +
        • > {{ end }} > {{ end }} >
      > @@ -50,11 +52,13 @@ > {{ end }} > >
        > - {{ range sort $articles "path" }} > + {{ range sort $articles "weight" "path" }} > {{ if in .path "_index.adoc" }} > {{ $articlePath :=3D replaceRE "/_index.adoc" "" .path }} > {{ $articleName :=3D replaceRE "articles/" "" $articlePath }} > -
      • {{ .page.Title }}
        • > +
      • {{ .page.Title }} > +

        {{ .page.Params.description }}

        > +
        • > {{ end }} > {{ end }} >
      Uo! Really nice! Thanks for that! I'm preparing the tags too :) From owner-dev-commits-doc-all@freebsd.org Sun May 2 17:11:27 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 F409962B201 for ; Sun, 2 May 2021 17:11: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 4FYCLk6HQ9z4rSf; Sun, 2 May 2021 17:11: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 CAE216CA9; Sun, 2 May 2021 17:11: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 142HBQ5n082170; Sun, 2 May 2021 17:11:26 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142HBQbh082169; Sun, 2 May 2021 17:11:26 GMT (envelope-from git) Date: Sun, 2 May 2021 17:11:26 GMT Message-Id: <202105021711.142HBQbh082169@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Allan Jude Subject: git: 10a098a053 - main - Add link to the committer's guide to the docs site top-nav MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: allanjude X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 10a098a0538275f6d82fbbab72bc5e3af661bf4b 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: Sun, 02 May 2021 17:11:27 -0000 The branch main has been updated by allanjude: URL: https://cgit.FreeBSD.org/doc/commit/?id=10a098a0538275f6d82fbbab72bc5e3af661bf4b commit 10a098a0538275f6d82fbbab72bc5e3af661bf4b Author: Allan Jude AuthorDate: 2021-05-02 17:11:01 +0000 Commit: Allan Jude CommitDate: 2021-05-02 17:11:01 +0000 Add link to the committer's guide to the docs site top-nav Sponsored-By: Klara Inc. --- documentation/themes/beastie/layouts/partials/site-navigation.html | 3 +++ 1 file changed, 3 insertions(+) diff --git a/documentation/themes/beastie/layouts/partials/site-navigation.html b/documentation/themes/beastie/layouts/partials/site-navigation.html index 15ad25466e..3dd10a31d7 100644 --- a/documentation/themes/beastie/layouts/partials/site-navigation.html +++ b/documentation/themes/beastie/layouts/partials/site-navigation.html @@ -61,6 +61,9 @@
    • {{ i18n "developerHandbook" }}
      • +
    • + {{ i18n "committersGuide" }} +
    • {{ i18n "manualPages" }}
      • From owner-dev-commits-doc-all@freebsd.org Sun May 2 20:22: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 15ADD5F89AA for ; Sun, 2 May 2021 20:22: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 4FYHbh06RYz3J3p; Sun, 2 May 2021 20:22: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 EAF4E1178A; Sun, 2 May 2021 20:22:55 +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 142KMtOR035607; Sun, 2 May 2021 20:22:55 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 142KMtbR035606; Sun, 2 May 2021 20:22:55 GMT (envelope-from git) Date: Sun, 2 May 2021 20:22:55 GMT Message-Id: <202105022022.142KMtbR035606@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Charlie Li Subject: git: 9f29b29e6a - main - Add committers entries for Charlie Li (vishwin) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: vishwin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9f29b29e6ae3b2835b30146a49d933234988104d 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: Sun, 02 May 2021 20:22:56 -0000 The branch main has been updated by vishwin (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=9f29b29e6ae3b2835b30146a49d933234988104d commit 9f29b29e6ae3b2835b30146a49d933234988104d Author: Charlie Li AuthorDate: 2021-05-02 03:57:26 +0000 Commit: Charlie Li CommitDate: 2021-05-02 20:20:33 +0000 Add committers entries for Charlie Li (vishwin) Following section 7.1 in Committer's Guide. Approved by: arrowd (mentor), delphij (doc), ygy (doc) Differential Revision: https://reviews.freebsd.org/D30077 --- .../articles/contributors/contrib-committers.adoc | 1 + .../content/en/articles/pgpkeys/_index.adoc | 3 + documentation/static/pgpkeys/vishwin.key | 66 ++++++++++++++++++++++ shared/authors.adoc | 4 ++ website/data/en/news/news.toml | 3 + website/data/zh-cn/news/news.toml | 4 ++ 6 files changed, 81 insertions(+) diff --git a/documentation/content/en/articles/contributors/contrib-committers.adoc b/documentation/content/en/articles/contributors/contrib-committers.adoc index ae10679778..3a1877cf9e 100644 --- a/documentation/content/en/articles/contributors/contrib-committers.adoc +++ b/documentation/content/en/articles/contributors/contrib-committers.adoc @@ -198,6 +198,7 @@ * {achim} * {truckman} * {glewis} +* {vishwin} * {qingli} * {delphij} * {avatar} diff --git a/documentation/content/en/articles/pgpkeys/_index.adoc b/documentation/content/en/articles/pgpkeys/_index.adoc index f55d39fe46..aa394baefa 100644 --- a/documentation/content/en/articles/pgpkeys/_index.adoc +++ b/documentation/content/en/articles/pgpkeys/_index.adoc @@ -920,6 +920,9 @@ include::static/pgpkeys/truckman.key[] === `{glewis}` include::static/pgpkeys/glewis.key[] +=== `{vishwin}` +include::static/pgpkeys/vishwin.key[] + === `{qingli}` include::static/pgpkeys/qingli.key[] diff --git a/documentation/static/pgpkeys/vishwin.key b/documentation/static/pgpkeys/vishwin.key new file mode 100644 index 0000000000..663c41dd1a --- /dev/null +++ b/documentation/static/pgpkeys/vishwin.key @@ -0,0 +1,66 @@ +// sh addkey.sh vishwin FEB7852BE29B3E87 ; + +[.literal-block-margin] +.... +pub rsa4096/FEB7852BE29B3E87 2021-05-02 [SC] [expires: 2023-05-16] + Key fingerprint = 2577 79BA D34D 8697 8770 1331 FEB7 852B E29B 3E87 +uid Charlie Li (FreeBSD Project) +sub rsa4096/2F452088A7FB535E 2021-05-02 [E] [expires: 2023-05-02] + +.... + +[.literal-block-margin] +.... +-----BEGIN PGP PUBLIC KEY BLOCK----- + +mQINBGCOEbUBEACsAJytQ+p1D27T9El6AbDi/PlGlz2X/Sn5ZqAId+JcxcNbdJgc +ZLbCVOTUSfBo+OFytxRCBw867yfZlRdC8aEvubo7pdnho45G+U5lXeWvwwLGUSrU +7LDIaCmFj70iY/aSaYQp2WPALcIpzSXyPeJuuLuiELsCSm3g3eD6wk2ttvobWRzp +DmL9JH/5oaTLRcZatb+9fUXR4rKXodZFAuDkmX8XS5Kcajv35zfOozRfvrDM88K3 +JHRjpwbRNlhHMggNKuoFJ2fkOfwE34H2Pd5Si6kL41Fv5d1oe/p45GxDZp5/Uvo3 +O/4H+v8s7f5HIt2xQu7Jp6AvpShvHcxnSJNIukBbtI2P/28HQOuZPc6bO6cl/qhR +T+J/5GuKs0AECprxz1PgLRZoZbFWTiN11ohdNoZjl6mW5qOkCeZfgd+KP/TkY+Gc +gM95hGWvigPtL5leCZcfGORgarhJ7kbVF4PtIBM9+UhZlgwEOyu6iRQr8GQ8BW23 +09TLDzwVj71pj18EaHAbYD7mS2/62ABCYG+tr1Cbu3UH9CcTNkc1tF2pyMn338bv +OuUWFHhaC2QVTwvOdyaArMhaBvSkTppoJJzvafUadss3e0PnMABZG3uyOzo5MzjY +XpkiCSWTB7OnOu6KE0bQ2d9SVz6IiXzMAbYZob3oMpU/R6Y0AmOWG9oflQARAQAB +tDJDaGFybGllIExpIChGcmVlQlNEIFByb2plY3QpIDx2aXNod2luQEZyZWVCU0Qu +b3JnPokCVAQTAQgAPgIbAwULCQgHAgYVCgkICwIEFgIDAQIeAQIXgBYhBCV3ebrT +TYaXh3ATMf63hSvimz6HBQJgjhNrBQkD1N21AAoJEP63hSvimz6HvqUP/22zMOCs +Z15zOgmkq/BXjxXarY+/7aeZHP5ip21jhcmJOc9wZHcDgFoAaD2XiHBAk3snjQkw +dYP7iYqMRdNN+2JS5cHZm5M3nOjQNgSceoF0rKESo+Cgnj+l4kty+RFYnIvvKndr +KLQkUV/3dJFmLDhKT/rJezj9tZnAFiGbpW6HWhrWykEqI0g3uZWZAJjm18H/EARF +AovRUtPDzkqxb1/KW/C8WOlMuw9BuDV/fPxxN7zBlKijcQqvxSJ6trsoNOmMqQOF +YOdtusVkxGFg02cplN45juzHOj74zhH38HB/k12LMlfktaga/L+80TPvVZnRew4C +cx3s5HVsyY4BD/3mVmq5X183reunDYSZPNk/CAmPYiLPPwZ0FtDt8k33azt8IROb +kj6uGmJJBHuWdRia5s2iRgx1Oypqr2XQQQVrKAP8z23ACiMtxxeONVAEPrVFeMD2 +OjkMoat0jn103lIH/Jv+6YS9Z20WsVOYqAGkbDy1cHMACH29cSn6HyzvFpHluZ/O +tU2QgB+0FHQ3QDBp1v5lC22apUe6D55BtBSbvqJkvt1J2/ZQRXJAkSpTBLZFqP0H +kbfRGhajDt/6WUJws+wxAIIcpelI0We6tnpqzmIhTE2n1pH3Y8ck7/9HSBkByTZY +bz4BICotWydtHn932/xV2BQ6hsR/d2ZIHNxBuQINBGCOEbUBEACZ6lzhj6K8FvC5 +/fDr85klKzDfY2eWhhd/WahES53ehesoKXlMAhScOvMRpKjyoL6VVrn47g0jnfcm +pZPxUVnVeHz+deuPXPfm+2SHbhpJ+L7fCIrV6haFin84THFraNdqYsDDQjf0ER9A +yDSamqd6WOfEhjJodZb483TUh67dHaMlFOcbY+j82PWhzMlkizrxfm3C37C28uym +qeDxA1k74dVrgtdtX9LJOMm6HzHrtqbkDx0Z+HI2rOqSfzY6Zmxtp3nQpyy/M1Nk +01Cv5AWH2D5z83qObEaN6DxxjEVdCaC7sQEH9K9vWoTZCrnXEwzf58u89F3fdZBg +fbSYuFZXV0q/qrtLL8PHd0/W/mhR2f2POn+aJtJjQu53uZZHRR1HGHWemJYACXgW +yL0K0xING+0MrUJhJFSkWIWJSpNoQZGO6FydKLx6f/abE5AVz9gCjor5FuH2K0Qk +sgKGJz8b/W8+i+whyfoLbPdaVaizL5wBoqFf14/ITN1+Svn8j1Rdhclhf6uQmTIl +Jt2vawl2SEl8SupokEYugwVI99ERlb+eZaIDOixvOVByl4Guf7hEPx4YqdPxE2Hc +lC7KApGODPXVKY3LvDAK6WzTVEybpQaZthwoPRNq97cXkaJFqSzKXUDcIqiPPGLM +CqT/2euRspL8hIL9y2oY7EROApUK7wARAQABiQI8BBgBCAAmFiEEJXd5utNNhpeH +cBMx/reFK+KbPocFAmCOEbUCGwwFCQPCZwAACgkQ/reFK+KbPofxaRAAhdM20RDD +TPDjH1nSvXbb33lvsLwzd3WbmcHcIxEQXBtWpn7YUyb/Oe3xBlDfzuLdQDLijsku +zkETUggx0FBRhPUwyzdsflro1wgfH0EqyuegOq2FY+z2RtQOJDGHb8hBd49GwD9H +5wiSgwDJMA2pjDSr8aG77VDaN1/NeHpE4bmlJGwbKihM0fOoAh8KjZhapJM9ycjk +o61yFrofObO5h+b9WPdpFNyt9eHCGBO6zxpMlEViQ7Fm6t71R7FWP3AIsK6tHAal +zf3IQsbB8r//RYeko8nJa24rl3JdB8MhgDUgx5g5hqRaLSAVmwlH8NdIB2eHXaU+ +iwlA/Y03zgp1yiI4fYz+Vp0By5Sv0k3T9zEzhYaW+ahOq8LqOW4dR5G3x3Ht5F6j +kySF6lBtLwChWGCUbiJYuIzX9ErKzMrwkaBBiA9M66UqVEo7gA2rUIilCgt+V4rn +P8LXjlcF4RK8zmajdzZRixA7iILTNP7m688ZiFnfkeAfOUipMyYjnj4k4M4FGgSt +2a5Dih3g/6Rf8kRMPD1VvdsbOH09FKKi+cnI5aeJ51DpTyT/d2cu9vqy4RfRetDz +xH0jUxEEWOmhG59YBuRH3AgWxJ93UGKconihyQ1G+2quP2tewZQEPMOh5HzKmLpD +7ChTGV5tKqPdWMTfdWjLks8d7C4782boDbQ= +=UfX2 +-----END PGP PUBLIC KEY BLOCK----- +.... diff --git a/shared/authors.adoc b/shared/authors.adoc index 4426c817b4..31cc50f46c 100644 --- a/shared/authors.adoc +++ b/shared/authors.adoc @@ -3419,6 +3419,10 @@ :viny-email: viny@FreeBSD.org :viny: {viny-name} <{viny-email}> +:vishwin-name: Charlie Li +:vishwin-email: vishwin@FreeBSD.org +:vishwin: {vishwin-name} <{vishwin-email}> + :vkashyap-name: Vinod Kashyap :vkashyap-email: vkashyap@FreeBSD.org :vkashyap: {vkashyap-name} <{vkashyap-email}> diff --git a/website/data/en/news/news.toml b/website/data/en/news/news.toml index bcb8fff542..75fa8fc275 100644 --- a/website/data/en/news/news.toml +++ b/website/data/en/news/news.toml @@ -1,4 +1,7 @@ # Sort news by year, month and day +[[news]] +date = "2021-04-29" +description = "New committer: Charlie Li (ports)" [[news]] date = "2021-04-21" diff --git a/website/data/zh-cn/news/news.toml b/website/data/zh-cn/news/news.toml index 1785f9db4e..9655d86d18 100644 --- a/website/data/zh-cn/news/news.toml +++ b/website/data/zh-cn/news/news.toml @@ -1,6 +1,10 @@ # Sort news by year, month and day # $FreeBSD$ +[[news]] +date = "2021-04-29" +description = "新增 committer: 李呈 (ports)" + [[news]] date = "2018-12-11" title = "FreeBSD 12.0-RELEASE 发布了"