Previous: , Up: Info Format Text Constructs   [Contents][Index]

F.2.4 Info Format: Cross Reference

A general cross reference in Info format has one of the following two forms:

    <cross-reference> =
  * (N|n)ote <id>::
| * (N|n)ote <label>:<id>(.|,)

    <id> = (<lparen><infofile><rparen>)?(<nodename>)?
    <label> = <del>?<label text><del>?

No space should occur between the ‘*’ character and the following ‘N’ or ‘n’. ‘*Note’ should be used at the start of a sentence, otherwise ‘*note’ should be used. (Some Info readers, such as the one in Emacs, can display ‘*Note’ and ‘*note’ as ‘See’ and ‘see’ respectively.) In both cases, <label text> is descriptive text.

In both forms the <id> refers to a node or anchor, in the same way as a reference in the node information line does (see Info Format Regular Nodes). The optional parenthesized ‘<infofile>’ is the filename of the manual being referenced, and the <nodename> is the node or anchor within that manual,

The second form has a descriptive label. A cross-reference in this form should be terminated with a comma or period, to make it feasible to find the end of the <id>.

The format does not prescribe how to find other manuals to resolve such references.

Here are some examples:

*note GNU Free Documentation License::
*note Tag table: Info Format Tag Table, for details.
*Note Overview: (make)Top.

The first shows a reference to a node in the current manual using the short form.

The second also refers to a node in the current manual, namely ‘Info Format Tag Table’; the ‘Tag table’ before the ‘:’ is only a label on this particular reference, and the ‘for details.’ is text belonging to the sentence, not part of the reference.

The third example refers to the node ‘Top’ in another manual, namely ‘make’, with ‘Overview’ being the label for this cross reference.

See Cross References.

Previous: , Up: Info Format Text Constructs   [Contents][Index]