home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 6 / FreshFish_September1994.bin / gnu / info / info.info (.txt) < prev    next >
GNU Info File  |  1994-09-02  |  31KB  |  590 lines
  1. This is Info file info.info, produced by Makeinfo-1.55 from the input
  2. file info.texi.
  3.    This file describes how to use Info, the on-line, menu-driven GNU
  4. documentation system.
  5.    Copyright (C) 1989, 1992 Free Software Foundation, Inc.
  6.    Permission is granted to make and distribute verbatim copies of this
  7. manual provided the copyright notice and this permission notice are
  8. preserved on all copies.
  9.    Permission is granted to copy and distribute modified versions of
  10. this manual under the conditions for verbatim copying, provided that
  11. the entire resulting derived work is distributed under the terms of a
  12. permission notice identical to this one.
  13.    Permission is granted to copy and distribute translations of this
  14. manual into another language, under the above conditions for modified
  15. versions, except that this permission notice may be stated in a
  16. translation approved by the Free Software Foundation.
  17. File: info.info,  Node: Top,  Next: Getting Started,  Prev: (dir),  Up: (dir)
  18. Info: An Introduction
  19. *********************
  20.    Info is a program for reading documentation, which you are using now.
  21.    To learn how to use Info, type the command `h'.  It brings you to a
  22. programmed instruction sequence.
  23.    To learn advanced Info commands, type `n' twice.  This brings you to
  24. `Info for Experts', skipping over the .  `Getting Started' chapter.
  25. * Menu:
  26. * Getting Started::
  27. * Advanced Info::
  28. * Create an Info File::
  29. File: info.info,  Node: Getting Started,  Next: Advanced Info,  Prev: Top,  Up: Top
  30. Getting Started
  31. ***************
  32.    This first part of the Info manual describes how to get around inside
  33. of Info.  The second part of the manual describes various advanced Info
  34. commands, and how to write an Info as distinct from a Texinfo file.
  35. The third part is about how to generate Info files from Texinfo files.
  36. * Menu:
  37. * Help-Small-Screen::   Starting Info on a Small Screen
  38. * Help::                How to use Info
  39. * Help-P::              Returning to the Previous node
  40. * Help-^L::             The Space, Rubout, B and ^L commands.
  41. * Help-M::              Menus
  42. * Help-Adv::            Some advanced Info commands
  43. * Help-Q::              Quitting Info
  44. File: info.info,  Node: Help-Small-Screen,  Next: Help,  Up: Getting Started
  45. Starting Info on a Small Screen
  46. ===============================
  47.    Since your terminal has an unusually small number of lines on its
  48. screen, it is necessary to give you special advice at the beginning.
  49.    If you see the text `--All----' at near the bottom right corner of
  50. the screen, it means the entire text you are looking at fits on the
  51. screen.  If you see `--Top----' instead, it means that there is more
  52. text below that does not fit.  To move forward through the text and see
  53. another screen full, press the Space bar, SPC.  To move back up, press
  54. the key labeled `Rubout' or `Delete' or DEL.
  55.    Here are 40 lines of junk, so you can try SPC and DEL and see what
  56. they do.  At the end are instructions of what you should do next.
  57.    This is line 17
  58. This is line 18
  59. This is line 19
  60. This is line 20
  61. This is line 21
  62. This is line 22
  63. This is line 23
  64. This is line 24
  65. This is line 25
  66. This is line 26
  67. This is line 27
  68. This is line 28
  69. This is line 29
  70. This is line 30
  71. This is line 31
  72. This is line 32
  73. This is line 33
  74. This is line 34
  75. This is line 35
  76. This is line 36
  77. This is line 37
  78. This is line 38
  79. This is line 39
  80. This is line 40
  81. This is line 41
  82. This is line 42
  83. This is line 43
  84. This is line 44
  85. This is line 45
  86. This is line 46
  87. This is line 47
  88. This is line 48
  89. This is line 49
  90. This is line 50
  91. This is line 51
  92. This is line 52
  93. This is line 53
  94. This is line 54
  95. This is line 55
  96. This is line 56
  97. If you have managed to get here, go back to the beginning with DEL, and
  98. come back here again, then you understand SPC and DEL.  So now type an
  99. `n'--just one character; do not type the quotes and do not type the
  100. Return key, RET, afterward--to get to the normal start of the course.
  101. File: info.info,  Node: Help,  Next: Help-P,  Prev: Help-Small-Screen,  Up: Getting Started
  102. How to use Info
  103. ===============
  104.    You are talking to the program Info, for reading documentation.
  105.    Right now you are looking at one "Node" of Information.  A node
  106. contains text describing a specific topic at a specific level of
  107. detail.  This node's topic is "how to use Info".
  108.    The top line of a node is its "header".  This node's header (look at
  109. it now) says that it is the node named `Help' in the file `info'.  It
  110. says that the `Next' node after this one is the node called `Help-P'.
  111. An advanced Info command lets you go to any node whose name you know.
  112.    Besides a `Next', a node can have a `Previous' or an `Up'.  This
  113. node has a `Previous' but no `Up', as you can see.
  114.    Now it is time to move on to the `Next' node, named `Help-P'.
  115.    >> Type `n' to move there.  Type just one character;    do not type
  116. the quotes and do not type a RET afterward.
  117.    `>>' in the margin means it is really time to try a command.
  118. File: info.info,  Node: Help-P,  Next: Help-^L,  Prev: Help,  Up: Getting Started
  119. Returning to the Previous node
  120. ==============================
  121.    This node is called `Help-P'.  The `Previous' node, as you see, is
  122. `Help', which is the one you just came from using the `n' command.
  123. Another `n' command now would take you to the next node, `Help-^L'.
  124.    >> But do not do that yet.  First, try the `p' command, which takes
  125.  you to the `Previous' node.  When you get there, you can do an    `n'
  126. again to return here.
  127.    This all probably seems insultingly simple so far, but *do not* be
  128. led into skimming.  Things will get more complicated soon.  Also, do
  129. not try a new command until you are told it is time to.  Otherwise, you
  130. may make Info skip past an important warning that was coming up.
  131.    >> Now do an `n' to get to the node `Help-^L' and learn more.
  132. File: info.info,  Node: Help-^L,  Next: Help-M,  Prev: Help-P,  Up: Getting Started
  133. The Space, Rubout, B and ^L commands.
  134. =====================================
  135.    This node's header tells you that you are now at node `Help-^L', and
  136. that `p' would get you back to `Help-P'.  The node's title is
  137. underlined; it says what the node is about (most nodes have titles).
  138.    This is a big node and it does not all fit on your display screen.
  139. You can tell that there is more that is not visible because you can see
  140. the string `--Top-----' rather than `--All----' near the bottom right
  141. corner of the screen.
  142.    The SPC, DEL and `b' commands exist to allow you to "move around" in
  143. a node that does not all fit on the screen at once.  SPC moves forward,
  144. to show what was below the bottom of the screen.  DEL moves backward,
  145. to show what was above the top of the screen (there is not anything
  146. above the top until you have typed some spaces).
  147.    >> Now try typing a SPC (afterward, type a DEL to return here).
  148.    When you type the SPC, the two lines that were at the bottom of the
  149. screen appear at the top, followed by more lines.  DEL takes the two
  150. lines from the top and moves them to the bottom, *usually*, but if
  151. there are not a full screen's worth of lines above them they may not
  152. make it all the way to the bottom.
  153.    If you type a SPC when there is no more to see, it rings the bell
  154. and otherwise does nothing.  The same goes for a DEL when the header of
  155. the node is visible.
  156.    If your screen is ever garbaged, you can tell Info to print it out
  157. again by typing `C-l' (`Control-L', that is--hold down "Control" and
  158. type an L or `l').
  159.    >> Type `C-l' now.
  160.    To move back to the beginning of the node you are on, you can type a
  161. lot of DELs.  You can also type simply `b' for beginning.
  162.    >> Try that now.  (I have put in enough verbiage to make sure you are
  163.   not on the first screenful now).  Then come back, typing SPC
  164. several times.
  165.    You have just learned a considerable number of commands.  If you
  166. want to use one but have trouble remembering which, you should type a ?
  167. which prints out a brief list of commands.  When you are finished
  168. looking at the list, make it go away by typing a SPC.
  169.    >> Type a ? now.  After it finishes, type a SPC.
  170.    (If you are using the standalone Info reader, type `l' to return
  171. here.)
  172.    From now on, you will encounter large nodes without warning, and
  173. will be expected to know how to use SPC and DE