From owner-svn-doc-head@FreeBSD.ORG Thu Aug 23 10:22:51 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E0DE51065672; Thu, 23 Aug 2012 10:22:51 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id CB5228FC18; Thu, 23 Aug 2012 10:22:51 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.4/8.14.4) with ESMTP id q7NAMpko004379; Thu, 23 Aug 2012 10:22:51 GMT (envelope-from ryusuke@svn.freebsd.org) Received: (from ryusuke@localhost) by svn.freebsd.org (8.14.4/8.14.4/Submit) id q7NAMpmj004377; Thu, 23 Aug 2012 10:22:51 GMT (envelope-from ryusuke@svn.freebsd.org) Message-Id: <201208231022.q7NAMpmj004377@svn.freebsd.org> From: Ryusuke SUZUKI Date: Thu, 23 Aug 2012 10:22:51 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r39422 - head/ja_JP.eucJP/books/handbook/cutting-edge X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Aug 2012 10:22:52 -0000 Author: ryusuke Date: Thu Aug 23 10:22:51 2012 New Revision: 39422 URL: http://svn.freebsd.org/changeset/doc/39422 Log: - Merge the following from the English version: r38879 -> 39399 head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml Modified: head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml ============================================================================== --- head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml Thu Aug 23 04:10:45 2012 (r39421) +++ head/ja_JP.eucJP/books/handbook/cutting-edge/chapter.sgml Thu Aug 23 10:22:51 2012 (r39422) @@ -2,7 +2,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: r38879 + Original revision: r39399 $FreeBSD$ --> @@ -750,13 +750,12 @@ Fetching 133 new ports or files... done. 最新の &os; ドキュメントセットをローカルで維持する方法が用意されています。 - - CVSup を用いたドキュメントのアップデート方法 + + <application>Subversion</application> + を用いたドキュメントのアップデート方法 - &os; のドキュメントのソースやインストールされたドキュメントは、 - ベースシステムのソースのアップデート - ( を参照) と同様、 - CVSup を用いてアップデートできます。 + &os; のドキュメントのソースは、 + Subversion を用いて入手できます。 この節では以下について説明します。 @@ -767,9 +766,10 @@ Fetching 133 new ports or files... done. - CVSup を用いて + Subversion を用いて、 + ドキュメントのソースを /usr/doc - にドキュメントのソースをダウンロードする方法。 + 以下にダウンロードする方法。 @@ -787,12 +787,13 @@ Fetching 133 new ports or files... done. - CVSup およびドキュメントツールチェインのインストール + <application>Subversion</application> + およびドキュメントツールチェインのインストール &os; のドキュメントをソースから再構築するには、 かなり大きなツールのコレクションが必要です。 これらのツールは多くのディスク容量を必要とし、また、 - すべての &os; ユーザにとって有用というわけではないため、 + すべての &os; ユーザにとって有用というわけではないので、 &os; ベースシステムの一部ではありません。 これらのツールは、&os; のために新しいドキュメントを活発に執筆している方や、 @@ -816,68 +817,36 @@ Fetching 133 new ports or files... done. このツールをインストールしないことはとても賢明です。 - CVSup - のインストールおよび利用に関するさらなる情報は、CVSup を使う の章をご覧ください。 + textproc/docproj + をインストールすると、Subversion + もインストールされます。 ドキュメントのソースをアップデートする - CVSup ユーティリティを使って、 - ドキュメントのソースをダウンロードできます。 - ここで /usr/share/examples/cvsup/doc-supfile - ファイルが設定のテンプレートです。 - デフォルトのアップデートホストは doc-supfile - のプレースホルダの値で設定されていますが、 - &man.cvsup.1; にコマンドラインでホスト名を指定することもできます。 - CVSup サーバの - 1 つからドキュメントのソースをダウンロードするには以下のように入力してください。 - - &prompt.root; cvsup -h cvsup.FreeBSD.org -g -L 2 /usr/share/examples/cvsup/doc-supfile - - ここで cvsup.FreeBSD.org を最も近くの - CVSup サーバに置き換えてください。 - ミラーサイトの完全な一覧については、 をご覧ください。 + ドキュメントのソースは、 + Subversion + プログラムを使ってダウンロードできます。 + ダウンロードするには以下のように入力してください。 + + &prompt.root; svn checkout svn://svn.FreeBSD.org/doc/head /usr/doc 最初にドキュメントのソースをダウンロードするには少し時間がかかります。 ダウンロードが終わるまでお待ちください。 - 将来ドキュメントのソースをアップデートするには、 - 同じコマンドを実行してください。CVSup - ユーティリティは最後に実行した時からのアップデートのみをダウンロードするので、 - 最初に CVSup を実行した後では、 - コマンドの実行時間はかなり短くなります + ダウンロードしたドキュメントのソースをアップデートするには、 + 以下のコマンドを実行してください。 + + &prompt.root; svn update /usr/doc - ソースを入手したら、ドキュメントのアップデートに、ソースを入手したら、/usr/doc ディレクトリの - Makefile を使うこともできます。 - /etc/make.conf ファイルの - SUP_UPDATE, SUPHOST および - DOCSUPFILE を設定すると、 - 以下を実行できるようになります。 + Makefile を使い、 + 以下のようにドキュメントをアップデートすることもできます。 &prompt.root; cd /usr/doc &prompt.root; make update - - 以下は、/etc/make.conf の &man.make.1; - オプションの典型的な例です。 - - SUP_UPDATE= yes -SUPHOST?= cvsup.freebsd.org -DOCSUPFILE?= /usr/share/examples/cvsup/doc-supfile - - - SUPHOST および - DOCSUPFILE の値を - ?= にすると、 - make のコマンドラインからの上書きを許可します。 - これは、さまざまなオプションの値をテストする場合に、 - 値ごとにファイルを編集することを避けられるため、 - make.conf - にオプションを追加する方法として推奨されています。 - @@ -916,15 +885,6 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d - SUPHOST - - - アップデート時に使う CVSup - サーバのホストネーム。 - - - - DOCDIR @@ -957,15 +917,6 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d &prompt.root; cd /usr/doc &prompt.root; make install clean - もし、make.conf で - DOCSUPFILE, SUPHOST および - SUP_UPDATE オプションを適切に設定しているのであれば、 - インストールのステップは、 - 以下のようにドキュメントのアップデート作業と統合できます。 - - &prompt.root; cd /usr/doc -&prompt.root; make update install clean - もし、ある特定の言語のみをアップデートしたいのであれば、 /usr/doc サブディレクトリで以下のように &man.make.1; を実行してください。 @@ -1008,7 +959,7 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d ドキュメントをソースから構築するには、 かなり大きなツールとユーティリティから構成される ドキュメンテーションツールチェイン が必要です。 - また、CVS + また、Subversion リポジトリからソースをチェックアウトし、 チェックアウトしたソースからドキュメントを手動で構築する方法について、 それなりに熟知している必要もあります。 @@ -1146,7 +1097,7 @@ DOCSUPFILE?= /usr/share/examples/cvsup/d デフォルトのターゲットディレクトリは、 - CVSup + Subversion を用いる方法とは異なります。 なぜならば、この節で説明をしている方法では port を用いてインストールしており、