[WIP] 'hidden' option for domain directives

[jakobandersen]

Feature or Bugfix

• Feature

Purpose

Adding feature for #9662, implemented as suggested in #9662 (comment).

Each domain directive that inherits from ObjectDescription and keeps the option_spec entries in that base class gets an option hidden. This will cause the complete document subtree rooted at that declaration to be replaced with an empty inline node but where all ids mention in the replaced subtree are put in the new node. As the domains have already run, this effectively hides the declaration, but keeps the anchors in the document.

Detail

Each addnodes.desc gets a boolean hidden attribute based on the option, which the post-transform searches for.
Instead of duplicating the option I have changed the py, c, cpp, and js domains to extend a copy of the option_spec in ObjectDescription.

TODO

Assuming this implementation is reasonable the following should be done:

• Add tests for each of the domains (py, c, cpp, js).
• Add documentation.
• Whatever I forgot.

References

Fixes #9662

[AA-Turner]

Closing in favour of #10478.

A