documentation added to tables

html/messagetable.php

@@ -23,7 +23,29 @@
 
 require_once("opendb.php");
 try {
-  $db->query('create table if not exists message (id int primary key not null auto_increment, time timestamp default current_timestamp, user varchar(50) not null, msg longtext not null, foreign key (user) references user(name) on delete cascade on update cascade) character set utf8 engine=innodb;');
+  $query = <<<EOD
+    create table if not exists
+      message (
+        id
+          int primary key not null auto_increment
+          comment "id of the message, it is used in the client to check if a message has already been downloaded or not",
+        time
+          timestamp default current_timestamp
+          comment "time when the message has been stored on the server",
+        user
+          varchar(50) not null
+          comment "name of the user that sent the message",
+        msg
+          longtext not null
+          comment "message content, must be armored gnupg encrypted format",
+        foreign key (user)
+          references user(name)
+          on delete cascade
+          on update cascade
+      ) character set utf8 engine=innodb
+        comment="table to hold all messages for later download by the receiver";
+EOD;
+  $db->query($query);
   $db->query('set global max_allowed_packet=1000000000');
   $db->query('set global net_buffer_length=1000000');
 } catch (Exception $e) {

html/usertable.php

@@ -24,7 +24,19 @@
 
 require_once("opendb.php");
 try {
-  $db->query('create table if not exists user (name varchar(50) not null primary key, pubkey text not null) character set utf8 engine=innodb;');
+  $query = <<<EOD
+    create table if not exists
+      user (
+          name
+            varchar(50) not null primary key
+            comment "unique name of the user",
+          pubkey
+            text not null
+            comment "armored gnupg public key of the user"
+      ) character set utf8 engine=innodb
+        comment="list of all registered users and their public keys";
+EOD;
+  $db->query($query);
 } catch (Exception $e) {
   error('database error on server');
 }