schedule debug arg for removal

src/pymatgen/util/io_utils.py

@@ -4,6 +4,7 @@
 
 import os
 import re
+import warnings
 from typing import TYPE_CHECKING
 
 from monty.io import zopen
@@ -65,8 +66,6 @@ def micro_pyawk(
     run(results, match), where match is the Match object from running
     Pattern.match.
 
-    TODO: deprecate and remove debug/postdebug?
-
     Args:
         filename (PathLike): The file to search through.
         search (list[tuple[Pattern | str, Callable, Callable]]): The "search program" of
@@ -82,6 +81,12 @@ def micro_pyawk(
 
     Author: Rickard Armiento, Ioannis Petousis
     """
+    # TODO: remove debug and postdebug after 2025-11-09 if no one is opposing
+    if debug is not None:
+        warnings.warn("arg debug is scheduled for removal, see PR4160", DeprecationWarning, stacklevel=2)
+    if postdebug is not None:
+        warnings.warn("arg postdebug is scheduled for removal, see PR4160", DeprecationWarning, stacklevel=2)
+
     if results is None:
         results = {}