git: 5391fa93ba - main - ja/handbook: Update ports chapter

From: Ryusuke SUZUKI <ryusuke_at_FreeBSD.org>
Date: Mon, 10 Oct 2022 05:43:52 UTC
The branch main has been updated by ryusuke:

URL: https://cgit.FreeBSD.org/doc/commit/?id=5391fa93ba849a53f81b7c22e86c22c97433dbef

commit 5391fa93ba849a53f81b7c22e86c22c97433dbef
Author:     Ryusuke SUZUKI <ryusuke@FreeBSD.org>
AuthorDate: 2022-10-10 05:43:21 +0000
Commit:     Ryusuke SUZUKI <ryusuke@FreeBSD.org>
CommitDate: 2022-10-10 05:43:21 +0000

    ja/handbook: Update ports chapter
    
    2b027dd017 -> 6feb98a171
---
 .../content/ja/books/handbook/ports/_index.adoc    | 95 ++++++----------------
 1 file changed, 26 insertions(+), 69 deletions(-)

diff --git a/documentation/content/ja/books/handbook/ports/_index.adoc b/documentation/content/ja/books/handbook/ports/_index.adoc
index ff8d4df6b1..703325c9ed 100644
--- a/documentation/content/ja/books/handbook/ports/_index.adoc
+++ b/documentation/content/ja/books/handbook/ports/_index.adoc
@@ -8,6 +8,7 @@ tags: ["ports", "collection", "pkg", "poudriere", "管理"]
 showBookMenu: true
 weight: 6
 path: "/books/handbook/"
+aliases: ["/ja/books/handbook/ports-overview/","/ja/books/handbook/ports-finding-applications/","/ja/books/handbook/pkgng-intro/","/ja/books/handbook/ports-using/","/ja/books/handbook/ports-poudriere/","/ja/books/handbook/ports-nextsteps/","/ja/books/handbook/ports-broken/"]
 ---
 
 [[ports]]
@@ -188,7 +189,7 @@ Info:   Lists information about open files (similar to fstat(1))
 Maint:  ler@lerctr.org
 Index:  sysutils
 B-deps:
-R-deps: 
+R-deps:
 ....
 +
 [TIP]
@@ -611,50 +612,6 @@ port の構築の展開部で、ダウンロードされたソースは自動的
 
 port を用いてアプリケーションをコンパイルできるようにするには、 まず最初に Ports Collection をインストールする必要があります。 FreeBSD のインストール時に Ports Collection をインストールしていない場合には、 以下の方法のどれかを用いてインストールしてください。
 
-[[ports-using-portsnap-method]]
-[.procedure]
-====
-*Procedure: Portsnap を利用する方法*
-
-FreeBSD のベースシステムには、Portsnap が含まれています。 これは Ports Collection を取得するための速くて使いやすく、 多くのユーザ (FreeBSD-CURRENT を使っているユーザは除きます) に推奨されるツールです。 このユーティリティは、FreeBSD のサイトに接続し、セキュリティキーを検証し、 Ports Collection の最新版をダウンロードします。 セキュリティキーは、 ダウンロードしたすべてのファイルの検証に用いられます。
-
-+Note that Portsnap updates are generated from a snapshot of the main
-+branch of the Ports Collection and cannot be configured to use a
-+different branch (for example, `quarterly`).
-+If it is necessary to use a different branch of the Ports Collection
-+(for instance as referenced earlier in conjunction with binary
-+packages), then the <<ports-using-git-method,Git method>> must be used.
-+
-. 圧縮された Ports Collection のスナップショットを [.filename]#/var/db/portsnap# にダウンロードするには以下を実行してください。
-+
-[source,shell]
-....
-# portsnap fetch
-....
-+
-. 初めて Portsnap を使う時は、 スナップショットをまず [.filename]#/usr/ports# に展開してください。
-+
-[source,shell]
-....
-# portsnap extract
-....
-+
-. 上で示した Portsnap を初めて利用する際に行うコマンドを実行した後は、 以下のコマンドで [.filename]#/usr/ports# をアップデートしてください。
-+
-[source,shell]
-....
-# portsnap fetch
-# portsnap update
-....
-+ 
-`fetch` を使う場合には、以下のよう `extract` または `update` を連続して行うことができます。
-+
-[source,shell]
-....
-# portsnap fetch update
-....
-====
-
 [[ports-using-git-method]]
 [.procedure]
 ====
@@ -855,7 +812,7 @@ port が削除されるときに表示されるメッセージを読むことを
 
 ports のインストール後、時間が経過すると、Ports Collection で新しいバージョンのソフトウェアを利用できるようになります。 この章では、 どのようにしてアップグレードする必要のあるソフトウェアを判断するか、 そしてアップグレードの方法について説明します。
 
-インストールされている ports の新しいバージョンを利用できるかどうかを知るには、まず、 最新の ports ツリーがインストールされていることを確認してください。 これには、<<ports-using-portsnap-method,「Portsnap を利用する方法」>> もしくは <<ports-using-git-method,「Git を用いる方法」>> で書かれているアップデートのコマンドを使ってください。
+インストールされている ports の新しいバージョンを利用できるかどうかを知るには、まず、 最新の ports ツリーがインストールされていることを確認してください。 これには、<<ports-using-git-method,「Git を用いる方法」>> で書かれているアップデートのコマンドを使ってください。
 FreeBSD 10 以降のシステム、または、pkg に変換されたシステムでは、 以下のコマンドを実行すると、現在利用可能なバージョンよりも古い ports の一覧が表示されます。
 
 [source,shell]
@@ -1051,25 +1008,25 @@ poudriere を実行するシステムで、 必ずしも ZFS を使う必要は
 
 [source,shell]
 ....
-# poudriere jail -c -j 11amd64 -v 11.4-RELEASE
-[00:00:00] Creating 11amd64 fs at /poudriere/jails/11amd64... done
-[00:00:00] Using pre-distributed MANIFEST for FreeBSD 11.4-RELEASE amd64
-[00:00:00] Fetching base for FreeBSD 11.4-RELEASE amd64
-/poudriere/jails/11amd64/fromftp/base.txz              125 MB 4110 kBps    31s
+# poudriere jail -c -j 13amd64 -v 13.1-RELEASE
+[00:00:00] Creating 13amd64 fs at /poudriere/jails/13amd64... done
+[00:00:00] Using pre-distributed MANIFEST for FreeBSD 13.1-RELEASE amd64
+[00:00:00] Fetching base for FreeBSD 13.1-RELEASE amd64
+/poudriere/jails/13amd64/fromftp/base.txz              125 MB 4110 kBps    31s
 [00:00:33] Extracting base... done
-[00:00:54] Fetching src for FreeBSD 11.4-RELEASE amd64
-/poudriere/jails/11amd64/fromftp/src.txz               154 MB 4178 kBps    38s
+[00:00:54] Fetching src for FreeBSD 13.1-RELEASE amd64
+/poudriere/jails/13amd64/fromftp/src.txz               154 MB 4178 kBps    38s
 [00:01:33] Extracting src... done
-[00:02:31] Fetching lib32 for FreeBSD 11.4-RELEASE amd64
-/poudriere/jails/11amd64/fromftp/lib32.txz              24 MB 3969 kBps    06s
+[00:02:31] Fetching lib32 for FreeBSD 13.1-RELEASE amd64
+/poudriere/jails/13amd64/fromftp/lib32.txz              24 MB 3969 kBps    06s
 [00:02:38] Extracting lib32... done
 [00:02:42] Cleaning up... done
 [00:02:42] Recording filesystem state for clean... done
 [00:02:42] Upgrading using ftp
-/etc/resolv.conf -> /poudriere/jails/11amd64/etc/resolv.conf
+/etc/resolv.conf -> /poudriere/jails/13amd64/etc/resolv.conf
 Looking up update.FreeBSD.org mirrors... 3 mirrors found.
 Fetching public key from update4.freebsd.org... done.
-Fetching metadata signature for 11.4-RELEASE from update4.freebsd.org... done.
+Fetching metadata signature for 13.1-RELEASE from update4.freebsd.org... done.
 Fetching metadata index... done.
 Fetching 2 metadata files... done.
 Inspecting system... done.
@@ -1078,7 +1035,7 @@ Fetching 124 patches.....10....20....30....40....50....60....70....80....90....1
 Applying patches... done.
 Fetching 6 files... done.
 The following files will be added as part of updating to
-11.4-RELEASE-p1:
+13.1-RELEASE-p1:
 /usr/src/contrib/unbound/.github
 /usr/src/contrib/unbound/.github/FUNDING.yml
 /usr/src/contrib/unbound/contrib/drop2rpz
@@ -1087,14 +1044,14 @@ The following files will be added as part of updating to
 /usr/src/contrib/unbound/services/rpz.h
 /usr/src/lib/libc/tests/gen/spawnp_enoexec.sh
 The following files will be updated as part of updating to
-11.4-RELEASE-p1:
+13.1-RELEASE-p1:
 […]
 Installing updates...Scanning //usr/share/certs/blacklisted for certificates...
 Scanning //usr/share/certs/trusted for certificates...
  done.
-11.4-RELEASE-p1
+13.1-RELEASE-p1:
 [00:04:06] Recording filesystem state for clean... done
-[00:04:07] Jail 11amd64 11.4-RELEASE-p1 amd64 is ready to be used
+[00:04:07] Jail 13amd64 13.1-RELEASE-p1 amd64 is ready to be used
 ....
 
 [source,shell]
@@ -1107,10 +1064,10 @@ Scanning //usr/share/certs/trusted for certificates...
 一つのコンピュータ上で、 複数の設定、複数の jails、異なる port ツリーから poudriere は port をビルドできます。 これらのコンビネーションのカスタム設定は _セット_ と呼ばれます。 詳細については、package:ports-mgmt/poudriere[] もしくは package:ports-mgmt/poudriere-devel[] をインストール後、 man:poudriere[8] の CUSTOMIZATION の章をご覧下さい。
 
 ここで示される基本設定では、jail, ports そしてセット固有の [.filename]#make.conf# を [.filename]#/usr/local/etc/poudriere.d# に置いてください。
-この例でのファイル名 [.filename]#11amd64-local-workstation-make.conf# は、jail 名、port 名そして、セット名の組み合わせで付けられています。
+この例でのファイル名 [.filename]#13amd64-local-workstation-make.conf# は、jail 名、port 名そして、セット名の組み合わせで付けられています。
 システムの [.filename]#make.conf# と、この新しいファイルは、ビルド時に結合され、構築した jail で用いられる [.filename]#make.conf# を作成します。
 
-ビルドする package を [.filename]#11amd64-local-workstation-pkglist# に記載してください。
+ビルドする package を [.filename]#13amd64-local-workstation-pkglist# に記載してください。
 
 [.programlisting]
 ....
@@ -1124,14 +1081,14 @@ ports-mgmt/pkg
 
 [source,shell]
 ....
-# poudriere options -j 11amd64 -p local -z workstation -f 11amd64-local-workstation-pkglist
+# poudriere options -j 13amd64 -p local -z workstation -f 13amd64-local-workstation-pkglist
 ....
 
 最後に packages を構築し、 package リポジトリを生成してください。
 
 [source,shell]
 ....
-# poudriere bulk -j 11amd64 -p local -z workstation -f 11amd64-local-workstation-pkglist
+# poudriere bulk -j 13amd64 -p local -z workstation -f 13amd64-local-workstation-pkglist
 ....
 
 このコマンドの実行中に kbd:[Ctrl+t] を押すと、現在のビルド状況が表示されます。 Poudriere は [.filename]#/poudriere/logs/bulk/jailname# にあるファイルも構築します。 このファイルをウェブサーバと共に使うことで、 ビルド情報を表示できます。
@@ -1152,15 +1109,15 @@ FreeBSD: {
 ....
 
 通常は、HTTP 経由で poudriere リポジトリをクライアントコンピュータに公開すると簡単です。
-package ディレクトリ (たとえば、 [.filename]#/usr/local/poudriere/data/packages/11amd64# ) を公開するようにウェブサーバを設定してください。
-この例で [.filename]#11amd64# は構築名です。
+package ディレクトリ (たとえば、 [.filename]#/usr/local/poudriere/data/packages/13amd64# ) を公開するようにウェブサーバを設定してください。
+この例で [.filename]#13amd64# は構築名です。
 
-もし、package リポジトリの URL が `http://pkg.example.com/11oamd64` であれば、 リポジトリの設定ファイルである [.filename]#/usr/local/etc/pkg/repos/custom.conf# は、 以下のようになります。
+もし、package リポジトリの URL が `http://pkg.example.com/13amd64` であれば、 リポジトリの設定ファイルである [.filename]#/usr/local/etc/pkg/repos/custom.conf# は、 以下のようになります。
 
 [.programlisting]
 ....
 custom: {
-	url: "http://pkg.example.com/11amd64",
+	url: "http://pkg.example.com/13amd64",
 	enabled: yes,
 }
 ....