From 8c1ab804b387ac2f6f55f9397e9d5c8a5684dd58 Mon Sep 17 00:00:00 2001
From: Andrew Nicols <andrew@nicols.co.uk>
Date: Fri, 14 Jun 2024 09:24:40 +0800
Subject: [PATCH] MDL-82191 core: Deprecated unused stale libraries

---
 .upgradenotes/MDL-82191-2024061401255575.yml |  9 +++++++++
 lib/soaplib.php                              | 13 +++++++++----
 lib/tests/coverage.php                       |  2 --
 lib/tokeniserlib.php                         | 10 ++++++++++
 4 files changed, 28 insertions(+), 6 deletions(-)
 create mode 100644 .upgradenotes/MDL-82191-2024061401255575.yml

diff --git a/.upgradenotes/MDL-82191-2024061401255575.yml b/.upgradenotes/MDL-82191-2024061401255575.yml
new file mode 100644
index 00000000000..34a4eb23373
--- /dev/null
+++ b/.upgradenotes/MDL-82191-2024061401255575.yml
@@ -0,0 +1,9 @@
+issueNumber: MDL-82191
+notes:
+  core:
+    - message: |
+        The following files and their contents have been deprecated:
+
+        - `lib/soaplib.php
+        - `lib/tokeniserlib.php`
+      type: deprecated
diff --git a/lib/soaplib.php b/lib/soaplib.php
index dc9f3384c5e..4ef50ec2b1f 100644
--- a/lib/soaplib.php
+++ b/lib/soaplib.php
@@ -16,10 +16,7 @@
 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
 
 /**
- * Web services wrapper library script
- *
- * Since Moodle 2.0 we rely only on native PHP Soap extension,
- * the original name of this file was lib/soap/phpsoap.php
+ * Web services wrapper library script.
  *
  * @package    core
  * @subpackage lib
@@ -27,10 +24,18 @@
  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  *             {@link http://maths.york.ac.uk/serving_maths}
  *             and others
+ * @deprecated Moodle 4.5
+ * @todo MDL-89124 Remove this file.
  */
 
 defined('MOODLE_INTERNAL') || die();
 
+debugging(
+    'The soaplib.php file is deprecated and should not be used any more. ',
+    DEBUG_DEVELOPER,
+);
+
+
 /**
 * Create a new SoapClient object
 *
diff --git a/lib/tests/coverage.php b/lib/tests/coverage.php
index dce3ee1026e..0c8faeeff83 100644
--- a/lib/tests/coverage.php
+++ b/lib/tests/coverage.php
@@ -100,10 +100,8 @@ return new class extends phpunit_coverage_info {
         'searchlib.php',
         'sessionlib.php',
         'setuplib.php',
-        'soaplib.php',
         'statslib.php',
         'tablelib.php',
-        'tokeniserlib.php',
         'upgradelib.php',
         'uploadlib.php',
         'webdavlib.php',
diff --git a/lib/tokeniserlib.php b/lib/tokeniserlib.php
index ac9112f7291..75d7c91246d 100644
--- a/lib/tokeniserlib.php
+++ b/lib/tokeniserlib.php
@@ -48,8 +48,18 @@
  * @package   moodlecore
  * @copyright (C) 2001-3001 Eloy Lafuente (stronk7) {@link http://contiento.com}
  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ * @deprecated Moodle 4.5
+ * @todo MDL-89124 Remove this file.
  */
 
+defined('MOODLE_INTERNAL') || die();
+
+debugging(
+    'The tokeniserlib.php file is deprecated and should not be used any more. ',
+    DEBUG_DEVELOPER,
+);
+
+
 /**
  * Some constants
  */