X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=info%2Finfo.info;h=ff9d60ecac6792b38a9592fef77e623c0f960501;hb=94f84031a3642f80ea856573f2bbb7c38d7c729c;hp=9e504e6bbd3685081191fbf6165e26bfe0d2501a;hpb=14144012929ab5944f367d5d1b323ab8268abb05;p=chise%2Fxemacs-chise.git.1 diff --git a/info/info.info b/info/info.info index 9e504e6..ff9d60e 100644 --- a/info/info.info +++ b/info/info.info @@ -1,5 +1,5 @@ -This is ../info/info.info, produced by makeinfo version 4.0 from -info.texi. +This is Info file ../info/info.info, produced by Makeinfo version 1.68 +from the input file info.texi. INFO-DIR-SECTION Texinfo documentation system START-INFO-DIR-ENTRY @@ -9,7 +9,7 @@ END-INFO-DIR-ENTRY This file describes how to use Info, the on-line, menu-driven GNU documentation system. - Copyright (C) 1989, 92, 96, 97, 98, 99 Free Software Foundation, Inc. + Copyright (C) 1989, 92, 96, 97 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -31,17 +31,20 @@ File: info.info, Node: Top, Next: Getting Started, Up: (dir) Info: An Introduction ********************* - Info is a program for reading documentation, which you might be using -now to read this. + Info is a program for reading documentation, which you are using now. - To learn how to use Info, type the command `h' while using the Info -program. It brings you to a programmed instruction sequence. + To learn how to use Info, type the command `h'. It brings you to a +programmed instruction sequence. + + To learn advanced Info commands, type `n' twice. This brings you to +`Info for Experts', skipping over the `Getting Started' chapter. * Menu: * Getting Started:: Getting started using an Info reader. * Advanced Info:: Advanced commands within Info. -* Creating an Info File:: How to make your own Info file. +* Create an Info File:: How to make your own Info file. +* The Standalone Info Program: (info-stnd.info).  File: info.info, Node: Getting Started, Next: Advanced Info, Prev: Top, Up: Top @@ -169,7 +172,7 @@ Another `n' command now would take you to the next node, `Help-^L'. you to the `Previous' node. When you get there, you can do an `n' again to return here. - This all probably seems insultingly simple so far, but _do not_ be + This all probably seems insultingly simple so far, but *do not* be led into skimming. Things will get more complicated soon. Also, do not try a new command until you are told it is time to. Otherwise, you may make Info skip past an important warning that was coming up. @@ -201,7 +204,7 @@ not anything above the top until you have typed some spaces). When you type the space, the two lines that were at the bottom of the screen appear at the top, followed by more lines. Delete takes the -two lines from the top and moves them to the bottom, _usually_, but if +two lines from the top and moves them to the bottom, *usually*, but if there are not a full screen's worth of lines above them they may not make it all the way to the bottom. @@ -295,8 +298,8 @@ actually visible in its node. If you cannot find a menu in a node by looking at it, then the node does not have a menu and the `m' command is not available. - The command to go to one of the subnodes is `m'--but _do not do it -yet!_ Before you use `m', you must understand the difference between + The command to go to one of the subnodes is `m'--but *do not do it +yet!* Before you use `m', you must understand the difference between commands and arguments. So far, you have learned several commands that do not need arguments. When you type one, Info processes it and is instantly ready for another command. The `m' command is different: it @@ -335,16 +338,16 @@ what you have entered. not need to type the argument: you just type a Return, and it stands for the subtopic of the line you are on. - Here is a menu to give you a chance to practice. This menu gives you -three ways of going to one place, Help-FOO: + Here is a menu to give you a chance to practice. -* Menu: + * Menu: The menu starts here. + + This menu gives you three ways of going to one place, Help-FOO. -* Foo: Help-FOO. A node you can visit for fun. + * Foo: Help-FOO. A node you can visit for fun. * Bar: Help-FOO. Strange! two ways to get to the same place. * Help-FOO:: And yet another! - - >> Now type just an `m' and see what happens: +>> Now type just an `m' and see what happens: Now you are "inside" an `m' command. Commands cannot be used now; the next thing you will type must be the name of a subtopic. @@ -390,7 +393,7 @@ 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 +"Up". That puts you at the *front* of the node--to get back to where you were reading you have to type some s. >> Now type `u' to move back up to `Help-M'. @@ -420,7 +423,7 @@ back to `Help-M'. Then follow directions again and you will end up back here. - Note the difference between `l' and `p': `l' moves to where _you_ + Note the difference between `l' and `p': `l' moves to where *you* last were, whereas `p' always moves to the node which the header says is the `Previous' node (from this node, to `Help-M'). @@ -429,7 +432,7 @@ node, which is the first one you saw when you entered Info, has a menu which leads (directly, or indirectly through other menus), to all the nodes that exist. - >> Try doing a `d', then do an `l' to return here (yes, _do_ + >> Try doing a `d', then do an `l' to return here (yes, *do* return). Sometimes, in Info documentation, you will see a cross reference. @@ -496,14 +499,14 @@ and Return, to get to the node about Info and see what other help is available.  -File: info.info, Node: Advanced Info, Next: Creating an Info File, Prev: Getting Started, Up: Top +File: info.info, Node: Advanced Info, Next: Create an Info File, Prev: Getting Started, Up: Top 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 +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.) @@ -559,10 +562,10 @@ short for the `m' command together with an argument. `1' goes through the first item in the current node's menu; `2' goes through the second item, etc. - If your display supports multiple fonts, and you are using Emacs' -Info mode to read Info files, the `*' for the fifth menu item is -underlined, and so is the `*' for the ninth item; these underlines make -it easy to see at a glance which number to use for an item. + If you display supports multiple fonts, and you are using Emacs' Info +mode to read Info files, the `*' for the fifth menu item is underlines, +and so is the `*' for the ninth item; these underlines make it easy to +see at a glance which number to use for an item. On ordinary terminals, you won't have underlining. If you need to actually count items, it is better to use `m' instead, and specify the @@ -584,7 +587,7 @@ Adding a new node to Info 2. Put that topic in the menu in the directory. *Note Menu: Menus. - Usually, the way to create the nodes is with Texinfo (*note Overview + Usually, the way to create the nodes is with Texinfo *note Overview of Texinfo: (texinfo)Top.); this has the advantage that you can also make a printed manual from them. However, if you want to edit an Info file, here is how. @@ -594,8 +597,8 @@ one. It must have a <^_> character before it (invisible to the user; this node has one but you cannot see it), and it ends with either a <^_>, a <^L>, or the end of file. Note: If you put in a <^L> to end a new node, be sure that there is a <^_> after it to start the next one, -since <^L> cannot _start_ a node. Also, a nicer way to make a node -boundary be a page boundary as well is to put a <^L> _right after_ the +since <^L> cannot *start* a node. Also, a nicer way to make a node +boundary be a page boundary as well is to put a <^L> *right after* the <^_>. The <^_> starting a node must be followed by a newline or a <^L> @@ -631,10 +634,10 @@ make it possible to make old-fashioned, unstructured files into nodes of the tree. The `Node:' name, in which a node states its own name, must not -contain a filename, since Info when searching for a node does not expect -one to be there. The `Next', `Previous' and `Up' names may contain -them. In this node, since the `Up' node is in the same file, it was -not necessary to use one. +contain a filename, since Info when searching for a node does not +expect one to be there. The `Next', `Previous' and `Up' names may +contain them. In this node, since the `Up' node is in the same file, +it was not necessary to use one. Note that the nodes in this file have a file name in the header line. The file names are ignored by Info, but they serve as comments @@ -679,13 +682,13 @@ to see them all need not keep revisiting the Menu. The Info Directory is simply the menu of the node `(dir)Top'--that is, node `Top' in file `.../info/dir'. You can put new entries in that -menu just like any other menu. The Info Directory is _not_ the same as +menu just like any other menu. The Info Directory is *not* the same as the file directory called `info'. It happens that many of Info's files live on that file directory, but they do not have to; and files on that directory are not automatically listed in the Info Directory node. Also, although the Info node graph is claimed to be a "hierarchy", -in fact it can be _any_ directed graph. Shared structures and pointer +in fact it can be *any* directed graph. Shared structures and pointer cycles are perfectly possible, and can be used if they are appropriate to the meaning to be expressed. There is no need for all the nodes in a file to form a connected structure. In fact, this file has two @@ -704,7 +707,7 @@ Creating Cross References 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 +*cannot* be terminated by a `)', because `)''s are so often part of node names. If you wish to enclose a cross reference in parentheses, terminate it with a period first. Here are two examples of cross references pointers: @@ -776,10 +779,10 @@ File: info.info, Node: Emacs Info Variables, Prev: Checking, Up: Advanced Inf Emacs Info-mode Variables ========================= - The following variables may modify the behavior of Info-mode in + 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: (xemacs)Examining. +Setting Variables: (emacs)Examining. `Info-enable-edit' Set to `nil', disables the `e' (`Info-edit') command. A non-`nil' @@ -799,42 +802,43 @@ Setting Variables: (xemacs)Examining. when the function `Info-directory' is called.  -File: info.info, Node: Creating an Info File, Prev: Advanced Info, Up: Top +File: info.info, Node: Create an Info File, Prev: Advanced Info, Up: Top -Creating an Info File -********************* +Creating an Info File from a Makeinfo file +****************************************** - *Note Overview of Texinfo: (texinfo)Top, to learn how to write a -Texinfo file. + `makeinfo' is a utility that converts a Texinfo file into an Info +file; `texinfo-format-region' and `texinfo-format-buffer' are GNU Emacs +functions that do the same. *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)Install an Info File, to -learn how to install an Info file after you have created one. + *Note Overview of Texinfo: (texinfo)Top, to learn how to write a +Texinfo file.  Tag Table: -Node: Top1067 -Node: Getting Started1612 -Node: Help-Small-Screen2360 -Node: Help4109 -Node: Help-P5139 -Node: Help-^L6001 -Node: Help-M8879 -Node: Help-FOO14859 -Node: Help-Adv15597 -Node: Help-Cross18272 -Node: Help-Q18918 -Node: Advanced Info19545 -Node: Expert20523 -Node: Add23037 -Node: Menus26397 -Node: Cross-refs29271 -Node: Tags29973 -Node: Checking31275 -Node: Emacs Info Variables32228 -Node: Creating an Info File33217 +Node: Top1085 +Node: Getting Started1770 +Node: Help-Small-Screen2518 +Node: Help4267 +Node: Help-P5297 +Node: Help-^L6159 +Node: Help-M9037 +Node: Help-FOO15047 +Node: Help-Adv15785 +Node: Help-Cross18460 +Node: Help-Q19106 +Node: Advanced Info19733 +Node: Expert20709 +Node: Add23222 +Node: Menus26581 +Node: Cross-refs29455 +Node: Tags30157 +Node: Checking31459 +Node: Emacs Info Variables32412 +Node: Create an Info File33401  End Tag Table