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] をご覧ください。