doc: \section commands elsewhere than top-level docs are not supported.

The visual layout is not ready for such thing at all.

diff --git a/doc/doxygen.rst b/doc/doxygen.rst
index 4cd7a096164ec63d8ad00796ef77fde5da64aaf3..e88900c63f09e8f988110935ac5934f59587ef61 100644 (file)
--- a/doc/doxygen.rst
+++ b/doc/doxygen.rst
@@ -204,6 +204,9 @@ amount of generated content for no added value.
     accompanied with corresponding tutorial page instead)
 -   :cpp:`inline` functions are not marked as such (I see it as an unimportant
     implementation detail)
+-   ``@section``, ``@subsection`` etc. commands inside anything else than
+    top-level documentation of a class, namespace, file, directory, page or
+    module are not supported as the visual layout is not expecting such things
 
 `Not yet implemented features`_
 -------------------------------