File:  [Local Repository] / gnujdoc / autoconf-2.52 / install-ja.texi
Revision 1.1: download - view: text, annotated - select for diffs
Mon Jan 14 14:46:48 2002 UTC (18 years, 9 months ago) by futoshi
Branches: MAIN
CVS tags: HEAD
Add autoconf-2.52, but it is now DRAFT status.

    1: @c This file is included by autoconf.texi and is used to produce
    2: @c the INSTALL file.
    3: 
    4: @node Basic Installation
    5: @section 基本インストール
    6: 
    7: @c These are generic installation instructions.
    8: @c 
    9: これは一般的なインストール説明書です.
   10: 
   11: @c The @code{configure} shell script attempts to guess correct values for
   12: @c various system-dependent variables used during compilation.  It uses
   13: @c those values to create a @file{Makefile} in each directory of the
   14: @c package.  It may also create one or more @file{.h} files containing
   15: @c system-dependent definitions.  Finally, it creates a shell script
   16: @c @file{config.status} that you can run in the future to recreate the
   17: @c current configuration, and a file @file{config.log} containing compiler
   18: @c output (useful mainly for debugging @code{configure}).
   19: @c 
   20: @code{configure}シェルスクリプトは,コンパイル時に使用する様々なシステム
   21: に依存する変数の,正しい値を推測します.パッケージのそれぞれのディレクト
   22: リの@file{Makefile}を作成するために,これらの値は使用されます.システム
   23: 依存の定義を含む,一つ以上の@file{.h}ファイルも作成します.終りに,現在
   24: のコンフィグレーションを将来再生成するために実行可能なシェルスクリプト 
   25: @file{config.status}と,コンパイラの出力を含んでいるファイル
   26: @file{config.log} (主に@code{configure}のデバッグで役立ちます)を作成しま
   27: す.
   28: 
   29: @c It can also use an optional file (typically called @file{config.cache}
   30: @c and enabled with @option{--cache-file=config.cache} or simply
   31: @c @option{-C}) that saves the results of its tests to speed up
   32: @c reconfiguring.  (Caching is disabled by default to prevent problems with
   33: @c accidental use of stale cache files.)
   34: @c 
   35: 再コンフィグレーションのスピードをあげるため,テストの結果を保存する追加
   36: ファイルも使用可能です(通常,@file{config.cache}と呼ばれ,
   37: @option{--cache-file=config.cache}や短い@option{-C}で利用可能になります).
   38: (古いキャッシュファイルを偶然使用することによる問題を避けるため,キャッ
   39: シュはデフォルトで利用不可能になっています.) 
   40: 
   41: @c If you need to do unusual things to compile the package, please try to
   42: @c figure out how @code{configure} could check whether to do them, and mail
   43: @c diffs or instructions to the address given in the @file{README} so they
   44: @c can be considered for the next release.  If you are using the cache, and
   45: @c at some point @file{config.cache} contains results you don't want to
   46: @c keep, you may remove or edit it.
   47: @c 
   48: パッケージをコンパイルするため,通常行なうこと以外のことをする必要がある
   49: 場合,@code{configure}がどのように調査したのかを理解し,次のリリースに反
   50: 映できるように,@file{README}にあるアドレスに,差分や説明をメールしてく
   51: ださい.キャッシュを使用していて,@file{config.cache}が含む結果に保持し
   52: たくないものがある場合,削除しても編集してもかまいません.
   53: 
   54: @c The file @file{configure.ac} (or @file{configure.in}) is used to create
   55: @c @file{configure} by a program called @code{autoconf}.  You only need
   56: @c @file{configure.ac} if you want to change it or regenerate
   57: @c @file{configure} using a newer version of @code{autoconf}.
   58: @c 
   59: ファイル@file{configure.ac} (や@file{configure.in})は,@code{autoconf}と
   60: 呼ばれるプログラムで,@file{configure}を作成するために使用されます.それ
   61: を変更したり,新しいバージョンの@code{autoconf}で@file{configure}を再生
   62: 成したい場合だけ,@file{configure.in}が必要です.
   63: 
   64: @noindent
   65: @c The simplest way to compile this package is:
   66: @c 
   67: このパッケージをコンパイルする最も単純な方法は,以下の通りです.
   68: 
   69: @enumerate
   70: @item
   71: @c @code{cd} to the directory containing the package's source code and type
   72: @c @samp{./configure} to configure the package for your system.  If you're
   73: @c using @code{csh} on an old version of System V, you might need to type
   74: @c @samp{sh ./configure} instead to prevent @code{csh} from trying to
   75: @c execute @code{configure} itself.
   76: @c 
   77: パッケージのソースコード含んでいるディレクトリに@code{cd}して,システム
   78: に対してパッケージのコンフィグレーションを行なうために@samp{./configure} 
   79: と入力してください.System Vの古いバージョンの@code{csh}を使用している場
   80: 合,@code{csh}自身から@code{configure}を実行しないようにするため,
   81: @samp{sh ./configure}と入力する必要があるかもしれません.
   82: 
   83: @c Running @code{configure} takes awhile.  While running, it prints some
   84: @c messages telling which features it is checking for.
   85: @c 
   86: @code{configure}の実行にはしばらくかかります.実行中,調査している特徴を
   87: 伝えるメッセージを出力します.
   88: 
   89: @item
   90: @c Type @samp{make} to compile the package.
   91: @c 
   92: パッケージをコンパイルするために@samp{make}と入力してください.
   93: 
   94: @item
   95: @c Optionally, type @samp{make check} to run any self-tests that come with
   96: @c the package.
   97: @c 
   98: オプションとして,パッケージ付属の自己テストを実行するため,@samp{make
   99: check}と入力してください.
  100: 
  101: @item
  102: @c Type @samp{make install} to install the programs and any data files and
  103: @c documentation.
  104: @c 
  105: プログラムと,あらゆるデータファイルと,ドキュメントをインストールするた
  106: め,@samp{make install}と入力してください.
  107: 
  108: @item
  109: @c You can remove the program binaries and object files from the source code
  110: @c directory by typing @samp{make clean}.  To also remove the files that
  111: @c @code{configure} created (so you can compile the package for a different
  112: @c kind of computer), type @samp{make distclean}.  There is also a
  113: @c @samp{make maintainer-clean} target, but that is intended mainly for the
  114: @c package's developers.  If you use it, you may have to get all sorts of
  115: @c other programs in order to regenerate files that came with the distribution.
  116: @c 
  117: @samp{make clean}と入力することで,ソースコードディレクトリから,プログ
  118: ラムのバイナリやオブジェクトファイルを削除することが可能です.(異なる種
  119: 類のコンピュータに対するパッケージをコンパイルすることが可能になるように)
  120: @code{configure}が作成したファイルも削除するためには,@samp{make
  121: distclean}と入力してください.@samp{make maintainer-clean}ターゲットもあ
  122: りますが,主にパッケージ開発者用です.それを使用する場合,配布物の付属ファ
  123: イルを再生成するため,いろいろな種類の他のプログラムを入手する必要がある
  124: かもしれません.
  125: @end enumerate
  126: 
  127: @node Compilers and Options
  128: @section コンパイラとオプション
  129: 
  130: @c Some systems require unusual options for compilation or linking that the
  131: @c @code{configure} script does not know about.  Run @samp{./configure
  132: @c --help} for details on some of the pertinent environment variables.
  133: @c 
  134: @code{configure}スクリプトが知らない,普通使わない,コンパイルやリンクの
  135: オプションが必要なシステムもあります.妥当な環境変数の詳細を得るために,
  136: @samp{./configure --help}を実行してください.
  137: 
  138: @c You can give @code{configure} initial values for variables by setting
  139: @c them in the environment.  You can do that on the command line like this:
  140: @c 
  141: 環境変数に初期値をセットすることで,@code{configure}に与えることが可能で
  142: す.以下のようにコマンドラインで行うことが可能です.
  143: 
  144: @example
  145: ./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
  146: @end example
  147: 
  148: @c @xref{Environment Variables}, for more details.
  149: @c 
  150: 詳細は,@xref{Environment Variables}.
  151: 
  152: 
  153: @node Multiple Architectures
  154: @section 複数のアーキテクチャに対するコンパイル
  155: 
  156: @c You can compile the package for more than one kind of computer at the
  157: @c same time, by placing the object files for each architecture in their
  158: @c own directory.  To do this, you must use a version of @code{make} that
  159: @c supports the @code{VPATH} variable, such as GNU @code{make}.  @code{cd}
  160: @c to the directory where you want the object files and executables to go
  161: @c and run the @code{configure} script.  @code{configure} automatically
  162: @c checks for the source code in the directory that @code{configure} is in
  163: @c and in @file{..}.
  164: @c 
  165: それぞれのアーキテクチャに対するオブジェクトファイルをそれ自身のディレク
  166: トリに置くことで,同時に1種類以上のコンピュータに対するパッケージをコン
  167: パイルすることが可能です.こうするために,GNU @code{make}の様に, 
  168: @code{VPATH}変数をサポートする@code{make}のバージョンを使用する必要があ
  169: ります.オブジェクトファイルと実行可能なファイルを配置したいディレクトリ
  170: に @code{cd}して,@code{configure}スクリプトを実行してください.
  171: @code{configure} は,@code{configure}があるディレクトリと@file{..}で,ソー
  172: スコードを自動的に調査します.
  173: 
  174: @c If you have to use a @code{make} that does not support the @code{VPATH}
  175: @c variable, you have to compile the package for one architecture at a time
  176: @c in the source code directory.  After you have installed the package for
  177: @c one architecture, use @samp{make distclean} before reconfiguring for
  178: @c another architecture.
  179: @c 
  180: @code{VPATH}をサポートしない@code{make}を使用する必要がある場合,ソース
  181: コードディレクトリで,一度に一つのアーキテクチャに対してパッケージをコン
  182: パイルする必要があります.一つのアーキテクチャのパッケージをインストール
  183: した後,他のアーキテクチャに対して再コンフィグレーションするため,
  184: @samp{make distclean}を使用してください.
  185: 
  186: 
  187: @node Installation Names
  188: @section インストール名
  189: 
  190: @c By default, @samp{make install} will install the package's files in
  191: @c @file{/usr/local/bin}, @file{/usr/local/man}, etc.  You can specify an
  192: @c installation prefix other than @file{/usr/local} by giving
  193: @c @code{configure} the option @option{--prefix=@var{path}}.
  194: @c 
  195: デフォルトで,@samp{make install}はパッケージファイルを,
  196: @file{/usr/local/bin}や@file{/usr/local/man}等にインストールします.イン
  197: ストール先の接頭辞は,@option{--prefix=@var{path}}オプションを 
  198: @code{configure}に与えることで指定することが可能です.
  199: 
  200: @c You can specify separate installation prefixes for architecture-specific
  201: @c files and architecture-independent files.  If you give @code{configure}
  202: @c the option @option{--exec-prefix=@var{path}}, the package will use
  203: @c @var{path} as the prefix for installing programs and libraries.
  204: @c Documentation and other data files will still use the regular prefix.
  205: @c 
  206: アーキテクチャ特有のファイルと,アーキテクチャ非依存のファイルを,別々の
  207: インストール先の接頭辞に分けて指定することが可能です.@code{configure} 
  208: に@option{--exec-prefix=@var{path}}オプションを与えた場合,パッケージは,
  209: プログラムとライブラリをインストールする接頭辞として,@var{path}を使用し
  210: ます.ドキュメントと他のデータファイルは通常の接頭辞を使用します.
  211: 
  212: @c In addition, if you use an unusual directory layout you can give options
  213: @c like @option{--bindir=@var{path}} to specify different values for
  214: @c particular kinds of files.  Run @samp{configure --help} for a list of
  215: @c the directories you can set and what kinds of files go in them.
  216: @c 
  217: さらに,普通でないディレクトリの配置を使用する場合,特定の種類のファイル
  218: に対し異なる値で指定するように,@option{--bindir=@var{path}}のようなオプ
  219: ションを与えることが可能です.設定可能なできるディレクトリリストと,そこ
  220: に置きたいファイルの種類のリストを見るために,@samp{configure --help}を
  221: 実行してください.
  222: 
  223: @c If the package supports it, you can cause programs to be installed with
  224: @c an extra prefix or suffix on their names by giving @code{configure} the
  225: @c option @option{--program-prefix=@var{PREFIX}} or
  226: @c @option{--program-suffix=@var{SUFFIX}}.
  227: @c 
  228: パッケージがサポートしている場合,@code{configure}にオプションの
  229: @option{--program-prefix=@var{PREFIX}}や
  230: @option{--program-suffix=@var{SUFFIX}}を与えることで,プログラムの名前に
  231: 余分な接頭辞や接尾子を付けてインストールすることが可能です.
  232: 
  233: 
  234: @node Optional Features
  235: @section オプションの特徴
  236: 
  237: @c Some packages pay attention to @option{--enable-@var{feature}} options
  238: @c to @code{configure}, where @var{feature} indicates an optional part of
  239: @c the package.  They may also pay attention to
  240: @c @option{--with-@var{package}} options, where @var{package} is something
  241: @c like @samp{gnu-as} or @samp{x} (for the X Window System).  The
  242: @c @file{README} should mention any @option{--enable-} and @option{--with-}
  243: @c options that the package recognizes.
  244: @c 
  245: @code{configure}への@option{--enable-@var{feature}}オプションに注意を払
  246: うパッケージもあり,@var{feature}は,パッケージのオプションの部分を示し
  247: ています.@option{--with-@var{package}}オプションに注意を払うパッケージ
  248: もあり,@var{package}は,@samp{gnu-as}や@samp{x}(X Window System用)の様
  249: なものです.@file{README}で,パッケージが理解する@option{--enable-}と
  250: @option{--with-}オプションについて述べているはずです.
  251: 
  252: @c For packages that use the X Window System, @code{configure} can usually
  253: @c find the X include and library files automatically, but if it doesn't,
  254: @c you can use the @code{configure} options @option{--x-includes=@var{dir}}
  255: @c and @option{--x-libraries=@var{dir}} to specify their locations.
  256: @c 
  257: X Window Systemを使うパッケージに対して,@code{configure}は通常,Xのイン
  258: クルードファイルやリンクファイルを自動的に見つけますが,できなかった場合
  259: は,@code{configure}オプションの,@option{--x-includes=@var{dir}}と
  260: @option{--x-libraries=@var{dir}}を,その場所を指定するために使用すること
  261: が可能です.
  262: 
  263: 
  264: @node System Type
  265: @section システムタイプの指定
  266: 
  267: @c There may be some features @code{configure} cannot figure out
  268: @c automatically, but needs to determine by the type of host the package
  269: @c will run on.  Usually @code{configure} can figure that out, but if it
  270: @c prints a message saying it cannot guess the host type, give it the
  271: @c @option{--build=@var{type}} option.  @var{type} can either be a short
  272: @c name for the system type, such as @samp{sun4}, or a canonical name which
  273: @c has the form:
  274: @c 
  275: @code{configure}が自動的に判定できない特徴もあるかもしれませんが,パッケー
  276: ジを実行するホストのタイプで定義する必要があるものもあります.通常,
  277: @code{configure}はそれを判定可能ですが,ホストタイプが分からない旨のメッ
  278: セージを出力した場合,@option{--host=@var{type}}オプションで与えてくださ
  279: い.@var{type}は,@samp{sun4}の様なシステムタイプの短い名前や,3つのフィー
  280: ルドを持つ標準的な名前が可能です.
  281: 
  282: @example
  283: @var{cpu}-@var{company}-@var{system}
  284: @end example
  285: 
  286: @noindent
  287: @c where @var{system} can have one of these forms:
  288: @c 
  289: @var{system}は,以下の形式の一つが可能です.
  290: 
  291: @example
  292: @var{os}
  293: @var{kernel}-@var{os}
  294: @end example
  295: 
  296: @c See the file @file{config.sub} for the possible values of each field.
  297: @c If @file{config.sub} isn't included in this package, then this package
  298: @c doesn't need to know the host type.
  299: @c 
  300: それぞれのフィールドでの可能な値は,ファイル@file{config.sub}を参照して
  301: ください.@file{config.sub}がパッケージに含まれていない場合,パッケージ
  302: にホストタイプを知らせる必要はありません.
  303: 
  304: @c If you are @emph{building} compiler tools for cross-compiling, you should
  305: @c use the @option{--target=@var{type}} option to select the type of system
  306: @c they will produce code for.
  307: @c 
  308: クロスコンパイルに対するコンパイラツールを@emph{ビルドしている}場合,コー
  309: ドを生成しているシステムの形式を選択するために,
  310: @option{--target=@var{type}}オプションを使用すべきです.
  311: 
  312: @c If you want to @emph{use} a cross compiler, that generates code for a
  313: @c platform different from the build platform, you should specify the host
  314: @c platform (i.e., that on which the generated programs will eventually be
  315: @c run) with @option{--host=@var{type}}.  In this case, you should also
  316: @c specify the build platform with @option{--build=@var{type}}, because, in
  317: @c this case, it may not be possible to guess the build platform (it
  318: @c sometimes involves compiling and running simple test programs, and this
  319: @c can't be done if the compiler is a cross compiler).
  320: @c 
  321: ビルドしているプラットフォームと異なるプラットフォームに対するコードを生
  322: 成するクロスコンパイラを使用したい場合,ホストプラットフォーム(すなわち,
  323: 生成されたプログラムを最終的に実行するプラットフォーム)を
  324: @option{--host=@var{type}}を用いて指定すべきです.この場合は,ビルドして
  325: いるプラットフォームも,@option{--build=@var{type}}を用いて指定すべきで,
  326: その理由は,この場合にはビルドしているプラットフォームを吹奏することが不
  327: 可能かもしれないためです(コンパイルと単純なテストプログラムを呼び出すこ
  328: ともあり,コンパイラがクロスコンパイラの場合,これは実行不可能です).
  329: 
  330: 
  331: @node Sharing Defaults
  332: @section デフォルトの共有
  333: 
  334: @c If you want to set default values for @code{configure} scripts to share,
  335: @c you can create a site shell script called @file{config.site} that gives
  336: @c default values for variables like @code{CC}, @code{cache_file}, and
  337: @c @code{prefix}.  @code{configure} looks for
  338: @c @file{@var{prefix}/share/config.site} if it exists, then
  339: @c @file{@var{prefix}/etc/config.site} if it exists.  Or, you can set the
  340: @c @code{CONFIG_SITE} environment variable to the location of the site
  341: @c script.  A warning: not all @code{configure} scripts look for a site
  342: @c script.
  343: @c 
  344: @code{configure}スクリプトを共有するため,デフォルト値を設定したい場合, 
  345: @code{CC},@code{cache_file},そして@code{prefix}の様な変数のデフォルト
  346: 値を与える,@file{config.site}と呼ばれるサイトシェルスクリプトを作成する
  347: ことが可能です.@code{configure}は,存在する場合は
  348: @file{@var{prefix}/share/config.site} を探し,そして,存在する場合は
  349: @file{@var{prefix}/etc/config.site}を探します.また,@code{CONFIG_SITE}
  350: 環境変数を,サイトスクリプトのある場所に設定することも可能です.注意:全
  351: ての@code{configure}スクリプトが,サイトスクリプトを探すわけではありませ
  352: ん.
  353: 
  354: 
  355: @node Environment Variables
  356: @section 環境変数
  357: 
  358: @c Variables not defined in a site shell script can be set in the
  359: @c environment passed to configure.  However, some packages may run
  360: @c configure again during the build, and the customized values of these
  361: @c variables may be lost.  In order to avoid this problem, you should set
  362: @c them in the @code{configure} command line, using @samp{VAR=value}.  For
  363: @c example:
  364: @c 
  365: サイトシェルスクリプトで定義されていない変数は,@code{configure}に渡す環
  366: 境変数で設定可能です.しかし,パッケージによっては,ビルド時に再び
  367: @code{configure}を実行し,カスタマイズされているこれらの変数の値を失うか
  368: もしれません.この問題を避けるため,@samp{VAR=value}を用いて,それらを
  369: @code{configure}コマンドラインで設定すべきです.例えば,以下のようにしま
  370: す.
  371: 
  372: @example
  373: ./configure CC=/usr/local2/bin/gcc
  374: @end example
  375: 
  376: @noindent
  377: @c will cause the specified gcc to be used as the C compiler (unless it is
  378: @c overridden in the site shell script).
  379: @c 
  380: これで,(サイトシェルスクリプトで優先されない限り)Cコンパイラとして
  381: @code{gcc}を指定します.
  382: 
  383: 
  384: @node configure Invocation
  385: @section @code{configure}の呼び出し
  386: 
  387: @c @code{configure} recognizes the following options to control how it
  388: @c operates.
  389: @c 
  390: @code{configure}は,処理方法を制御する以下のオプションを理解します.
  391: 
  392: @table @option
  393: @item --help
  394: @itemx -h
  395: @c Print a summary of the options to @code{configure}, and exit.
  396: @c 
  397: @code{configure}オプションの概要を出力して終了します.
  398: 
  399: @item --version
  400: @itemx -V
  401: @c Print the version of Autoconf used to generate the @code{configure}
  402: @c script, and exit.
  403: @c 
  404: @code{configure}スクリプトの生成に使用したAutoconfのバージョンを出力し終
  405: 了します.
  406: 
  407: @item --cache-file=@var{file}
  408: @cindex Cache, enabling
  409: @c Enable the cache: use and save the results of the tests in @var{file},
  410: @c traditionally @file{config.cache}.  @var{file} defaults to
  411: @c @file{/dev/null} to disable caching.
  412: @c 
  413: キャッシュを可能にします.調査の結果を,通常は@file{config.cache}という
  414: @var{file}に保存し,使用します.@var{file}はデフォルトで@file{/dev/null}
  415: でキャッシュは利用不可能です.
  416: 
  417: @item --config-cache
  418: @itemx -C
  419: @c Alias for @option{--cache-file=config.cache}.
  420: @c 
  421: @option{--cache-file=config.cache}の別名です.
  422: 
  423: @item --quiet
  424: @itemx --silent
  425: @itemx -q
  426: @c Do not print messages saying which checks are being made.  To suppress
  427: @c all normal output, redirect it to @file{/dev/null} (any error messages
  428: @c will still be shown).
  429: @c 
  430: 調査したり作成したりしているメッセージを出力しません.通常の出力も全て省
  431: 略するためには,(エラーメッセージは表示されるので)@file{/dev/null}にファ
  432: イルをリダイレクトしてください.
  433: 
  434: @item --srcdir=@var{dir}
  435: @c Look for the package's source code in directory @var{dir}.  Usually
  436: @c @code{configure} can determine that directory automatically.
  437: @c 
  438: ディレクトリ@var{dir}で,パッケージのソースコードを探します.通常, 
  439: @code{configure}は,ディレクトリを自動的に決定可能です.
  440: @end table
  441: 
  442: @noindent
  443: @c @code{configure} also accepts some other, not widely useful, options.
  444: @c Run @samp{configure --help} for more details.
  445: @c 
  446: @code{configure}は,広範囲では役に立たないかもしれませんが,他のオプショ
  447: ンも受け入れます.詳細を知るために@samp{configure --help}を実行してくだ
  448: さい.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>