Next: Man pages, Up: Documentation
カレントディレクトリにTexinfoソースを含んでいる場合,‘TEXINFOS’プ
ライマリでそれを宣言する必要があります.通常,Texinfoファイルはinfoに
変換されるので,info_TEXINFOS
変数が最も一般的に使用されます.す
べてのTexinfoソースファイルは,.texi,.txi,または
.texinfoの拡張子で終える必要があります.新しいマニュアルには,
.texiを推奨します.
Automakeは,.info,.dvi,.ps,.pdf,そして
.htmlファイルを,Texinfoソースからビルドするルールを生成します.
.infoファイルはmake all
でビルドされ,make install
でインストールされます(no-installinfo
を使用していない場合に限り
ます.以下を参照してください).それ以外のファイルは,make dvi
,
make ps
,make pdf
,そしてmake html
でビルドを要求
することが可能です.
.texiファイルがversion.texiを@include
している場
合,そのファイルが自動的に生成されます.ファイルversion.texiは,
四つのTexinfoのフラグを定義し,それは@value{EDITION}
,
@value{VERSION}
,@value{UPDATED}
,そして
@value{UPDATED-MONTH}
を使用することで参照可能です.
EDITION
VERSION
UPDATED
UPDATED-MONTH
version.texiサポートには,mdate-sh
プログラムが必要です.
このプログラムはAutomakeと一緒に供給されていて,automake
が
--add-missing
オプションで呼び出されるとき,自動的に含められます.
複数のTexinfoファイルがあり,version.texiの機能を使用したい場合, それぞれのTexinfoファイルに対し個別のバージョンファイルを持たせる必要 があります.Automakeは‘vers*.texi’に一致したTexinfoファイル内に含 まれるものを,単純に自動的に生成されたバージョンファイルとして扱います.
infoファイルが,実際には一つ以上の.texiファイルに依存する場合も
あります.例えば,GNU Helloでは,hello.texiはgpl.texiファ
イルを含んでいます.texi_TEXINFOS
変数を使用することでこれ
らの依存性をAutomakeに伝えることが可能です.GNU Helloで用いた方法は,
以下のようになっています.
info_TEXINFOS = hello.texi hello_TEXINFOS = gpl.texi
デフォルトでAutomakeは,ファイルtexinfo.texがTexinfoソースと同
じディレクトリに存在することを要求します(これは,TEXINFO_TEX
変
数で変更することが可能です.以下を参照して下さい).しかし,
configure.acでAC_CONFIG_AUX_DIR
を使用した場合
(see Finding `configure' Input),texinfo.texはそこで探されます.Automakeは,
‘--add-missing’が与えられている場合,texinfo.texを供給しま
す.
オプション‘no-texinfo.tex’を,texinfo.texを要求することを
止めるために使用することが可能です.しかし,変数TEXINFO_TEX
の使
用は望ましく,それはdvi
,ps
,そしてpdf
ターゲット
を動作させることが可能だからです.
Automakeはinstall-info
ルールを生成します.これを明示的に使用す
る人もいます.デフォルトで,infoページは‘make install’でインストー
ルされます.これはno-installinfo
オプションによって止めることが
可能です.
以下の変数はTexinfoのビルドルールで使用されます.
MAKEINFO
makeinfo
プログラムがシステムで見
つかった場合,デフォルトで使用されます.それ以外ではmissing
が代
わりに使用されます.
MAKEINFOHTML
$(MAKEINFO) --html
と定義します.
MAKEINFOFLAGS
$(MAKEINFO)
と$(MAKEINFOHTML)
のそれぞれの呼び出しに渡すユー
ザフラグです.このユーザ変数(see User Variables)はMakefile
で定義していることを期待していません.それはユーザが必要に応じて追加フ
ラグを渡すことで使用することが可能です.
AM_MAKEINFOFLAGS
AM_MAKEINFOHTMLFLAGS
makeinfo
の呼び出しで管理者が渡すフラグです.これらは
Makefile.amで優先することが可能な管理者用の変数です.
$(AM_MAKEINFOFLAGS)
は.infoファイルをビルドするとき
makeinfo
に渡されます.そして,$(AM_MAKEINFOHTMLFLAGS)
は
.htmlファイルをビルドするときmakeinfo
に使用されます.
例えば以下の設定で,一つのマニュアルに付き,ノードで分離されていない単 一の.htmlファイルを入手するために使用することが可能です.
AM_MAKEINFOHTMLFLAGS = --no-headers --no-split
デフォルトで,$(AM_MAKEINFOHTMLFLAGS)
は
$(AM_MAKEINFOFLAGS)
に設定されます.これは,
$(AM_MAKEINFOHTMLFLAGS)
を定義せずに$(AM_MAKEINFOFLAGS)
を
定義すると.infoと.htmlの両方のファイルが暗黙にビルドされ
ることを意味します.
TEXI2DVI
texi2dvi
で,Texinfoパッケージとともに配布されて
います.
TEXI2PDF
$(TEXI2DVI) --pdf --batch
です.
DVIPS
dvips
です.
TEXINFO_TEX
TEXINFO_TEX
を使用することが可能です.この変数の値は,現在の
Makefile.amからtexinfo.texへの相対的なパスにすべきです.
TEXINFO_TEX = ../doc/texinfo.tex