Contents|Index|Previous|Next

Parts of an Xref

Cross references have two major parts: the first part is called the label; it is the name that you can use to refer to the cross reference, and the second is the target; it is the full name of the node to which the cross reference points.

The target is separated from the label by a colon ‘:’; first, the label appears, and then the target.

For instance, in the following example’s input shows a cross reference menu, the single colon separates the label from the target.

    * Foo Label: Foo Target. More information about Foo.

The ‘.’ is not part of the target; it serves only to let info know where the target name ends.

A shorthand way of specifying references allows two adjacent colons to stand for a target name, as in the following example.

    * Foo Commands:: Commands pertaining to Foo.

In the previous example, the name of the target is the same as the name of the label, in this case Foo Commands.

You will normally see two types of cross references while viewing nodes: menu references, and note references. Menu references appear within a node’s menu; they begin with a ‘*’ at the beginning of a line, and continue with a label, a target, and a comment which describes what the contents of the node pointed to contains.

Note:

References appear within the body of the node text; they begin with *Note, and continue with a label and a target.

Like ‘Next’, ‘Prev’ and ‘Up’ pointers, cross references can point to any valid node. They are used to refer you to a place where more detailed information can be found on a particular subject.

See “Cross References” in Texinfo, The GNU Documentation Format, for more information on creating your own Texinfo cross references.