-This is ../info/info.info, produced by makeinfo version 4.0 from
+This is ../info/info.info, produced by makeinfo version 4.8 from
info.texi.
INFO-DIR-SECTION Texinfo documentation system
Info: An Introduction
*********************
- Info is a program for reading documentation, which you are using now.
+Info is a program for reading documentation, which you might be using
+now to read this.
- To learn how to use Info, type the command `h'. It brings you to a
-programmed instruction sequence.
+ To learn how to use Info, type the command `h' while using the Info
+program. It brings you to a programmed instruction sequence.
* Menu:
\1f
File: info.info, Node: Getting Started, Next: Advanced Info, Prev: Top, Up: Top
-Getting Started
-***************
+1 Getting Started
+*****************
- This first part of the Info manual describes how to get around inside
+This first part of the Info manual describes how to get around inside
of Info. The second part of the manual describes various advanced Info
commands, and how to write an Info as distinct from a Texinfo file.
The third part is about how to generate Info files from Texinfo files.
\1f
File: info.info, Node: Help-Small-Screen, Next: Help, Up: Getting Started
-Starting Info on a Small Screen
-===============================
+1.1 Starting Info on a Small Screen
+===================================
- Since your terminal has an unusually small number of lines on its
+Since your terminal has an unusually small number of lines on its
screen, it is necessary to give you special advice at the beginning.
If you see the text `--All----' at near the bottom right corner of
\1f
File: info.info, Node: Help, Next: Help-P, Prev: Help-Small-Screen, Up: Getting Started
-How to use Info
-===============
+1.2 How to use Info
+===================
- You are talking to the program Info, for reading documentation.
+You are talking to the program Info, for reading documentation.
Right now you are looking at one "Node" of Information. A node
contains text describing a specific topic at a specific level of
\1f
File: info.info, Node: Help-P, Next: Help-^L, Prev: Help, Up: Getting Started
-Returning to the Previous node
-==============================
+1.3 Returning to the Previous node
+==================================
- This node is called `Help-P'. The `Previous' node, as you see, is
+This node is called `Help-P'. The `Previous' node, as you see, is
`Help', which is the one you just came from using the `n' command.
Another `n' command now would take you to the next node, `Help-^L'.
\1f
File: info.info, Node: Help-^L, Next: Help-M, Prev: Help-P, Up: Getting Started
-The Space, Delete, B and ^L commands.
-=====================================
+1.4 The Space, Delete, B and ^L commands.
+=========================================
- This node's header tells you that you are now at node `Help-^L', and
+This node's header tells you that you are now at node `Help-^L', and
that `p' would get you back to `Help-P'. The node's title is
underlined; it says what the node is about (most nodes have titles).
\1f
File: info.info, Node: Help-M, Next: Help-Adv, Prev: Help-^L, Up: Getting Started
-Menus
-=====
+1.5 Menus
+=========
- Menus and the `m' command
+Menus and the `m' command
With only the `n' and `p' commands for moving between nodes, nodes
are restricted to a linear sequence. Menus allow a branching
\1f
File: info.info, Node: Help-FOO, Up: Help-M
-The `u' command
----------------
+1.5.1 The `u' command
+---------------------
- Congratulations! This is the node `Help-FOO'. Unlike the other
-nodes you have seen, this one has an `Up': `Help-M', the node you just
-came from via the `m' command. This is the usual convention--the nodes
-you reach from a menu have `Up' nodes that lead back to the menu.
-Menus move Down in the tree, and `Up' moves Up. `Previous', on the
-other hand, is usually used to "stay on the same level but go backwards"
+Congratulations! This is the node `Help-FOO'. Unlike the other nodes
+you have seen, this one has an `Up': `Help-M', the node you just came
+from via the `m' command. This is the usual convention--the nodes you
+reach from a menu have `Up' nodes that lead back to the menu. Menus
+move Down in the tree, and `Up' moves Up. `Previous', on the other
+hand, is usually used to "stay on the same level but go backwards"
You can go back to the node `Help-M' by typing the command `u' for
"Up". That puts you at the _front_ of the node--to get back to where
\1f
File: info.info, Node: Help-Adv, Next: Help-Q, Prev: Help-M, Up: Getting Started
-Some advanced Info commands
-===========================
+1.6 Some advanced Info commands
+===============================
- The course is almost over, so please stick with it to the end.
+The course is almost over, so please stick with it to the end.
If you have been moving around to different nodes and wish to
retrace your steps, the `l' command (`l' for "last") will do that, one
\1f
File: info.info, Node: Help-Cross, Up: Help-Adv
-The node reached by the cross reference in Info
------------------------------------------------
+1.6.1 The node reached by the cross reference in Info
+-----------------------------------------------------
- This is the node reached by the cross reference named `Cross'.
+This is the node reached by the cross reference named `Cross'.
While this node is specifically intended to be reached by a cross
reference, most cross references lead to nodes that "belong" someplace
\1f
File: info.info, Node: Help-Q, Prev: Help-Adv, Up: Getting Started
-Quitting Info
-=============
+1.7 Quitting Info
+=================
- To get out of Info, back to what you were doing before, type `q' for
+To get out of Info, back to what you were doing before, type `q' for
"Quit".
This is the end of the course on using Info. There are some other
\1f
File: info.info, Node: Advanced Info, Next: Creating an Info File, Prev: Getting Started, Up: Top
-Info for Experts
-****************
+2 Info for Experts
+******************
- This chapter describes various advanced Info commands, and how to
-write an Info as distinct from a Texinfo file. (However, in most
-cases, writing a Texinfo file is better, since you can use it _both_ to
+This chapter describes various advanced Info commands, and how to write
+an Info as distinct from a Texinfo file. (However, in most cases,
+writing a Texinfo file is better, since you can use it _both_ to
generate an Info file and to make a printed manual. *Note Overview of
Texinfo: (texinfo)Top.)
\1f
File: info.info, Node: Expert, Next: Add, Up: Advanced Info
-Advanced Info Commands
-======================
+2.1 Advanced Info Commands
+==========================
- `g', `s', `1', - `9', and `e'
+`g', `s', `1', - `9', and `e'
If you know a node's name, you can go there by typing `g', the name,
and <RET>. Thus, `gTop<RET>' would go to the node called `Top' in this
\1f
File: info.info, Node: Add, Next: Menus, Prev: Expert, Up: Advanced Info
-Adding a new node to Info
-=========================
+2.2 Adding a new node to Info
+=============================
- To add a new topic to the list in the Info directory, you must:
+To add a new topic to the list in the Info directory, you must:
1. Create some nodes, in some file, to document that topic.
2. Put that topic in the menu in the directory. *Note Menu: Menus.
\1f
File: info.info, Node: Menus, Next: Cross-refs, Prev: Add, Up: Advanced Info
-How to Create Menus
-===================
+2.3 How to Create Menus
+=======================
- Any node in the Info hierarchy may have a "menu"--a list of subnodes.
+Any node in the Info hierarchy may have a "menu"--a list of subnodes.
The `m' command searches the current node's menu for the topic which it
reads from the terminal.
\1f
File: info.info, Node: Cross-refs, Next: Tags, Prev: Menus, Up: Advanced Info
-Creating Cross References
-=========================
+2.4 Creating Cross References
+=============================
- A cross reference can be placed anywhere in the text, unlike a menu
+A cross reference can be placed anywhere in the text, unlike a menu
item which must go at the front of a line. A cross reference looks
like a menu item except that it has `*note' instead of `*'. It
_cannot_ be terminated by a `)', because `)''s are so often part of
\1f
File: info.info, Node: Tags, Next: Checking, Prev: Cross-refs, Up: Advanced Info
-Tag Tables for Info Files
-=========================
+2.5 Tag Tables for Info Files
+=============================
- You can speed up the access to nodes of a large Info file by giving
-it a tag table. Unlike the tag table for a program, the tag table for
-an Info file lives inside the file itself and is used automatically
+You can speed up the access to nodes of a large Info file by giving it
+a tag table. Unlike the tag table for a program, the tag table for an
+Info file lives inside the file itself and is used automatically
whenever Info reads in the file.
To make a tag table, go to a node in the file using Emacs Info mode
\1f
File: info.info, Node: Checking, Next: Emacs Info Variables, Prev: Tags, Up: Advanced Info
-Checking an Info File
-=====================
+2.6 Checking an Info File
+=========================
- When creating an Info file, it is easy to forget the name of a node
-when you are making a pointer to it from another node. If you put in
-the wrong name for a node, this is not detected until someone tries to
-go through the pointer using Info. Verification of the Info file is an
+When creating an Info file, it is easy to forget the name of a node when
+you are making a pointer to it from another node. If you put in the
+wrong name for a node, this is not detected until someone tries to go
+through the pointer using Info. Verification of the Info file is an
automatic process which checks all pointers to nodes and reports any
pointers which are invalid. Every `Next', `Previous', and `Up' is
checked, as is every menu item and every cross reference. In addition,
\1f
File: info.info, Node: Emacs Info Variables, Prev: Checking, Up: Advanced Info
-Emacs Info-mode Variables
-=========================
+2.7 Emacs Info-mode Variables
+=============================
- The following variables may modify the behaviour of Info-mode in
-Emacs; you may wish to set one or several of these variables
-interactively, or in your `~/.emacs' init file. *Note Examining and
-Setting Variables: (emacs)Examining.
+The following variables may modify the behavior of Info-mode in Emacs;
+you may wish to set one or several of these variables interactively, or
+in your `~/.emacs' init file. *Note Examining and Setting Variables:
+(xemacs)Examining.
`Info-enable-edit'
Set to `nil', disables the `e' (`Info-edit') command. A non-`nil'
\1f
File: info.info, Node: Creating an Info File, Prev: Advanced Info, Up: Top
-Creating an Info File
-*********************
+3 Creating an Info File
+***********************
- *Note Overview of Texinfo: (texinfo)Top, to learn how to write a
+*Note Overview of Texinfo: (texinfo)Top, to learn how to write a
Texinfo file.
- *Note Creating an Info File: (texinfo)Creating an Info File, to
-learn how to create an Info file from a Texinfo file.
+ *Note Creating an Info File: (texinfo)Create an Info File, to learn
+how to create an Info file from a Texinfo file.
- *Note Installing an Info File: (texinfo)Installing an Info File, to
+ *Note Installing an Info File: (texinfo)Install an Info File, to
learn how to install an Info file after you have created one.
\1f
Tag Table:
Node: Top\7f1067
-Node: Getting Started\7f1565
-Node: Help-Small-Screen\7f2313
-Node: Help\7f4062
-Node: Help-P\7f5092
-Node: Help-^L\7f5954
-Node: Help-M\7f8832
-Node: Help-FOO\7f14812
-Node: Help-Adv\7f15550
-Node: Help-Cross\7f18225
-Node: Help-Q\7f18871
-Node: Advanced Info\7f19498
-Node: Expert\7f20476
-Node: Add\7f22990
-Node: Menus\7f26350
-Node: Cross-refs\7f29224
-Node: Tags\7f29926
-Node: Checking\7f31228
-Node: Emacs Info Variables\7f32181
-Node: Creating an Info File\7f33170
+Node: Getting Started\7f1609
+Node: Help-Small-Screen\7f2358
+Node: Help\7f4112
+Node: Help-P\7f5147
+Node: Help-^L\7f6014
+Node: Help-M\7f8897
+Node: Help-FOO\7f14882
+Node: Help-Adv\7f15630
+Node: Help-Cross\7f18310
+Node: Help-Q\7f18965
+Node: Advanced Info\7f19597
+Node: Expert\7f20576
+Node: Add\7f23095
+Node: Menus\7f26460
+Node: Cross-refs\7f29339
+Node: Tags\7f30046
+Node: Checking\7f31353
+Node: Emacs Info Variables\7f32311
+Node: Creating an Info File\7f33305
\1f
End Tag Table
projects / chise / xemacs-chise.git.1 / blobdiff