Deprecated upload_docs command. Ref #2971

Author: jaraco

changelog.d/2971.change.rst

@@ -0,0 +1 @@
+Deprecated upload_docs command, to be removed in the future.

setuptools/command/upload_docs.py

@@ -17,8 +17,10 @@
 import functools
 import http.client
 import urllib.parse
+import warnings
 
 from .._importlib import metadata
+from .. import SetuptoolsDeprecationWarning
 
 from .upload import upload
 
@@ -89,6 +91,12 @@ def create_zipfile(self, filename):
             zip_file.close()
 
     def run(self):
+        warnings.warn(
+            "upload_docs is deprecated and will be removed in a future "
+            "version. Use tools like httpie or curl instead.",
+            SetuptoolsDeprecationWarning,
+        )
+
         # Run sub commands
         for cmd_name in self.get_sub_commands():
             self.run_command(cmd_name)