Merge pull request #10859 from jfbu/latex_doc_tableofcontentshook

LaTeX: improve doc of \sphinxtableofcontents (closes #10858)

doc/latex.rst

@@ -1300,6 +1300,12 @@ Macros
      ``\sphinxtableofcontentshook``.  This macro is also executed by the
      ``'howto'`` docclass, but defaults to empty with it.
 
+  .. hint::
+
+     If adding to preamble the loading of ``tocloft`` package, also add to
+     preamble ``\renewcommand\sphinxtableofcontentshook{}`` else it will reset
+     ``\l@section`` and ``\l@subsection`` cancelling ``tocloft`` customization.
+
 - ``\sphinxmaketitle``: Used as the default setting of the ``'maketitle'``
   :confval:`latex_elements` key.
   Defined in the class files :file:`sphinxmanual.cls` and