[Emacs-diffs] Changes to emacs/man/text.texi

[Richard M . Stallman]

Index: emacs/man/text.texi
diff -c emacs/man/text.texi:1.50 emacs/man/text.texi:1.51
*** emacs/man/text.texi:1.50    Mon Mar 21 19:06:47 2005
--- emacs/man/text.texi Sat Mar 26 01:55:41 2005
***************
*** 1053,1082 ****
  you can undo right past them.  Making lines visible or invisible is simply
  not recorded by the undo mechanism.
  
  @table @kbd
! @item C-c C-t
! Make all body lines in the buffer invisible (@code{hide-body}).
! @item C-c C-a
! Make all lines in the buffer visible (@code{show-all}).
  @item C-c C-d
! Make everything under this heading invisible, not including this
  heading itself (@code{hide-subtree}).
  @item C-c C-s
! Make everything under this heading visible, including body,
  subheadings, and their bodies (@code{show-subtree}).
  @item C-c C-l
! Make the body of this heading line, and of all its subheadings,
  invisible (@code{hide-leaves}).
  @item C-c C-k
! Make all subheadings of this heading line, at all levels, visible
! (@code{show-branches}).
  @item C-c C-i
! Make immediate subheadings (one level down) of this heading line
! visible (@code{show-children}).
! @item C-c C-c
! Make this heading line's body invisible (@code{hide-entry}).
! @item C-c C-e
! Make this heading line's body visible (@code{show-entry}).
  @item C-c C-q
  Hide everything except the top @var{n} levels of heading lines
  (@code{hide-sublevels}).
--- 1053,1087 ----
  you can undo right past them.  Making lines visible or invisible is simply
  not recorded by the undo mechanism.
  
+   Many of these commands act on the ``current'' heading line.  If
+ point is on a heading line, that is the current heading line; if point
+ is on a body line, the current heading line is the nearest preceding
+ header line.
+ 
  @table @kbd
! @item C-c C-c
! Make the current heading line's body invisible (@code{hide-entry}).
! @item C-c C-e
! Make the current heading line's body visible (@code{show-entry}).
  @item C-c C-d
! Make everything under the current heading invisible, not including the
  heading itself (@code{hide-subtree}).
  @item C-c C-s
! Make everything under the current heading visible, including body,
  subheadings, and their bodies (@code{show-subtree}).
  @item C-c C-l
! Make the body of the current heading line, and of all its subheadings,
  invisible (@code{hide-leaves}).
  @item C-c C-k
! Make all subheadings of the current heading line, at all levels,
! visible (@code{show-branches}).
  @item C-c C-i
! Make immediate subheadings (one level down) of the current heading
! line visible (@code{show-children}).
! @item C-c C-t
! Make all body lines in the buffer invisible (@code{hide-body}).
! @item C-c C-a
! Make all lines in the buffer visible (@code{show-all}).
  @item C-c C-q
  Hide everything except the top @var{n} levels of heading lines
  (@code{hide-sublevels}).
***************
*** 1091,1112 ****
  @kindex C-c C-c @r{(Outline mode)}
  @kindex C-c C-e @r{(Outline mode)}
    Two commands that are exact opposites are @kbd{C-c C-c}
! (@code{hide-entry}) and @kbd{C-c C-e} (@code{show-entry}).  They are
! used with point on a heading line, and apply only to the body lines of
! that heading.  Subheadings and their bodies are not affected.
  
  @findex hide-subtree
  @findex show-subtree
  @kindex C-c C-s @r{(Outline mode)}
  @kindex C-c C-d @r{(Outline mode)}
  @cindex subtree (Outline mode)
!   Two more powerful opposites are @kbd{C-c C-d} (@code{hide-subtree}) and
! @kbd{C-c C-s} (@code{show-subtree}).  Both expect to be used when point is
! on a heading line, and both apply to all the lines of that heading's
! @dfn{subtree}: its body, all its subheadings, both direct and indirect, and
! all of their bodies.  In other words, the subtree contains everything
! following this heading line, up to and not including the next heading of
! the same or higher address@hidden
  
  @findex hide-leaves
  @findex show-branches
--- 1096,1116 ----
  @kindex C-c C-c @r{(Outline mode)}
  @kindex C-c C-e @r{(Outline mode)}
    Two commands that are exact opposites are @kbd{C-c C-c}
! (@code{hide-entry}) and @kbd{C-c C-e} (@code{show-entry}).  They apply
! to the body lines directly following the current heading line.
! Subheadings and their bodies are not affected.
  
  @findex hide-subtree
  @findex show-subtree
  @kindex C-c C-s @r{(Outline mode)}
  @kindex C-c C-d @r{(Outline mode)}
  @cindex subtree (Outline mode)
!   Two more powerful opposites are @kbd{C-c C-d} (@code{hide-subtree})
! and @kbd{C-c C-s} (@code{show-subtree}).  Both apply to the current
! heading line's @dfn{subtree}: its body, all its subheadings, both
! direct and indirect, and all of their bodies.  In other words, the
! subtree contains everything following the current heading line, up to
! and not including the next heading of the same or higher address@hidden
  
  @findex hide-leaves
  @findex show-branches
***************
*** 1131,1139 ****
  @kindex C-c C-a @r{(Outline mode)}
    Two commands have a blanket effect on the whole file.  @kbd{C-c C-t}
  (@code{hide-body}) makes all body lines invisible, so that you see just
! the outline structure.  @kbd{C-c C-a} (@code{show-all}) makes all lines
! visible.  These commands can be thought of as a pair of opposites even
! though @kbd{C-c C-a} applies to more than just body lines.
  
  @findex hide-sublevels
  @kindex C-c C-q @r{(Outline mode)}
--- 1135,1146 ----
  @kindex C-c C-a @r{(Outline mode)}
    Two commands have a blanket effect on the whole file.  @kbd{C-c C-t}
  (@code{hide-body}) makes all body lines invisible, so that you see just
! the outline structure (as a special exception, it will not hide lines
! at the top of the file, preceding the first header line, even though
! these are technically body lines).  @kbd{C-c C-a} (@code{show-all})
! makes all lines visible.  These commands can be thought of as a pair
! of opposites even though @kbd{C-c C-a} applies to more than just body
! lines.
  
  @findex hide-sublevels
  @kindex C-c C-q @r{(Outline mode)}
***************
*** 1284,1322 ****
  @cindex @TeX{} mode
  @cindex address@hidden mode
  @cindex address@hidden mode
  @cindex mode, @TeX{}
  @cindex mode, address@hidden
  @cindex mode, address@hidden
  @findex tex-mode
  @findex plain-tex-mode
  @findex latex-mode
  @findex slitex-mode
  
    @TeX{} is a powerful text formatter written by Donald Knuth; it is also
  free, like GNU Emacs.  address@hidden is a simplified input format for @TeX{},
  implemented by @TeX{} macros; it comes with @TeX{}.  address@hidden is a 
special
  form of address@hidden@address@hidden is obsoleted by the @samp{slides}
! document class in recent address@hidden versions.}
  
    Emacs has a special @TeX{} mode for editing @TeX{} input files.
  It provides facilities for checking the balance of delimiters and for
  invoking @TeX{} on all or part of the file.
  
  @vindex tex-default-mode
!   @TeX{} mode has three variants, Plain @TeX{} mode, address@hidden mode, and
! address@hidden mode (these three distinct major modes differ only slightly).
! They are designed for editing the three different formats.  The command
! @kbd{M-x tex-mode} looks at the contents of the buffer to determine
! whether the contents appear to be either address@hidden input or 
address@hidden
! input; if so, it selects the appropriate mode.  If the file contents do
! not appear to be address@hidden or address@hidden, it selects Plain @TeX{} 
mode.
! If the contents are insufficient to determine this, the variable
  @code{tex-default-mode} controls which mode is used.
  
    When @kbd{M-x tex-mode} does not guess right, you can use the commands
! @kbd{M-x plain-tex-mode}, @kbd{M-x latex-mode}, and @kbd{M-x
! slitex-mode} to select explicitly the particular variants of @TeX{}
! mode.
  
  @menu
  * Editing: TeX Editing.   Special commands for editing in TeX mode.
--- 1291,1335 ----
  @cindex @TeX{} mode
  @cindex address@hidden mode
  @cindex address@hidden mode
+ @cindex address@hidden mode
  @cindex mode, @TeX{}
  @cindex mode, address@hidden
  @cindex mode, address@hidden
+ @cindex mode, address@hidden
  @findex tex-mode
  @findex plain-tex-mode
  @findex latex-mode
  @findex slitex-mode
+ @findex doctex-mode
  
    @TeX{} is a powerful text formatter written by Donald Knuth; it is also
  free, like GNU Emacs.  address@hidden is a simplified input format for @TeX{},
  implemented by @TeX{} macros; it comes with @TeX{}.  address@hidden is a 
special
  form of address@hidden@address@hidden is obsoleted by the @samp{slides}
! document class in recent address@hidden versions.}  address@hidden 
(@file{.dtx})
! is a special file format in which the address@hidden sources are written,
! combining sources with documentation.
  
    Emacs has a special @TeX{} mode for editing @TeX{} input files.
  It provides facilities for checking the balance of delimiters and for
  invoking @TeX{} on all or part of the file.
  
  @vindex tex-default-mode
!   @TeX{} mode has four variants: Plain @TeX{} mode, address@hidden mode,
! address@hidden mode, and address@hidden mode (these distinct major modes 
differ
! only slightly).  They are designed for editing the four different
! formats.  The command @kbd{M-x tex-mode} looks at the contents of the
! buffer to determine whether the contents appear to be either address@hidden
! input, address@hidden, or address@hidden input; if so, it selects the
! appropriate mode.  If the file contents do not appear to be address@hidden,
! address@hidden or address@hidden, it selects Plain @TeX{} mode.  If the 
contents
! are insufficient to determine this, the variable
  @code{tex-default-mode} controls which mode is used.
  
    When @kbd{M-x tex-mode} does not guess right, you can use the commands
! @kbd{M-x plain-tex-mode}, @kbd{M-x latex-mode}, @kbd{M-x slitex-mode},
! and @kbd{doctex-mode} to select explicitly the particular variants of
! @TeX{} mode.
  
  @menu
  * Editing: TeX Editing.   Special commands for editing in TeX mode.