From 2d1503262d3ba5cbdaee97c45606c38cb262404a Mon Sep 17 00:00:00 2001
From: jfbu <jfbu@free.fr>
Date: Tue, 23 May 2017 13:00:42 +0200
Subject: [PATCH] Add explanatory comment in LaTeX style file for
 ``\spx@VerbatimFBox``

---
 sphinx/texinputs/sphinx.sty | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/sphinx/texinputs/sphinx.sty b/sphinx/texinputs/sphinx.sty
index 2c73a9e10..05683a914 100644
--- a/sphinx/texinputs/sphinx.sty
+++ b/sphinx/texinputs/sphinx.sty
@@ -722,6 +722,11 @@
 
 % Inspired and adapted from framed.sty's \CustomFBox with extra handling
 % of a non separable by pagebreak caption.
+% The sole purpose of this macro is to add the framing and the title. The #1
+% already has the typeset contents with background color, and took into
+% account the \sphinxverbatimsep. The \fboxsep parameter is here zero
+% (see \spx@fcolorbox definition) in order for the frame borders to exactly
+% fit the colored contents.
 \long\def\spx@VerbatimFBox#1{%
   \leavevmode
   \begingroup