--- mysql.sql	Tue Sep 26 17:43:37 2006
+++ mysql-new.sql	Fri Dec 01 23:15:36 2006
@@ -439,7 +439,7 @@
   `mtable` varchar(30) NOT NULL default '',
   `field` varchar(200) NOT NULL default '',
    PRIMARY KEY  (`id`)
-) TYPE=MyISAM COMMENT='For a particular module/action, specifies a moodle table/field.';
+) TYPE=MyISAM COMMENT='For each module/action, specifies a moodle table/field.';
 ALTER TABLE prefix_log_display ADD UNIQUE `moduleaction`(`module` , `action`);
 # --------------------------------------------------------
 
@@ -543,7 +543,7 @@
     modified DATETIME NOT NULL,
     sessdata LONGTEXT,
 CONSTRAINT  PRIMARY KEY (sesskey)
-) COMMENT='Optional database session storage in new format, not used by default';
+) COMMENT='Optional db session storage in new format, not default';
 
 CREATE INDEX prefix_sess_exp_ix ON prefix_sessions2 (expiry);
 CREATE INDEX prefix_sess_exp2_ix ON prefix_sessions2 (expireref);
@@ -857,7 +857,7 @@
   KEY `post_lastmodified_idx` (`lastmodified`),
   KEY `post_module_idx` (`module`),
   KEY `post_subject_idx` (`subject`)
-) TYPE=MyISAM  COMMENT='Generic post table to hold data blog entries etc in different modules.';
+) TYPE=MyISAM  COMMENT='Generic post table for blogs, etc in different modules';
 
 
 # tags are not limited to blogs
@@ -941,7 +941,7 @@
   KEY `modifierid` (`modifierid`),
   UNIQUE KEY `roleid-contextid-capability` (`roleid`, `contextid`, `capability`),  
   PRIMARY KEY (`id`)
-) TYPE=MYISAM COMMENT ='permission has to be signed, overriding a capability for a particular role in a particular context';
+) TYPE=MYISAM COMMENT ='Signed permission overrides capability for role a context';
 
 CREATE TABLE prefix_role_allow_assign (
   `id` int(10) unsigned NOT NULL auto_increment,