Next: , Previous: , Up: Info Format General Layout   [Contents][Index]

Info Format Indirect Table

Info Format: Indirect Table

    <indirect table> =
(<filename>: <bytepos>)*

The indirect table is written to the main file in the case of split output only. It specifies, as a decimal integer, the starting byte position (zero-based) that the first node of each subfile would have if the subfiles were concatenated together in order, not including the top-level file. The first node of actual content is pointed to by the first entry.

As an example, suppose split output is generated for the GDB manual. The top-level file will contain something like this:

Indirect: 1878 295733

This tells Info viewers that the first node of the manual occurs at byte 1878 of the file (which would be after that file’s preamble.) The first node in the subfile would start at byte 295733 if were appended to, including any preamble sections in both files.

Unfortunately, Info-creating programs such as makeinfo have not always implemented these rules perfectly, due to various bugs and oversights. Therefore, robust Info viewers should fall back to searching “nearby” the given position for a node, instead of giving up immediately if the position is not exactly at a node beginning.