From: Joel E. Denny <jdenny@ces.clemson.edu>
Date: Fri, 22 May 2009 05:39:07 +0000 (-0400)
Subject: Update some comments to make sense for -D.
X-Git-Tag: v2.7.90~867
X-Git-Url: https://git.saurik.com/bison.git/commitdiff_plain/f8e7258f7f24013b8da07cedba6177dc3b6d4453

Update some comments to make sense for -D.

* data/bison.m4 (b4_check_user_names): In header comments, say
"user occurrence" instead of "grammar occurrence".
* src/muscle-tab.h (muscle_percent_define_insert): Likewise.
(muscle_percent_code_grow): Likewise just for consistency.
(cherry picked from commit 246c4efafed178058a22b96d7a046340f6119057)

Conflicts:

	src/muscle-tab.h
---

diff --git a/ChangeLog b/ChangeLog
index 029beebb..698349c4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2009-05-22  Joel E. Denny  <jdenny@ces.clemson.edu>
+
+	Update some comments to make sense for -D.
+	* data/bison.m4 (b4_check_user_names): In header comments, say
+	"user occurrence" instead of "grammar occurrence".
+	* src/muscle-tab.h (muscle_percent_define_insert): Likewise.
+	(muscle_percent_code_grow): Likewise just for consistency.
+
 2009-05-20  Joel E. Denny  <jdenny@ces.clemson.edu>
 
 	* data/c++.m4 (b4_namespace_close): Simplify slightly.
diff --git a/data/bison.m4 b/data/bison.m4
index 5d97a29e..b532ad7f 100644
--- a/data/bison.m4
+++ b/data/bison.m4
@@ -506,8 +506,8 @@ b4_define_user_code([stype])
 # but is not used by Bison (as recorded by macros in the namespace
 # BISON-NAMESPACE).
 #
-# USER-LIST must expand to a list specifying all grammar occurrences of all
-# names of type WHAT.   Each item in the list must be a triplet specifying one
+# USER-LIST must expand to a list specifying all user occurrences of all names
+# of type WHAT.   Each item in the list must be a triplet specifying one
 # occurrence: name, start boundary, and end boundary.  Empty string names are
 # fine.  An empty list is fine.
 #
diff --git a/src/muscle-tab.h b/src/muscle-tab.h
index 3fe64e5a..12e4f1d1 100644
--- a/src/muscle-tab.h
+++ b/src/muscle-tab.h
@@ -127,9 +127,9 @@ void muscle_user_name_list_grow (char const *key, char const *user_name,
                                  location loc);
 
 /* Define the muscle for the %define variable VARIABLE appearing at
-   VARIABLE_LOC in the grammar file with value VALUE.  Warn if VARIABLE is
-   already defined.  Record this as a grammar occurrence of VARIABLE by
-   invoking muscle_user_name_list_grow.  */
+   VARIABLE_LOC with value VALUE.  Warn if VARIABLE is already defined.
+   Record this as a user occurrence of VARIABLE by invoking
+   muscle_user_name_list_grow.  */
 void muscle_percent_define_insert (char const *variable, location variable_loc,
                                    char const *value);
 
@@ -196,9 +196,10 @@ void muscle_percent_define_default (char const *variable, char const *value);
    output.  */
 void muscle_percent_define_check_values (char const * const *values);
 
-/* Grow the muscle for the %code qualifier QUALIFIER appearing at QUALIFIER_LOC
-   in the grammar file with code CODE appearing at CODE_LOC.  Record this as a
-   grammar occurrence of VARIABLE by invoking muscle_user_name_list_grow.  */
+/* Grow the muscle for the %code qualifier QUALIFIER appearing at
+   QUALIFIER_LOC with code CODE appearing at CODE_LOC.  Record this as a
+   user occurrence of QUALIFIER by invoking
+   muscle_user_name_list_grow.  */
 void muscle_percent_code_grow (char const *qualifier, location qualifier_loc,
                                char const *code, location code_loc);