Deprecate t.w.h.HTTPClient

[twm]

Is your feature request related to a problem? Please describe.

I think this speaks for itself:

twisted/src/twisted/web/http.py

Lines 626 to 628 in dd3b1f3

	class HTTPClient(basic.LineReceiver):
	"""
	A client for HTTP 1.0.

It looks like we forgot to deprecate and remove this along with getPage and friends (in #10295).

Describe the solution you'd like

Deprecate it, and file a ticket to remove it per policy.

Describe alternatives you've considered

Leave it sitting there like a footgun. 🤷‍♂️

Additional context

See #735 (comment) and note #12159.

[adiroiban]

+1 deprecate it... and I think that we should just skip trying to fix the existing bugs

[glyph]

👍

[glyph]

FWIW I think the reason it has lingered on so long is that it's the backing for getPage, which the docs use a bunch

[twm]

getPage was removed in #10295 so I'll clean up any lingering references as part of this.