:orphan: options sometimes shows up
More precisely, I use the
:orphan: option in RST files that are not used in the
toctree, but are included by other files (for factorizing role declarations, for example).
include directive is at the top of the including file, then no problem, the
:orphan: does not appear, as expected. However, if the
include directives appears at other places, then the
:orphan: option shows up at the beginning of the included content.
Although I guess I understand why this happens, it seems to contradict the documentation stating that:
In Sphinx, a field list preceding any other markup (...) is not displayed in the output.
Also, this is in my opinion a bug worth fixing, as included files are an obvious use case for the