[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo update (Mon Oct 17 10:52:01 EDT 2005)
From: |
Karl Berry |
Subject: |
texinfo update (Mon Oct 17 10:52:01 EDT 2005) |
Date: |
Mon, 17 Oct 2005 10:52:20 -0400 |
Index: doc/info.texi
===================================================================
RCS file: /cvsroot/texinfo/texinfo/doc/info.texi,v
retrieving revision 1.19
retrieving revision 1.20
diff -c -r1.19 -r1.20
*** doc/info.texi 19 Sep 2005 12:50:55 -0000 1.19
--- doc/info.texi 17 Oct 2005 14:36:00 -0000 1.20
***************
*** 72,99 ****
type the command @kbd{h} now. It brings you to a programmed
instruction sequence.
! To read about expert-level Info commands, type @kbd{n} twice. This
! brings you to @cite{Info for Experts}, skipping over the `Getting
Started' chapter.
@end ifinfo
@end ifnottex
@menu
* Getting Started:: Getting started using an Info reader.
* Expert Info:: Info commands for experts.
- * Creating an Info File:: How to make your own Info file.
* Index:: An index of topics, commands, and variables.
@end menu
! @node Getting Started, Expert Info, Top, Top
@comment node-name, next, previous, up
@chapter Getting Started
This first part of this 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 briefly explains how to generate Info files from
! Texinfo files.
@ifnotinfo
This manual is primarily designed for browsing with an Info reader
--- 72,99 ----
type the command @kbd{h} now. It brings you to a programmed
instruction sequence.
! To read about advanced Info commands, type @kbd{n} twice. This
! brings you to @cite{Advanced Info Commands}, skipping over the `Getting
Started' chapter.
@end ifinfo
@end ifnottex
@menu
* Getting Started:: Getting started using an Info reader.
+ * Advanced:: Advanced Info commands.
* Expert Info:: Info commands for experts.
* Index:: An index of topics, commands, and variables.
@end menu
! @node Getting Started, Advanced, Top, Top
@comment node-name, next, previous, up
@chapter Getting Started
This first part of this Info manual describes how to get around inside
of Info. The second part of the manual describes various advanced
! Info commands. The third part briefly explains how to generate Info
! files from Texinfo files, and describes how to write an Info file
! by hand.
@ifnotinfo
This manual is primarily designed for browsing with an Info reader
***************
*** 847,853 ****
There is also a short-cut Info command, @kbd{i}, which does all of
that for you. It searches the index for a given topic (a string) and
goes to the node which is listed in the index for that topic.
! @xref{Info Search}, for a full explanation.
@kindex l @r{(Info mode)}
@findex Info-history-back
--- 847,853 ----
There is also a short-cut Info command, @kbd{i}, which does all of
that for you. It searches the index for a given topic (a string) and
goes to the node which is listed in the index for that topic.
! @xref{Search Index}, for a full explanation.
@kindex l @r{(Info mode)}
@findex Info-history-back
***************
*** 905,949 ****
>> Now type @kbd{n} to see the last node of the course.
@end format
! @xref{Expert Info}, for more advanced Info features.
@c If a menu appears at the end of this node, remove it.
@c It is an accident of the menu updating command.
! @node Expert Info
! @chapter Info for Experts
! This chapter describes various Info commands for experts. (If you
are using a stand-alone Info reader, there are additional commands
specific to it, which are documented in several chapters of @ref{Top,,
GNU Info, info-stnd, GNU Info}.)
- This chapter also explains 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 to make a printed manual or produce other
- formats, such as HTML and DocBook, as well as for generating Info
- files.) @xref{Top,, Overview of Texinfo, texinfo, Texinfo: The GNU
- Documentation Format}.
-
@menu
! * Advanced:: Advanced Info commands: g, e, and 1 - 9.
! * Info Search:: How to search Info documents for specific subjects.
! * Add:: Describes how to add new nodes to the hierarchy.
! Also tells what nodes look like.
! * Menus:: How to add to or create menus in Info nodes.
! * Cross-refs:: How to add cross-references to Info nodes.
! * Tags:: How to make tags tables for Info files.
! * Checking:: Checking an Info File.
* Emacs Info Variables:: Variables modifying the behavior of Emacs Info.
@end menu
! @node Advanced, Info Search, , Expert Info
@comment node-name, next, previous, up
! @section Advanced Info Commands
! Here are some more Info commands that make it easier to move around.
! @subheading @kbd{g} goes to a node by name
@kindex g @r{(Info mode)}
@findex Info-goto-node
--- 905,1031 ----
>> Now type @kbd{n} to see the last node of the course.
@end format
! @xref{Advanced}, for more advanced Info features.
@c If a menu appears at the end of this node, remove it.
@c It is an accident of the menu updating command.
! @node Advanced
! @chapter Advanced Info Commands
! This chapter describes various advanced Info commands. (If you
are using a stand-alone Info reader, there are additional commands
specific to it, which are documented in several chapters of @ref{Top,,
GNU Info, info-stnd, GNU Info}.)
@menu
! * Search Text:: How to search Info documents.
! * Search Index:: How to search the indices for specific subjects.
! * Go to node:: How to go to a node by name.
! * Choose menu subtopic:: How to choose a menu subtopic by its number.
! * Create Info buffer:: How to create a new Info buffer in Emacs.
* Emacs Info Variables:: Variables modifying the behavior of Emacs Info.
@end menu
! @node Search Text, Search Index, , Advanced
! @comment node-name, next, previous, up
! @section How to search Info documents
!
! @cindex searching Info documents
! @cindex Info document as a reference
! The commands which move between and inside nodes allow you to read
! the entire manual or its large portions. But what if you need to find
! some information in the manual as fast as you can, and you don't know
! or don't remember in what node to look for it? This need arises when
! you use a manual as a @dfn{reference}, or when it is impractical to
! read the entire manual before you start using the programs it
! describes.
!
! Info has powerful searching facilities that let you find things
! quickly. You can search either the manual text or its indices.
!
! @kindex s @r{(Info mode)}
! @findex Info-search
! The @kbd{s} command allows you to search a whole Info file for a string.
! It switches to the next node if and when that is necessary. You
! type @kbd{s} followed by the string to search for, terminated by
! @key{RET}. To search for the same string again, just @kbd{s} followed
! by @key{RET} will do. The file's nodes are scanned in the order
! they are in the file, which has no necessary relationship to the
! order that they may be in the tree structure of menus and @samp{next}
! pointers. But normally the two orders are not very different. In any
! case, you can always look at the mode line to find out what node you have
! reached, if the header is not visible (this can happen, because @kbd{s}
! puts your cursor at the occurrence of the string, not at the beginning
! of the node).
!
! @kindex M-s @r{(Info mode)}
! In Emacs, @kbd{Meta-s} is equivalent to @kbd{s}. That is for
! compatibility with other GNU packages that use @kbd{M-s} for a similar
! kind of search command. Both @kbd{s} and @kbd{M-s} run in Emacs the
! command @code{Info-search}.
!
! @kindex C-s @r{(Info mode)}
! @kindex C-r @r{(Info mode)}
! @findex isearch
! Instead of using @kbd{s} in Emacs Info and in the stand-alone Info,
! you can use an incremental search started with @kbd{C-s} or @kbd{C-r}.
! It can search through multiple Info nodes. @xref{Incremental Search,,,
! emacs, The GNU Emacs Manual}. In Emacs, this behavior is enabled only
! if the variable @code{Info-isearch-search} is address@hidden
! (@pxref{Emacs Info Variables}).
!
! @node Search Index, Go to node, Search Text, Advanced
@comment node-name, next, previous, up
! @section How to search the indices for specific subjects
!
! @cindex searching Info indices
! @kindex i @r{(Info mode)}
! @findex Info-index
! Since most topics in the manual should be indexed, you should try
! the index search first before the text search. The @kbd{i} command
! prompts you for a subject and then looks up that subject in the
! indices. If it finds an index entry with the subject you typed, it
! goes to the node to which that index entry points. You should browse
! through that node to see whether the issue you are looking for is
! described there. If it isn't, type @kbd{,} one or more times to go
! through additional index entries which match your subject.
!
! The @kbd{i} command and subsequent @kbd{,} commands find all index
! entries which include the string you typed @emph{as a substring}.
! For each match, Info shows in the 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 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
! if you are not sure how they are spelled in the index. For example,
! suppose you want to find something that is pertinent to commands which
! complete partial input (e.g., when you type @key{TAB}). If you want
! to catch index entries that refer to ``complete'', ``completion'', and
! ``completing'', you could type @address@hidden
!
! Info documents which describe programs should index the commands,
! options, and key sequences that the program provides. If you are
! looking for a description of a command, an option, or a key, just type
! their names when @kbd{i} prompts you for a topic. For example, if you
! want to read the description of what the @kbd{C-l} key does, type
! @address@hidden literally.
!
! In Emacs, @kbd{i} runs the command @code{Info-index}.
! @findex info-apropos
! @findex index-apropos
! If you aren't sure which manual documents the topic you are looking
! for, try the @kbd{M-x info-apropos} command in Emacs, or the @kbd{M-x
! index-apropos} command in the stand-alone reader. It prompts for
! a string and then looks up that string in all the indices of all the
! Info documents installed on your system.
! @node Go to node, Choose menu subtopic, Search Index, Advanced
! @comment node-name, next, previous, up
! @section @kbd{g} goes to a node by name
@kindex g @r{(Info mode)}
@findex Info-goto-node
***************
*** 951,957 ****
If you know a node's name, you can go there by typing @kbd{g}, the
name, and @key{RET}. Thus, @address@hidden would go to the node
called @samp{Top} in this file. (This is equivalent to @kbd{t}, see
! @ref{Help-Int}.) @address@hidden would come back here.
@kbd{g} in Emacs runs the command @code{Info-goto-node}.
Unlike @kbd{m}, @kbd{g} does not allow the use of abbreviations.
--- 1033,1039 ----
If you know a node's name, you can go there by typing @kbd{g}, the
name, and @key{RET}. Thus, @address@hidden would go to the node
called @samp{Top} in this file. (This is equivalent to @kbd{t}, see
! @ref{Help-Int}.) @kbd{gGo to address@hidden would come back here.
@kbd{g} in Emacs runs the command @code{Info-goto-node}.
Unlike @kbd{m}, @kbd{g} does not allow the use of abbreviations.
***************
*** 969,975 ****
all of the current file by typing @address@hidden or all of any
other file with @kbd{g(@var{filename})address@hidden
! @subheading @address@hidden choose a menu subtopic by its number
@kindex 1 @r{through} 9 @r{(Info mode)}
@findex Info-nth-menu-item
--- 1051,1059 ----
all of the current file by typing @address@hidden or all of any
other file with @kbd{g(@var{filename})address@hidden
! @node Choose menu subtopic, Create Info buffer, Go to node, Advanced
! @comment node-name, next, previous, up
! @section @address@hidden choose a menu subtopic by its number
@kindex 1 @r{through} 9 @r{(Info mode)}
@findex Info-nth-menu-item
***************
*** 994,1015 ****
@kbd{m} instead, and specify the name, or use @key{TAB} to quickly
move between menu items.
! @subheading @kbd{e} makes Info document editable
!
! @kindex e @r{(Info mode)}
! @findex Info-edit
! @cindex edit Info document
! The Info command @kbd{e} changes from Info mode to an ordinary
! Emacs editing mode, so that you can edit the text of the current node.
! Type @kbd{C-c C-c} to switch back to Info. The @kbd{e} command is allowed
! only if the variable @code{Info-enable-edit} is address@hidden
!
! The @kbd{e} command only works in Emacs, where it runs the command
! @code{Info-edit}. The stand-alone Info reader doesn't allow you to
! edit the Info file, so typing @kbd{e} there goes to the end of the
! current node.
!
! @subheading @kbd{M-n} creates a new independent Info buffer in Emacs
@kindex M-n @r{(Info mode)}
@findex clone-buffer
--- 1078,1086 ----
@kbd{m} instead, and specify the name, or use @key{TAB} to quickly
move between menu items.
! @node Create Info buffer, Emacs Info Variables, Choose menu subtopic, Advanced
! @comment node-name, next, previous, up
! @section @kbd{M-n} creates a new independent Info buffer in Emacs
@kindex M-n @r{(Info mode)}
@findex clone-buffer
***************
*** 1031,1130 ****
switches to the Info buffer with that number. Thus, @kbd{C-u 2 C-h i}
switches to the buffer @samp{*info*<2>}, creating it if necessary.
! @node Info Search, Add, Advanced, Expert Info
@comment node-name, next, previous, up
! @section How to search Info documents for specific subjects
! @cindex searching Info documents
! @cindex Info document as a reference
! The commands which move between and inside nodes allow you to read
! the entire manual or its large portions. But what if you need to find
! some information in the manual as fast as you can, and you don't know
! or don't remember in what node to look for it? This need arises when
! you use a manual as a @dfn{reference}, or when it is impractical to
! read the entire manual before you start using the programs it
! describes.
! Info has powerful searching facilities that let you find things
! quickly. You can search either the manual indices or its text.
! @kindex i @r{(Info mode)}
! @findex Info-index
! Since most subjects related to what the manual describes should be
! indexed, you should try the index search first. The @kbd{i} command
! prompts you for a subject and then looks up that subject in the
! indices. If it finds an index entry with the subject you typed, it
! goes to the node to which that index entry points. You should browse
! through that node to see whether the issue you are looking for is
! described there. If it isn't, type @kbd{,} one or more times to go
! through additional index entries which match your subject.
! The @kbd{i} command finds all index entries which include the string
! you typed @emph{as a substring}. For each match, Info shows in the
! 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 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
! if you are not sure how they are spelled in the index. For example,
! suppose you want to find something that is pertinent to commands which
! complete partial input (e.g., when you type @key{TAB}). If you want
! to catch index entries that refer to ``complete'', ``completion'', and
! ``completing'', you could type @address@hidden
! Info documents which describe programs should index the commands,
! options, and key sequences that the program provides. If you are
! looking for a description of a command, an option, or a key, just type
! their names when @kbd{i} prompts you for a topic. For example, if you
! want to read the description of what the @kbd{C-f} key does, type
! @kbd{i C - f @key{RET}}. Here @kbd{C-f} are 3 literal characters
! @samp{C}, @samp{-}, and @samp{f}, not the ``Control-f'' command key
! you type inside Emacs to run the command bound to @kbd{C-f}.
! In Emacs, @kbd{i} runs the command @code{Info-index}.
! @findex info-apropos
! @findex index-apropos
! If you don't know what manual documents something, try the @kbd{M-x
! info-apropos} command in Emacs, or the @kbd{M-x index-apropos} command
! in the stand-alone reader. It prompts for a string and then looks up
! that string in all the indices of all the Info documents installed on
! your system.
! @kindex s @r{(Info mode)}
! @findex Info-search
! The @kbd{s} command allows you to search a whole file for a string.
! It switches to the next node if and when that is necessary. You
! type @kbd{s} followed by the string to search for, terminated by
! @key{RET}. To search for the same string again, just @kbd{s} followed
! by @key{RET} will do. The file's nodes are scanned in the order
! they are in the file, which has no necessary relationship to the
! order that they may be in the tree structure of menus and @samp{next}
! pointers. But normally the two orders are not very different. In any
! case, you can always look at the echo area to find out what node you have
! reached, if the header is not visible (this can happen, because @kbd{s}
! puts your cursor at the occurrence of the string, not at the beginning
! of the node).
! @kindex M-s @r{(Info mode)}
! In Emacs, @kbd{Meta-s} is equivalent to @kbd{s}. That is for
! compatibility with other GNU packages that use @kbd{M-s} for a similar
! kind of search command. Both @kbd{s} and @kbd{M-s} run in Emacs the
! command @code{Info-search}.
! @kindex C-s @r{(Info mode)}
! @kindex C-r @r{(Info mode)}
! @findex isearch
! Instead of using @kbd{s} in Emacs Info and in the stand-alone Info,
! you can use an incremental search started with @kbd{C-s} or @kbd{C-r}.
! It can search through multiple Info nodes. @xref{Incremental Search,,,
! emacs, The GNU Emacs Manual}. In Emacs, this behavior is enabled only
! if the variable @code{Info-isearch-search} is address@hidden
! (@pxref{Emacs Info Variables}).
! @node Add, Menus, Info Search, Expert Info
@comment node-name, next, previous, up
@section Adding a new node to Info
--- 1102,1228 ----
switches to the Info buffer with that number. Thus, @kbd{C-u 2 C-h i}
switches to the buffer @samp{*info*<2>}, creating it if necessary.
! @node Emacs Info Variables, , Create Info buffer, Advanced
@comment node-name, next, previous, up
! @section Emacs Info-mode Variables
! 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 @file{~/.emacs} init file. @xref{Examining, Examining and Setting
! Variables, Examining and Setting Variables, emacs, The GNU Emacs
! Manual}. The stand-alone Info reader program has its own set of
! variables, described in @ref{Variables,, Manipulating Variables,
! info-stnd, GNU Info}.
! @vtable @code
! @item Info-directory-list
! The list of directories to search for Info files. Each element is a
! string (directory name) or @code{nil} (try default directory). If not
! initialized Info uses the environment variable @env{INFOPATH} to
! initialize it, or @code{Info-default-directory-list} if there is no
! @env{INFOPATH} variable in the environment.
! If you wish to customize the Info directory search list for both Emacs
! Info and stand-alone Info, it is best to set the @env{INFOPATH}
! environment variable, since that applies to both programs.
! @item Info-additional-directory-list
! A list of additional directories to search for Info documentation files.
! These directories are not searched for merging the @file{dir} file.
! @item Info-mode-hook
! Hooks run when @code{Info-mode} is called. By default, it contains
! the hook @code{turn-on-font-lock} which enables highlighting of Info
! files. You can change how the highlighting looks by customizing the
! faces @code{info-node}, @code{info-xref}, @code{info-xref-visited},
! @code{info-header-xref}, @code{info-header-node}, @code{info-menu-header},
! @code{info-menu-star}, and @address@hidden (where @var{n}
! is the level of the section, a number between 1 and 4). To customize
! a face, type @kbd{M-x customize-face @key{RET} @var{face} @key{RET}},
! where @var{face} is one of the face names listed here.
! @item Info-fontify-maximum-menu-size
! Maximum size of menu to fontify if @code{font-lock-mode} is address@hidden
! @item Info-fontify-visited-nodes
! If address@hidden, menu items and cross-references pointing to visited
! nodes are displayed in the @code{info-xref-visited} face.
! @item Info-use-header-line
! If address@hidden, Emacs puts in the Info buffer a header line showing
! the @samp{Next}, @samp{Prev}, and @samp{Up} links. A header line does
! not scroll with the rest of the buffer, making these links always
! visible.
! @item Info-hide-note-references
! As explained in earlier nodes, the Emacs version of Info normally
! hides some text in menus and cross-references. You can completely
! disable this feature, by setting this option to @code{nil}. Setting
! it to a value that is neither @code{nil} nor @code{t} produces an
! intermediate behavior, hiding a limited amount of text, but showing
! all text that could potentially be useful.
! @item Info-scroll-prefer-subnodes
! If set to a address@hidden value, @key{SPC} and @key{BACKSPACE} (or
! @key{DEL}) keys in a menu visit subnodes of the current node before
! scrolling to its end or beginning, respectively. For example, if the
! node's menu appears on the screen, the next @key{SPC} moves to a
! subnode indicated by the following menu item. Setting this option to
! @code{nil} results in behavior similar to the stand-alone Info reader
! program, which visits the first subnode from the menu only when you
! hit the end of the current node. The default is @code{nil}.
! @item Info-isearch-search
! If address@hidden, isearch in Info searches through multiple nodes.
! @item Info-enable-active-nodes
! When set to a address@hidden value, allows Info to execute Lisp code
! associated with nodes. The Lisp code is executed when the node is
! selected. The Lisp code to be executed should follow the node
! delimiter (the @samp{DEL} character) and an @samp{execute: } tag, like
! this:
!
! @example
! ^_execute: (message "This is an active node!")
! @end example
! @end vtable
!
!
! @node Expert Info
! @chapter Info for Experts
!
! This chapter explains how to write an Info file by hand. However,
! in most cases, writing a Texinfo file is better, since you can use it
! to make a printed manual or produce other formats, such as HTML and
! DocBook, as well as for generating Info files.
!
! The @code{makeinfo} command converts a Texinfo file into an Info file;
! @code{texinfo-format-region} and @code{texinfo-format-buffer} are GNU
! Emacs functions that do the same.
!
! @xref{Top,, Overview of Texinfo, texinfo, Texinfo: The GNU
! Documentation Format}, for how to write a Texinfo file.
!
! @xref{Creating an Info File,,, texinfo, Texinfo: The GNU Documentation
! Format}, for how to create an Info file from a Texinfo file.
!
! @xref{Installing an Info File,,, texinfo, Texinfo: The GNU
! Documentation Format}, for how to install an Info file after you
! have created one.
!
! However, if you want to edit an Info file manually and install it manually,
! here is how.
!
! @menu
! * Add:: Describes how to add new nodes to the hierarchy.
! Also tells what nodes look like.
! * Menus:: How to add to or create menus in Info nodes.
! * Cross-refs:: How to add cross-references to Info nodes.
! * Tags:: How to make tags tables for Info files.
! * Checking:: Checking an Info File.
! @end menu
!
! @node Add, Menus, , Expert Info
@comment node-name, next, previous, up
@section Adding a new node to Info
***************
*** 1137,1150 ****
Put that topic in the menu in the directory. @xref{Menus, Menu}.
@end enumerate
- Usually, the way to create the nodes is with Texinfo (@pxref{Top,,
- Overview of Texinfo, texinfo, Texinfo: The GNU Documentation Format});
- this has the advantage that you can also make a printed manual or HTML
- from them. You would use the @samp{@@dircategory} and
- @samp{@@direntry} commands to put the manual into the Info directory.
- However, if you want to edit an Info file manually and install it
- manually, here is how.
-
@cindex node delimiters
The new node can live in an existing documentation file, or in a new
one. It must have a @samp{^_} character before it (invisible to the
--- 1235,1240 ----
***************
*** 1324,1330 ****
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}.
Yet another set of commands are meant for experienced users; you can
find them by looking in the Directory node for documentation on Info.
--- 1414,1420 ----
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{Advanced}.
Yet another set of commands are meant for experienced users; you can
find them by looking in the Directory node for documentation on Info.
***************
*** 1382,1389 ****
a @samp{DEL} character, and the character position in the file of the
beginning of the node.
!
! @node Checking, Emacs Info Variables, Tags, Expert Info
@section Checking an Info File
When creating an Info file, it is easy to forget the name of a node when
--- 1472,1478 ----
a @samp{DEL} character, and the character position in the file of the
beginning of the node.
! @node Checking, , Tags, Expert Info
@section Checking an Info File
When creating an Info file, it is easy to forget the name of a node when
***************
*** 1401,1512 ****
@findex Info-validate
To check an Info file, do @kbd{M-x Info-validate} while looking at any
node of the file with Emacs Info mode.
-
- @node Emacs Info Variables, , Checking, Expert Info
- @section Emacs Info-mode Variables
-
- 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 @file{~/.emacs} init file. @xref{Examining, Examining and Setting
- Variables, Examining and Setting Variables, emacs, The GNU Emacs
- Manual}. The stand-alone Info reader program has its own set of
- variables, described in @ref{Variables,, Manipulating Variables,
- info-stnd, GNU Info}.
-
- @vtable @code
- @item Info-directory-list
- The list of directories to search for Info files. Each element is a
- string (directory name) or @code{nil} (try default directory). If not
- initialized Info uses the environment variable @env{INFOPATH} to
- initialize it, or @code{Info-default-directory-list} if there is no
- @env{INFOPATH} variable in the environment.
-
- If you wish to customize the Info directory search list for both Emacs
- Info and stand-alone Info, it is best to set the @env{INFOPATH}
- environment variable, since that applies to both programs.
-
- @item Info-additional-directory-list
- A list of additional directories to search for Info documentation files.
- These directories are not searched for merging the @file{dir} file.
-
- @item Info-mode-hook
- Hooks run when @code{Info-mode} is called. By default, it contains
- the hook @code{turn-on-font-lock} which enables highlighting of Info
- files. You can change how the highlighting looks by customizing the
- faces @code{info-node}, @code{info-xref}, @code{info-xref-visited},
- @code{info-header-xref}, @code{info-header-node}, @code{info-menu-header},
- @code{info-menu-star}, and @address@hidden (where @var{n}
- is the level of the section, a number between 1 and 4). To customize
- a face, type @kbd{M-x customize-face @key{RET} @var{face} @key{RET}},
- where @var{face} is one of the face names listed here.
-
- @item Info-fontify-maximum-menu-size
- Maximum size of menu to fontify if @code{font-lock-mode} is address@hidden
-
- @item Info-fontify-visited-nodes
- If address@hidden, menu items and cross-references pointing to visited
- nodes are displayed in the @code{info-xref-visited} face.
-
- @item Info-use-header-line
- If address@hidden, Emacs puts in the Info buffer a header line showing
- the @samp{Next}, @samp{Prev}, and @samp{Up} links. A header line does
- not scroll with the rest of the buffer, making these links always
- visible.
-
- @item Info-hide-note-references
- As explained in earlier nodes, the Emacs version of Info normally
- hides some text in menus and cross-references. You can completely
- disable this feature, by setting this option to @code{nil}. Setting
- it to a value that is neither @code{nil} nor @code{t} produces an
- intermediate behavior, hiding a limited amount of text, but showing
- all text that could potentially be useful.
-
- @item Info-scroll-prefer-subnodes
- If set to a address@hidden value, @key{SPC} and @key{BACKSPACE} (or
- @key{DEL}) keys in a menu visit subnodes of the current node before
- scrolling to its end or beginning, respectively. For example, if the
- node's menu appears on the screen, the next @key{SPC} moves to a
- subnode indicated by the following menu item. Setting this option to
- @code{nil} results in behavior similar to the stand-alone Info reader
- program, which visits the first subnode from the menu only when you
- hit the end of the current node. The default is @code{nil}.
-
- @item Info-isearch-search
- If address@hidden, isearch in Info searches through multiple nodes.
-
- @item Info-enable-active-nodes
- When set to a address@hidden value, allows Info to execute Lisp code
- associated with nodes. The Lisp code is executed when the node is
- selected. The Lisp code to be executed should follow the node
- delimiter (the @samp{DEL} character) and an @samp{execute: } tag, like
- this:
-
- @example
- ^_execute: (message "This is an active node!")
- @end example
-
- @item Info-enable-edit
- Set to @code{nil}, disables the @samp{e} (@code{Info-edit}) command. A
- address@hidden value enables it. @xref{Add, Edit}.
- @end vtable
-
-
- @node Creating an Info File
- @chapter Creating an Info File from a Texinfo File
-
- @code{makeinfo} is a utility that converts a Texinfo file into an Info
- file; @code{texinfo-format-region} and @code{texinfo-format-buffer} are
- GNU Emacs functions that do the same.
-
- @xref{Top,, Overview of Texinfo, texinfo, Texinfo: The GNU
- Documentation Format}, to learn how to write a Texinfo file.
-
- @xref{Creating an Info File,,, texinfo, Texinfo: The GNU Documentation
- Format}, to learn how to create an Info file from a Texinfo file.
-
- @xref{Installing an Info File,,, texinfo, Texinfo: The GNU
- Documentation Format}, to learn how to install an Info file after you
- have created one.
@node Index
@unnumbered Index
--- 1490,1495 ----
Index: lib/strcasecmp.c
===================================================================
RCS file: /cvsroot/texinfo/texinfo/lib/strcasecmp.c,v
retrieving revision 1.4
retrieving revision 1.5
diff -c -r1.4 -r1.5
*** lib/strcasecmp.c 21 Sep 2005 12:30:36 -0000 1.4
--- lib/strcasecmp.c 17 Oct 2005 14:36:52 -0000 1.5
***************
*** 25,30 ****
--- 25,31 ----
#include "strcase.h"
#include <ctype.h>
+ #include <limits.h>
#if HAVE_MBRTOWC
# include "mbuiter.h"
***************
*** 93,98 ****
}
while (c1 == c2);
! return c1 - c2;
}
}
--- 94,105 ----
}
while (c1 == c2);
! if (UCHAR_MAX <= INT_MAX)
! return c1 - c2;
! else
! /* On machines where 'char' and 'int' are types of the same size, the
! difference of two 'unsigned char' values - including the sign bit -
! doesn't fit in an 'int'. */
! return (c1 > c2 ? 1 : c1 < c2 ? -1 : 0);
}
}
Index: lib/strncasecmp.c
===================================================================
RCS file: /cvsroot/texinfo/texinfo/lib/strncasecmp.c,v
retrieving revision 1.2
retrieving revision 1.3
diff -c -r1.2 -r1.3
*** lib/strncasecmp.c 21 Sep 2005 12:30:36 -0000 1.2
--- lib/strncasecmp.c 17 Oct 2005 14:36:52 -0000 1.3
***************
*** 1,5 ****
/* strncasecmp.c -- case insensitive string comparator
! Copyright (C) 1998, 1999 Free Software Foundation, Inc.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
--- 1,5 ----
/* strncasecmp.c -- case insensitive string comparator
! Copyright (C) 1998, 1999, 2005 Free Software Foundation, Inc.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
***************
*** 23,28 ****
--- 23,29 ----
#include "strcase.h"
#include <ctype.h>
+ #include <limits.h>
#define TOLOWER(Ch) (isupper (Ch) ? tolower (Ch) : (Ch))
***************
*** 54,58 ****
}
while (c1 == c2);
! return c1 - c2;
}
--- 55,65 ----
}
while (c1 == c2);
! if (UCHAR_MAX <= INT_MAX)
! return c1 - c2;
! else
! /* On machines where 'char' and 'int' are types of the same size, the
! difference of two 'unsigned char' values - including the sign bit -
! doesn't fit in an 'int'. */
! return (c1 > c2 ? 1 : c1 < c2 ? -1 : 0);
}
P doc/info.texi
P lib/strcasecmp.c
P lib/strncasecmp.c
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- texinfo update (Mon Oct 17 10:52:01 EDT 2005),
Karl Berry <=