diff --git a/backup/db/mysql.php b/backup/db/mysql.php
index e49ccb6c2c8..af93afa8a62 100644
--- a/backup/db/mysql.php
+++ b/backup/db/mysql.php
@@ -1,20 +1,9 @@
 <?php  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// backup/restore utility.
-// 
-// Sometimes, changes between versions involve 
-// alterations to database structures and other 
-// major things that may break installations.  
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it 
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -164,6 +153,7 @@ function backup_upgrade($oldversion=0) {
         table_column('backup_ids','info','info','mediumtext','','','','not null');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
 
     //Finally, return result
     return $result;
diff --git a/blocks/activity_modules/db/mysql.php b/blocks/activity_modules/db/mysql.php
index 1556053c44a..1549db4838f 100644
--- a/blocks/activity_modules/db/mysql.php
+++ b/blocks/activity_modules/db/mysql.php
@@ -1,20 +1,8 @@
 <?PHP  //$Id$
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +16,8 @@ function activity_modules_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/admin/db/mysql.php b/blocks/admin/db/mysql.php
index 30a5d48d454..845fbc9658a 100644
--- a/blocks/admin/db/mysql.php
+++ b/blocks/admin/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function admin_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/calendar_month/db/mysql.php b/blocks/calendar_month/db/mysql.php
index b467db451c4..4e529bef17d 100644
--- a/blocks/calendar_month/db/mysql.php
+++ b/blocks/calendar_month/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function calendar_month_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/calendar_upcoming/db/mysql.php b/blocks/calendar_upcoming/db/mysql.php
index 32653d49c35..5ccd9122337 100644
--- a/blocks/calendar_upcoming/db/mysql.php
+++ b/blocks/calendar_upcoming/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function calendar_upcoming_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/course_list/db/mysql.php b/blocks/course_list/db/mysql.php
index f02c929896c..1d006bb0272 100644
--- a/blocks/course_list/db/mysql.php
+++ b/blocks/course_list/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function course_list_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/course_summary/db/mysql.php b/blocks/course_summary/db/mysql.php
index 301a19aa9a4..4dccae1a32c 100644
--- a/blocks/course_summary/db/mysql.php
+++ b/blocks/course_summary/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function course_summary_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/db/mysql.php b/blocks/db/mysql.php
index 280f5cf5ad0..2c58e407377 100644
--- a/blocks/db/mysql.php
+++ b/blocks/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -161,6 +150,8 @@ global $CFG;
         modify_database('','ALTER TABLE prefix_block_pinned ADD INDEX pagetype (pagetype);');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/news_items/db/mysql.php b/blocks/news_items/db/mysql.php
index 829618f2270..2728665f0d0 100644
--- a/blocks/news_items/db/mysql.php
+++ b/blocks/news_items/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function news_items_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/online_users/db/mysql.php b/blocks/online_users/db/mysql.php
index f8f77e3c393..4f05306128d 100644
--- a/blocks/online_users/db/mysql.php
+++ b/blocks/online_users/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function online_users_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/participants/db/mysql.php b/blocks/participants/db/mysql.php
index c955da82eb0..996ae7cdf03 100644
--- a/blocks/participants/db/mysql.php
+++ b/blocks/participants/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function participants_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/recent_activity/db/mysql.php b/blocks/recent_activity/db/mysql.php
index 3888f031e3a..45813892101 100644
--- a/blocks/recent_activity/db/mysql.php
+++ b/blocks/recent_activity/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function recent_activity_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/rss_client/db/mysql.php b/blocks/rss_client/db/mysql.php
index 91effa998e2..d708a30f0bc 100644
--- a/blocks/rss_client/db/mysql.php
+++ b/blocks/rss_client/db/mysql.php
@@ -1,5 +1,10 @@
 <?php //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function rss_client_upgrade($oldversion) {
 /// This function does anything necessary to upgrade 
 /// older versions to match current functionality 
@@ -130,7 +135,9 @@ function rss_client_upgrade($oldversion) {
         }
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
-?>
\ No newline at end of file
+?>
diff --git a/blocks/search/db/mysql.php b/blocks/search/db/mysql.php
index cbbe8f62907..9914857349a 100644
--- a/blocks/search/db/mysql.php
+++ b/blocks/search/db/mysql.php
@@ -1,20 +1,9 @@
 <?php
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function search_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/search_forums/db/mysql.php b/blocks/search_forums/db/mysql.php
index 00f4d5e8118..5161f4f667f 100644
--- a/blocks/search_forums/db/mysql.php
+++ b/blocks/search_forums/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function search_forums_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/blocks/section_links/db/mysql.php b/blocks/section_links/db/mysql.php
index 897bb3032a7..d714536834d 100644
--- a/blocks/section_links/db/mysql.php
+++ b/blocks/section_links/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -27,6 +16,7 @@ function section_links_upgrade($oldversion=0) {
     if ($oldversion < 2004050500 and $result) {
         $result = true; //Nothing to do
     }
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
 
     //Finally, return result
     return $result;
diff --git a/blocks/social_activities/db/mysql.php b/blocks/social_activities/db/mysql.php
index 8932b104588..aaca97101f5 100644
--- a/blocks/social_activities/db/mysql.php
+++ b/blocks/social_activities/db/mysql.php
@@ -1,20 +1,9 @@
 <?PHP  //$Id$
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
 //
-// This file keeps track of upgrades to Moodle's
-// blocks system.
-//
-// Sometimes, changes between versions involve
-// alterations to database structures and other
-// major things that may break installations.
-//
-// The upgrade function in this file will attempt
-// to perform all the necessary actions to upgrade
-// your older installtion to the current version.
-//
-// If there's something it cannot do itself, it
-// will tell you what you need to do.
-//
-// Versions are defined by backup_version.php
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
 //
 // This file is tailored to MySQL
 
@@ -28,6 +17,8 @@ function social_activities_upgrade($oldversion=0) {
         $result = true; //Nothing to do
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     //Finally, return result
     return $result;
 }
diff --git a/enrol/authorize/db/mysql.php b/enrol/authorize/db/mysql.php
index ea193d4269f..fecdd288bef 100755
--- a/enrol/authorize/db/mysql.php
+++ b/enrol/authorize/db/mysql.php
@@ -1,5 +1,10 @@
 <?php //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this enrolment module
 
 function enrol_authorize_upgrade($oldversion=0) {
@@ -132,6 +137,8 @@ function enrol_authorize_upgrade($oldversion=0) {
         execute_sql("ALTER TABLE `{$CFG->prefix}enrol_authorize` ADD paymentmethod enum('cc', 'echeck') NOT NULL default 'cc' AFTER `id`", true);
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return $result;
 }
 
diff --git a/enrol/paypal/db/mysql.php b/enrol/paypal/db/mysql.php
index 9f6abc5db9d..7a926a081cc 100644
--- a/enrol/paypal/db/mysql.php
+++ b/enrol/paypal/db/mysql.php
@@ -1,5 +1,10 @@
 <?PHP  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this enrolment module
 
 function enrol_paypal_upgrade($oldversion=0) {
@@ -8,6 +13,8 @@ function enrol_paypal_upgrade($oldversion=0) {
 
     $result = true;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return $result;
 
 }
diff --git a/mod/assignment/db/mysql.php b/mod/assignment/db/mysql.php
index 54704ac7555..3cd8d5eae09 100644
--- a/mod/assignment/db/mysql.php
+++ b/mod/assignment/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function assignment_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -168,6 +173,8 @@ function assignment_upgrade($oldversion) {
     include_once("$CFG->dirroot/mod/assignment/lib.php");
     assignment_upgrade_submodules();
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/chat/db/mysql.php b/mod/chat/db/mysql.php
index 1a3faa4315e..b31f409288a 100644
--- a/mod/chat/db/mysql.php
+++ b/mod/chat/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function chat_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -57,7 +62,9 @@ function chat_upgrade($oldversion) {
         table_column('chat_users', '', 'course', 'integer', '10', 'unsigned', '0', 'not null', '');
         table_column('chat_users', '', 'lang'  , 'varchar', '10', ''        , '' , 'not null', '');
     }
-    
+
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/choice/db/mysql.php b/mod/choice/db/mysql.php
index 46d0aca0b67..e95cb1c634a 100644
--- a/mod/choice/db/mysql.php
+++ b/mod/choice/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function choice_upgrade($oldversion) {
     
     global $CFG;
@@ -122,6 +127,9 @@ function choice_upgrade($oldversion) {
     if ($oldversion < 2006020900) { //rename release column to showanswers - Release is now reserved word in mySql
         table_column('choice', '`release`', 'showresults', 'TINYINT', '2', 'unsigned', 0, 'not null');
     }
+
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/data/db/mysql.php b/mod/data/db/mysql.php
index 69806355747..38a14a93b66 100644
--- a/mod/data/db/mysql.php
+++ b/mod/data/db/mysql.php
@@ -1,5 +1,10 @@
 <?php
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function data_upgrade($oldversion) {
 /// This function does anything necessary to upgrade
 /// older versions to match current functionality
@@ -136,7 +141,9 @@ function data_upgrade($oldversion) {
         execute_sql("ALTER TABLE {$CFG->prefix}data_content CHANGE content3 content3 longtext NULL AFTER content2");
         execute_sql("ALTER TABLE {$CFG->prefix}data_content CHANGE content4 content4 longtext NULL AFTER content3");
     }
-    
+
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/exercise/db/mysql.php b/mod/exercise/db/mysql.php
index 20b7aed39c3..d2a0f461b58 100644
--- a/mod/exercise/db/mysql.php
+++ b/mod/exercise/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function exercise_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -56,6 +61,8 @@ function exercise_upgrade($oldversion) {
         modify_database('','ALTER TABLE prefix_exercise_grades ADD INDEX exerciseid (exerciseid);');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/forum/db/mysql.php b/mod/forum/db/mysql.php
index 7cd965d3888..aae07c20d92 100644
--- a/mod/forum/db/mysql.php
+++ b/mod/forum/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function forum_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -282,7 +287,9 @@ function forum_upgrade($oldversion) {
           execute_sql($sql);
       }
   }
-  
+
+  //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
   return true;
   
 }
diff --git a/mod/hotpot/db/mysql.php b/mod/hotpot/db/mysql.php
index 5eae4322f65..cc7ea3c6200 100644
--- a/mod/hotpot/db/mysql.php
+++ b/mod/hotpot/db/mysql.php
@@ -1,4 +1,10 @@
 <?PHP
+
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function hotpot_upgrade($oldversion) {
     global $CFG;
     $ok = true;
@@ -57,6 +63,8 @@ function hotpot_upgrade($oldversion) {
         $ok = $ok && hotpot_update_to_v2_2();
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return $ok;
 }
 ?>
diff --git a/mod/journal/db/mysql.php b/mod/journal/db/mysql.php
index caf7cd2767b..989c00da137 100644
--- a/mod/journal/db/mysql.php
+++ b/mod/journal/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function journal_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -81,6 +86,8 @@ function journal_upgrade($oldversion) {
         table_column('journal_entries', 'comment', 'entrycomment', 'text', '', '', '');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return $result;
 }
 
diff --git a/mod/label/db/mysql.php b/mod/label/db/mysql.php
index f9ca2a22b74..43cce9e24c0 100644
--- a/mod/label/db/mysql.php
+++ b/mod/label/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function label_upgrade($oldversion) {
 
 /// This function does anything necessary to upgrade 
@@ -21,6 +26,8 @@ function label_upgrade($oldversion) {
         modify_database('','ALTER TABLE prefix_label ADD INDEX course (course);');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 
 }
diff --git a/mod/lams/db/mysql.php b/mod/lams/db/mysql.php
index 1be817d17ac..dc0ab50a838 100644
--- a/mod/lams/db/mysql.php
+++ b/mod/lams/db/mysql.php
@@ -1,5 +1,10 @@
 <?PHP
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function lams_upgrade($oldversion) {
 /// This function does anything necessary to upgrade 
 /// older versions to match current functionality 
@@ -12,6 +17,8 @@ function lams_upgrade($oldversion) {
 
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/lesson/db/mysql.php b/mod/lesson/db/mysql.php
index ad4dff5ccca..7fae2523f69 100644
--- a/mod/lesson/db/mysql.php
+++ b/mod/lesson/db/mysql.php
@@ -1,5 +1,10 @@
 <?PHP
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function lesson_upgrade($oldversion) {
 /// This function does anything necessary to upgrade 
 /// older versions to match current functionality 
@@ -235,7 +240,9 @@ function lesson_upgrade($oldversion) {
         table_column('lesson', '', 'feedback', 'int', '3', 'unsigned', '1', 'not null', 'nextpagedefault'); 
         table_column('lesson_default', '', 'feedback', 'int', '3', 'unsigned', '1', 'not null', 'nextpagedefault'); 
     }
-    
+
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/quiz/db/mysql.php b/mod/quiz/db/mysql.php
index 1cc905b302f..ffacb719973 100644
--- a/mod/quiz/db/mysql.php
+++ b/mod/quiz/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function quiz_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -1144,6 +1149,8 @@ function quiz_upgrade($oldversion) {
         $success = $success && table_column('question', 'commentarytext', 'generalfeedback', 'text', '', '', '');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return $success;
 }
 
diff --git a/mod/resource/db/mysql.php b/mod/resource/db/mysql.php
index b185254ad8a..a68a22d50c9 100644
--- a/mod/resource/db/mysql.php
+++ b/mod/resource/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function resource_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -70,6 +75,8 @@ function resource_upgrade($oldversion) {
         table_column('resource','reference','reference','varchar','255','','','not null');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/scorm/db/mysql.php b/mod/scorm/db/mysql.php
index 6108dc15b31..b9c66686b5f 100755
--- a/mod/scorm/db/mysql.php
+++ b/mod/scorm/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function scorm_upgrade($oldversion) {
 /// This function does anything necessary to upgrade
 /// older versions to match current functionality
@@ -226,6 +231,8 @@ function scorm_upgrade($oldversion) {
         execute_sql("INSERT INTO {$CFG->prefix}log_display (module, action, mtable, field) VALUES ('scorm', 'review', 'scorm', 'name');", false);
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 ?>
diff --git a/mod/survey/db/mysql.php b/mod/survey/db/mysql.php
index 48fecd42709..9518aa4b146 100644
--- a/mod/survey/db/mysql.php
+++ b/mod/survey/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function survey_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -214,6 +219,8 @@ function survey_upgrade($oldversion) {
         table_column('survey_questions','intro','intro','varchar','50','','','not null');
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/wiki/db/mysql.php b/mod/wiki/db/mysql.php
index d00034f8a87..512230adf32 100644
--- a/mod/wiki/db/mysql.php
+++ b/mod/wiki/db/mysql.php
@@ -1,5 +1,10 @@
 <?PHP
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function wiki_upgrade($oldversion) {
 /// This function does anything necessary to upgrade 
 /// older versions to match current functionality 
@@ -175,6 +180,9 @@ CREATE TABLE prefix_wiki_locks
   INDEX wiki_locks_ix(lockedseen)  
 );"); 
     }
+
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/mod/workshop/db/mysql.php b/mod/workshop/db/mysql.php
index d53ff1963a3..22c17675fe9 100644
--- a/mod/workshop/db/mysql.php
+++ b/mod/workshop/db/mysql.php
@@ -1,5 +1,10 @@
 <?php // $Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 function workshop_upgrade($oldversion) {
 // This function does anything necessary to upgrade
 // older versions to match current functionality
@@ -217,6 +222,8 @@ function workshop_upgrade($oldversion) {
         }
     }
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/calculated/db/mysql.php b/question/type/calculated/db/mysql.php
index 7f29bf5de97..0ab573ddedf 100644
--- a/question/type/calculated/db/mysql.php
+++ b/question/type/calculated/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_calculated_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/essay/db/mysql.php b/question/type/essay/db/mysql.php
index 547dbe39acc..d0845a512fd 100644
--- a/question/type/essay/db/mysql.php
+++ b/question/type/essay/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_essay_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/match/db/mysql.php b/question/type/match/db/mysql.php
index fbb28ffc37b..601398a9f11 100644
--- a/question/type/match/db/mysql.php
+++ b/question/type/match/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_match_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/multianswer/db/mysql.php b/question/type/multianswer/db/mysql.php
index fded4f41af2..eb380aaf77c 100644
--- a/question/type/multianswer/db/mysql.php
+++ b/question/type/multianswer/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_multianswer_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/multichoice/db/mysql.php b/question/type/multichoice/db/mysql.php
index d8fa976b726..271b09cf828 100644
--- a/question/type/multichoice/db/mysql.php
+++ b/question/type/multichoice/db/mysql.php
@@ -1,5 +1,10 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_multichoice_upgrade($oldversion=0) {
@@ -11,7 +16,9 @@ function qtype_multichoice_upgrade($oldversion=0) {
         $success = $success && table_column('question_multichoice', '', 'partiallycorrectfeedback', 'text', '', '', '');
         $success = $success && table_column('question_multichoice', '', 'incorrectfeedback', 'text', '', '', '');
     }
-    
+
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return $success;
 }
 
diff --git a/question/type/numerical/db/mysql.php b/question/type/numerical/db/mysql.php
index 7572d100df2..1a38e4fa174 100644
--- a/question/type/numerical/db/mysql.php
+++ b/question/type/numerical/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_numerical_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/randomsamatch/db/mysql.php b/question/type/randomsamatch/db/mysql.php
index b57d42ff8b1..a8a5ec34972 100644
--- a/question/type/randomsamatch/db/mysql.php
+++ b/question/type/randomsamatch/db/mysql.php
@@ -1,5 +1,10 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_randomsamatch_upgrade($oldversion=0) {
@@ -9,6 +14,9 @@ function qtype_randomsamatch_upgrade($oldversion=0) {
         // This is a random questiontype and therefore answers are always shuffled, no need for this field
         modify_database('', 'ALTER TABLE prefix_question_randomsamatch DROP shuffleanswers');
     }
+
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/rqp/db/mysql.php b/question/type/rqp/db/mysql.php
index 4fec5aa3b48..c77dcd94977 100644
--- a/question/type/rqp/db/mysql.php
+++ b/question/type/rqp/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_rqp_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/shortanswer/db/mysql.php b/question/type/shortanswer/db/mysql.php
index 57164b8ae02..eb09aa2655a 100644
--- a/question/type/shortanswer/db/mysql.php
+++ b/question/type/shortanswer/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_shortanswer_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }
 
diff --git a/question/type/truefalse/db/mysql.php b/question/type/truefalse/db/mysql.php
index 649b86d25c9..ae5ec963812 100644
--- a/question/type/truefalse/db/mysql.php
+++ b/question/type/truefalse/db/mysql.php
@@ -1,10 +1,17 @@
 <?php  //$Id$
 
+// THIS FILE IS DEPRECATED!  PLEASE DO NOT MAKE CHANGES TO IT!
+//
+// IT IS USED ONLY FOR UPGRADES FROM BEFORE MOODLE 1.7, ALL 
+// LATER CHANGES SHOULD USE upgrade.php IN THIS DIRECTORY.
+
 // MySQL commands for upgrading this question type
 
 function qtype_truefalse_upgrade($oldversion=0) {
     global $CFG;
 
+    //////  DO NOT ADD NEW THINGS HERE!!  USE upgrade.php and the lib/ddllib.php functions.
+
     return true;
 }