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

[jhefferon at domain.hid]

Author: jhefferon
Date: Sat Nov 28 12:58:33 2015
New Revision: 480

URL: http://svn.gna.org/viewcvs/latexrefman?rev=480&view=rev
Log:
counter wording

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=480&r1=479&r2=480&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sat Nov 28 12:58:33 2015
@@ -1,3 +1,8 @@
+2015-11-28  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (Counters)  Adjust wording and add examples
+	for \setcounter and \addtocounter.
+
 2015-11-28  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (Counters)  Add variable `counter' to description

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=480&r1=479&r2=480&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sat Nov 28 12:58:33 2015
@@ -5123,21 +5123,24 @@
 @findex \newcounter
 @cindex counters, defining new
 
-Synopsis:
-
- at domain.hid
+Synopsis, one of:
+
+ at example
+\newcounter at domain.hid}@}
 \newcounter at domain.hid}]
 @end example
 
-The @code{\newcounter} command globally defines a new counter named
- at domain.hid}.  The name consists of letters only and does not begin
-with a backslash (@samp{\}).  The name must not already be used by
-another counter. The new counter is initialized to zero.
-
-If the optional argument @code{[@var{supercounter}]} appears, then
+Globally defines a new counter named @var{countername} and initialize
+the new counter to zero.
+
+The name @var{countername} must consists of letters only, and does not
+begin with a backslash.  This name must not already be in use by another
+counter.
+
+When you use the optional argument @code{[@var{supercounter}]} then
 @var{countername} will be numbered within, or subsidiary to, the
 existing counter @var{supercounter}.  For example, ordinarily
- at domain.hid} is numbered within @code{section}.  Any time
+ at code{subsection} is numbered within @code{section} so that any time
 @var{supercounter} is incremented with @code{\stepcounter}
 (@pxref{\stepcounter}) or @code{\refstepcounter}
 (@pxref{\refstepcounter}) then @var{countername} is reset to zero.
@@ -5630,26 +5633,27 @@
 
 @ftable @code
 @item \alph at domain.hid}@}
-prints @var{counter} using lowercase letters: `a', `b', @enddots{}
+Print the value of @var{counter} in lowercase letters: `a', `b', @enddots{}
 
 @item \Alph at domain.hid}@}
-uses uppercase letters: `A', `B', @enddots{}
+Print in uppercase letters: `A', `B', @enddots{}
 
 @item \arabic at domain.hid}@}
-uses Arabic numbers: `1', `2', @enddots{}
+Print in Arabic numbers: `1', `2', @enddots{}
 
 @item \roman at domain.hid}@}
-uses lowercase roman numerals: `i', `ii', @enddots{}
+Print in lowercase roman numerals: `i', `ii', @enddots{}
 
 @item \Roman at domain.hid}@}
-uses uppercase roman numerals: `I', `II', @enddots{}
+Print in uppercase roman numerals: `I', `II', @enddots{}
 
 @item \fnsymbol at domain.hid}@}
-prints the value of @var{counter} in a specific sequence of nine
+Prints the value of @var{counter} in a specific sequence of nine
 symbols (conventionally used for labeling footnotes).  The value of
 @var{counter} must be between at domain.hid and at domain.hid, inclusive.
 
-Here are the symbols (as Unicode code points in ASCII output):
+Here are the symbols (if you are reading this in ASCII output then you
+will see the Unicode code points):
 
 @display
 asterisk(*) dagger(@U{2021}) ddagger(@U{2021})
@@ -5752,6 +5756,13 @@
 to the @var{value} argument.  Note that the counter name does not start
 with a backslash.
 
+In this example the section value appears as @samp{V}.
+
+ at example
+\setcounter at domain.hid@}
+Here it is in Roman: \Roman at domain.hid@}.
+ at end example
+
 
 @node \addtocounter
 @section @code{\addtocounter at domain.hid}@}}
@@ -5760,6 +5771,14 @@
 
 The @code{\addtocounter} command globally increments @var{counter} by
 the amount specified by the @var{value} argument, which may be negative.
+
+In this example the section value appears as @samp{VII}.
+
+ at example
+\setcounter at domain.hid@}
+\addtocounter at domain.hid@}
+Here it is in Roman: \Roman at domain.hid@}.
+ at end example
 
 
 @node \refstepcounter