home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Fresh Fish 4
/
FreshFish_May-June1994.bin
/
gnu
/
info
/
texi.info-2
(
.txt
)
< prev
next >
Wrap
GNU Info File
|
1994-02-24
|
51KB
|
975 lines
This is Info file texi.info, produced by Makeinfo-1.55 from the input
file texi.texi.
This file documents Texinfo, a documentation system that uses a
single source file to produce both on-line information and a printed
manual.
Copyright (C) 1988, 1990, 1991, 1992, 1993 Free Software Foundation,
This is the second edition of the Texinfo documentation,
and is consistent with version 2 of `texinfo.tex'.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of
this manual under the conditions for verbatim copying, provided that
the entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be stated in a
translation approved by the Free Software Foundation.
File: texi.info, Node: Texinfo Mode, Next: Beginning a File, Prev: Overview, Up: Top
Using Texinfo Mode
******************
You may edit a Texinfo file with any text editor you choose. A
Texinfo file is no different from any other ASCII file. However, GNU
Emacs comes with a special mode, called Texinfo mode, that provides
Emacs commands and tools to help ease your work.
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.
* 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.
File: texi.info, Node: Texinfo Mode Overview, Next: Emacs Editing, Up: Texinfo Mode
Texinfo Mode Overview
=====================
Texinfo mode provides special features for working with Texinfo
files:
* Insert frequently used @commands.
* Automatically create `@node' lines.
* Show the structure of a Texinfo source file.
* Automatically create or update the `Next',
`Previous', and `Up' pointers of a node.
* Automatically create or update menus.
* Automatically create a master menu.
* Format a part or all of a file for Info.
* Typeset and print part or all of a file.
Perhaps the two most helpful features are those for inserting
frequently used @-commands and for creating node pointers and menus.
File: texi.info, Node: Emacs Editing, Next: Inserting, Prev: Texinfo Mode Overview, Up: Texinfo Mode
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 `M-q' (`fill-paragraph') command will refill a
paragraph but not mix an indexing command on a line adjacent to it into
the paragraph.
In addition, Texinfo mode sets the `page-delimiter' variable to the
value of `texinfo-chapter-level-regexp'; by default, this is a regular
expression matching the commands for chapters and their equivalents,
such as appendices. With this value for the page delimiter, you can
jump from chapter title to chapter title with the `C-x ]'
(`forward-page') and `C-x [' (`backward-page') commands and narrow to a
chapter with the `C-x p' (`narrow-to-page') command. (*Note Pages:
(emacs)Pages, for details about the page commands.)
You may name a Texinfo file however you wish, but the convention is
to end a Texinfo file name with one of the three extensions `.texinfo',
`.texi', or `.tex'. A longer extension is preferred, since it is
explicit, but a shorter extension may be necessary for operating
systems that limit the length of file names. GNU Emacs automatically
enters Texinfo mode when you visit a file with a `.texinfo' or `.texi'
extension. Also, Emacs switches to Texinfo mode when you visit a file
that has `-*-texinfo-*-' in its first line. If ever you are in another
mode and wish to switch to Texinfo mode, type `M-x texinfo-mode'.
Like all other Emacs features, you can customize or enhance Texinfo
mode as you wish. In particular, the keybindings are very easy to
change. The keybindings described here are the default or standard
ones.
File: texi.info, Node: Inserting, Next: Showing the Structure, Prev: Emacs Editing, Up: Texinfo Mode
Inserting Frequently Used Commands
==================================
Texinfo mode provides commands to insert various frequently used
@-commands into the buffer. You can use these commands to save
keystrokes.
The insert commands are invoked by typing `C-c' twice and then the
first letter of the @-command:
`C-c C-c c'
`M-x texinfo-insert-@code'
Insert `@code{}' and put the cursor between the braces.
`C-c C-c d'
`M-x texinfo-insert-@dfn'
Insert `@dfn{}' and put the cursor between the braces.
`C-c C-c e'
`M-x texinfo-insert-@end'
Insert `@end' and attempt to insert the correct following word,
such as `example' or `table'. (This command does not handle
nested lists correctly, but inserts the word appropriate to the
immediately preceding list.)
`C-c C-c i'
`M-x texinfo-insert-@item'
Insert `@item' and put the cursor at the beginning of the next
line.
`C-c C-c k'
`M-x texinfo-insert-@kbd'
Insert `@kbd{}' and put the cursor between the braces.
`C-c C-c n'
`M-x texinfo-insert-@node'
Insert `@node' and a comment line listing the sequence for the
`Next', `Previous', and `Up' nodes. Leave point after the `@node'.
`C-c C-c o'
`M-x texinfo-insert-@noindent'
Insert `@noindent' and put the cursor at the beginning of the next
line.
`C-c C-c s'
`M-x texinfo-insert-@samp'
Insert `@samp{}' and put the cursor between the braces.
`C-c C-c t'
`M-x texinfo-insert-@table'
Insert `@table' followed by a SPC and leave the cursor after the
SPC.
`C-c C-c v'
`M-x texinfo-insert-@var'
Insert `@var{}' and put the cursor between the braces.
`C-c C-c x'
`M-x texinfo-insert-@example'
Insert `@example' and put the cursor at the beginning of the next
line.
`C-c C-c {'
`M-x texinfo-insert-braces'
Insert `{}' and put the cursor between the braces.
`C-c C-c }'
`C-c C-c ]'
`M-x up-list'
Move from between a pair of braces forward past the closing brace.
Typing `C-c C-c ]' is easier than typing `C-c C-c }', which is,
however, more mnemonic; hence the two keybindings. (Also, you can
move out from between braces by typing `C-f'.)
To put a command such as `@code{...}' around an *existing* word,
position the cursor in front of the word and type `C-u 1 C-c C-c c'.
This makes it easy to edit existing plain text. The value of the
prefix argument tells Emacs how many words following point to include
between braces--1 for one word, 2 for two words, and so on. Use a
negative argument to enclose the previous word or words. If you do not
specify a prefix argument, Emacs inserts the @-command string and
positions the cursor between the braces. This feature works only for
those @-commands that operate on a word or words within one line, such
as `@kbd