latex: hint that code-blocks continue on next page (closes #3764)

doc/latex.rst

@@ -189,6 +189,15 @@ The available styling options
     default ``true``. Tells whether long lines in :rst:dir:`code-block`\ 's
     contents should wrap.
 
+``verbatimhintsturnover``
+    default ``false``. If ``true``, code-blocks display "continued on next
+    page", "continued from previous page" hints in case of pagebreaks.
+
+    .. versionadded:: 1.6.3
+       the default will change to ``true`` at 1.7 and horizontal positioning
+       of continuation hints (currently right aligned only) will be
+       customizable.
+
 ``parsedliteralwraps``
     default ``true``. Tells whether long lines in :dudir:`parsed-literal`\ 's
     contents should wrap.
@@ -359,7 +368,8 @@ Macros
   ``indexentry``, ``indexextra``, ``indexpageref``, ``topictitle``,
   ``sidebartitle``, ``othertitle``, ``sidebarsubtitle``, ``thead``,
   ``theadfamily``, ``emphasis``, ``literalemphasis``, ``strong``,
-  ``literalstrong``, ``abbreviation``, ``literalintitle``.
+  ``literalstrong``, ``abbreviation``, ``literalintitle``, ``codecontinued``,
+  ``codecontinues``.
 
   .. versionadded:: 1.5
      these macros were formerly hard-coded as non customizable ``\texttt``,
@@ -369,6 +379,8 @@ Macros
      multiple paragraphs in header cells of tables.
   .. deprecated:: 1.6
      macro ``\sphinxstylethead`` is deprecated at 1.6 and will be removed at 1.7.
+  .. versionadded:: 1.6.3
+     ``\sphinxstylecodecontinued`` and ``\sphinxstylecodecontinues``.
 - by default the Sphinx style file ``sphinx.sty`` executes the command
   ``\fvset{fontsize=\small}`` as part of its configuration of
   ``fancyvrb.sty``. This may be overriden for example via