info-stnd: Parts of an Xref

1 
1 8.1 Parts of an Xref
1 ====================
1 
1 Cross-references have two major parts: the first part is called the
1 "label"; it is the name that you can use to refer to the cross
1 reference, and the second is the "target"; it is the full name of the
1 node that the cross-reference points to.
1 
1    The target is separated from the label by a colon ':'; first the
1 label appears, and then the target.  For example, in the sample menu
1 cross-reference below, the single colon separates the label from the
1 target.
1 
1      * Foo Label: Foo Target.        More information about Foo.
1 
1    Note the '.' which ends the name of the target.  The '.' is not part
1 of the target; it serves only to let Info know where the target name
1 ends.
1 
1    A shorthand way of specifying references allows two adjacent colons
1 to stand for a target name which is the same as the label name:
1 
1      * Foo Commands::                Commands pertaining to Foo.
1 
1    In the above example, the name of the target is the same as the name
1 of the label, in this case 'Foo Commands'.
1 
1    You will normally see two types of cross-reference while viewing
1 nodes: "menu" references, and "note" references.  Menu references appear
1 within a node's menu; they begin with a '*' at the beginning of a line,
1 and continue with a label, a target, and a comment which describes what
1 the contents of the node pointed to contains.
1 
1    Note references appear within the body of the node text; they begin
1 with '*Note', and continue with a label and a target.
1 
1    Like 'Next', 'Prev', and 'Up' pointers, cross-references can point to
1 any valid node.  They are used to refer you to a place where more
1 detailed information can be found on a particular subject.  Here is a
1 cross-reference which points to a node within the Texinfo documentation:
1 ⇒Writing an Xref (texinfo)xref, for more information on creating
1 your own texinfo cross references.
1