Added and updated miscellaneous comments.

cpp/QrSegment.hpp

@@ -162,7 +162,7 @@ class QrSegment final {
 	
 	
 	/* 
-	 * Creates a new QR Code data segment with the given parameters and data.
+	 * Creates a new QR Code segment with the given parameters and data.
 	 * The character count (numCh) must agree with the mode and the bit buffer length,
 	 * but the constraint isn't checked. The given bit buffer is moved and stored.
 	 */

python/qrcodegen.py

@@ -685,6 +685,8 @@ class QrSegment(object):
 			raise TypeError("QrSegment.Mode expected")
 		if numch < 0:
 			raise ValueError()
+		
+		# The mode indicator for this segment.
 		self._mode = mode
 		
 		# The length of this segment's unencoded data, measured in characters for
@@ -692,6 +694,7 @@ class QrSegment(object):
 		# Always zero or positive.
 		self._numchars = numch
 		
+		# The data bits of this segment. Accessed through get_bits().
 		self._bitdata = list(bitdata)  # Make defensive copy