1

我正在尝试以 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-0menu-1

fornode 是 中的第一个节点menu-0returnnode 是 中的第一个节点menu-1dot-product|join|distinct是 中的最后一个节点menu-2initially是 中的最后一个节点menu-0

顶部节点不能有上一个/下一个/上一个节点......原因很明显。

根据要求,违规节点:

@node for, with, , Top
@node return, collect, , Top
@node dot-product|join|distinct, , permutations, for
@node initially, , finally, Top

更多信息。我实际上可以通过将return节点指定为 的下一个节点initiallyinitially作为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
4

1 回答 1

1

只需使用@node forand@node return没有额外的参数。@chapter然后,Texinfo 将根据和其他切片命令自动找出 prev/next/up 链接。

于 2012-12-11T21:14:03.047 回答