gh-107659: ctypes: Add docstrings for ctypes.pointer and ctypes.POINTER

[tomasr8]

Adds docstrings for ctypes.pointer and ctypes.POINTER and converts both functions to Argument Clinic.
(First time using the AC so I apologize in advance if I missed something 😄 )

• Issue: ctypes: Add docstrings for ctypes.pointer and ctypes.POINTER #107659

[AA-Turner]

@erlend-aasland -- Unsure on correct practice here, I would normally apply backport labels for docs PRs, but as this introduces AC, it may not be correct to backport the change. What would you advise?

A

[erlend-aasland]

@erlend-aasland -- Unsure on correct practice here, I would normally apply backport labels for docs PRs, but as this introduces AC, it may not be correct to backport the change. What would you advise?

IIRC, we generally do not backport PRs that introduce Argument Clinic.

[erlend-aasland]

Some suggestions to the docstring text. (Remember to regenerate clinic after applying.)

[tomasr8]

Thanks for the review! I've applied your suggestions :) Just wondering, since the docstrings were taken mostly verbatim from the docs, should we also update the docs (e.g. use the imperative there as well)?

[erlend-aasland]

Thanks for the review! I've applied your suggestions :) Just wondering, since the docstrings were taken mostly verbatim from the docs, should we also update the docs (e.g. use the imperative there as well)?

IMO, that would be an improvement. I'd do it in a follow-up PR, so we could backport through to 3.11. IMO, we should normalise the wording in the entire prose of that page, so one section at the time could make sense.

[erlend-aasland]

FTR, I did a similar operation for the sqlite3 docs last year, though through multiple PRs.

[erlend-aasland]

Thanks!