ドキュメントを Texinfo 形式で書こうとしています (Emacs の伝統的な形式に違いないと思います)。そして、それは悪夢です...とにかく、ソースが私が始めたときよりも少ないエラーを与えるポイントに到達することができましたが、エラーを理解することは不可能であり、修正することはできません.
すべてのエラーは、「悪い」次/前/上のノードに要約されます。そしてそれらはすべて、「次」、「前」、「上」ノードが存在しない場所で発生します。つまり、リストの最後のノードには次のノードがありません。同様に、最初のノードは前のノードを持つことができず、トップレベルには「上」を持つことはできません。ノード。これらは私が得ている正確なメッセージです:
./i-iterate/info/i-iterate.texi:385: ノード `dot-product|join|distinct' の次のフィールドが指されていません (おそらく間違ったセクション化?)。
./i-iterate/info/i-iterate.texi:392: このノード (リターン) には、前の
./i-iterate/info/i-iterate.texi:199: 「最初に」ノードの次のフィールドが指されていません (おそらくセクションが間違っているのでしょうか?)。
./i-iterate/info/i-iterate.texi:120: このノード (for) には不良な Prev があります。
./i-iterate/info/i-iterate.texi:29: ノード `Top' の次のフィールドが指されていません (おそらく間違ったセクション化?)。
./i-iterate/info/i-iterate.texi:120: このノード (for) には不良な Prev があります。
私のtextiファイル構造は次のとおりです。
- Top
|- menu-0
| |- menu-2
|- menu-1
<list of nodes>
つまり、 で言及されているノードは にmenu-2
トップ ノードがありmenu-0
、 は およびTop
のノードのトップ ノードです。menu-0
menu-1
for
node は の最初のノードmenu-0
、return
node は の最初のノードmenu-1
、dot-product|join|distinct
は の最後のノードmenu-2
、initially
は の最後のノードですmenu-0
。
最上位ノードには、前/次/上ノードを含めることはできません...明らかな理由があります。
要求に応じて、問題のあるノード:
@node for, with, , Top
@node return, collect, , Top
@node dot-product|join|distinct, , permutations, for
@node initially, , finally, Top
いくつかの詳細情報。return
ノードを の次のノードinitially
およびinitially
の前のノードとして指定することで、実際に「修正」することができましたreturn
。しかし、これら 2 つは異なるノード セットに属しているため、これは望ましい効果ではありません。
また、メニュー全体はこんな感じです。
@menu
* for:: A multi-purpose driver for doing variety of things.
* with:: A driver for variable declaration.
* generate:: A general purpose generator driver.
* repeat:: A simple driver for performing iteration N number of itmes.
* finally:: A driver that runs when the iteration finishes normally.
* initially:: A driver that runs before any code in the iteration.
@end menu
@strong{Keywords}
@menu
* return:: Returns the control flow to the form outside the loop.
* collect:: Generates a list with the cells being the experssion given.
* hash:: Generates a hash-table with the provided keys and values.
* skip:: Skips the execution of the rest of the loop body.
* previous:: Gives the value of the variable from the previous iteration.
* next:: Gives the value of the variable from the next iteration.
* output:: Prints the variable to the dedicated stream.
* insert:: Generates a vector and inserts elements into it.
* minimize:: Finds the minimum value of the variable.
* maximize:: Finds the maximum value of the variable.
* count:: Counts the number ot times this expression was executed.
* sum:: Sums the values of this variable.
* multiply:: Multiplies the values of this variable.
* reduce:: General purpose accumulation handler.
@end menu
@node for, with, , Top
@chapter Multi-purpose driver
... description of what for node is ...
@strong{For continuations}
@menu
* in|on:: Iterates over lists.
* upfrom|from|downfrom:: Iterates numberically.
* across|reverse|binary:: Iterates over arrays.
* depth-first|breadth-first:: Iterates over trees.
* keys|values|pairs:: Iterates over hash-tables.
* random:: Produces unique random each iteration.
* chars|words|lines:: Iterates over entities in buffer.
* permutations:: Generates permutation of an array.
* dot-product|join|distinct:: Iterates over sets.
@end menu