[latexrefman-commits] r347 - in /trunk: ChangeLog latex2e.texi

[jhefferon at domain.hid]

Author: jhefferon
Date: Thu May 28 13:21:26 2015
New Revision: 347

URL: http://svn.gna.org/viewcvs/latexrefman?rev=347&view=rev
Log:
environments do delimit scope

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=347&r1=346&r2=347&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Thu May 28 13:21:26 2015
@@ -1,3 +1,8 @@
+2015-05-28  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (\newcommand & \renewcommand): Realized environments
+	do delimit scope.
+
 2015-05-27  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (\newcommand & \renewcommand): Copy recent edits to

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=347&r1=346&r2=347&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Thu May 28 13:21:26 2015
@@ -3897,25 +3897,27 @@
 \renewenvironment*@{@var{env}@}[@var{nargs}][@var{optargdefault}]@{@var{begdefn}@}@{@var{enddefn}@}
 @end example
 
-Unlike @code{\newcommand} and @code{\renewcommand}, the starred forms
+Unlike @code{\newcommand} and @code{\renewcommand}, the @code{*}-forms
 @code{\newenvironment*} and @code{\renewcommand*} have the same effect
-as the non-starred forms.
+as the forms with no @code{*}.
 
 @table @var
 @item env
-Required; the environment name.  It does not begin with @code{\}.  It
-must not begin with the string @code{end}.  For @code{\newenvironment},
-the name @var{env} must not be the name of an already existing
-environment, and also the command @code{\@var{env}} must be undefined.
-For @code{\renewenvironment}, @var{env} must be the name of an existing
-environment.
+Required; the environment name.  It does not begin with backslash
+(@code{\}).  It must not begin with the string @code{end}.  For
+ at code{\newenvironment}, the name @var{env} must not be the name of an
+already existing environment, and also the command @code{\@var{env}}
+must be undefined.  For @code{\renewenvironment}, @var{env} must be the
+name of an existing environment.
 
 @item nargs
 Optional; an integer from 0 to 9 denoting the number of arguments of
-that the environment will take.  If this argument is not present, the
-default is for the environment to have no arguments.  When redefining an
-environment, the new version can have a different number of arguments
-than the old version.
+that the environment will take.  These arguments appear after the
+ at code{\begin}, as in
+ at code{\begin at domain.hid}@}}.  If this
+argument is not present then the default is for the environment to have
+no arguments.  When redefining an environment, the new version can have
+a different number of arguments than the old version.
 
 @item optargdefault
 Optional; if this argument is present then the first argument of the
@@ -3923,7 +3925,8 @@
 (which may be the empty string).  If this argument is not present then
 the environment does not take an optional argument.
 
-That is, if @code{\begin at domain.hid}@}} is used with square brackets
+That is, when @code{[@var{optargdefault}]} is present in the environment
+definition, if @code{\begin at domain.hid}@}} is used with square brackets
 following, as in @code{\begin at domain.hid}]}, then within
 the enviroment @code{#1} expands @var{myval}.  If
 @code{\begin at domain.hid}@}} is called without square brackets following,
@@ -3947,8 +3950,10 @@
 
 @end table
 
-The braces around @var{defn} do not delimit the scope of the result of
-expanding @var{defn}.
+The braces around @var{defn} delimit the scope of the result of
+expanding @var{defn}.  Thus, in the first example below, the effect of
+the @code{\small} is limited to the quote and does not extend to
+material following the environment.
 
 This example gives an environment like @LaTeX{}'s @code{quotation} except that
 it will be set in smaller type.