texinfo.texi

gcc-2.95.3 Linux下最常用的C编译器

encyclopedia or it may be free form.@refill

@item 6. End
The @dfn{End} contains commands for printing indices and generating
the table of contents, and the @code{@@bye} command on a line of its
own.@refill
@end table

@node Short Sample, Acknowledgements, Six Parts, Overview
@comment  node-name,  next,  previous,  up
@section A Short Sample Texinfo File
@cindex Sample Texinfo file

Here is a complete but very short Texinfo file, in six parts.  The first
three parts of the file, from @samp{\input texinfo} through to
@samp{@@end titlepage}, look more intimidating than they are.  Most of
the material is standard boilerplate; when you write a manual, simply
insert the names for your own manual in this segment. (@xref{Beginning a
File}.)@refill

@noindent
In the following, the sample text is @emph{indented}; comments on it are
not.  The complete file, without any comments, is shown in
@ref{Sample Texinfo File}.

@subheading Part 1: Header

@noindent
The header does not appear in either the Info file or the
printed output.  It sets various parameters, including the
name of the Info file and the title used in the header.

@example
@group
\input texinfo   @@c -*-texinfo-*-
@@c %**start of header
@@setfilename sample.info
@@settitle Sample Document
@@c %**end of header

@@setchapternewpage odd
@end group
@end example

@subheading Part 2: Summary Description and Copyright

@noindent
The summary description and copyright segment does not
appear in the printed document.

@example
@group
@@ifinfo
This is a short example of a complete Texinfo file.

Copyright @@copyright@{@} 1990 Free Software Foundation, Inc.
@@end ifinfo
@end group
@end example

@subheading Part 3: Titlepage and Copyright

@noindent
The titlepage segment does not appear in the Info file.

@example
@group
@@titlepage
@@sp 10
@@comment The title is printed in a large font.
@@center @@titlefont@{Sample Title@}
@end group

@group
@@c The following two commands start the copyright page.
@@page
@@vskip 0pt plus 1filll
Copyright @@copyright@{@} 1990 Free Software Foundation, Inc.
@@end titlepage
@end group
@end example

@subheading Part 4: `Top' Node and Master Menu

@noindent
The `Top' node contains the master menu for the Info file.
Since a printed manual uses a table of contents rather than
a menu, the master menu appears only in the Info file.

@example
@group
@@node    Top,       First Chapter, ,         (dir)
@@comment node-name, next,          previous, up
@end group
@end example

@example
@group
@@menu
* First Chapter::    The first chapter is the
                     only chapter in this sample.
* Concept Index::    This index has two entries.
@@end menu
@end group
@end example

@subheading Part 5:  The Body of the Document

@noindent
The body segment contains all the text of the document, but not the
indices or table of contents.  This example illustrates a node and a
chapter containing an enumerated list.@refill

@example
@group
@@node    First Chapter, Concept Index, Top,      Top
@@comment node-name,     next,          previous, up
@@chapter First Chapter
@@cindex Sample index entry
@end group

@group
This is the contents of the first chapter.
@@cindex Another sample index entry
@end group

@group
Here is a numbered list.

@@enumerate
@@item
This is the first item.

@@item
This is the second item.
@@end enumerate
@end group

@group
The @@code@{makeinfo@} and @@code@{texinfo-format-buffer@}
commands transform a Texinfo file such as this into
an Info file; and @@TeX@{@} typesets it for a printed
manual.
@end group
@end example

@subheading Part 6: The End of the Document

@noindent
The end segment contains commands both for generating an index in a node
and unnumbered chapter of its own and for generating the table of
contents; and it contains the @code{@@bye} command that marks the end of
the document.@refill

@example
@group
@@node    Concept Index,    ,  First Chapter, Top
@@comment node-name,    next,  previous,      up
@@unnumbered Concept Index
@end group

@group
@@printindex cp

@@contents
@@bye
@end group
@end example

@subheading The Results

Here is what the contents of the first chapter of the sample look like:

@sp 1
@need 700
@quotation
This is the contents of the first chapter.

Here is a numbered list.

@enumerate
@item
This is the first item.

@item
This is the second item.
@end enumerate

The @code{makeinfo} and @code{texinfo-format-buffer}
commands transform a Texinfo file such as this into
an Info file; and @TeX{} typesets it for a printed
manual.
@end quotation

@node Acknowledgements,  , Short Sample, Overview
@comment  node-name,  next,  previous,  up
@section Acknowledgements

@cindex Stallman, Richard M.
@cindex Chassell, Robert J.
@cindex Berry, Karl
Richard M.@: Stallman wrote Edition 1.0 of this manual.  @w{Robert J.@:
Chassell} revised and extended it, starting with Edition 1.1.  Karl
Berry made updates for the Texinfo 3.8 and subsequent releases, starting
with Edition 2.22.

@cindex Pinard, Fran@,{c}ois
@cindex Zuhn, David D.
@cindex Weisshaus, Melissa
Our thanks go out to all who helped improve this work, particularly to
Fran@,{c}ois Pinard and @w{David D.@: Zuhn}, who tirelessly recorded and
reported mistakes and obscurities; our special thanks go to Melissa
Weisshaus for her frequent and often tedious reviews of nearly similar
editions.  Our mistakes are our own.

Please send suggestions and corrections to:

@example
@group
@r{Internet address:}
    bug-texinfo@@prep.ai.mit.edu
@end group
@end example

@noindent
Please include the manual's edition number and update date in your messages.

@node Texinfo Mode, Beginning a File, Overview, Top
@comment  node-name,  next,  previous,  up
@chapter Using Texinfo Mode
@cindex Texinfo mode
@cindex Mode, using Texinfo
@cindex GNU Emacs
@cindex Emacs

You may edit a Texinfo file with any text editor you choose.  A Texinfo
file is no different from any other @sc{ascii} file.  However, GNU Emacs
comes with a special mode, called Texinfo
mode, that provides  Emacs commands and tools to help ease your work.@refill

This chapter describes features of GNU Emacs' Texinfo mode but not any
features of the Texinfo formatting language.  If you are reading this
manual straight through from the beginning, you may want to skim through
this chapter briefly and come back to it after reading succeeding
chapters which describe the Texinfo formatting language in
detail.@refill

@menu
* Texinfo Mode Overview::       How Texinfo mode can help you.
* Emacs Editing::               Texinfo mode adds to GNU Emacs' general
                                  purpose editing features.
* Inserting::                   How to insert frequently used @@-commands.
* Showing the Structure::       How to show the structure of a file.
* Updating Nodes and Menus::    How to update or create new nodes and menus.
* Info Formatting::             How to format for Info.
* Printing::                    How to format and print part or all of a file.
* Texinfo Mode Summary::        Summary of all the Texinfo mode commands.
@end menu

@node Texinfo Mode Overview, Emacs Editing, Texinfo Mode, Texinfo Mode
@ifinfo
@heading Texinfo Mode Overview
@end ifinfo

Texinfo mode provides special features for working with Texinfo
files:@refill

@itemize @bullet
@item
Insert frequently used @@-commands. @refill

@item
Automatically create @code{@@node} lines.

@item
Show the structure of a Texinfo source file.@refill

@item
Automatically create or update the `Next',
`Previous', and `Up' pointers of a node.

@item
Automatically create or update menus.@refill

@item
Automatically create a master menu.@refill

@item
Format a part or all of a file for Info.@refill

@item
Typeset and print part or all of a file.@refill
@end itemize

Perhaps the two most helpful features are those for inserting frequently
used @@-commands and for creating node pointers and menus.@refill

@node Emacs Editing, Inserting, Texinfo Mode Overview, Texinfo Mode
@section The Usual GNU Emacs Editing Commands

In most cases, the usual Text mode commands work the same in Texinfo
mode as they do in Text mode.  Texinfo mode adds new editing commands
and tools to GNU Emacs' general purpose editing features.  The major
difference concerns filling.  In Texinfo mode, the paragraph
separation variable and syntax table are redefined so that Texinfo
commands that should be on lines of their own are not inadvertently
included in paragraphs.  Thus, the @kbd{M-q} (@code{fill-paragraph})
command will refill a paragraph but not mix an indexing command on a
line adjacent to it into the paragraph.@refill

In addition, Texinfo mode sets the @code{page-delimiter} variable to
the val