diff -Naur texinfo-4.7.orig/doc/info.texi texinfo-4.7/doc/info.texi --- texinfo-4.7.orig/doc/info.texi 2004-04-06 10:21:35.000000000 +0200 +++ texinfo-4.7/doc/info.texi 2004-10-04 19:23:56.780398504 +0200 @@ -115,25 +115,25 @@ @end enumerate In either case, then type @kbd{mInfo} (just the letters), followed by address@hidden ``Return'' or ``Enter'' key. At this point, you should address@hidden -- the ``Return'' or ``Enter'' key. At this point, you should be ready to follow the instructions in this manual as you read them on the screen. @c FIXME! (address@hidden, 14 dec 1992) @c Is it worth worrying about what-if the beginner goes to somebody @c else's Emacs session, which already has an Info running in the middle address@hidden of something---in which case these simple instructions won't work? address@hidden of something -- in which case these simple instructions won't work? @end ifnotinfo @menu -* Help-Small-Screen:: Starting Info on a Small Screen -* Help:: How to use Info -* Help-P:: Returning to the Previous node +* Help-Small-Screen:: Starting Info on a Small Screen. +* Help:: How to use Info. +* Help-P:: Returning to the Previous node. * Help-^L:: The Space, DEL, B and ^L commands. * Help-Inv:: Invisible text in Emacs Info. -* Help-M:: Menus -* Help-Xref:: Following cross-references -* Help-Int:: Some intermediate Info commands -* Help-Q:: Quitting Info +* Help-M:: Using menus. +* Help-Xref:: Following cross-references. +* Help-Int:: Some intermediate Info commands. +* Help-Q:: Quitting Info. @end menu @node Help-Small-Screen @@ -207,8 +207,8 @@ If you have managed to get here, go back to the beginning with @kbd{DEL} (or @key{BACKSPACE}), and come back here again, then you understand the about the @samp{Space} and @samp{Backspace} keys. So -now type an @kbd{n} ---just one character; don't type the quotes and -don't type the Return key afterward--- to get to the normal start of +now type an @kbd{n} -- just one character; don't type the quotes and +don't type the Return key afterward -- to get to the normal start of the course. @end ifinfo @@ -239,7 +239,7 @@ if you scroll through the node. Besides a @samp{Next}, a node can have a @samp{Previous} or an address@hidden links, or both. As you can see, this node has all of these address@hidden link, or both. As you can see, this node has all of these links. @kindex n @r{(Info mode)} @@ -369,7 +369,7 @@ @kindex C-l @r{(Info mode)} 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 +again by typing @kbd{C-l} (@kbd{Control-L} -- that is, hold down @key{CTRL} and type @kbd{L} or @kbd{l}). @format @@ -407,8 +407,8 @@ @end format (If you are using the stand-alone Info reader, type @kbd{C-x 0} to -return here, that is---press and hold @key{CTRL}, type an @kbd{x}, -then release @key{CTRL} and @kbd{x}, and press @kbd{0}---a zero, not +return here -- that is, press and hold @key{CTRL}, type an @kbd{x}, +then release @key{CTRL} and @kbd{x}, and press @kbd{0}; a zero, not the letter ``o''.) From now on, you will encounter large nodes without warning, and @@ -516,7 +516,7 @@ name of the node that talks about that subtopic (again, normally hidden in Emacs), and optionally some further description of the subtopic. Lines in the menu that do not start with a @samp{*} have no -special meaning---they are only for the human reader's benefit and do +special meaning -- they are only for the human reader's benefit and do not define additional subtopics. Here is an example: @example @@ -606,7 +606,7 @@ @cindex completion of Info node names You can also use the @dfn{completion} feature to help enter the subtopic name. If you type the @key{TAB} key after entering part of a -name, it will fill in more of the name---as much as Info can deduce +name, it will fill in more of the name -- as much as Info can deduce from the part you have entered. If you move the cursor to one of the menu subtopic lines, then you do @@ -666,7 +666,7 @@ Another way to move to the menu subtopic lines and between them is to type @key{TAB}. Each time you type a @key{TAB}, you move to the next subtopic line. To move to a previous subtopic line, type address@hidden@key{TAB}}---that is, press and hold the @key{META} key and then address@hidden@key{TAB}} -- that is, press and hold the @key{META} key and then press @key{TAB}. (On some keyboards, the @key{META} key might be labeled @samp{Alt}.) @@ -686,7 +686,7 @@ message may appear at the bottom of the screen. @kbd{Mouse-2} is the second button of your mouse counting from the -left---the middle button on a 3-button mouse. (On a 2-button mouse, +left -- the middle button on a 3-button mouse. (On a 2-button mouse, you may have to press both buttons together to ``press the middle button''.) The message tells you pressing @kbd{Mouse-2} with the current position of the mouse pointer (on subtopic in the menu) will @@ -709,7 +709,7 @@ Congratulations! This is the node @samp{Help-FOO}. It has an @samp{Up} pointer @samp{Help-M}, the node you just came from via the @kbd{m} -command. This is the usual convention---the nodes you reach from a menu +command. This is the usual convention -- the nodes you reach from a menu have @samp{Up} nodes that lead back to the menu. Menus move Down in the tree, and @samp{Up} moves Up. @samp{Previous}, on the other hand, is usually used to ``stay on the same level but go backwards''. @@ -718,7 +718,7 @@ @findex Info-up You can go back to the node @samp{Help-M} by typing the command @kbd{u} for ``Up'' (the Emacs command run by @kbd{u} is address@hidden). That puts you at the @emph{front} of the node---to address@hidden). That puts you at the @emph{front} of the node -- to get back to where you were reading you have to type some @key{SPC}s. (Some Info readers, such as the one built into Emacs, put you at the same place where you were reading in @samp{Help-M}.) @@ -1055,7 +1055,7 @@ echo area the full index entry it found. Often, the text of the full index entry already gives you enough information to decide whether it is relevant to what you are looking for, so we recommend that you read -what Emacs shows in the echo area before looking at the node it +what Info shows in the echo area before looking at the node it displays. Since @kbd{i} looks for a substring, you can search for subjects even @@ -1164,7 +1164,7 @@ relative starting from the standard directory for Info files of your site. The name @samp{(@var{filename})Top} can be abbreviated to just @samp{(@var{filename})}. By convention, the name @samp{Top} is used -for the ``highest'' node in any single file---the node whose @samp{Up} +for the ``highest'' node in any single file -- the node whose @samp{Up} points out of the file. The @samp{Directory} node is @file{(dir)}, it points to a file @file{dir} which holds a large menu listing all the Info documents installed on your site. The @samp{Top} node of a @@ -1191,7 +1191,7 @@ @comment node-name, next, previous, up @section How to Create Menus - Any node in the Info hierarchy may have a @dfn{menu}---a list of subnodes. + Any node in the Info hierarchy may have a @dfn{menu} -- a list of subnodes. The @kbd{m} command searches the current node's menu for the topic which it reads from the terminal. @@ -1199,8 +1199,8 @@ A menu begins with a line starting with @address@hidden Menu:}}. The rest of the line is a comment. After the starting line, every line that begins with a @samp{* } lists a single topic. The name of the -topic--what the user must type at the @kbd{m}'s command prompt to -select this topic---comes right after the star and space, and is +topic -- what the user must type at the @kbd{m}'s command prompt to +select this topic -- comes right after the star and space, and is followed by a colon, spaces and tabs, and the name of the node which discusses that topic. The node name, like node names following @samp{Next}, @samp{Previous} and @samp{Up}, may be terminated with a @@ -1212,7 +1212,7 @@ clutter in the menu). It is considerate to choose the topic names so that they differ -from each other very near the beginning---this allows the user to type +from each other very near the beginning -- this allows the user to type short abbreviations. In a long menu, it is a good idea to capitalize the beginning of each item name which is the minimum acceptable abbreviation for it (a long menu is more than 5 or so entries). @@ -1223,7 +1223,7 @@ in a sequence of @samp{Next} and @samp{Previous} pointers so that someone who wants to see them all need not keep revisiting the Menu. - The Info Directory is simply the menu of the node @samp{(dir)Top}---that + The Info Directory is simply the menu of the node @samp{(dir)Top} -- that is, node @samp{Top} in file @file{.../info/dir}. You can put new entries in that menu just like any other menu. The Info Directory is @emph{not} the same as the file directory called @file{info}. It happens that many of @@ -1301,7 +1301,7 @@ as new users should do when they learn a new package. Another set of Info commands is useful when you need to find -something quickly in a manual---that is, when you need to use a manual +something quickly in a manual -- that is, when you need to use a manual as a reference rather than as a tutorial. We urge you to learn these search commands as well. If you want to do that now, follow this cross reference to @ref{Info Search}.