Go to the first, previous, next, last section, table of contents.

Cross References

You can create cross references using the `*Main Menu*' buffer or recently visited nodes buffer; or you can create cross references in the Para buffer itself. Similarly, you can visit cross references.

The two commands are:

C-c C-p r para-xref create a cross reference

f C-c C-p C-f para-follow go to a cross referenced node, even in another file

(In the Para mode buffer itself, you cannot use the `r' command for `para-xref' since point must be located at the spot you want to insert the reference. However, you can use the `f' command, as usual.)

To create a cross reference, type the `C-c C-p r' (para-xref) command.

The `para-xref' command inserts a standard Texinfo `xref' cross reference into the source file, and inserts a period after it. The command offers name completion, that is, if you type the beginning of the node name, and then type TAB, Emacs will provide the rest of the name. This is very helpful if you are not sure of the name; and it saves typing.

(NOTE: Completion only works if the node name is listed in the `*Main Menu*' buffer by the `para-directory' command. Type `C-c C-p d' (para-directory) to list the main menu. If necessary, type `C-c C-p m' (para-master-menu) to create the detailed master menu for `C-c C-p d' to list. See section Using the Main Menu.)

With a prefix, the `para-xref' command inserts the topic description in the reference as well as the node name. The command looks like this:

C-u C-c C-p r

When it can, the function offers the description line for the node in the main menu as the default for the topic description.

For example, here is a reference to the chapter summarizing how Para mode works. See section Summary of How Para Mode Works.

(The same keystrokes, `C-c C-p r', may be used inside both the `*Main Menu*' buffer and the `*Recently Visited Nodes*' buffer; in those buffers, the keys are bound to special versions of the command which offer you the node name on which the cursor is placed. @xref{Listing Nodes, , Listing Recently Visited Nodes}, and see section Using the Main Menu.)

To follow a reference, use the `f' or `C-c C-p C-f' (para-follow) command.

The `para-follow' command will automatically bring you to the referenced node if the node you are in has only one cross reference within it. If the node you are within has two or more cross references, the command will prompt you for the node name. If you type just a part of the node name (in either upper or lower case) and then press TAB, Emacs will attempt to complete the name of the node, thereby saving keystrokes.


Go to the first, previous, next, last section, table of contents.