diff --git a/appview.php b/appview.php
index 08148b9..034548e 100644
--- a/appview.php
+++ b/appview.php
@@ -3,8 +3,8 @@
 /* code to display an application */
 /**********************************/
 
-/**
- * APPLICATION ENVIRONMENT
+/*
+ * application evironment
  */
 include("path.php");
 require(BASE."include/"."incl.php");
diff --git a/bugs.php b/bugs.php
index ef7194e..5cae5ee 100644
--- a/bugs.php
+++ b/bugs.php
@@ -1,9 +1,11 @@
 <?php
-/*
- * Application Database - appview.php
- *
- */
+/*********************************/
+/* bugs linked to an application */
+/*********************************/
 
+/*
+ * application evironment
+ */
 include("path.php");
 require(BASE."include/"."incl.php");
 require(BASE."include/"."application.php");
diff --git a/commentview.php b/commentview.php
index b391b3a..18a1620 100644
--- a/commentview.php
+++ b/commentview.php
@@ -5,6 +5,9 @@
 /* script expects appId, versionId and threadId as argument */
 /************************************************************/
 
+/*
+ * application evironment
+ */
 include("path.php");
 include(BASE."include/"."incl.php");
 require(BASE."include/"."comments.php");
diff --git a/deletecomment.php b/deletecomment.php
index d37f88c..a0461c6 100644
--- a/deletecomment.php
+++ b/deletecomment.php
@@ -1,5 +1,11 @@
 <?php
+/*******************/
+/* delete comments */
+/*******************/
 
+/*
+ * application evironment
+ */
 include("path.php");
 require(BASE."include/"."incl.php");
 require(BASE."include/"."application.php");
diff --git a/edituser.php b/edituser.php
index daffbfb..ee933c6 100644
--- a/edituser.php
+++ b/edituser.php
@@ -1,5 +1,11 @@
 <?php
-    
+/************************/
+/* code to edit an user */
+/************************/
+
+/*
+ * application evironment
+ */    
 include("path.php");
 include(BASE."include/"."incl.php");
 
diff --git a/index.php b/index.php
index 29897bf..26ce9c1 100644
--- a/index.php
+++ b/index.php
@@ -1,8 +1,11 @@
 <?php
 /***********************************/
-/* Application Database Index Page */
+/* application database index page */
 /***********************************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 
diff --git a/maintainerdelete.php b/maintainerdelete.php
index 52c80eb..e6b2e48 100644
--- a/maintainerdelete.php
+++ b/maintainerdelete.php
@@ -1,5 +1,11 @@
 <?php
+/*******************************/
+/* code to delete a maintainer */
+/*******************************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 require(BASE."include/"."tableve.php");
diff --git a/maintainersubmit.php b/maintainersubmit.php
index fcfd766..8f05991 100644
--- a/maintainersubmit.php
+++ b/maintainersubmit.php
@@ -1,7 +1,20 @@
 <?php
+/*******************************/
+/* code to submit a maintainer */
+/*******************************/
 
-// Check the input of a submitted form. And output with a list
-// of errors. (<ul></ul>)
+/*
+ * application evironment
+ */ 
+include("path.php");
+require(BASE."include/"."incl.php");
+require(BASE."include/"."tableve.php");
+require(BASE."include/"."category.php");
+
+/**
+ * Check the input of a submitted form. And output with a list
+ * of errors. (<ul></ul>)
+ */
 function checkAppMaintainerInput( $fields )
 {
     $errors = "";
@@ -21,10 +34,6 @@ function checkAppMaintainerInput( $fields )
     }
 }
 
-include("path.php");
-require(BASE."include/"."incl.php");
-require(BASE."include/"."tableve.php");
-require(BASE."include/"."category.php");
 
 if(!loggedin())
 {
diff --git a/noteview.php b/noteview.php
index a348d94..2984457 100644
--- a/noteview.php
+++ b/noteview.php
@@ -1,8 +1,11 @@
 <?php
-/**************************************/
-/* Application Database - Note Viewer */
-/**************************************/
+/***************/
+/* note viewer */
+/***************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 
diff --git a/preferences.php b/preferences.php
index c66d903..bfe5c39 100644
--- a/preferences.php
+++ b/preferences.php
@@ -1,5 +1,11 @@
 <?php
-    
+/**********************/
+/* preferences editor */
+/**********************/
+
+/*
+ * application evironment
+ */     
 include("path.php");
 include(BASE."include/"."incl.php");
 
diff --git a/screenshots.php b/screenshots.php
index c432409..f520ac2 100644
--- a/screenshots.php
+++ b/screenshots.php
@@ -5,12 +5,13 @@
 /* cmd and imageId                                                 */
 /*******************************************************************/
 
-/**
- * APPLICATION ENVIRONMENT
- */
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 require(BASE."include/"."application.php");
+
 if($_REQUEST['cmd'])
 {
     //process screenshot upload
diff --git a/search.php b/search.php
index 873cc83..b2a8cc4 100644
--- a/search.php
+++ b/search.php
@@ -1,5 +1,11 @@
 <?php
+/*****************/
+/* search engine */
+/*****************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 require(BASE."include/"."application.php");
diff --git a/stdquery.php b/stdquery.php
index 3e25ffa..9bb6c11 100644
--- a/stdquery.php
+++ b/stdquery.php
@@ -1,5 +1,11 @@
 <?php
+/**************************/
+/* FIXME: add description */
+/**************************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 require(BASE."include/"."qclass.php");
diff --git a/support.php b/support.php
index e153698..44f6595 100644
--- a/support.php
+++ b/support.php
@@ -1,8 +1,11 @@
 <?php
-/*************************************/
-/* Application Database Support Page */
-/*************************************/
+/****************/
+/* support page */
+/****************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 
diff --git a/updaterating.php b/updaterating.php
index e7ca27a..2b3c673 100644
--- a/updaterating.php
+++ b/updaterating.php
@@ -1,5 +1,11 @@
 <?php
+/*************************/
+/* code to modify rating */
+/*************************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 include(BASE."include/"."incl.php");
 include(BASE."include/"."rating.php");
diff --git a/updatevote.php b/updatevote.php
index 6cc1d81..350d562 100644
--- a/updatevote.php
+++ b/updatevote.php
@@ -1,5 +1,11 @@
 <?php
+/*************************/
+/* code to modify voting */
+/*************************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 include(BASE."include/"."incl.php");
 include(BASE."include/"."vote.php");
diff --git a/vendorview.php b/vendorview.php
index 4c1da71..925cfc6 100644
--- a/vendorview.php
+++ b/vendorview.php
@@ -3,6 +3,9 @@
 /* code to view vendors & their apps */
 /*************************************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 require(BASE."include/"."incl.php");
 require(BASE."include/"."application.php");
diff --git a/votestats.php b/votestats.php
index e9a2857..eb7f307 100644
--- a/votestats.php
+++ b/votestats.php
@@ -1,5 +1,11 @@
 <?php
+/*********************/
+/* voting statistics */
+/*********************/
 
+/*
+ * application evironment
+ */ 
 include("path.php");
 include(BASE."include/"."incl.php");
 require(BASE."include/"."category.php");