hack hocdomain.py for Sphinx 5.0.1

[alexsavulescu]

Sphinx 5.0.1 is out:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/nrn/conda/latest/lib/python3.10/site-packages/sphinx/config.py", line 343, in eval_config_file
    exec(code, namespace)
  File "/home/docs/checkouts/readthedocs.org/user_builds/nrn/checkouts/latest/docs/conf.py", line 22, in <module>
    import hocdomain  # Sphinx HOC domain (hacked from the Python domain via docs/generate_hocdomain.py)
  File "/home/docs/checkouts/readthedocs.org/user_builds/nrn/checkouts/latest/docs/domains/hocdomain.py", line 41, in <module>
    from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning
ImportError: cannot import name 'RemovedInSphinx50Warning' from 'sphinx.deprecation' (/home/docs/checkouts/readthedocs.org/user_builds/nrn/conda/latest/lib/python3.10/site-packages/sphinx/deprecation.py)

[alexsavulescu]

RTD build successful: https://nrn.readthedocs.io/en/hocdomain501/

[azure-pipelines]

✔️ 646ba9e -> Azure artifacts URL

[nrnhines]

Don't know how you figured some of this out :) Did you analyze the differences between old and new sphinx/domains/python.py ? Do you have debugging understanding that is teachable? There is a hackathon coming up ... :)

[alexsavulescu]

@nrnhines it's all in the error log above :) import hocdomain # Sphinx HOC domain (hacked from the Python domain via docs/generate_hocdomain.py)

https://docs.google.com/presentation/d/19k5O9DjTTGffdq4nQEEzGZtYdL_0sZTFMARje7UUVPI/edit#slide=id.g10eed073d91_0_0

[alexsavulescu]

There is a hackathon coming up ... :)

I've created one ticket related to this