Docs: turn getopt examples into doctests #131519

Job	Run time
Change detection / Compute changed files	10s
Windows ${{ ((fromJSON(matrix.free-threading) && '(free-threading)') \|\| '') }}	0s
Windows MSI${{ '' }}	0s
Check if Autoconf files are up to date	0s
Check if generated files are up to date	0s
macOS ${{ ((fromJSON(matrix.free-threading) && '(free-threading)') \|\| '') }}	0s
Ubuntu ${{ ((fromJSON(matrix.free-threading) && '(free-threading)') \|\| '') }}	0s
Ubuntu SSL tests with OpenSSL	0s
WASI	0s
Address sanitizer	0s
Thread sanitizer	0s
Thread sanitizer (free-threading)	0s
Hypothesis tests on Ubuntu	0s
CIFuzz	0s
Docs / Docs	2m 9s
Docs / Docs (Oldest Sphinx)	2m 12s
Docs / Doctest	27m 36s
All required checks pass	3s
	32m 10s

Provide feedback