# HG changeset patch # User Richard M. Stallman # Date 982552537 0 # Node ID 32fc1ec135742ab3aa2292d2be8d0a610d088451 # Parent 1f5dd1c73a2ab2f654c465b673652f28db5fac38 Move the Refill Mode node. Move the TeX mode miscellany to a new node. Clean up the Foldout node. Other minor changes. diff -r 1f5dd1c73a2a -r 32fc1ec13574 man/text.texi --- a/man/text.texi Mon Feb 19 02:26:38 2001 +0000 +++ b/man/text.texi Mon Feb 19 03:15:37 2001 +0000 @@ -50,7 +50,7 @@ @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 @@ -388,11 +388,11 @@ @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. * Adaptive Fill:: How Emacs can determine the fill prefix automatically. -* Refill:: Keeping paragraphs filled. @end menu @node Auto Fill @@ -453,6 +453,25 @@ 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 @@ -534,10 +553,10 @@ fill commands put two spaces after a colon. @vindex sentence-end-without-period -The variable @code{sentence-end-without-period} can be set -non-@code{nil} to indicate that a sentence will end without a period. -For example, a sentence in Thai text ends with double space but without -a 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 @@ -699,25 +718,6 @@ line. If it returns @code{nil}, that means it sees no fill prefix in that line. -@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 Case @section Case Conversion Commands @cindex case conversion @@ -962,12 +962,12 @@ 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 @@ -1149,28 +1149,23 @@ buffers. @node Foldout -@subsection Folding editing +@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 + 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. -@noindent -Folding editing works as follows. - -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 @@ -1178,7 +1173,7 @@ 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 @@ -1186,65 +1181,76 @@ 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 provides mouse bindings for entering and exiting folds and for -showing and hiding text as follows: + Foldout mode also provides mouse commands for entering and exiting +folds, and for showing and hiding text: + @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 @@ -1285,61 +1291,11 @@ 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}. - -@findex iso-iso2tex -@findex iso-tex2iso -@findex iso-iso2gtex -@findex iso-gtex2iso -@cindex Latin-1 @TeX{} encoding -@TeX{} encoding -@vindex format-alist -@findex format-find-file -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. They are included -by default in the @code{format-alist} variable, and so an be used with -@kbd{M-x format-find-file}, for instance. - -@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} can -be used to insert missing @samp{~} @dfn{tie} characters which should be -present in the file to represent `hard spaces'. This is set up for -Czech---customize the group @samp{tildify} for other languages or for -other sorts of markup; there is support for SGML (HTML). - -@cindex RefTeX 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}. - -@cindex Bib@TeX{} mode -@cindex mode, Bib@TeX{} -@pindex bibtex -@findex bibtex-mode -There is also a mode for editing files for the Bib@TeX{} bibliography -program often used with La@TeX{}. - @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 @@ -1630,6 +1586,57 @@ @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. +@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 +@vindex format-alist +@findex format-find-file + 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 @@ -1805,7 +1812,7 @@ 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.