(Text Mode): ESC TAB alternative for M-TAB.
[bpt/emacs.git] / man / text.texi
index b061858..7b262e1 100644 (file)
@@ -185,9 +185,9 @@ Kill back to the beginning of the sentence (@code{backward-kill-sentence}).
   The commands @kbd{M-a} and @kbd{M-e} (@code{backward-sentence} and
 @code{forward-sentence}) move to the beginning and end of the current
 sentence, respectively.  They were chosen to resemble @kbd{C-a} and
-@kbd{C-e}, which move to the beginning and end of a line.  Unlike them,
-@kbd{M-a} and @kbd{M-e} if repeated or given numeric arguments move over
-successive sentences.
+@kbd{C-e}, which move to the beginning and end of a line.  Unlike
+them, @kbd{M-a} and @kbd{M-e} move over successive sentences if
+repeated.
 
   Moving backward over a sentence places point just before the first
 character of the sentence; moving forward places point right after the
@@ -238,11 +238,10 @@ set @code{sentence-end} to this value:
 @end example
 
 @noindent
-You should also set the variable @code{sentence-end-double-space} to
-@code{nil} so that the fill commands expect and leave just one space at
-the end of a sentence.  Note that this makes it impossible to
-distinguish between periods that end sentences and those that indicate
-abbreviations.
+This is what setting the variable @code{sentence-end-double-space} to
+@code{nil} automatically does.  But note that this makes it impossible
+to distinguish between periods that end sentences and those that
+indicate abbreviations.
 
 @node Paragraphs
 @section Paragraphs
@@ -269,8 +268,8 @@ paragraph, while @kbd{M-@}} moves to the end of the current or next
 paragraph.  Blank lines and text-formatter command lines separate
 paragraphs and are not considered part of any paragraph.  In Indented
 Text mode, but not in Text mode, an indented line also starts a new
-paragraph.  (If a paragraph is preceded by a blank line, these
-commands treat that blank line as the beginning of the paragraph.)
+paragraph.  If there is a blank line before the paragraph, @kbd{M-@{}
+moves to the blank line, because that is convenient in practice.
 
   In major modes for programs, paragraphs begin and end only at blank
 lines.  This makes the paragraph commands continue to be useful even
@@ -619,12 +618,13 @@ beginning of a line.@refill
 
   When a fill prefix is in effect, the fill commands remove the fill
 prefix from each line before filling and insert it on each line after
-filling.  Auto Fill mode also inserts the fill prefix automatically when
-it makes a new line.  The @kbd{C-o} command inserts the fill prefix on
-new lines it creates, when you use it at the beginning of a line
-(@pxref{Blank Lines}).  Conversely, the command @kbd{M-^} deletes the
-prefix (if it occurs) after the newline that it deletes
-(@pxref{Indentation}).
+filling.  (The beginning of the first line is left unchanged, since
+often that is intentionally different.)  Auto Fill mode also inserts
+the fill prefix automatically when it makes a new line.  The @kbd{C-o}
+command inserts the fill prefix on new lines it creates, when you use
+it at the beginning of a line (@pxref{Blank Lines}).  Conversely, the
+command @kbd{M-^} deletes the prefix (if it occurs) after the newline
+that it deletes (@pxref{Indentation}).
 
   For example, if @code{fill-column} is 40 and you set the fill prefix
 to @samp{;; }, then @kbd{M-q} in the following text
@@ -852,10 +852,12 @@ paragraph-indent-minor-mode} to enter an equivalent minor mode, for
 instance during mail composition.
 
 @kindex M-TAB @r{(Text mode)}
-  Text mode, and all the modes based on it, define @kbd{M-@key{TAB}} as
-the command @code{ispell-complete-word}, which performs completion of
-the partial word in the buffer before point, using the spelling
-dictionary as the space of possible words.  @xref{Spelling}.
+  Text mode, and all the modes based on it, define @kbd{M-@key{TAB}}
+as the command @code{ispell-complete-word}, which performs completion
+of the partial word in the buffer before point, using the spelling
+dictionary as the space of possible words.  @xref{Spelling}.  If your
+window manager defines @kbd{M-@key{TAB}} to switch windows, you can
+type this Emacs command as @kbd{@key{ESC} @key{TAB}}.
 
 @vindex text-mode-hook
   Entering Text mode runs the hook @code{text-mode-hook}.  Other major
@@ -893,11 +895,11 @@ invisible so that you can see the outline structure.  Type @kbd{M-x
 outline-mode} to switch to Outline mode as the major mode of the current
 buffer.
 
-  When Outline mode makes a line invisible, the line does not appear on
-the screen.  The screen appears exactly as if the invisible line were
-deleted, except that an ellipsis (three periods in a row) appears at the
-end of the previous visible line (only one ellipsis no matter how many
-invisible lines follow).
+  When Outline mode makes a line invisible, the line does not appear
+on the screen.  The screen appears exactly as if the invisible line
+were deleted, except that an ellipsis (three periods in a row) appears
+at the end of the previous visible line.  (Multiple consecutive
+invisible lines produce just one ellipsis.)
 
   Editing commands that operate on lines, such as @kbd{C-n} and
 @kbd{C-p}, treat the text of the invisible line as part of the previous
@@ -928,7 +930,7 @@ the hook @code{outline-mode-hook} (@pxref{Hooks}).
                                      outlines.
 * Visibility: Outline Visibility.  Commands to control what is visible.
 * Views: Outline Views.            Outlines and multiple views.
-* Foldout::                        Folding editing.
+* Foldout::                        Folding means zooming in on outlines.
 @end menu
 
 @node Outline Format
@@ -1899,8 +1901,11 @@ for more information about text properties.
 @cindex soft newline
 @cindex newlines, hard and soft
 
+@cindex use-hard-newlines
   In formatted text, Emacs distinguishes between two different kinds of
-newlines, @dfn{hard} newlines and @dfn{soft} newlines.
+newlines, @dfn{hard} newlines and @dfn{soft} newlines.  (You can enable
+or disable this feature separately in any  buffer with the command
+@code{use-hard-newlines}.)
 
   Hard newlines are used to separate paragraphs, or items in a list, or
 anywhere that there should always be a line break regardless of the
@@ -2321,7 +2326,7 @@ text-based tables.  Here is an example of such a table:
   Table Mode allows the contents of the table such as this one to be
 easily manipulated by inserting or deleting characters inside a cell.
 A cell is effectively a localized rectangular edit region and edits to
-a cell do not affect the contets of the surrounding cells.  If the
+a cell do not affect the contents of the surrounding cells.  If the
 contents do not fit into a cell, then the cell is automatically
 expanded in the vertical and/or horizontal directions and the rest of
 the table is restructured and reformatted in accordance with the
@@ -2405,9 +2410,9 @@ From left to right:
 @item
 Nested cells are not allowed.
 @item
-Overlapped cells or nonrectangular cells are not allowed.
+Overlapped cells or non-rectangular cells are not allowed.
 @item
-The border must be rectanglular.
+The border must be rectangular.
 @item
 Cells must have a minimum width/height of one character.
 @item
@@ -2450,7 +2455,7 @@ for table editing.  The converse command, @code{table-unrecognize}, is
 used to remove the special text properties and revert the buffer back
 to plain text.
 
-  An optional numeric prefix argument can preceed the
+  An optional numeric prefix argument can precede the
 @code{table-recognize} command.  If the argument is negative, tables
 in the buffer become inactive.  This is equivalent to invoking
 @code{table-unrecognize}.
@@ -2560,7 +2565,7 @@ to justify: a cell,a column, or a row.  If you select cell
 justification, this command sets the justification only to the current
 cell.  Selecting column or row justification set the justification to
 all the cells within a column or row respectively.  The command then
-requsts the user to enter which justification to apply: @code{left},
+requests the user to enter which justification to apply: @code{left},
 @code{center}, @code{right}, @code{top}, @code{middle}, @code{bottom},
 or @code{none}.  The options @code{left}, @code{center}, and
 @code{right} specify horizontal justification while the options
@@ -2709,7 +2714,7 @@ delimiter regexp, creates a table with a single cell like the
 following one.
 
 @c The first line's right-hand frame in the following two examples
-@c sticks out to accomodate for the removal of @samp in the
+@c sticks out to accommodate for the removal of @samp in the
 @c produced output!!
 @example
 +-----------------------------------------------------------------+