docs: change docstring so API docs are correctly updated

Author: sbillinge

src/diffpy/utils/_deprecator.py

@@ -110,3 +110,10 @@ def deprecation_message(
         f"version {removal_version}. Please use '{new_base}.{new_name}' "
         f"instead."
     )
+
+
+_DEPRECATION_DOCSTRING_TEMPLATE = (
+    "This function has been deprecated and will be "
+    "removed in version {removal_version}. Please use"
+    "{new_base}.{new_name} instead."
+)

src/diffpy/utils/parsers/loaddata.py

@@ -36,6 +36,11 @@
 def loadData(
     filename, minrows=10, headers=False, hdel="=", hignore=None, **kwargs
 ):
+    """This function has been deprecated and will be removed in version
+    4.0.0.
+
+    Please use diffpy.utils.parsers.load_data instead.
+    """
     return load_data(filename, minrows, headers, hdel, hignore, **kwargs)