Support Sphinx :reversed: on .. toctree::

[d-s-codappix]

Feature request

The .. toctree:: directive of Sphinx has an option :reversed: which will invert the order of entries: https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-option-toctree-reversed

This is useful for situations like:

.. _changelog:

Changelog
=========

.. toctree::
   :glob:
   :reversed:

   Changelog/*

That way newest versions are at the top.

Would be cool to have that supported. Right now the option seems to be ignored.

We use this here: https://github.com/werkraum-media/events/blob/main/Documentation/Changelog.rst rendered result: https://docs.typo3.org/p/werkraummedia/events/main/en-us/Changelog.html

[jaapio]

If I get this right it will only order the documents in reverse not the sub headings?

[d-s-codappix]

To be honest: I don't know but good question.
https://github.com/sphinx-doc/sphinx/blob/116a430caca98580c8877cf7b0ba270eae9604bf/sphinx/directives/other.py#L62 looks to be the implementation of sphinx, which seem to reverse both.

But https://docs.typo3.org/p/werkraummedia/events/main/en-us/Changelog.html shows that only the files seem to be reversed. Maybe TYPO3 used an older version of Sphinx. But I guess it will only reverse the top level? Like you wrote, not the sub headings.