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
-@section Marking Environment, Sections, or Texinfo nodes
+@section 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
-@node MakingLaTeX
-@subsection LaTeX Commands for marking Environment and Sections
+@node Marking (LaTeX)
+@subsection LaTeX Commands for Marking Environments and Sections
-@deffn Command LaTeX-mark-section &optional @var{no-subsections}
+@deffn 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
-@code{texinfo-section-list}.
-
-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
-@deffn Command LaTeX-mark-environment &optional @var{count}
+@deffn 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
-@node MakingTexinfo
-@subsection Texinfo Commands for marking Environment and Sections
+@node Marking (Texinfo)
+@subsection Texinfo Commands for Marking Environments and Sections
-@deffn Command Texinfo-mark-section &optional @var{no-subsection}
+@deffn 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
-@code{texinfo-section-list}.
-
-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
+@code{outline-regexp} 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
-@deffn Command Texinfo-mark-environment &optional @var{count}
+@deffn 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
+@code{@@node} and ending at next occurrence of the keywords
+@code{@@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. @samp{@{\tiny
+foo@}}). If there is no active region, no braces are inserted.
@item nil
Insert empty braces.
_______________________________________________
auctex-diffs mailing list
auctex-di...@gnu.org
https://lists.gnu.org/mailman/listinfo/auctex-diffs
