From 3aac1dc9a0e4767e71639624dfd5b1351d246374 Mon Sep 17 00:00:00 2001
From: stronk7 <stronk7>
Date: Thu, 26 Oct 2006 22:39:10 +0000
Subject: [PATCH] Deprecating old "upgrade" files. MDL-7214

Merged from MOODLE_17_STABLE
---
 backup/db/mysql.php                      | 20 +++++---------------
 blocks/activity_modules/db/mysql.php     | 20 +++++---------------
 blocks/admin/db/mysql.php                | 21 ++++++---------------
 blocks/calendar_month/db/mysql.php       | 21 ++++++---------------
 blocks/calendar_upcoming/db/mysql.php    | 21 ++++++---------------
 blocks/course_list/db/mysql.php          | 21 ++++++---------------
 blocks/course_summary/db/mysql.php       | 21 ++++++---------------
 blocks/db/mysql.php                      | 21 ++++++---------------
 blocks/news_items/db/mysql.php           | 21 ++++++---------------
 blocks/online_users/db/mysql.php         | 21 ++++++---------------
 blocks/participants/db/mysql.php         | 21 ++++++---------------
 blocks/recent_activity/db/mysql.php      | 21 ++++++---------------
 blocks/rss_client/db/mysql.php           |  9 ++++++++-
 blocks/search/db/mysql.php               | 21 ++++++---------------
 blocks/search_forums/db/mysql.php        | 21 ++++++---------------
 blocks/section_links/db/mysql.php        | 20 +++++---------------
 blocks/social_activities/db/mysql.php    | 21 ++++++---------------
 enrol/authorize/db/mysql.php             |  7 +++++++
 enrol/paypal/db/mysql.php                |  7 +++++++
 mod/assignment/db/mysql.php              |  7 +++++++
 mod/chat/db/mysql.php                    |  9 ++++++++-
 mod/choice/db/mysql.php                  |  8 ++++++++
 mod/data/db/mysql.php                    |  9 ++++++++-
 mod/exercise/db/mysql.php                |  7 +++++++
 mod/forum/db/mysql.php                   |  9 ++++++++-
 mod/hotpot/db/mysql.php                  |  8 ++++++++
 mod/journal/db/mysql.php                 |  7 +++++++
 mod/label/db/mysql.php                   |  7 +++++++
 mod/lams/db/mysql.php                    |  7 +++++++
 mod/lesson/db/mysql.php                  |  9 ++++++++-
 mod/quiz/db/mysql.php                    |  7 +++++++
 mod/resource/db/mysql.php                |  7 +++++++
 mod/scorm/db/mysql.php                   |  7 +++++++
 mod/survey/db/mysql.php                  |  7 +++++++
 mod/wiki/db/mysql.php                    |  8 ++++++++
 mod/workshop/db/mysql.php                |  7 +++++++
 question/type/calculated/db/mysql.php    |  7 +++++++
 question/type/essay/db/mysql.php         |  7 +++++++
 question/type/match/db/mysql.php         |  7 +++++++
 question/type/multianswer/db/mysql.php   |  7 +++++++
 question/type/multichoice/db/mysql.php   |  9 ++++++++-
 question/type/numerical/db/mysql.php     |  7 +++++++
 question/type/randomsamatch/db/mysql.php |  8 ++++++++
 question/type/rqp/db/mysql.php           |  7 +++++++
 question/type/shortanswer/db/mysql.php   |  7 +++++++
 question/type/truefalse/db/mysql.php     |  7 +++++++
 46 files changed, 313 insertions(+), 246 deletions(-)

diff --git a/backup/db/mysql.php b/backup/db/mysql.php
index e49ccb6c2c..af93afa8a6 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 1556053c44..1549db4838 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 30a5d48d45..845fbc9658 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 b467db451c..4e529bef17 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 32653d49c3..5ccd912233 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 f02c929896..1d006bb027 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 301a19aa9a..4dccae1a32 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 280f5cf5ad..2c58e40737 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 829618f227..2728665f0d 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 f8f77e3c39..4f05306128 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 c955da82eb..996ae7cdf0 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 3888f031e3..4581389210 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 91effa998e..d708a30f0b 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 cbbe8f6290..9914857349 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 00f4d5e811..5161f4f667 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 897bb3032a..d714536834 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 8932b10458..aaca97101f 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 ea193d4269..fecdd288be 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 9f6abc5db9..7a926a081c 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 54704ac755..3cd8d5eae0 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 1a3faa4315..b31f409288 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 46d0aca0b6..e95cb1c634 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 6980635574..38a14a93b6 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 20b7aed39c..d2a0f461b5 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 7cd965d388..aae07c20d9 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 5eae4322f6..cc7ea3c620 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 caf7cd2767..989c00da13 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 f9ca2a22b7..43cce9e24c 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 1be817d17a..dc0ab50a83 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 ad4dff5ccc..7fae2523f6 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 1cc905b302..ffacb71997 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 b185254ad8..a68a22d50c 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 6108dc15b3..b9c66686b5 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 48fecd4270..9518aa4b14 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 d00034f8a8..512230adf3 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 d53ff1963a..22c17675fe 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 7f29bf5de9..0ab573dded 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 547dbe39ac..d0845a512f 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 fbb28ffc37..601398a9f1 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 fded4f41af..eb380aaf77 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 d8fa976b72..271b09cf82 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 7572d100df..1a38e4fa17 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 b57d42ff8b..a8a5ec3497 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 4fec5aa3b4..c77dcd9497 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 57164b8ae0..eb09aa2655 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 649b86d25c..ae5ec96381 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;
 }
 
-- 
2.39.5