From baac82435d239cf0fc74a8c3a517de77db007221 Mon Sep 17 00:00:00 2001
From: Alexei Znamensky <russoz@gmail.com>
Date: Mon, 21 Jul 2025 21:16:31 +1200
Subject: [PATCH] cpanm: deprecate mode=compatibility

---
 plugins/modules/cpanm.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plugins/modules/cpanm.py b/plugins/modules/cpanm.py
index 482183c0e0..3cf807ed5b 100644
--- a/plugins/modules/cpanm.py
+++ b/plugins/modules/cpanm.py
@@ -211,6 +211,7 @@ class CPANMinus(ModuleHelper):
         if v.mode == "compatibility":
             if v.name_check:
                 self.do_raise("Parameter name_check can only be used with mode=new")
+            self.deprecate("'mode=compatibility' is deprecated, use 'mode=new' instead", version='12.0.0', collection_name="community.general")
         else:
             if v.name and v.from_path:
                 self.do_raise("Parameters 'name' and 'from_path' are mutually exclusive when 'mode=new'")