MDL-69521 core: Move all comments in code from 4.1 to 3.11
authorEloy Lafuente (stronk7) <stronk7@moodle.org>
Sun, 6 Sep 2020 14:58:51 +0000 (16:58 +0200)
committerEloy Lafuente (stronk7) <stronk7@moodle.org>
Tue, 8 Sep 2020 16:59:30 +0000 (18:59 +0200)
12 files changed:
analytics/classes/local/analyser/base.php
analytics/classes/manager.php
auth/ldap/auth.php
enrol/database/cli/sync.php
enrol/ldap/lib.php
lib/adminlib.php
lib/behat/behat_base.php
lib/deprecatedlib.php
lib/tests/behat/behat_deprecated.php
message/defaultoutputs.php
mod/forum/deprecatedlib.php
mod/forum/externallib.php

index 99735bd..7a958f9 100644 (file)
@@ -111,14 +111,14 @@ abstract class base {
      * \core_analytics\local\analyser\by_course and \core_analytics\local\analyser\sitewide are implementing
      * this method returning site courses (by_course) and the whole system (sitewide) as analysables.
      *
-     * @todo MDL-65284 This will be removed in Moodle 4.1
+     * @todo MDL-65284 This will be removed in Moodle 3.11
      * @deprecated
      * @see get_analysables_iterator
      * @throws  \coding_exception
      * @return \core_analytics\analysable[] Array of analysable elements using the analysable id as array key.
      */
     public function get_analysables() {
-        // This function should only be called from get_analysables_iterator and we keep it here until Moodle 4.1
+        // This function should only be called from get_analysables_iterator and we keep it here until Moodle 3.11
         // for backwards compatibility.
         throw new \coding_exception('This method is deprecated in favour of get_analysables_iterator.');
     }
index faea917..054a07a 100644 (file)
@@ -303,7 +303,7 @@ class manager {
      * Returns the enabled time splitting methods.
      *
      * @deprecated since Moodle 3.7
-     * @todo MDL-65086 This will be deleted in Moodle 4.1
+     * @todo MDL-65086 This will be deleted in Moodle 3.11
      * @see \core_analytics\manager::get_time_splitting_methods_for_evaluation
      * @return \core_analytics\local\time_splitting\base[]
      */
@@ -604,7 +604,7 @@ class manager {
      * Used to be used to add models included with the Moodle core.
      *
      * @deprecated Deprecated since Moodle 3.7 (MDL-61667) - Use lib/db/analytics.php instead.
-     * @todo Remove this method in Moodle 4.1 (MDL-65186).
+     * @todo Remove this method in Moodle 3.11 (MDL-65186).
      * @return void
      */
     public static function add_builtin_models() {
index aae5522..dfdd0b4 100644 (file)
@@ -709,7 +709,7 @@ class auth_plugin_ldap extends auth_plugin_base {
 
             do {
                 if ($ldappagedresults) {
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         // Before 7.3, use this function that was deprecated in PHP 7.4.
                         ldap_control_paged_result($ldapconnection, $this->config->pagesize, true, $ldapcookie);
@@ -722,7 +722,7 @@ class auth_plugin_ldap extends auth_plugin_base {
                 }
                 if ($this->config->search_sub) {
                     // Use ldap_search to find first user from subtree.
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         $ldapresult = ldap_search($ldapconnection, $context, $filter, array($this->config->user_attribute));
                     } else {
@@ -731,7 +731,7 @@ class auth_plugin_ldap extends auth_plugin_base {
                     }
                 } else {
                     // Search only in this context.
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         $ldapresult = ldap_list($ldapconnection, $context, $filter, array($this->config->user_attribute));
                     } else {
@@ -745,7 +745,7 @@ class auth_plugin_ldap extends auth_plugin_base {
                 if ($ldappagedresults) {
                     // Get next server cookie to know if we'll need to continue searching.
                     $ldapcookie = '';
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         // Before 7.3, use this function that was deprecated in PHP 7.4.
                         $pagedresp = ldap_control_paged_result_response($ldapconnection, $ldapresult, $ldapcookie);
@@ -1554,7 +1554,7 @@ class auth_plugin_ldap extends auth_plugin_base {
 
             do {
                 if ($ldap_pagedresults) {
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         // Before 7.3, use this function that was deprecated in PHP 7.4.
                         ldap_control_paged_result($ldapconnection, $this->config->pagesize, true, $ldap_cookie);
@@ -1567,7 +1567,7 @@ class auth_plugin_ldap extends auth_plugin_base {
                 }
                 if ($this->config->search_sub) {
                     // Use ldap_search to find first user from subtree.
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         $ldap_result = ldap_search($ldapconnection, $context, $filter, array($this->config->user_attribute));
                     } else {
@@ -1576,7 +1576,7 @@ class auth_plugin_ldap extends auth_plugin_base {
                     }
                 } else {
                     // Search only in this context.
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         $ldap_result = ldap_list($ldapconnection, $context, $filter, array($this->config->user_attribute));
                     } else {
@@ -1590,7 +1590,7 @@ class auth_plugin_ldap extends auth_plugin_base {
                 if ($ldap_pagedresults) {
                     // Get next server cookie to know if we'll need to continue searching.
                     $ldap_cookie = '';
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         // Before 7.3, use this function that was deprecated in PHP 7.4.
                         ldap_control_paged_result_response($ldapconnection, $ldap_result, $ldap_cookie);
index 605f7c0..9a78691 100644 (file)
@@ -27,7 +27,7 @@
  *   - use "su" if "sudo" not available
  *
  * @deprecated since Moodle 3.7 MDL-59986 - please do not use this CLI script any more, use scheduled task instead.
- * @todo       MDL-63266 This will be deleted in Moodle 4.1.
+ * @todo       MDL-63266 This will be deleted in Moodle 3.11.
  * @package    enrol_database
  * @copyright  2010 Petr Skoda {@link http://skodak.org}
  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
index 8c4672d..5b44a5a 100644 (file)
@@ -389,7 +389,7 @@ class enrol_ldap_plugin extends enrol_plugin {
                 $flat_records = array();
                 do {
                     if ($ldap_pagedresults) {
-                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                         if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                             // Before 7.3, use this function that was deprecated in PHP 7.4.
                             ldap_control_paged_result($this->ldapconnection, $this->config->pagesize, true, $ldap_cookie);
@@ -403,7 +403,7 @@ class enrol_ldap_plugin extends enrol_plugin {
 
                     if ($this->config->course_search_sub) {
                         // Use ldap_search to find first user from subtree
-                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                         if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                             $ldap_result = @ldap_search($this->ldapconnection, $ldap_context,
                                 $ldap_search_pattern, $ldap_fields_wanted);
@@ -414,7 +414,7 @@ class enrol_ldap_plugin extends enrol_plugin {
                         }
                     } else {
                         // Search only in this context
-                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                         if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                             $ldap_result = @ldap_list($this->ldapconnection, $ldap_context,
                                 $ldap_search_pattern, $ldap_fields_wanted);
@@ -431,7 +431,7 @@ class enrol_ldap_plugin extends enrol_plugin {
                     if ($ldap_pagedresults) {
                         // Get next server cookie to know if we'll need to continue searching.
                         $ldap_cookie = '';
-                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                        // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                         if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                             // Before 7.3, use this function that was deprecated in PHP 7.4.
                             ldap_control_paged_result_response($this->ldapconnection, $ldap_result, $ldap_cookie);
@@ -806,7 +806,7 @@ class enrol_ldap_plugin extends enrol_plugin {
             $flat_records = array();
             do {
                 if ($ldap_pagedresults) {
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         // Before 7.3, use this function that was deprecated in PHP 7.4.
                         ldap_control_paged_result($this->ldapconnection, $this->config->pagesize, true, $ldap_cookie);
@@ -820,7 +820,7 @@ class enrol_ldap_plugin extends enrol_plugin {
 
                 if ($this->get_config('course_search_sub')) {
                     // Use ldap_search to find first user from subtree
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         $ldap_result = @ldap_search($this->ldapconnection, $context,
                             $ldap_search_pattern, $ldap_fields_wanted);
@@ -831,7 +831,7 @@ class enrol_ldap_plugin extends enrol_plugin {
                     }
                 } else {
                     // Search only in this context
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         $ldap_result = @ldap_list($this->ldapconnection, $context,
                             $ldap_search_pattern, $ldap_fields_wanted);
@@ -849,7 +849,7 @@ class enrol_ldap_plugin extends enrol_plugin {
                 if ($ldap_pagedresults) {
                     // Get next server cookie to know if we'll need to continue searching.
                     $ldap_cookie = '';
-                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 4.1).
+                    // TODO: Remove the old branch of code once PHP 7.3.0 becomes required (Moodle 3.11).
                     if (version_compare(PHP_VERSION, '7.3.0', '<')) {
                         // Before 7.3, use this function that was deprecated in PHP 7.4.
                         ldap_control_paged_result_response($this->ldapconnection, $ldap_result, $ldap_cookie);
index 69fdd79..b91129b 100644 (file)
@@ -6538,7 +6538,7 @@ class admin_page_managemessageoutputs extends admin_externalpage {
  * Default message outputs configuration
  *
  * @deprecated since Moodle 3.7 MDL-64495. Please use admin_page_managemessageoutputs instead.
- * @todo       MDL-64866 This will be deleted in Moodle 4.1.
+ * @todo       MDL-64866 This will be deleted in Moodle 3.11.
  *
  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
@@ -6547,7 +6547,7 @@ class admin_page_defaultmessageoutputs extends admin_page_managemessageoutputs {
      * Calls parent::__construct with specific arguments
      *
      * @deprecated since Moodle 3.7 MDL-64495. Please use admin_page_managemessageoutputs instead.
-     * @todo       MDL-64866 This will be deleted in Moodle 4.1.
+     * @todo       MDL-64866 This will be deleted in Moodle 3.11.
      */
     public function __construct() {
         global $CFG;
index ce2ae0b..db165c7 100644 (file)
@@ -66,7 +66,7 @@ class behat_base extends Behat\MinkExtension\Context\RawMinkContext {
      * be enough.
      *
      * @deprecated since Moodle 3.7 MDL-64979 - please use get_reduced_timeout() instead
-     * @todo MDL-64982 This will be deleted in Moodle 4.1
+     * @todo MDL-64982 This will be deleted in Moodle 3.11
      * @see behat_base::get_reduced_timeout()
      */
     const REDUCED_TIMEOUT = 2;
@@ -75,7 +75,7 @@ class behat_base extends Behat\MinkExtension\Context\RawMinkContext {
      * The timeout for each Behat step (load page, wait for an element to load...).
      *
      * @deprecated since Moodle 3.7 MDL-64979 - please use get_timeout() instead
-     * @todo MDL-64982 This will be deleted in Moodle 4.1
+     * @todo MDL-64982 This will be deleted in Moodle 3.11
      * @see behat_base::get_timeout()
      */
     const TIMEOUT = 6;
@@ -84,7 +84,7 @@ class behat_base extends Behat\MinkExtension\Context\RawMinkContext {
      * And extended timeout for specific cases.
      *
      * @deprecated since Moodle 3.7 MDL-64979 - please use get_extended_timeout() instead
-     * @todo MDL-64982 This will be deleted in Moodle 4.1
+     * @todo MDL-64982 This will be deleted in Moodle 3.11
      * @see behat_base::get_extended_timeout()
      */
     const EXTENDED_TIMEOUT = 10;
index 3420ebb..d9e8dfa 100644 (file)
@@ -2761,7 +2761,7 @@ function message_get_contact() {
  *            in such a large SELECT
  *
  * @deprecated since Moodle 3.7
- * @todo The final deprecation of this function will take place in Moodle 41 - see MDL-65319.
+ * @todo The final deprecation of this function will take place in Moodle 3.11 - see MDL-65319.
  *
  * @param string|int $categoryid Either a category id or 'all' for everything
  * @param string $sort A field and direction to sort by
index 8906527..e7f23ef 100644 (file)
@@ -47,7 +47,7 @@ class behat_deprecated extends behat_base {
      * @param string $blockname
      * @return void
      * @deprecated since Moodle 3.7 MDL-64506 - please do not use this definition step any more.
-     * @todo MDL-65215 This will be deleted in Moodle 4.1.
+     * @todo MDL-65215 This will be deleted in Moodle 3.11.
      */
     public function i_dock_block($blockname) {
 
index fe733d4..62272ae 100644 (file)
@@ -22,7 +22,7 @@
  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  *
  * @deprecated since Moodle 3.7 MDL-64495. Please use /admin/message.php instead.
- * @todo       MDL-64866 This will be deleted in Moodle 4.1.
+ * @todo       MDL-64866 This will be deleted in Moodle 3.11.
  */
 require_once(__DIR__ . '/../config.php');
 require_once($CFG->dirroot . '/message/lib.php');
index ae0142c..330f05b 100644 (file)
@@ -1628,7 +1628,7 @@ function forum_print_latest_discussions($course, $forum, $maxdiscussions = -1, $
  * @param bool $children
  * @return int
  * @deprecated since Moodle 3.7
- * @todo MDL-65252 This will be removed in Moodle 4.1
+ * @todo MDL-65252 This will be removed in Moodle 3.11
  */
 function forum_count_replies($post, $children = true) {
     global $USER;
index 23788fd..264841e 100644 (file)
@@ -289,7 +289,7 @@ class mod_forum_external extends external_api {
      *
      * @return array the forum post details
      * @since Moodle 2.7
-     * @todo MDL-65252 This will be removed in Moodle 4.1
+     * @todo MDL-65252 This will be removed in Moodle 3.11
      */
     public static function get_forum_discussion_posts($discussionid, $sortby = "created", $sortdirection = "DESC") {
         global $CFG, $DB, $USER, $PAGE;