From 4d0e661918afe0ad39ba5f34c93582febcf20bfe Mon Sep 17 00:00:00 2001
From: David Rose <david@ddrose.com>
Date: Fri, 7 Jan 2005 03:06:47 +0000
Subject: [PATCH] more comment refinements

---
 direct/src/doc/sample.dc | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/direct/src/doc/sample.dc b/direct/src/doc/sample.dc
index fb762a4de8..56e175dea0 100644
--- a/direct/src/doc/sample.dc
+++ b/direct/src/doc/sample.dc
@@ -52,8 +52,8 @@ struct AvatarObject {
 
   // You can also define "methods" on a struct, just as on a dclass.
   // This implies the existence of the corresponding get method
-  // (e.g. getObjectCode() in this case) method, to query the
-  // information at generate time.
+  // (e.g. getObjectCode() in this case), to query the information at
+  // generate time.
   setObjectCode(int8(0-50) code, DoId player);
 };
 
@@ -63,7 +63,9 @@ dclass DistributedObjectHolder : DistributedObject {
   dropObject(AvatarObject object);
 
   // You can also have an array of structs.  This specifies a
-  // fixed-length array of five elements.
+  // fixed-length array of five elements.  This is slightly more
+  // optimal than an array of unrestricted length, since the length
+  // prefix need not be transmitted as part of the message.
   setObjectList(AvatarObject objectArray[5]);
 
   // In addition to fixed-length arrays and unbounded arrays, you can
@@ -78,8 +80,9 @@ typedef uint8(0-25) DNAColor = 1;
   
 struct AvatarDNA {
   // This defines a character element that can be any one of the three
-  // specified.  (It is similar to the uint8 range restrictions,
-  // below.)
+  // specified.  (It is similar in form to the uint8 definitions
+  // below, except that the legal values are ASCII characters instead
+  // of numbers.)
   char('a','q','x') type;
 
   // These specify one-byte numeric elements that can be any of the