[AUCTeX-diffs] Changes to auctex/doc/auctex.texi,v

[Ralf Angeli]

CVSROOT:        /cvsroot/auctex
Module name:    auctex
Changes by:     Ralf Angeli <angeli>    11/09/18 16:18:02

Index: auctex.texi
===================================================================
RCS file: /cvsroot/auctex/auctex/doc/auctex.texi,v
retrieving revision 1.308
retrieving revision 1.309
diff -u -b -r1.308 -r1.309
--- auctex.texi 18 Sep 2011 16:12:54 -0000      1.308
+++ auctex.texi 18 Sep 2011 16:18:02 -0000      1.309
@@ -13,7 +13,7 @@
 a sophisticated TeX environment for Emacs.
 
 Copyright @copyright{} 1992, 1993, 1994, 1995, 2001, 2002, 2004, 2005,
-2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -321,7 +321,7 @@
 * Environments::                Inserting Environment Templates
 * Mathematics::                 Entering Mathematics
 * Completion::                  Completion of macros
-* Marking::                     Marking Environment, sections, or texinfo nodes
+* Marking::                     Marking Environments, Sections, or Texinfo 
Nodes
 * Commenting::                  Commenting text
 * Indenting::                   Reflecting syntactic constructs with whitespace
 * Filling::                     Automatic and manual line breaking
@@ -1053,93 +1053,82 @@
 does not conflict with the basename of one of @TeX{} files.
 
 @node Marking
address@hidden Marking Environment, Sections, or Texinfo nodes
address@hidden Marking Environments, Sections, or Texinfo Nodes
 
-You can set the region over the current environment with the @kbd{C-c .}
-command, or over the current section with the @kbd{C-c *} command.
+You can mark the current environment by typing @kbd{C-c .}, or the
+current section by typing @kbd{C-c *}.
 
-For Texinfo documents there is an additional command @kbd{M-C-h} to set
-the region over the current node.
+In Texinfo documents you can type @kbd{M-C-h} to mark the current node.
 
 When the region is set, the point is moved to its beginning and the mark
-at its end.
+to its end.
 
 @menu
-* MakingLaTeX:: LaTeX Commands for marking Environment and Sections
-* MakingTexinfo:: Texinfo Commands for marking Environment, Sections, and Nodes
+* Marking (LaTeX):: LaTeX Commands for Marking Environments and Sections
+* Marking (Texinfo):: Texinfo Commands for Marking Environments, Sections, and 
Nodes
 @end menu
 
address@hidden MakingLaTeX
address@hidden LaTeX Commands for marking Environment and Sections
address@hidden Marking (LaTeX)
address@hidden LaTeX Commands for Marking Environments and Sections
 
address@hidden Command LaTeX-mark-section &optional @var{no-subsections}
address@hidden Command LaTeX-mark-section
 @kindex C-c *
-(@kbd{C-c *}) Mark current section, with inclusion of any containing node.
+(@kbd{C-c *}) Set mark at end of current logical section, and point at
+top.
 
-The current section is detected as starting by any of the structuring
-commands matched by regexp in variable @code{outline-regexp} which in
-turn is a regexp matching any element of variable
address@hidden
-
-If optional argument @var{no-subsection} is set to any integer or is a
-non nil empty argument (i.e. @kbd{C-u C-c *}), then mark the current
-section with exclusion of any subsections.
-
-Otherwise, any included subsections are also marked along with current
-section.
-
-Note that when current section is starting immediatley after a node
-commande, then the node command is also marked as part as the section.
+With a non-nil prefix argument, mark only the region from the current
+section start to the next sectioning command.  Thereby subsections are
+not being marked.  Otherwise, any included subsections are also marked
+along with current section.
 @end deffn
 
address@hidden Command LaTeX-mark-environment &optional @var{count}
address@hidden Command LaTeX-mark-environment
 @kindex C-c .
-(@kbd{C-c .}) Set mark to end of current environment and point to the
-matching begin.  If prefix argument @var{count} is given, mark the
-respective number of enclosing environments.  The command will not work
-properly if there are unbalanced begin-end pairs in comments and
-verbatim environments.
+(@kbd{C-c .}) Set mark to the end of the current environment and point
+to the matching beginning.
+
+If a prefix argument is given, mark the respective number of enclosing
+environments.  The command will not work properly if there are
+unbalanced begin-end pairs in comments and verbatim environments.
 @end deffn
 
address@hidden MakingTexinfo
address@hidden Texinfo Commands for marking Environment and Sections
address@hidden Marking (Texinfo)
address@hidden Texinfo Commands for Marking Environments and Sections
 
address@hidden Command Texinfo-mark-section &optional @var{no-subsection}
address@hidden Command Texinfo-mark-section
 @kindex C-c *
-(@kbd{C-c *}) Mark current section, with inclusion of any containing
+(@kbd{C-c *}) Mark the current section, with inclusion of any containing
 node.
 
 The current section is detected as starting by any of the structuring
-commands matched by regexp in variable @code{outline-regexp} which in
-turn is a regexp matching any element of variable
address@hidden
-
-If optional argument @var{no-subsection} is set to any integer or is a
-non @code{nil} empty argument (i.e. @kbd{C-u C-c *}), then mark the
-current section with exclusion of any subsections.
+commands matched by the regular expression in the variable
address@hidden which in turn is a regular expression matching any
+element of the variable @code{texinfo-section-list}.
 
-Otherwise, any included subsections are also marked along with
-current section.
+With a non-nil prefix argument, mark only the region from the current
+section start to the next sectioning command.  Thereby subsections are
+not being marked.  Otherwise, any included subsections are also marked
 
-Note that when current section is starting immediatley after a
-node commande, then the node command is also marked as part as
-the section.
+Note that when the current section is starting immediately after a node
+command, then the node command is also marked as part of the section.
 @end deffn
 
address@hidden Command Texinfo-mark-environment &optional @var{count}
address@hidden Command Texinfo-mark-environment
 @kindex C-c .
-(@kbd{C-c .}) Set mark to end of current environment and point to the matching
-beginning.  If prefix argument @var{count} is given, mark the respective
-number of enclosing environments.  The command will not work properly if
-there are unbalanced begin-end pairs in comments and verbatim
-environments.
+(@kbd{C-c .}) Set mark to the end of the current environment and point
+to the matching beginning.
+
+If a prefix argument is given, mark the respective number of enclosing
+environments.  The command will not work properly if there are
+unbalanced begin-end pairs in comments and verbatim environments.
 @end deffn
 
 @deffn Command Texinfo-mark-node
 @kindex M-C-h
-(@kbd{M-C-h}) Mark the current node.  This is the node in which the
-point is.  It is starting at previous beginning of keyword @code{@@node}
-and ending at next beginning of keyword @code{@@node} or @code{@@bye}.
+(@kbd{M-C-h}) Mark the current node.  This is the node in which point is
+located.  It is starting at the previous occurrence of the keyword
address@hidden@@node} and ending at next occurrence of the keywords
address@hidden@@node} or @code{@@bye}.
 @end deffn
 
 @node Commenting
@@ -3871,7 +3860,10 @@
 Use the string as a prompt to prompt for the argument.
 
 @item number
-Insert that many braces, leave point inside the first.
+Insert that many braces, leave point inside the first.  0 and -1 are
+special.  0 means that no braces are inserted.  -1 means that braces are
+inserted around the macro and an active region (e.g. @address@hidden
address@hidden).  If there is no active region, no braces are inserted.
 
 @item nil
 Insert empty braces.