[gentoo-commits] gentoo commit in xml/htdocs/doc/ja/handbook: hb-working-portage.xml

[Naoaki Shindo (shindo)]

shindo      08/09/09 17:09:01

  Modified:             hb-working-portage.xml
  Log:
  Sync to 1.71. Thanks to Masuda.

Revision  Changes    Path
1.12                 xml/htdocs/doc/ja/handbook/hb-working-portage.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/ja/handbook/hb-working-portage.xml?rev=1.12&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/ja/handbook/hb-working-portage.xml?rev=1.12&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/ja/handbook/hb-working-portage.xml?r1=1.11&r2=1.12

Index: hb-working-portage.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/ja/handbook/hb-working-portage.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- hb-working-portage.xml	5 Feb 2006 10:26:32 -0000	1.11
+++ hb-working-portage.xml	9 Sep 2008 17:09:00 -0000	1.12
@@ -4,13 +4,19 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/ja/handbook/hb-working-portage.xml,v 1.11 2006/02/05 10:26:32 idani Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/ja/handbook/hb-working-portage.xml,v 1.12 2008/09/09 17:09:00 shindo Exp $ -->
 
 <sections>
 
-<version>1.52</version>
-<date>2005-12-26</date>
-<!-- Original revision: 1.57 -->
+<abstract>
+この章では、システムにおけるソフトウェアの管理をしていくのに、
+ユーザーが知っておくべき「簡単な」手順を説明します。
+</abstract>
+
+
+<version>1.64</version>
+<date>2008-02-29</date>
+<!-- Original revision: 1.71 -->
 <!-- Translator: kobayashi -->
 
 <section>
@@ -178,12 +184,14 @@
 <pre caption="現在のdoc USEフラグを確認">
 <comment>(もちろんalsa-libはただの例です)</comment>
 # <i>emerge -vp alsa-lib</i>
-[ebuild  N    ] media-libs/alsa-lib-1.0.9_rc3  +doc -jack 674 kB
+[ebuild  N    ] media-libs/alsa-lib-1.0.14_rc1  -debug +doc 698 kB
 </pre>
 
 <p>
-<c>doc</c>USEフラグは全体的には<path>/etc/make.conf</path>ファイルで、パッケージごとでは<path>/etc/portage/package.use</path>ファイルで有効や無効を切り替えることが出来ます。
-<uri link="?part=2&amp;chap=2">USEフラグ</uri>の章ではこれについて詳しく説明しています。
+<c>doc</c>USEフラグを有効にするのに一番良い方法は、<path>/etc/portage/package.use</path>によってパッケージごとに行うやり方です。
+そのため、興味のあるパッケージの分だけドキュメントを取得できるようになります。
+このフラグを全体に有効にしてしまうと、循環依存の問題を起こす原因となることが知られています。
+詳しくは、<uri link="?part=2&amp;chap=2">USEフラグ</uri>の章を読んでください。 
 </p>
 
 <p>
@@ -192,7 +200,7 @@
 </p>
 
 <pre caption="パッケージドキュメントの位置">
-# <i>ls -l /usr/share/doc/alsa-lib-1.0.9_rc3</i>
+# <i>ls -l /usr/share/doc/alsa-lib-1.0.14_rc1</i>
 total 28
 -rw-r--r--  1 root root  669 May 17 21:54 ChangeLog.gz
 -rw-r--r--  1 root root 9373 May 17 21:54 COPYING.gz
@@ -201,8 +209,8 @@
 
 <comment>(このほかにも、equeryを使用してファイルの位置を表示する方法もあります)</comment>
 # <i>equery files alsa-lib | less</i>
-media-libs/alsa-lib-1.0.9_rc3
-* Contents of media-libs/alsa-lib-1.0.9_rc3:
+media-libs/alsa-lib-1.0.14_rc1
+* Contents of media-libs/alsa-lib-1.0.14_rc1:
 /usr
 /usr/bin
 /usr/bin/alsalisp
@@ -256,8 +264,9 @@
 
 <p>
 Portageはインストールされているアプリケーションの新しいバージョンを検索します。
-しかし、これは明示的にインストールされたものしか確かめず、依存関係のものは確認されません。
-システムの全てのパッケージを更新したいときには<c>--deep</c>引数を与えてやります。
+しかし、これは<e>明示的に</e>インストールされたものしか確かめません（そうしたアプリケーションは<path>/var/lib/portage/world</path>にリストされています）。
+つまり、それらの依存関係は確認しないということです。
+システムの<e>個々のパッケージすべて</e>を更新したいときには<c>--deep</c>引数を与えてやります。
 </p>
 
 <pre caption="システムの全てを更新する">
@@ -356,7 +365,7 @@
 <p>
 いくらかのソフトウェアは少しのアーキテクチャのみで利用可能です。
 すなわちそのソフトウェアは他のアーキテクチャでは動作しないか、もっとテストが必要か、
-Portageツリーにソフトウェアをcommitした開発者が異なったアーキテクチャで動作するかどうか確認できないかです。
+Portageツリーにソフトウェアをコミットした開発者が異なったアーキテクチャで動作するかどうか確認できないかです。
 </p>
 
 <p>
@@ -392,6 +401,11 @@
 </p>
 
 <p>
+<b>&lt;</b>media-video/mplayer-bin-1.0_rc1-r2のように特定のパッケージ識別子（atom）を伴いブロックしていることがあるかもしれません。
+この場合、ブロックしているパッケージをより新しいバージョンに更新すれば、ブロックを取り除くことができかもしれません。
+</p>
+
+<p>
 既にインストールされた2つのパッケージがお互いをブロックし合っていることもあります。
 このまれな場合は、何故それらをインストールする必要があるのかを知るべきです。
 ほとんどの場合、1つのパッケージのみで事足ります。
@@ -415,7 +429,7 @@
 - lm-sensors/lm-sensors-2.8.7 (masked by: <i>-sparc keyword</i>)
 - sys-libs/glibc-2.3.4.20040808 (masked by: <i>-* keyword</i>)
 - dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>)
-- media-video/ati-gatos-4.3.0 (masked by: <i>package.mask</i>)
+- games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>)
 - sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>)
 </pre>
 
@@ -544,5 +558,48 @@
 
 </body>
 </subsection>
+<subsection id="digesterror">
+<title>ダイジェスト検証の失敗</title>
+<body>
+
+<p>
+ときどき、あるパッケージをemergeしようとして、次のようなメッセージと共に失敗することがあるかもしれません。
+</p>
+
+<pre caption="ダイジェスト検証の失敗">
+&gt;&gt;&gt; checking ebuild checksums
+!!! Digest verification failed:
+</pre>
+
+<p>
+これはPortageツリーにどこかおかしい所がある兆候です。
+よく、開発者がパッケージをツリーにコミットするとき失敗したことが原因で起こります。
+</p>
+
+<p>
+Digestの検証に失敗するとき、そのパッケージをあなた自身で再度ダイジェスト作成しようとしては<e>いけません。</e>
+この問題は<c>ebuild foo digest</c>では修正されない上に、ほぼ間違いなく悪化します。
+</p>
+
+<p>
+かわりに、1時間か2時間ツリーが安定するのを待っていてください。
+おそらくエラーはすぐに検知されると思いますが、修正がPortageツリーに流れるのに少し時間がかかります。
+待っている間、<uri link="http://bugs.gentoo.org">Bugzilla</uri>をチェックし、誰かがこの問題をすでに報告しているか調べてください。
+もしいなければ、すぐ壊れているパッケージのバグ報告をしてください。
+</p>
+
+<p>
+いったんバグが修正されたことを確認したら、再び同期し修正されたダイジェストを取得する必要があるでしょう。
+</p>
+
+<impo>
+これは何度もツリーの同期をしてもよいという意味では<e>ありません</e>！
+rsycnポリシーの中で述べられているように（<c>emerge --sync</c>を走らせたとき）、
+あまり頻繁に同期するユーザは接続を禁止されることになります！
+実際には次の定期的な同期まで待ち、そしてrsyncサーバに負荷をかけないようにしてください。
+</impo>
+
+</body>
+</subsection>
 </section>
 </sections>