From 8fa03264e408e71f69f13aeb4d1b2aed74a528bd Mon Sep 17 00:00:00 2001
From: lorilee <leelorik@gmail.com>
Date: Sat, 14 Aug 2010 15:14:45 -0700
Subject: [PATCH] Added comments

---
 db_export.php                    |  1 +
 enum_editor.php                  | 22 +++++++++++++++-------
 libraries/display_export.lib.php |  1 +
 server_export.php                |  1 +
 4 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/db_export.php b/db_export.php
index 9eb738512..a24ed18d7 100644
--- a/db_export.php
+++ b/db_export.php
@@ -52,6 +52,7 @@ if (!empty($selected_tbl) && empty($table_select)) {
     $table_select = $selected_tbl;
 }
 
+// Check if the selected tables are defined in $_GET (from clicking Back button on export.php)
 if(isset($_GET['table_select'])) {
     $_GET['table_select'] = urldecode($_GET['table_select']);
     $_GET['table_select'] = explode(",", $_GET['table_select']);
diff --git a/enum_editor.php b/enum_editor.php
index ad2c28fec..f7397ea0e 100644
--- a/enum_editor.php
+++ b/enum_editor.php
@@ -1,6 +1,14 @@
 <?php 
-    require_once './libraries/common.inc.php';
-    
+
+/* vim: set expandtab sw=4 ts=4 sts=4: */
+/**
+ * Displays a form for editing ENUM and SET values with more space (as an alternative to doing it in tbl_alter.php)
+ * This form is only for users with JavaScript disabled -- users with JavaScript enabled will see a different form
+ * defined in tbl_properties.inc.php
+ * @package phpMyAdmin
+ */
+
+require_once './libraries/common.inc.php';
 require_once './libraries/header_http.inc.php';
 require_once './libraries/header_meta_style.inc.php';
 ?>
@@ -15,16 +23,16 @@ require_once './libraries/header_meta_style.inc.php';
             <div id="values">
             <?php
                 $values = '';
-                if (isset($_GET['values'])) {
+                if (isset($_GET['values'])) { // This page was displayed when the "add a new value" link or the link in tbl_alter.php was clicked
                     $values = urldecode($_GET['values']);
-                } elseif (isset($_GET['num_fields'])) {
+                } elseif (isset($_GET['num_fields'])) { // This page was displayed from submitting this form
                     for($field_num = 1; $field_num <= $_GET['num_fields']; $field_num++) {
                         $values .= $_GET['field' . $field_num] . ",";
                     }
                 }
-
+                // Display the values in text fields, excluding empty strings
                 $field_counter = 0;
-                $stripped_values = array();
+                $stripped_values = array(); // The values to display in the output
                 foreach(split(",", $values) as $value) {
                     if(trim($value) != "") {
                         $field_counter++;
@@ -34,7 +42,7 @@ require_once './libraries/header_meta_style.inc.php';
                 }
 
                 $total_fields = $field_counter;
-                // If extra fields are added, display them
+                // If extra empty fields are added, display them
                 if(isset($_GET['extra_fields'])) {
                     $total_fields += $_GET['extra_fields'];
                     for($i = $field_counter+1; $i <= $total_fields; $i++) {
diff --git a/libraries/display_export.lib.php b/libraries/display_export.lib.php
index 412ebc87a..172615785 100644
--- a/libraries/display_export.lib.php
+++ b/libraries/display_export.lib.php
@@ -36,6 +36,7 @@ if (empty($export_list)) {
     require './libraries/footer.inc.php';
 }
 
+// If the form data is being loaded from GET data, decode it
 foreach($_GET as $name => $value) {
     if(is_string($value)) {
         $_GET[urldecode($name)] = urldecode($value);
diff --git a/server_export.php b/server_export.php
index 2ab625d63..b5a4ca675 100644
--- a/server_export.php
+++ b/server_export.php
@@ -30,6 +30,7 @@ $multi_values .= '<a href="' . $checkall_url . '&amp;selectall=1" onclick="setSe
 $multi_values .= '<select name="db_select[]" id="db_select" size="10" multiple="multiple">';
 $multi_values .= "\n";
 
+// Check if the selected databases are defined in $_GET (from clicking Back button on export.php)
 if(isset($_GET['db_select'])) {
     $_GET['db_select'] = urldecode($_GET['db_select']);
     $_GET['db_select'] = explode(",", $_GET['db_select']);