From 190e5595bc33a04630a1feefac572c680cd334d1 Mon Sep 17 00:00:00 2001
From: Brian Paul <brian.paul@tungstengraphics.com>
Date: Wed, 1 Mar 2006 15:33:56 +0000
Subject: [PATCH] New comments.  Use tuples () instead of lists [] in a few
 places.

---
 src/mesa/glapi/typeexpr.py | 42 +++++++++++++++++++++++-------------------
 1 file changed, 23 insertions(+), 19 deletions(-)

diff --git a/src/mesa/glapi/typeexpr.py b/src/mesa/glapi/typeexpr.py
index eface2a..8ba7de4 100644
--- a/src/mesa/glapi/typeexpr.py
+++ b/src/mesa/glapi/typeexpr.py
@@ -29,20 +29,21 @@ import string, copy
 
 class type_node:
 	def __init__(self):
-		self.pointer = 0
-		self.const = 0
-		self.signed = 1
-		self.integer = 1
+		self.pointer = 0  # bool
+		self.const = 0    # bool
+		self.signed = 1   # bool
+		self.integer = 1  # bool
 
 		# If elements is set to non-zero, then field is an array.
 		self.elements = 0
 
 		self.name = None
-		self.size = 0
+		self.size = 0     # type's size in bytes
 		return
 
 
 	def string(self):
+		"""Return string representation of this type_node."""
 		s = ""
 		
 		if self.pointer:
@@ -85,16 +86,17 @@ class type_table:
 def create_initial_types():
 	tt = type_table()
 
-	basic_types = [ ["char",   1, 1], \
-	                ["short",  2, 1], \
-	                ["int",    4, 1], \
-	                ["long",   4, 1], \
-			["float",  4, 0], \
-			["double", 8, 0], \
-			["enum",   4, 1] ]
-
-
-	for [type_name, type_size, integer] in basic_types:
+	basic_types = [
+		("char",   1, 1),
+		("short",  2, 1),
+		("int",    4, 1),
+		("long",   4, 1),
+		("float",  4, 0),
+		("double", 8, 0),
+		("enum",   4, 1)
+	]
+
+	for (type_name, type_size, integer) in basic_types:
 		te = type_expression(None)
 		tn = type_node()
 		tn.name = type_name
@@ -113,22 +115,24 @@ class type_expression:
 	def __init__(self, type_string, extra_types = None):
 		self.expr = []
 
-		if not type_string: return
+		if not type_string:
+			return
 
 		self.original_string = type_string
 
 		if not type_expression.built_in_types:
 			raise RuntimeError("create_initial_types must be called before creating type_expression objects.")
 
-		
-		elements = string.split( string.replace( type_string, "*", " * " ) )
+		# Replace '*' with ' * ' in type_string.  Then, split the string
+		# into tokens, separated by spaces.
+		tokens = string.split( string.replace( type_string, "*", " * " ) )
 
 		const = 0
 		t = None
 		signed = 0
 		unsigned = 0
 
-		for i in elements:
+		for i in tokens:
 			if i == "const":
 				if t and t.pointer:
 					t.const = 1
-- 
2.7.4