pytho****@googl*****
pytho****@googl*****
2011年 11月 10日 (木) 10:05:38 JST
Revision: b97351416079 Author: Naoki INADA <inada****@klab*****> Date: Wed Nov 9 17:05:10 2011 Log: Update 2.7.2: distutils/setupscript http://code.google.com/p/python-doc-ja/source/detail?r=b97351416079 Modified: /distutils/setupscript.rst ======================================= --- /distutils/setupscript.rst Sat Mar 19 11:01:37 2011 +++ /distutils/setupscript.rst Wed Nov 9 17:05:10 2011 @@ -300,11 +300,14 @@ .. XXX Should mention clib libraries here or somewhere else! -その他の操作 ------------- +その他のオプション +-------------------- 他にもいくつかオプションがあり、特殊な状況を扱うために使います。 +:option:`optional` オプションはブール型で、真の場合は拡張モジュールのビルド に失敗したときに +ビルドプロセス自体を停止せず、単にその拡張モジュールのインストールをしませ ん。 + :option:`extra_objects` オプションには、リンカに渡すオブジェクトファイル のリストを指定します。ファイル名には拡張子をつけてはならず、コンパイラで使 われているデフォルトの拡張子が使われます。 @@ -315,9 +318,16 @@ シンボルのリストを入れられます。コンパイルして拡張モジュールをビルドする際 には、このオプションは不要です: Distutils は公開するシンボルを自動的に ``initmodule`` に渡すからです。 - -パッケージと配布物の関係 (Relationships between Distributions and Packages) -=========================================================================== +:option:`depends` オプションは、拡張モジュールが依存している(例: ヘッダーフ ァイルなどの) +ファイルのリストです。 +このファイルのいずれかが前回のビルドから変更された時、ビルドコマンドはこの ソース +ファイルをコンパイルしてリビルドします。 + + +.. Relationships between Distributions and Packages + +パッケージと配布物の関係 +========================= 配布物はパッケージと3種類の方法で関係します: @@ -379,6 +389,7 @@ 指定されたバージョンは、その配布物によって廃止されるバージョンを示していま す。バージョン指定が存在しない場合は、指定された名前のモジュールまたはパッ ケージの 全てが廃止されたと解釈されます。 +.. _distutils-installing-scripts: スクリプトをインストールする ============================ @@ -399,6 +410,11 @@ scripts=['scripts/xmlproc_parse', 'scripts/xmlproc_val'] ) +.. versionchanged:: 2.7 + テンプレートが提供されない時、全てのスクリプトが ``MANIFEST`` + ファイルに追加されるようになりました。 :ref:`manifest` を参照してくださ い + +.. _distutils-installing-package-data: パッケージデータをインストールする ================================== @@ -435,6 +451,12 @@ .. versionadded:: 2.4 +.. versionchanged:: 2.7 + テンプレートが提供されない時、全ての ``package_data`` にマッチするファ イルが ``MANIFEST`` + ファイルに追加されるようになりました。 :ref:`manifest` を参照してくださ い + + +.. _distutils-additional-files: 追加のファイルをインストールする ================================ @@ -463,6 +485,10 @@ 単にファイルの列を指定できます。しかし、このやり方は推奨されておらず、指定 すると :command:`install` コマンドが警告を出力します。 ターゲットディレクトリにデータファイルを直接インストールしたいなら、ディレ クトリ名として空文字列を指定してください。 +.. versionchanged:: 2.7 + テンプレートが提供されない時、全ての ``data_files`` にマッチするファイ ルが ``MANIFEST`` + ファイルに追加されるようになりました。 :ref:`manifest` を参照してくださ い + .. _meta-data: @@ -490,7 +516,7 @@ +----------------------+---------------------------------------------------+----------------------+--------+ | ``description`` | パッケージについての簡潔な概要説明 | 短い文字列 | | +----------------------+---------------------------------------------------+----------------------+--------+ -| ``long_description`` | パッケージについての詳細な説明 | 長い文字列 | | +| ``long_description`` | パッケージについての詳細な説明 | 長い文字列 | \(5) | +----------------------+---------------------------------------------------+----------------------+--------+ | ``download_url`` | パッケージをダウンロードできる場所 | URL | \(4) | +----------------------+---------------------------------------------------+----------------------+--------+ @@ -516,12 +542,9 @@ これらのフィールドは、2.2.3 および 2.3 より以前のバージョンの Python で も互換性を持たせたい場合には指定してはなりません。リストは `PyPI ウェブサイト <http://pypi.python.org/pypi>`_ にあります。 -.. (6) - The ``license`` field is a text indicating the license covering the - package where the license is not a selection from the "License" Trove - classifiers. See the ``Classifier`` field. Notice that - there's a ``licence`` distribution option which is deprecated but still - acts as an alias for ``license``. +(5) + パッケージを PyPI に登録する際、 PyPI は ``long_description`` フィール ドの値を使って + パッケージのホームページをビルドします。 (6) ``license`` フィールドは、パッケージのライセンスが Trove Classifier の
