Sphinx generates an index named genindex when building a documentation and therefore forbids to use that name for a document. Now, how would I include a link to that index in a table of contents?
I've tried this:
.. toctree::
:maxdepth: 2
genindex
api
Indices and tables
==================
* :ref:`genindex`
While the last line does create a link to that index in the document, the build doesn't know the reference when creating the TOC:
WARNING: toctree contains reference to nonexisting document 'genindex'