git: e5bca1a208 - main - 9562c272a7 -> f725439f65, 989d921f5d -> 132ff9d795

Ryusuke SUZUKI ryusuke at FreeBSD.org
Sat Apr 17 07:06:12 UTC 2021 

The branch main has been updated by ryusuke:

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

commit e5bca1a208fe6591bc5d545477f8ddc08177c81b
Author:     Ryusuke SUZUKI <ryusuke at FreeBSD.org>
AuthorDate: 2021-04-17 07:05:51 +0000
Commit:     Ryusuke SUZUKI <ryusuke at FreeBSD.org>
CommitDate: 2021-04-17 07:05:51 +0000

    9562c272a7 -> f725439f65, 989d921f5d -> 132ff9d795
---
 .../content/ja/books/handbook/ports/_index.adoc    | 65 ++++++++++++++++------
 1 file changed, 48 insertions(+), 17 deletions(-)

diff --git a/documentation/content/ja/books/handbook/ports/_index.adoc b/documentation/content/ja/books/handbook/ports/_index.adoc
index 83a4fc1c36..038a4263f6 100644
--- a/documentation/content/ja/books/handbook/ports/_index.adoc
+++ b/documentation/content/ja/books/handbook/ports/_index.adoc
@@ -576,6 +576,16 @@ Ports Collection は、[.filename]#Makefile#, 修正パッチ、 説明文など
 
 デフォルトでは、Ports Collection は、[.filename]#/usr/ports# 以下のサブディレクトリに置かれます。
 
+[WARNING]
+====
+
+Ports Collection をインストールして使用する前に、一般的には、
+ソフトウェアのインストールに、pkg でダウンロードしたバイナリパッケージと Ports Collection を組み合わせて使うことはあまり良いことではないことを知っておいてください。
+pkg は、デフォルトでは ports ツリーの  (HEAD ではなく) quarterly ブランチリリースを追いかけます。
+HEAD の port と対応する quarterly ブランチの port の依存関係は異なる可能性があり、そのため pkg でインストールされた依存関係と Ports Collection の依存関係の間で競合が起きることがあります。
+もし、Ports Collection と pkg を組み合わせて使用しなければならないのであれば、Ports Collection と pkg が同じ ports ツリーのブランチを使用していることを必ず確認してください。
+====
+
 port を用いてアプリケーションをコンパイルできるようにするには、 まず最初に Ports Collection をインストールする必要があります。 FreeBSD のインストール時に Ports Collection をインストールしていない場合には、 以下の方法のどれかを用いてインストールしてください。
 
 [[ports-using-portsnap-method]]
@@ -615,40 +625,56 @@ FreeBSD のベースシステムには、Portsnap が含まれています。 
 ....
 ====
 
-[[ports-using-subversion-method]]
+[[ports-using-git-method]]
 [.procedure]
 ====
-*Procedure: Subversion を用いる方法*
+*Procedure: Git を用いる方法*
 
-ports ツリーの管理が必要な場合や、 ローカルで変更点をメンテナンスする必要がある場合、 および FreeBSD-CURRENT を使用している場合には、 Subversion を使って Ports Collection を取得する方法があります。 Subversion のより詳細な説明については、 link:{committers-guide}#subversion-primer/[Subversion Primer] を参照してください。
+ports ツリーの管理が必要な場合や、 ローカルで変更点をメンテナンスする必要がある場合、 および FreeBSD-CURRENT を使用している場合には、 Git を使って Ports Collection を取得する方法があります。
+Git のより詳細な説明については、 link:{committers-guide}#git-primer/[Git Primer] を参照してください。
 
-. Subversion を使って ports ツリーをチェックアウトする前に、 Subversion をインストールしておく必要があります。 ports ツリーがすでにインストールされていれば、 以下のようにして Subversion をインストールできます。
+. Git を使って ports ツリーをチェックアウトする前に、Git をインストールしておく必要があります。
+ports ツリーがすでにインストールされていれば、 以下のようにして Git をインストールできます。
 +
 [source,shell]
 ....
-# cd /usr/ports/devel/subversion
+# cd /usr/ports/devel/git
 # make install clean
 ....
 + 
-ports ツリーが利用できない場合や、 package の管理に pkg を使っているのであれば、package から Subversion をインストールできます。
+ports ツリーが利用できない場合や、 package の管理に pkg を使っているのであれば、package から Git をインストールできます。
++
+[source,shell]
+....
+# pkg install git
+....
++
+. HEAD ブランチの ports ツリーをチェックアウトしてください。
++
+[source,shell]
+....
+# git clone https://git.FreeBSD.org/ports.git /usr/ports
+....
++
+. または、quarterly ブランチをチェックアウトしてください。
 +
 [source,shell]
 ....
-# pkg install subversion
+# git clone https://git.FreeBSD.org/ports.git -b 2020Q3 /usr/ports
 ....
 +
-. ports ツリーをチェックアウトしてください。
+. Git で最初のチェックアウトをした後は、必要に応じて [.filename]#/usr/ports# をアップデートしてください。
 +
 [source,shell]
 ....
-# svn checkout https://svn.FreeBSD.org/ports/head /usr/ports
+# git -C /usr/ports pull
 ....
 +
-. Subversion で最初のチェックアウトを行ったら、必要に応じて [.filename]#/usr/ports# をアップデートしてください。
+. 必要に応じて [.filename]#/usr/ports# を別の quarterly ブランチにスイッチしてください。
 +
 [source,shell]
 ....
-# svn update /usr/ports
+# git -C /usr/ports switch 2020Q4
 ....
 ====
 
@@ -812,7 +838,8 @@ port が削除されるときに表示されるメッセージを読むことを
 
 ports のインストール後、時間が経過すると、Ports Collection で新しいバージョンのソフトウェアを利用できるようになります。 この章では、 どのようにしてアップグレードする必要のあるソフトウェアを判断するか、 そしてアップグレードの方法について説明します。
 
-インストールされている ports の新しいバージョンを利用できるかどうかを知るには、まず、 最新の ports ツリーがインストールされていることを確認してください。 これには、<<ports-using-portsnap-method,「Portsnap を利用する方法」>> もしくは <<ports-using-subversion-method,「Subversion を用いる方法」>> で書かれているアップデートのコマンドを使ってください。 FreeBSD 10 以降のシステム、または、pkg に変換されたシステムでは、 以下のコマンドを実行すると、現在利用可能なバージョンよりも古い ports の一覧が表示されます。
+インストールされている ports の新しいバージョンを利用できるかどうかを知るには、まず、 最新の ports ツリーがインストールされていることを確認してください。 これには、<<ports-using-portsnap-method,「Portsnap を利用する方法」>> もしくは <<ports-using-git-method,「Git を用いる方法」>> で書かれているアップデートのコマンドを使ってください。
+FreeBSD 10 以降のシステム、または、pkg に変換されたシステムでは、 以下のコマンドを実行すると、現在利用可能なバージョンよりも古い ports の一覧が表示されます。
 
 [source,shell]
 ....
@@ -1045,8 +1072,8 @@ The following files will be added as part of updating to
 The following files will be updated as part of updating to
 11.4-RELEASE-p1:
 […]
-Installing updates...Scanning //usr/shared/certs/blacklisted for certificates...
-Scanning //usr/shared/certs/trusted for certificates...
+Installing updates...Scanning //usr/share/certs/blacklisted for certificates...
+Scanning //usr/share/certs/trusted for certificates...
  done.
 11.4-RELEASE-p1
 [00:04:06] Recording filesystem state for clean... done
@@ -1055,14 +1082,16 @@ Scanning //usr/shared/certs/trusted for certificates...
 
 [source,shell]
 ....
-# poudriere ports -c -p local -m svn+https
+# poudriere ports -c -p local -m git+https
 [00:00:00] Creating local fs at /poudriere/ports/local... done
 [00:00:00] Checking out the ports tree... done
 ....
 
 一つのコンピュータ上で、 複数の設定、複数の 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]#make.conf# と、この新しいファイルは、ビルド時に結合され、構築した jail で用いられる [.filename]#make.conf# を作成します。
+ここで示される基本設定では、jail, ports そしてセット固有の [.filename]#make.conf# を [.filename]#/usr/local/etc/poudriere.d# に置いてください。
+この例でのファイル名 [.filename]#11amd64-local-workstation-make.conf# は、jail 名、port 名そして、セット名の組み合わせで付けられています。
+システムの [.filename]#make.conf# と、この新しいファイルは、ビルド時に結合され、構築した jail で用いられる [.filename]#make.conf# を作成します。
 
 ビルドする package を [.filename]#11amd64-local-workstation-pkglist# に記載してください。
 
@@ -1105,7 +1134,9 @@ FreeBSD: {
 }
 ....
 
-通常は、HTTP 経由で poudriere リポジトリをクライアントコンピュータに公開すると簡単です。 package ディレクトリ (たとえば、 [.filename]#/usr/local/poudriere/data/packages/11amd64# ) を公開するようにウェブサーバを設定してください。 この例で [.filename]#11amd64# は構築名です。
+通常は、HTTP 経由で poudriere リポジトリをクライアントコンピュータに公開すると簡単です。
+package ディレクトリ (たとえば、 [.filename]#/usr/local/poudriere/data/packages/11amd64# ) を公開するようにウェブサーバを設定してください。
+この例で [.filename]#11amd64# は構築名です。
 
 もし、package リポジトリの URL が `http://pkg.example.com/11oamd64` であれば、 リポジトリの設定ファイルである [.filename]#/usr/local/etc/pkg/repos/custom.conf# は、 以下のようになります。

More information about the dev-commits-doc-all mailing list