DOC: `from_dataframe` contains deprecated parameter `DataFrameXchg` but is not deprecated itself

[cmp0xff]

Pandas version checks

• I have checked that the issue still exists on the latest versions of the docs on main here

Location of the documentation

https://pandas.pydata.org/docs/dev/reference/api/pandas.api.interchange.from_dataframe.html

Documentation problem

The function uses deprecated DataFrameXchg, but it is not declared to be deprecated itself. This issue is found in pandas-dev/pandas-stubs#1481.

Suggested fix for documentation

I guess the function will share the same deprecation plan with DataFrameXchg.

[jbrockmendel]

@MarcoGorelli does the recent deprecation of __dataframe__ handle this?

[MarcoGorelli]

I think the type should be updated to use ArrowStreamExportable hint from https://arrow.apache.org/docs/format/CDataInterface/PyCapsuleInterface.html#protocol-typehints