@c This file is included by autoconf.texi and is used to produce
@c the INSTALL file.

@node Basic Installation
@section 基本インストール

@c These are generic installation instructions.
@c 
これは一般的なインストール説明書です．

@c The @code{configure} shell script attempts to guess correct values for
@c various system-dependent variables used during compilation.  It uses
@c those values to create a @file{Makefile} in each directory of the
@c package.  It may also create one or more @file{.h} files containing
@c system-dependent definitions.  Finally, it creates a shell script
@c @file{config.status} that you can run in the future to recreate the
@c current configuration, and a file @file{config.log} containing compiler
@c output (useful mainly for debugging @code{configure}).
@c 
@code{configure}シェルスクリプトは，コンパイル時に使用する様々なシステム
に依存する変数の，正しい値を推測します．パッケージのそれぞれのディレクト
リの@file{Makefile}を作成するために，これらの値は使用されます．システム
依存の定義を含む，一つ以上の@file{.h}ファイルも作成します．終りに，現在
のコンフィグレーションを将来再生成するために実行可能なシェルスクリプト 
@file{config.status}と，コンパイラの出力を含んでいるファイル
@file{config.log} (主に@code{configure}のデバッグで役立ちます)を作成しま
す．

@c It can also use an optional file (typically called @file{config.cache}
@c and enabled with @option{--cache-file=config.cache} or simply
@c @option{-C}) that saves the results of its tests to speed up
@c reconfiguring.  (Caching is disabled by default to prevent problems with
@c accidental use of stale cache files.)
@c 
再コンフィグレーションのスピードをあげるため，テストの結果を保存する追加
ファイルも使用可能です(通常，@file{config.cache}と呼ばれ，
@option{--cache-file=config.cache}や短い@option{-C}で利用可能になります)．
(古いキャッシュファイルを偶然使用することによる問題を避けるため，キャッ
シュはデフォルトで利用不可能になっています．) 

@c If you need to do unusual things to compile the package, please try to
@c figure out how @code{configure} could check whether to do them, and mail
@c diffs or instructions to the address given in the @file{README} so they
@c can be considered for the next release.  If you are using the cache, and
@c at some point @file{config.cache} contains results you don't want to
@c keep, you may remove or edit it.
@c 
パッケージをコンパイルするため，通常行なうこと以外のことをする必要がある
場合，@code{configure}がどのように調査したのかを理解し，次のリリースに反
映できるように，@file{README}にあるアドレスに，差分や説明をメールしてく
ださい．キャッシュを使用していて，@file{config.cache}が含む結果に保持し
たくないものがある場合，削除しても編集してもかまいません．

@c The file @file{configure.ac} (or @file{configure.in}) is used to create
@c @file{configure} by a program called @code{autoconf}.  You only need
@c @file{configure.ac} if you want to change it or regenerate
@c @file{configure} using a newer version of @code{autoconf}.
@c 
ファイル@file{configure.ac} (や@file{configure.in})は，@code{autoconf}と
呼ばれるプログラムで，@file{configure}を作成するために使用されます．それ
を変更したり，新しいバージョンの@code{autoconf}で@file{configure}を再生
成したい場合だけ，@file{configure.in}が必要です．

@noindent
@c The simplest way to compile this package is:
@c 
このパッケージをコンパイルする最も単純な方法は，以下の通りです．

@enumerate
@item
@c @code{cd} to the directory containing the package's source code and type
@c @samp{./configure} to configure the package for your system.  If you're
@c using @code{csh} on an old version of System V, you might need to type
@c @samp{sh ./configure} instead to prevent @code{csh} from trying to
@c execute @code{configure} itself.
@c 
パッケージのソースコード含んでいるディレクトリに@code{cd}して，システム
に対してパッケージのコンフィグレーションを行なうために@samp{./configure} 
と入力してください．System Vの古いバージョンの@code{csh}を使用している場
合，@code{csh}自身から@code{configure}を実行しないようにするため，
@samp{sh ./configure}と入力する必要があるかもしれません．

@c Running @code{configure} takes awhile.  While running, it prints some
@c messages telling which features it is checking for.
@c 
@code{configure}の実行にはしばらくかかります．実行中，調査している特徴を
伝えるメッセージを出力します．

@item
@c Type @samp{make} to compile the package.
@c 
パッケージをコンパイルするために@samp{make}と入力してください．

@item
@c Optionally, type @samp{make check} to run any self-tests that come with
@c the package.
@c 
オプションとして，パッケージ付属の自己テストを実行するため，@samp{make
check}と入力してください．

@item
@c Type @samp{make install} to install the programs and any data files and
@c documentation.
@c 
プログラムと，あらゆるデータファイルと，ドキュメントをインストールするた
め，@samp{make install}と入力してください．

@item
@c You can remove the program binaries and object files from the source code
@c directory by typing @samp{make clean}.  To also remove the files that
@c @code{configure} created (so you can compile the package for a different
@c kind of computer), type @samp{make distclean}.  There is also a
@c @samp{make maintainer-clean} target, but that is intended mainly for the
@c package's developers.  If you use it, you may have to get all sorts of
@c other programs in order to regenerate files that came with the distribution.
@c 
@samp{make clean}と入力することで，ソースコードディレクトリから，プログ
ラムのバイナリやオブジェクトファイルを削除することが可能です．(異なる種
類のコンピュータに対するパッケージをコンパイルすることが可能になるように)
@code{configure}が作成したファイルも削除するためには，@samp{make
distclean}と入力してください．@samp{make maintainer-clean}ターゲットもあ
りますが，主にパッケージ開発者用です．それを使用する場合，配布物の付属ファ
イルを再生成するため，いろいろな種類の他のプログラムを入手する必要がある
かもしれません．
@end enumerate

@node Compilers and Options
@section コンパイラとオプション

@c Some systems require unusual options for compilation or linking that the
@c @code{configure} script does not know about.  Run @samp{./configure
@c --help} for details on some of the pertinent environment variables.
@c 
@code{configure}スクリプトが知らない，普通使わない，コンパイルやリンクの
オプションが必要なシステムもあります．妥当な環境変数の詳細を得るために，
@samp{./configure --help}を実行してください．

@c You can give @code{configure} initial values for variables by setting
@c them in the environment.  You can do that on the command line like this:
@c 
環境変数に初期値をセットすることで，@code{configure}に与えることが可能で
す．以下のようにコマンドラインで行うことが可能です．

@example
./configure CC=c89 CFLAGS=-O2 LIBS=-lposix
@end example

@c @xref{Environment Variables}, for more details.
@c 
詳細は，@xref{Environment Variables}.


@node Multiple Architectures
@section 複数のアーキテクチャに対するコンパイル

@c You can compile the package for more than one kind of computer at the
@c same time, by placing the object files for each architecture in their
@c own directory.  To do this, you must use a version of @code{make} that
@c supports the @code{VPATH} variable, such as GNU @code{make}.  @code{cd}
@c to the directory where you want the object files and executables to go
@c and run the @code{configure} script.  @code{configure} automatically
@c checks for the source code in the directory that @code{configure} is in
@c and in @file{..}.
@c 
それぞれのアーキテクチャに対するオブジェクトファイルをそれ自身のディレク
トリに置くことで，同時に1種類以上のコンピュータに対するパッケージをコン
パイルすることが可能です．こうするために，GNU @code{make}の様に， 
@code{VPATH}変数をサポートする@code{make}のバージョンを使用する必要があ
ります．オブジェクトファイルと実行可能なファイルを配置したいディレクトリ
に @code{cd}して，@code{configure}スクリプトを実行してください．
@code{configure} は，@code{configure}があるディレクトリと@file{..}で，ソー
スコードを自動的に調査します．

@c If you have to use a @code{make} that does not support the @code{VPATH}
@c variable, you have to compile the package for one architecture at a time
@c in the source code directory.  After you have installed the package for
@c one architecture, use @samp{make distclean} before reconfiguring for
@c another architecture.
@c 
@code{VPATH}をサポートしない@code{make}を使用する必要がある場合，ソース
コードディレクトリで，一度に一つのアーキテクチャに対してパッケージをコン
パイルする必要があります．一つのアーキテクチャのパッケージをインストール
した後，他のアーキテクチャに対して再コンフィグレーションするため，
@samp{make distclean}を使用してください．


@node Installation Names
@section インストール名

@c By default, @samp{make install} will install the package's files in
@c @file{/usr/local/bin}, @file{/usr/local/man}, etc.  You can specify an
@c installation prefix other than @file{/usr/local} by giving
@c @code{configure} the option @option{--prefix=@var{path}}.
@c 
デフォルトで，@samp{make install}はパッケージファイルを，
@file{/usr/local/bin}や@file{/usr/local/man}等にインストールします．イン
ストール先の接頭辞は，@option{--prefix=@var{path}}オプションを 
@code{configure}に与えることで指定することが可能です．

@c You can specify separate installation prefixes for architecture-specific
@c files and architecture-independent files.  If you give @code{configure}
@c the option @option{--exec-prefix=@var{path}}, the package will use
@c @var{path} as the prefix for installing programs and libraries.
@c Documentation and other data files will still use the regular prefix.
@c 
アーキテクチャ特有のファイルと，アーキテクチャ非依存のファイルを，別々の
インストール先の接頭辞に分けて指定することが可能です．@code{configure} 
に@option{--exec-prefix=@var{path}}オプションを与えた場合，パッケージは，
プログラムとライブラリをインストールする接頭辞として，@var{path}を使用し
ます．ドキュメントと他のデータファイルは通常の接頭辞を使用します．

@c In addition, if you use an unusual directory layout you can give options
@c like @option{--bindir=@var{path}} to specify different values for
@c particular kinds of files.  Run @samp{configure --help} for a list of
@c the directories you can set and what kinds of files go in them.
@c 
さらに，普通でないディレクトリの配置を使用する場合，特定の種類のファイル
に対し異なる値で指定するように，@option{--bindir=@var{path}}のようなオプ
ションを与えることが可能です．設定可能なできるディレクトリリストと，そこ
に置きたいファイルの種類のリストを見るために，@samp{configure --help}を
実行してください．

@c If the package supports it, you can cause programs to be installed with
@c an extra prefix or suffix on their names by giving @code{configure} the
@c option @option{--program-prefix=@var{PREFIX}} or
@c @option{--program-suffix=@var{SUFFIX}}.
@c 
パッケージがサポートしている場合，@code{configure}にオプションの
@option{--program-prefix=@var{PREFIX}}や
@option{--program-suffix=@var{SUFFIX}}を与えることで，プログラムの名前に
余分な接頭辞や接尾子を付けてインストールすることが可能です．


@node Optional Features
@section オプションの特徴

@c Some packages pay attention to @option{--enable-@var{feature}} options
@c to @code{configure}, where @var{feature} indicates an optional part of
@c the package.  They may also pay attention to
@c @option{--with-@var{package}} options, where @var{package} is something
@c like @samp{gnu-as} or @samp{x} (for the X Window System).  The
@c @file{README} should mention any @option{--enable-} and @option{--with-}
@c options that the package recognizes.
@c 
@code{configure}への@option{--enable-@var{feature}}オプションに注意を払
うパッケージもあり，@var{feature}は，パッケージのオプションの部分を示し
ています．@option{--with-@var{package}}オプションに注意を払うパッケージ
もあり，@var{package}は，@samp{gnu-as}や@samp{x}(X Window System用)の様
なものです．@file{README}で，パッケージが理解する@option{--enable-}と
@option{--with-}オプションについて述べているはずです．

@c For packages that use the X Window System, @code{configure} can usually
@c find the X include and library files automatically, but if it doesn't,
@c you can use the @code{configure} options @option{--x-includes=@var{dir}}
@c and @option{--x-libraries=@var{dir}} to specify their locations.
@c 
X Window Systemを使うパッケージに対して，@code{configure}は通常，Xのイン
クルードファイルやリンクファイルを自動的に見つけますが，できなかった場合
は，@code{configure}オプションの，@option{--x-includes=@var{dir}}と
@option{--x-libraries=@var{dir}}を，その場所を指定するために使用すること
が可能です．


@node System Type
@section システムタイプの指定

@c There may be some features @code{configure} cannot figure out
@c automatically, but needs to determine by the type of host the package
@c will run on.  Usually @code{configure} can figure that out, but if it
@c prints a message saying it cannot guess the host type, give it the
@c @option{--build=@var{type}} option.  @var{type} can either be a short
@c name for the system type, such as @samp{sun4}, or a canonical name which
@c has the form:
@c 
@code{configure}が自動的に判定できない特徴もあるかもしれませんが，パッケー
ジを実行するホストのタイプで定義する必要があるものもあります．通常，
@code{configure}はそれを判定可能ですが，ホストタイプが分からない旨のメッ
セージを出力した場合，@option{--host=@var{type}}オプションで与えてくださ
い．@var{type}は，@samp{sun4}の様なシステムタイプの短い名前や，3つのフィー
ルドを持つ標準的な名前が可能です．

@example
@var{cpu}-@var{company}-@var{system}
@end example

@noindent
@c where @var{system} can have one of these forms:
@c 
@var{system}は，以下の形式の一つが可能です．

@example
@var{os}
@var{kernel}-@var{os}
@end example

@c See the file @file{config.sub} for the possible values of each field.
@c If @file{config.sub} isn't included in this package, then this package
@c doesn't need to know the host type.
@c 
それぞれのフィールドでの可能な値は，ファイル@file{config.sub}を参照して
ください．@file{config.sub}がパッケージに含まれていない場合，パッケージ
にホストタイプを知らせる必要はありません．

@c If you are @emph{building} compiler tools for cross-compiling, you should
@c use the @option{--target=@var{type}} option to select the type of system
@c they will produce code for.
@c 
クロスコンパイルに対するコンパイラツールを@emph{ビルドしている}場合，コー
ドを生成しているシステムの形式を選択するために，
@option{--target=@var{type}}オプションを使用すべきです．

@c If you want to @emph{use} a cross compiler, that generates code for a
@c platform different from the build platform, you should specify the host
@c platform (i.e., that on which the generated programs will eventually be
@c run) with @option{--host=@var{type}}.  In this case, you should also
@c specify the build platform with @option{--build=@var{type}}, because, in
@c this case, it may not be possible to guess the build platform (it
@c sometimes involves compiling and running simple test programs, and this
@c can't be done if the compiler is a cross compiler).
@c 
ビルドしているプラットフォームと異なるプラットフォームに対するコードを生
成するクロスコンパイラを使用したい場合，ホストプラットフォーム(すなわち，
生成されたプログラムを最終的に実行するプラットフォーム)を
@option{--host=@var{type}}を用いて指定すべきです．この場合は，ビルドして
いるプラットフォームも，@option{--build=@var{type}}を用いて指定すべきで，
その理由は，この場合にはビルドしているプラットフォームを吹奏することが不
可能かもしれないためです(コンパイルと単純なテストプログラムを呼び出すこ
ともあり，コンパイラがクロスコンパイラの場合，これは実行不可能です)．


@node Sharing Defaults
@section デフォルトの共有

@c If you want to set default values for @code{configure} scripts to share,
@c you can create a site shell script called @file{config.site} that gives
@c default values for variables like @code{CC}, @code{cache_file}, and
@c @code{prefix}.  @code{configure} looks for
@c @file{@var{prefix}/share/config.site} if it exists, then
@c @file{@var{prefix}/etc/config.site} if it exists.  Or, you can set the
@c @code{CONFIG_SITE} environment variable to the location of the site
@c script.  A warning: not all @code{configure} scripts look for a site
@c script.
@c 
@code{configure}スクリプトを共有するため，デフォルト値を設定したい場合， 
@code{CC}，@code{cache_file}，そして@code{prefix}の様な変数のデフォルト
値を与える，@file{config.site}と呼ばれるサイトシェルスクリプトを作成する
ことが可能です．@code{configure}は，存在する場合は
@file{@var{prefix}/share/config.site} を探し，そして，存在する場合は
@file{@var{prefix}/etc/config.site}を探します．また，@code{CONFIG_SITE}
環境変数を，サイトスクリプトのある場所に設定することも可能です．注意：全
ての@code{configure}スクリプトが，サイトスクリプトを探すわけではありませ
ん．


@node Environment Variables
@section 環境変数

@c Variables not defined in a site shell script can be set in the
@c environment passed to configure.  However, some packages may run
@c configure again during the build, and the customized values of these
@c variables may be lost.  In order to avoid this problem, you should set
@c them in the @code{configure} command line, using @samp{VAR=value}.  For
@c example:
@c 
サイトシェルスクリプトで定義されていない変数は，@code{configure}に渡す環
境変数で設定可能です．しかし，パッケージによっては，ビルド時に再び
@code{configure}を実行し，カスタマイズされているこれらの変数の値を失うか
もしれません．この問題を避けるため，@samp{VAR=value}を用いて，それらを
@code{configure}コマンドラインで設定すべきです．例えば，以下のようにしま
す．

@example
./configure CC=/usr/local2/bin/gcc
@end example

@noindent
@c will cause the specified gcc to be used as the C compiler (unless it is
@c overridden in the site shell script).
@c 
これで，(サイトシェルスクリプトで優先されない限り)Cコンパイラとして
@code{gcc}を指定します．


@node configure Invocation
@section @code{configure}の呼び出し

@c @code{configure} recognizes the following options to control how it
@c operates.
@c 
@code{configure}は，処理方法を制御する以下のオプションを理解します．

@table @option
@item --help
@itemx -h
@c Print a summary of the options to @code{configure}, and exit.
@c 
@code{configure}オプションの概要を出力して終了します．

@item --version
@itemx -V
@c Print the version of Autoconf used to generate the @code{configure}
@c script, and exit.
@c 
@code{configure}スクリプトの生成に使用したAutoconfのバージョンを出力し終
了します．

@item --cache-file=@var{file}
@cindex Cache, enabling
@c Enable the cache: use and save the results of the tests in @var{file},
@c traditionally @file{config.cache}.  @var{file} defaults to
@c @file{/dev/null} to disable caching.
@c 
キャッシュを可能にします．調査の結果を，通常は@file{config.cache}という
@var{file}に保存し，使用します．@var{file}はデフォルトで@file{/dev/null}
でキャッシュは利用不可能です．

@item --config-cache
@itemx -C
@c Alias for @option{--cache-file=config.cache}.
@c 
@option{--cache-file=config.cache}の別名です．

@item --quiet
@itemx --silent
@itemx -q
@c Do not print messages saying which checks are being made.  To suppress
@c all normal output, redirect it to @file{/dev/null} (any error messages
@c will still be shown).
@c 
調査したり作成したりしているメッセージを出力しません．通常の出力も全て省
略するためには，(エラーメッセージは表示されるので)@file{/dev/null}にファ
イルをリダイレクトしてください．

@item --srcdir=@var{dir}
@c Look for the package's source code in directory @var{dir}.  Usually
@c @code{configure} can determine that directory automatically.
@c 
ディレクトリ@var{dir}で，パッケージのソースコードを探します．通常， 
@code{configure}は，ディレクトリを自動的に決定可能です．
@end table

@noindent
@c @code{configure} also accepts some other, not widely useful, options.
@c Run @samp{configure --help} for more details.
@c 
@code{configure}は，広範囲では役に立たないかもしれませんが，他のオプショ
ンも受け入れます．詳細を知るために@samp{configure --help}を実行してくだ
さい．
