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

[jhefferon at domain.hid]

Author: jhefferon
Date: Sun May 17 01:59:48 2015
New Revision: 338

URL: http://svn.gna.org/viewcvs/latexrefman?rev=338&view=rev
Log:
counters, numbered within

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=338&r1=337&r2=338&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sun May 17 01:59:48 2015
@@ -1,3 +1,9 @@
+2015-05-15  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (\newcounter, \stepcounter, \refstepcounter): Expand
+	definions, particularly of the defintion of one counter numbered
+	within the other.
+
 2015-05-15  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (\usecounter): Expand definition; give example.

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=338&r1=337&r2=338&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sun May 17 01:59:48 2015
@@ -3727,13 +3727,19 @@
 \newcounter at domain.hid}]
 @end example
 
-The @code{\newcounter} command defines a new counter named @var{countername}.
-The new counter is initialized to zero.
-
-Given the optional argument @code{[@var{super}]}, @var{countername}
-will be reset whenever the counter named @var{supercounter} is incremented.
-
+The @code{\newcounter} command globally defines a new counter named
+ at var{countername}.  The new counter is initialized to zero.
+
+If the optional argument @code{[@var{supercounter}]} appears then
+ at var{countername} will be numbered within, or subsidiary to, the
+existing counter @var{supercounter}.  For example, ordinarily
+ at code{subsection} is numbered within @code{section}.  Any time
+ at var{supercounter} is incremented with @code{\stepcounter}
+(@pxref{\stepcounter}) or @code{\refstepcounter}
+(@pxref{\refstepcounter}) then @var{counter} is reset to zero.
 @xref{Counters}, for more information about counters.
+
+Note that the name of each counter does not begin with a backslash (\).
 
 
 @node \newlength
@@ -3955,7 +3961,8 @@
 @section @code{\alph \Alph \arabic \roman \Roman \fnsymbol}: Printing counters
 
 All of these commands take a single counter as an argument, for
-instance, @code{\alph at domain.hid@}}.
+instance, @code{\alph at domain.hid@}}.  Note that the counter name does not
+start with a backslash.
 
 @ftable @code
 @item \alph
@@ -4056,16 +4063,17 @@
 \setcounter at domain.hid}@}
 @end example
 
-The @code{\setcounter} command sets the value of @var{counter} to the
- at domain.hid} argument.
+The @code{\setcounter} command globally sets the value of @var{counter}
+to the @var{value} argument.  Note that the counter name does not start
+with a backslash.
 
 
 @node \addtocounter
 @section @code{\addtocounter at domain.hid}@}}
 @findex \addtocounter
 
-The @code{\addtocounter} command increments @var{counter} by the
-amount specified by the @var{value} argument, which may be negative.
+The @code{\addtocounter} command globally increments @var{counter} by
+the amount specified by the @var{value} argument, which may be negative.
 
 
 @node \refstepcounter
@@ -4073,16 +4081,23 @@
 @findex \refstepcounter
 
 The @code{\refstepcounter} command works in the same way as
- at domain.hid} @xref{\stepcounter}, except it also defines the
-current @code{\ref} value to be the result of @code{\thecounter}.
+ at code{\stepcounter} (@pxref{\stepcounter}), meaning that it globally
+increments the value of @var{counter} by one and resets the value of any
+counter numbered within it.  (For the definition of counters numbered
+within this one, @pxref{\newcounter}.)  In addition, this command also
+defines the current @code{\ref} value to be the result of
+ at code{\thecounter}.  Note that while setting the counter is done
+globally, setting the current @code{\ref} value is only valid inside the
+current group.
 
 
 @node \stepcounter
 @section @code{\stepcounter at domain.hid}@}}
 @findex \stepcounter
 
-The @code{\stepcounter} command adds one to @var{counter} and
-resets all subsidiary counters.
+The @code{\stepcounter} command globally adds one to @var{counter} and
+resets all counters numbered within it.  (For the definition of counters
+numbered within this one, @pxref{\newcounter}.)
 
 
 @node \day \month \year