# HG changeset patch # User Richard M. Stallman # Date 1000930862 0 # Node ID 9012f11877c15a91552518ed0628a63e65ce277a # Parent 81362552baba91f01f456a95ea682a1c6bdff750 Major rewrite of Help-Xref. Don't use "print" except for paper. diff -r 81362552baba -r 9012f11877c1 man/info.texi --- a/man/info.texi Wed Sep 19 20:08:17 2001 +0000 +++ b/man/info.texi Wed Sep 19 20:21:02 2001 +0000 @@ -6,7 +6,7 @@ @syncodeindex vr cp @syncodeindex ky cp @comment %**end of header -@comment $Id: info.texi,v 1.14 2001/09/19 19:58:29 rms Exp $ +@comment $Id: info.texi,v 1.15 2001/09/19 20:08:17 rms Exp $ @dircategory Texinfo documentation system @direntry @@ -378,7 +378,7 @@ node. @kindex C-l @r{(Info mode)} - If your screen is ever garbaged, you can tell Info to print it out + If your screen is ever garbaged, you can tell Info to display it again by typing @kbd{C-l} (@kbd{Control-L}, that is---hold down @key{CTRL} and type @kbd{L} or @kbd{l}). @@ -406,7 +406,7 @@ You have just learned a considerable number of commands. If you want to use one but have trouble remembering which, you should type a @kbd{?} (in Emacs it runs the @code{Info-summary} command) which -prints out a brief list of commands. When you are finished looking at +displays a brief list of commands. When you are finished looking at the list, make it go away by typing a @key{SPC} repeatedly. @format @@ -605,7 +605,7 @@ the shape of the mouse pointer will change if your platform supports that. After a while, if you leave the mouse on that spot, a tooltip will pop up saying ``Mouse-2: go to that node''. (If the tooltips are -turned off or unavailable, this message is printed in the @dfn{echo +turned off or unavailable, this message is displayed in the @dfn{echo area}, the bottom screen line where you typed the menu subtopics in response to the prompt.) @kbd{Mouse-2} is the second button of your mouse counting from the left---the rightmost button for two-button @@ -663,37 +663,42 @@ @comment node-name, next, previous, up @section Following Cross-References - Sometimes, in Info documentation, you will see a cross reference. -Cross references look like this: @xref{Help-Cross, Cross}. That is a -real, live cross reference which is named @samp{Cross} and points at -the node named @samp{Help-Cross}. +@cindex cross references in Info documents + In Info documentation, you will see many @dfn{cross references}. +Cross references look like this: @xref{Help-Cross, Cross}. That text +is a real, live cross reference, whose name is @samp{Cross} and which +points to the node named @samp{Help-Cross}. @kindex f @r{(Info mode)} @findex Info-follow-reference -@cindex cross references in Info documents - If you wish to follow a cross reference, you must use the @kbd{f} -command. The @kbd{f} must be followed by the cross reference name -(in this case, @samp{Cross}). If the cursor is on or near the cross -reference, Info suggests the name if the nearest reference in -parentheses; typing @key{RET} will follow that reference. You can -also type a different name, if the default is not what you want. -While you enter the name, you can use the @key{DEL} (or + There are two ways to follow a cross reference. You can move the +cursor to it and press @key{RET}, just as in a menu. @key{RET} +follows the cross reference that the cursor is on. Or you can type +@kbd{f} and then specify the name of the cross reference (in this +case, @samp{Cross}) as an argument. In Emacs Info, @kbd{f} runs +@code{Info-follow-reference}, + + In the @kbd{f} command, you select the cross reference with its +name, so it does not matter where the cursor was. If the cursor is on +or near a cross reference, @kbd{f} suggests that reference name in +parentheses as the default; typing @key{RET} will follow that +reference. However, if you type a different reference name, @kbd{f} +will follow the other reference which has that name. + +@format +>> Type @kbd{f}, followed by @kbd{Cross}, and then @key{RET}. +@end format + + As you enter the reference name, you can use the @key{DEL} (or @key{BACKSPACE}) key to edit your input. If you change your mind about following any reference, you can use @kbd{Control-g} to cancel -the command. - - Completion is available in the @kbd{f} command; you can complete among -all the cross reference names in the current node by typing a @key{TAB}. - - @kbd{f} runs @code{Info-follow-reference} in Emacs. +the command. Completion is available in the @kbd{f} command; you can +complete among all the cross reference names in the current node by +typing a @key{TAB}. -@format ->> Type @kbd{f}, followed by @kbd{Cross}, and a @key{RET}. -@end format - - To get a list of all the cross references in the current node, you can -type @kbd{?} after an @kbd{f}. The @kbd{f} continues to await a -cross reference name even after printing the list, so if you don't + To get a list of all the cross references in the current node, you +can type @kbd{?} after an @kbd{f}. The @kbd{f} continues to await a +cross reference name even after displaying the list, so if you don't actually want to follow a reference, you should type a @kbd{Control-g} to cancel the @kbd{f}. @@ -702,10 +707,8 @@ type a @kbd{Control-g} and see how the @samp{f} gives up. @end format - The @key{TAB} and @kbd{M-@key{TAB}} key, which move between -subtopics in a menu can move between cross references as well. Once -the cursor is on a cross reference, you can press @key{RET} to follow -that reference, just like you do in a menu. + The @key{TAB} and @kbd{M-@key{TAB}} key, which move between menu +items in a menu, also move between cross references outside of menus. @node Help-Int, Help-Q, Help-Xref, Getting Started @comment node-name, next, previous, up