From af5363cefb32b2a7cde140ac4332417d9edb7374 Mon Sep 17 00:00:00 2001
From: jfbu <2589111+jfbu@users.noreply.github.com>
Date: Mon, 19 Jul 2021 12:07:03 +0200
Subject: [PATCH] LaTeX: add some documentation for container support (#9166)

---
 doc/latex.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/latex.rst b/doc/latex.rst
index f6d2987e2..f0b5a4aa8 100644
--- a/doc/latex.rst
+++ b/doc/latex.rst
@@ -1151,6 +1151,20 @@ Miscellany
      Formerly, use of *fncychap* with other styles than ``Bjarne`` was
      dysfunctional.
 
+- Docutils :dudir:`container` directives are supported in LaTeX output: to
+  let a container class with name ``foo`` influence the final PDF via LaTeX,
+  it is only needed to define in the preamble an environment
+  ``sphinxclassfoo``.  A simple example would be:
+
+  .. code-block:: latex
+
+     \newenvironment{sphinxclassred}{\color{red}}{}
+
+  Currently the class names must contain only ascii characters and avoid
+  characters special to LaTeX such as ``\``.
+
+  .. versionadded:: 4.1.0
+
 .. hint::
 
    As an experimental feature, Sphinx can use user-defined template file for