次: , 前: Updating Commands, 上: Updating Nodes and Menus


2.4.1 更新の必要条件

更新コマンドを使用するためには,章,セクション,サブセクション,そしてそ れに類するものを用いて,Texinfoファイルを階層的に組織化する必要がありま す.マニュアルの階層構造を構築するとき,一度に一階層以上`jump down'しな いでください.章を`Top'ノードの次にすることは可能ですが,セクションは不 可能です.セクションを章の次にすることは可能ですが,サブセクションでは不 可能です.しかし,一度に何レベルでも`jump up'することは可能です — 例え ば,サブセクションから章にすることは可能です.

それぞれの@node行は,`Top'ノードの行は例外として, @chapter@section,または@unnumberedsubsecのよ うな,構造的なコマンドの行が続きます.

それぞれの@node行や構造的なコマンド行は,以下のような組合せにす る必要があります.

     @node     Comments,  Minimum, Conventions, Overview
     @comment  node-name, next,    previous,    up
     @section Comments

または,(@comment行が無ければ)以下のようになります.

     @node Comments, Minimum, Conventions, Overview
     @section Comments

または,(明示的なノードポインタが無ければ)以下のようになります.

     @node Comments
     @section Comments

この例では,`Comments'はノードとセクションの名前です.次のノードは `Minimum'と呼ばれ,前のノードは`Conventions'と呼ばれます.`Comments'セク ションは`Overview'ノードにあり,`Up'ポインタで指定されています. (@comment行の代わりに,@ifinfo行を書いてもかまいません.)

ファイルに`Top'ノードがある場合,それは,`top'や`Top'と呼ばれ, ファイルの最初のノードにする必要があります.

メニュー更新コマンドは,章のセクションメニュー,セクションのサブセクショ ンメニュー等を作成します.これは,章のメニューが欲しい場合,`Top'ノード が必要だということを意味します.

ところで,makeinfoコマンドは,`Next',`Previous',そして`Up'ポイ ンタが無い階層的に組織化されたTexinfoファイルに対し,Infoファイルを作成 します.このため,Texinfoファイルがmakeinfoで書式化されることが確 実な場合,ノード更新コマンドは不要です(makeinfoの詳細は, see Creating an Info File).しかし,makeinfotexinfo-format-...コマンドでは,どちらもファイルにメニューを 挿入する必要があります.