我正在尝试以 Texinfo 格式编写文档(我猜必须是 Emacs 的传统格式)。这是一场噩梦......无论如何,我可以直截了当地说,当我开始时,源代码给我的错误更少,但这些错误无法理解并因此修复。
所有错误都归结为“坏”的下一个/上一个/上节点。它们都发生在没有“下一个”、没有“上一个”和没有“上”节点的地方。即列表中的最后一个节点没有下一个节点,同样,第一个节点也不能有前一个,顶层也不能有“上”。节点。这些是我收到的确切消息:
./i-iterate/info/i-iterate.texi:385:节点“dot-product|join|distinct”的下一个字段未指向(可能是不正确的切片?)。
./i-iterate/info/i-iterate.texi:392: 这个节点(返回)有坏的 Prev。
./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。
我的文本文件结构如下:
- 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
. 但这不是想要的效果,因为它们两个属于不同的节点集。
此外,这就是整个菜单的样子:
@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