Hey,

I'd like to request the ability to include same-page anchors in toctree.

A syntax similar to:

TOC
:::::::::::::::::::::
.. toctree::

    #constructors
    #set_get_methods
    #operators

Use case:
I'm using breathe to generate my c++ documentation from doxygen and having the ability to include some or all of the permalinks on my page in the table of contents would be desireable. Here's the real world use case for me: (an arbitrary anchor for reference) http://xo-math.readthedocs.io/en/latest/classes/vector4.html#special_operators

In this example doc you'll see I hacked in support for this myself. Having proper support so my TOC shows up in the side bar would be incredible.

Thanks,
Jared