Index: /trunk/glueforge/examples/complex.md
===================================================================
--- /trunk/glueforge/examples/complex.md	(revision 6457)
+++ /trunk/glueforge/examples/complex.md	(revision 6458)
@@ -1,10 +1,10 @@
 glueforge METADATA
-    pkg_name        STR  foodb 
+    pkg_name        STR  foodb
     pkg_namespace   STR  foo
 END
 
 foo METADATA
-    foo     STR     60      # Primary Key
-    bar     S32     0 
+    foo     STR     60      # Primary Key # the name of foo thing
+    bar     S32     0       ## count of bar
     baz     F32     0.0
     boing   F64     0.0
@@ -16,5 +16,5 @@
     boing   F64     0.0
     baz     F32     0.0
-    bar     S32     0 
-    foo     STR     60      # Primary Key
+    bar     S32     0       ## count of bar
+    foo     STR     60      # Primary Key # the name of foo thing
 END
Index: /trunk/glueforge/examples/simple.md
===================================================================
--- /trunk/glueforge/examples/simple.md	(revision 6457)
+++ /trunk/glueforge/examples/simple.md	(revision 6458)
@@ -1,5 +1,5 @@
 table   STR     foo
-foo     STR     60      # Primary Key
-bar     S32     0 
+foo     STR     60      # Primary Key # the name of foo thing
+bar     S32     0       ## count of bar
 baz     F32     0.0
 boing   F64     0.0
Index: /trunk/glueforge/glueforge.in
===================================================================
--- /trunk/glueforge/glueforge.in	(revision 6457)
+++ /trunk/glueforge/glueforge.in	(revision 6458)
@@ -3,5 +3,5 @@
 # Copyright (C) 2005-2006  Joshua Hoblitt
 #
-# $Id: glueforge.in,v 1.46 2006-02-17 03:39:28 jhoblitt Exp $
+# $Id: glueforge.in,v 1.47 2006-02-22 00:26:03 jhoblitt Exp $
 
 use strict;
@@ -344,6 +344,6 @@
 
     table   STR     foo
-    foo     STR     60      # Primary Key
-    bar     S32     0
+    foo     STR     60      # Primary Key # the name of foo thing
+    bar     S32     0       ## count of bar
     baz     F32     0.0
     boing   F64     0.0
@@ -360,6 +360,9 @@
 C<F32>, C<F64>, & C<BOOL> columns are ignored.
 
-Keys maybe specified as a C<Primary Key> or C<Key>.  Only one C<Primary Key>
-may be specified per table.
+Indexes maybe specified as comment value of either C<Primary Key> or C<Key>.
+Only one C<Primary Key> may be specified per table.  
+
+Description comments may specified as either a C<# ...> after an index
+specifier or as stand alone comment value of C<## ...>.
 
 The key name C<position> is also reserved as it is used internally by the
@@ -387,6 +390,6 @@
 
 foo METADATA
-    foo     STR     60      # Primary Key
-    bar     S32     0 
+    foo     STR     60      # Primary Key # the name of foo thing
+    bar     S32     0       ## count of bar
     baz     F32     0.0
     boing   F64     0.0
@@ -398,6 +401,6 @@
     boing   F64     0.0
     baz     F32     0.0
-    bar     S32     0 
-    foo     STR     60      # Primary Key
+    bar     S32     0       ## count of bar
+    foo     STR     60      # Primary Key # the name of foo thing
 END