@xref{Formatted Text}.
@end iftex
- The `automatic typing' features may be useful when writing text.
+ The ``automatic typing'' features may be useful when writing text.
@xref{Top, Autotyping, autotype, Features for Automatic Typing}.
@menu
not the comma and the space, use @kbd{M-b M-d} instead of
@kbd{M-@key{DEL}}.)
-@kindex M-t
-@findex transpose-words
+@c Don't index M-t and transpose-words here, they are indexed in
+@c fixit.texi, in the node "Transpose".
+@c @kindex M-t
+@c @findex transpose-words
@kbd{M-t} (@code{transpose-words}) exchanges the word before or
containing point with the following word. The delimiter characters between
the words do not move. For example, @w{@samp{FOO, BAR}} transposes into
@menu
* Auto Fill:: Auto Fill mode breaks long lines automatically.
+* Refill:: Keeping paragraphs filled.
* Fill Commands:: Commands to refill paragraphs and center lines.
* Fill Prefix:: Filling paragraphs that are indented
or in a comment, etc.
The section on init files says how to arrange this permanently for yourself.
@xref{Init File}.
+@node Refill
+@subsection Refill Mode
+@cindex refilling text, word processor style
+@cindex modes, Refill
+@cindex Refill minor mode
+
+ Refill minor mode provides support for keeping paragraphs filled as
+you type or modify them in other ways. It provides an effect similar
+to typical word processor behaviour. This works by running a
+paragraph-filling command at suitable times.
+
+ When you are typing text, only characters which normally trigger
+auto filling, like the space character, will trigger refilling. This
+is to avoid making it too slow. Apart from self-inserting characters,
+other commands which modify the text cause refilling.
+
+ The current implementation is preliminary and probably not robust.
+We expect to improve on it.
+
@node Fill Commands
@subsection Explicit Fill Commands
If the variable @code{colon-double-space} is non-@code{nil}, the
fill commands put two spaces after a colon.
+@vindex sentence-end-without-period
+ Some languages do not use period to indicate end of sentence. For
+example, a sentence in Thai text ends with double space but without a
+period. Set the variable @code{sentence-end-without-period} to
+@code{t} to tell the sentence commands that a period is not necessary.
+
@node Fill Prefix
@subsection The Fill Prefix
@section Outline Mode
@cindex Outline mode
@cindex mode, Outline
-@cindex selective display
@cindex invisible lines
@findex outline-mode
This works as long as no other command starts with @samp{@@chap}.
@vindex outline-level
- It is possible to change the rule for calculating the level of a
-heading line by setting the variable @code{outline-level}. The value of
+ You can change the rule for calculating the level of a heading line
+by setting the variable @code{outline-level}. The value of
@code{outline-level} should be a function that takes no arguments and
returns the level of the current heading. Some major modes such as C,
-Nroff, and Emacs Lisp mode set this variable and/or
-@code{outline-regexp} in order to work with Outline minor mode.
+Nroff, and Emacs Lisp mode set this variable and @code{outline-regexp}
+in order to work with Outline minor mode.
@node Outline Motion
@subsection Outline Motion Commands
buffers.
@node Foldout
-@subsection Folding editing with Foldout
+@subsection Folding Editing
@cindex folding editing
-The Foldout package provides folding editor extensions for Outline mode
-and Outline minor mode. It may be used by putting in your @file{.emacs}
-@example
-(eval-after-load "outline" '(require 'foldout))
-@end example
-Folding editing works as follows.
+ The Foldout package extends Outline mode and Outline minor mode with
+``folding'' commands. The idea of folding is that you zoom in on a
+nested portion of the outline, while hiding its relatives at higher
+levels.
-Consider an Outline mode buffer all the text and subheadings under
+ Consider an Outline mode buffer all the text and subheadings under
level-1 headings hidden. To look at what is hidden under one of these
-headings normally you would use @kbd{C-c C-e} (@kbd{M-x show-entry}) to
-expose the body or @kbd{C-c C-i} to expose the child (level-2) headings.
+headings, you could use @kbd{C-c C-e} (@kbd{M-x show-entry}) to expose
+the body, or @kbd{C-c C-i} to expose the child (level-2) headings.
@kindex C-c C-z
@findex foldout-zoom-subtree
-With Foldout, you use @kbd{C-c C-z} (@kbd{M-x foldout-zoom-subtree}).
-This exposes the body and child subheadings and narrows the buffer so
+ With Foldout, you use @kbd{C-c C-z} (@kbd{M-x foldout-zoom-subtree}).
+This exposes the body and child subheadings, and narrows the buffer so
that only the level-1 heading, the body and the level-2 headings are
visible. Now to look under one of the level-2 headings, position the
cursor on it and use @kbd{C-c C-z} again. This exposes the level-2 body
in on successive subheadings can be done as much as you like. A string
in the modeline shows how deep you've gone.
-When zooming in on a heading, to see only the child subheadings specify
+ When zooming in on a heading, to see only the child subheadings specify
a numeric argument: @kbd{C-u C-c C-z}. The number of levels of children
can be specified too (compare @kbd{M-x show-children}), e.g.@: @kbd{M-2
C-c C-z} exposes two levels of child subheadings. Alternatively, the
whole subtree can be expanded, similarly to @kbd{C-c C-s} (@kbd{M-x
show-subtree}), by specifying a zero argument: @kbd{M-0 C-c C-z}.
-While you're zoomed in you can still use outline-mode's exposure and
+ While you're zoomed in, you can still use Outline mode's exposure and
hiding functions without disturbing Foldout. Also, since the buffer is
-narrowed, `global' editing actions will only affect text under the
+narrowed, ``global'' editing actions will only affect text under the
zoomed-in heading. This is useful for restricting changes to a
particular chapter or section of your document.
@kindex C-c C-x
@findex foldout-exit-fold
-Unzoom (exit) a fold using @kbd{C-c C-x} (@kbd{M-x foldout-exit-fold}).
+ To unzoom (exit) a fold, use @kbd{C-c C-x} (@kbd{M-x foldout-exit-fold}).
This hides all the text and subheadings under the top-level heading and
returns you to the previous view of the buffer. Specifying a numeric
-argument exits that many folds. Specifying a zero argument exits all
+argument exits that many levels of folds. Specifying a zero argument exits all
folds.
-You might want to exit a fold without hiding the text and subheadings,
-specify a negative argument. For example, @kbd{M--2 C-c C-x} exits two
-folds and leaves the text and subheadings exposed.
+ To cancel the narrowing of a fold without hiding the text and
+subheadings, specify a negative argument. For example, @kbd{M--2 C-c
+C-x} exits two folds and leaves the text and subheadings exposed.
+
+ Foldout mode also provides mouse commands for entering and exiting
+folds, and for showing and hiding text:
-Foldout provides mouse bindings for entering and exiting folds and for
-showing and hiding text as follows:
@table @asis
-@item @kbd{M-C-mouse-1} zooms in on the heading clicked on
+@item @kbd{M-C-Mouse-1} zooms in on the heading clicked on
@table @asis
@item single click
-expose body
+expose body.
@item double click
-expose subheadings
+expose subheadings.
@item triple click
-expose body and subheadings
+expose body and subheadings.
@item quad click
-expose entire subtree
+expose entire subtree.
@end table
-@item @kbd{M-C-mouse-2} exposes text under the heading clicked on
+@item @kbd{M-C-Mouse-2} exposes text under the heading clicked on
@table @r
@item single click
-expose body
+expose body.
@item double click
-expose subheadings
+expose subheadings.
@item triple click
-expose body and subheadings
+expose body and subheadings.
@item quad click
-expose entire subtree
+expose entire subtree.
@end table
-@item @kbd{M-C-mouse-3} hides text under the heading clicked on or exits fold
+@item @kbd{M-C-Mouse-3} hides text under the heading clicked on or exits fold
@table @r
@item single click
-hide subtree
+hide subtree.
@item double click
-exit fold and hide text
+exit fold and hide text.
@item triple click
-exit fold without hiding text
+exit fold without hiding text.
@item quad click
-exit all folds and hide text
+exit all folds and hide text.
@end table
@end table
@vindex foldout-mouse-modifiers
-You can change the modifier keys used by setting
-@code{foldout-mouse-modifiers}.
+ You can specify different modifier keys (instead of
+@kbd{Control-Meta-}) by setting @code{foldout-mouse-modifiers}; but if
+you have already loaded the @file{foldout.el} library, you must reload
+it in order for this to take effect.
+
+ To use the Foldout package, you can type @kbd{M-x load-library
+@key{RET} foldout @key{RET}}; or you can arrange for to do that
+automatically by putting this in your @file{.emacs} file:
+
+@example
+(eval-after-load "outline" '(require 'foldout))
+@end example
@node TeX Mode, Nroff Mode, Outline Mode, Text
@section @TeX{} Mode
@TeX{} is a powerful text formatter written by Donald Knuth; it is also
free, like GNU Emacs. La@TeX{} is a simplified input format for @TeX{},
implemented by @TeX{} macros; it comes with @TeX{}. Sli@TeX{} is a special
-form of La@TeX{}.@refill
+form of La@TeX{}.@footnote{Sli@TeX{} is obsoleted by the @samp{slides}
+document class in recent La@TeX{} versions.}
Emacs has a special @TeX{} mode for editing @TeX{} input files.
It provides facilities for checking the balance of delimiters and for
slitex-mode} to select explicitly the particular variants of @TeX{}
mode.
-@vindex tex-shell-hook
-@vindex tex-mode-hook
-@vindex latex-mode-hook
-@vindex slitex-mode-hook
-@vindex plain-tex-mode-hook
- Entering any kind of @TeX{} mode runs the hooks @code{text-mode-hook}
-and @code{tex-mode-hook}. Then it runs either
-@code{plain-tex-mode-hook} or @code{latex-mode-hook}, whichever is
-appropriate. For Sli@TeX{} files, it calls @code{slitex-mode-hook}.
-Starting the @TeX{} shell runs the hook @code{tex-shell-hook}.
-@xref{Hooks}.
-
@menu
* Editing: TeX Editing. Special commands for editing in TeX mode.
* LaTeX: LaTeX Editing. Additional commands for LaTeX input files.
* Printing: TeX Print. Commands for printing part of a file with TeX.
+* Misc: TeX Misc. Customization of TeX mode, and related features.
@end menu
@node TeX Editing
@kbd{C-c TAB} (@code{tex-bibtex-file}), and then repeat @kbd{C-c C-f}
(@code{tex-file}) twice more to get the cross-references correct.
- For managing all kinds of references, you can use Ref@TeX{}.
-@xref{Top, , RefTeX, reftex}.
+@node TeX Misc
+@subsection @TeX{} Mode Miscellany
+
+@vindex tex-shell-hook
+@vindex tex-mode-hook
+@vindex latex-mode-hook
+@vindex slitex-mode-hook
+@vindex plain-tex-mode-hook
+ Entering any variant of @TeX{} mode runs the hooks
+@code{text-mode-hook} and @code{tex-mode-hook}. Then it runs either
+@code{plain-tex-mode-hook}, @code{latex-mode-hook}, or
+@code{slitex-mode-hook}, whichever is appropriate. Starting the
+@TeX{} shell runs the hook @code{tex-shell-hook}. @xref{Hooks}.
+
+@findex iso-iso2tex
+@findex iso-tex2iso
+@findex iso-iso2gtex
+@findex iso-gtex2iso
+@cindex Latin-1 @TeX{} encoding
+@TeX{} encoding
+ The commands @kbd{M-x iso-iso2tex}, @kbd{M-x iso-tex2iso}, @kbd{M-x
+iso-iso2gtex} and @kbd{M-x iso-gtex2iso} can be used to convert
+between Latin-1 encoded files and @TeX{}-encoded equivalents.
+@ignore
+@c Too cryptic to be useful, too cryptic for me to make it better -- rms.
+ They
+are included by default in the @code{format-alist} variable, so they
+can be used with @kbd{M-x format-find-file}, for instance.
+@end ignore
+
+@ignore @c Not worth documenting if it is only for Czech -- rms.
+@findex tildify-buffer
+@findex tildify-region
+@cindex ties, @TeX{}, inserting
+@cindex hard spaces, @TeX{}, inserting
+@cindex SGML
+@cindex HTML
+ The commands @kbd{M-x tildify-buffer} and @kbd{M-x tildify-region}
+insert @samp{~} (@dfn{tie}) characters where they are conventionally
+required. This is set up for Czech---customize the group
+@samp{tildify} for other languages or for other sorts of markup.
+@end ignore
+
+@cindex Ref@TeX{} package
+@cindex references, La@TeX{}
+@cindex La@TeX{} references
+ For managing all kinds of references for La@TeX{}, you can use
+Ref@TeX{}. @xref{Top, , RefTeX, reftex}.
@node Nroff Mode
@section Nroff Mode
can also use it with other major modes such as Outline mode and
Paragraph-Indent Text mode.
+@cindex text/enriched MIME format
Potentially, Emacs can store formatted text files in various file
formats. Currently, only one format is implemented: @dfn{text/enriched}
format, which is defined by the MIME protocol. @xref{Format
The easiest way to add properties to your document is by using the Text
Properties menu. You can get to this menu in two ways: from the Edit
-menu in the menu bar, or with @kbd{C-mouse-2} (hold the @key{CTRL} key
+menu in the menu bar, or with @kbd{C-Mouse-2} (hold the @key{CTRL} key
and press the middle mouse button).
Most of the items in the Text Properties menu lead to other submenus.
HCoop / bpt / emacs.git / blobdiff