Sphinx 7.3.6__py3-none-any.whl → 7.4.0__py3-none-any.whl

sphinx/texinputs/sphinxlatexadmonitions.sty

@@ -1,25 +1,51 @@
 %% NOTICES AND ADMONITIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexadmonitions.sty}[2023/03/19 admonitions]
+\ProvidesFile{sphinxlatexadmonitions.sty}[2024/07/01 v7.4.0 admonitions]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
-% - sphinxseealso environment added at 6.1.0
+% - sphinxseealso environment added at 6.1.0.
+%
+% At 7.4.0 it too now uses sphinxheavybox, and has the same associated
+% sphinxsetup CSS keys as admonitions do.
+%
+% - sphinxtodo environment added at 7.4.0.
 %
 % - sphinxadmonition (environment)
-%   This is a dispatch supporting
+%   This is a dispatch which formerly configured
+%
+%   - note, hint, important, tip to use sphinxlightbox (or optionally
+%     sphinxheavybox since 6.2.0),
+%   - warning, caution, attention, danger, error to use sphinxheavybox.
 %
-%   - note, hint, important, tip                 (via sphinxlightbox)
-%                    (also optionally via sphinxheavybox since 6.2.0)
-%   - warning, caution, attention, danger, error (via sphinxheavybox)
+% At 7.4.0 all admonitions use sphinxheavybox.
 %
-%   Each sphinx<notice name> environment can be redefined by user.
-%   The defaults are customizable via various colour and dimension
-%   settings, cf sphinx docs (latex customization).
+% - All environments sphinxnote, sphinxwarning, etc... can be redefined as
+%   will by user. Thay have a single parameter #1 which is the title.
+%
+% - The default sphinxnote, sphinxwarning, etc... use associated
+%   one-argument macros \sphinxstylenotetitle, \sphinxstylewarningtitle, etc
+%   which can be redefined.  Their default is to use \sphinxdotitlerowwithicon
+%   to typeset the title in a coloured header row at top of the
+%   admonition. (new with 7.4.0)
+%
+% The sphinxlightbox environment is kept for backward compatiblity, for user
+% custom code which used it via custom definitions done in preamble or via
+% raw latex directive.
+% MEMO: here is for example how sphinxnote was formerly defined:
+% (where #1 is the localized string Note, followed with  a colon)
+%     \newenvironment{sphinxnote}[1]
+%       {\begin{sphinxlightbox}\sphinxstrong{#1} }
+%       {\end{sphinxlightbox}}
+% Use this if you want to revert the 7.4.0 switch to usage of sphinxheavybox.
+% (the 7.4.0 redefined \sphinxstylenotetitle will not work in sphinxlightbox,
+%  so \sphinxstrong{#1}<space> which was its former default is used above).
+
 %
 % Requires:
 \RequirePackage{sphinxpackageboxes}
+% 7.4.0 removes unneeded \spx@boxes@border
 \RequirePackage{framed}% used by sphinxheavybox
 %
 % Dependencies (they do not need to be defined at time of loading):
@@ -29,25 +55,17 @@
 % - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty
 %
 % - \savenotes/\spewnotes from sphinxpackagefootnote (for sphinxheavybox)
-%
-% - \sphinxstylenotetitle, ..., \sphinxstylewarningtitle, etc... which are used by
-%   default in the corresponding sphinx<notice> environments to replace at 6.2.0
-%   formerly hard-coded \sphinxstrong{#1}<space>
-%   Their definitions are in sphinxlatexstyletext.sty.
-
 
 % Provides: (also in sphinxlatexliterals.sty)
+% Only needed here by legacy (deprecated) sphinxlightbox environment.
 \providecommand*\sphinxvspacefixafterfrenchlists{%
    \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi
 }
 
-% Some are quite plain
-\newenvironment{sphinxseealso}[1]{\sphinxstyleseealsotitle{#1}}{}
-
 % This \dimen register is a legacy relic from Sphinx 1.5 which is used now
 % only for sphinxlightbox.  It is set in the sphinxadmonition environment.
 \newdimen\spx@notice@border
-
+% sphinxlightbox is now also a legacy relic, not used by Sphinx anymore
 \newenvironment{sphinxlightbox}{%
   \par
   \noindent{\color{spx@notice@bordercolor}%
@@ -65,55 +83,28 @@
              {\linewidth}{\spx@notice@border}}\hss}\allowbreak
   }% end of sphinxlightbox environment definition
 
-% note/hint/important/tip notices
-%
-% Since 1.5 these environments are named individually to allow user to
-% redefine them entirely.
+% Since 1.5 these environments are named individually sphinxnote, sphinxhint,
+% etc... to allow user to redefine them entirely.
 %
-% The Sphinx definitions were done like this, prior to 6.2.0:
+% The Sphinx definitions for note/hint/important/tip notices were done like
+% this, prior to 6.2.0:
 %
 % \newenvironment{sphinxhint}[1]
 %   {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}}
 %
-% The more complex definition below will branch to sphinxheavybox if a certain
-% boolean associated to the notice type is true.  This boolean is set to true
-% whenever a CSS-named alike options for the notice type has been used in
-% sphinxsetup.  The old coding as above would still work, with the new options
-% being then simply ignored.  A user redefinition will probably either use
-% directly sphinxlightbox or sphinxheavybox or something else, with no need to
-% test the boolean.
-%
-% 6.2.0 also adds one layer of mark-up via \sphinxnotetitle etc..., because
-% the former \sphinxstrong{#1}<space> used a too generic \sphinxstrong.  But
-% perhaps the #1 should be passed over to sphinx{light,heavy}box as parameter.
-% Unfortunately replacing these environments with one-parameter environments
-% would be potentially a breaking change.  Anyway, sphinxpackageboxes.sty does not
-% provide a "titled" box; the caption of code-blocks is handled by extra
-% code in sphinxVerbatim.
-\newenvironment{sphinxnote}[1]
-  {\edef\spx@env{sphinx\ifspx@opt@heavynote heavy\else light\fi box}%
-   \expandafter\begin\expandafter{\spx@env}\sphinxstylenotetitle{#1}}
-  {\expandafter\end\expandafter{\spx@env}}
-\newenvironment{sphinxhint}[1]
-  {\edef\spx@env{sphinx\ifspx@opt@heavyhint heavy\else light\fi box}%
-   \expandafter\begin\expandafter{\spx@env}\sphinxstylehinttitle{#1}}
-  {\expandafter\end\expandafter{\spx@env}}
-\newenvironment{sphinximportant}[1]
-  {\edef\spx@env{sphinx\ifspx@opt@heavyimportant heavy\else light\fi box}%
-   \expandafter\begin\expandafter{\spx@env}\sphinxstyleimportanttitle{#1}}
-  {\expandafter\end\expandafter{\spx@env}}
-\newenvironment{sphinxtip}[1]
-  {\edef\spx@env{sphinx\ifspx@opt@heavytip heavy\else light\fi box}%
-   \expandafter\begin\expandafter{\spx@env}\sphinxstyletiptitle{#1}}
-  {\expandafter\end\expandafter{\spx@env}}
-
-% warning/caution/attention/danger/error  get more distinction
+% Then from 6.2.0 to 7.4.0 (exclusive) a more complex definition decided
+% to use either sphinxlightbox or sphinxheavybox according to whether
+% some CSS-like options had been used, for example for a background color.
+%
+% 6.2.0 also added one layer of mark-up via \sphinxnotetitle etc..., because
+% the former \sphinxstrong{#1}<space> used a too generic \sphinxstrong.
+%
+% At 7.4.0, sphinxheavybox environment is default for all types of notices
+% and also for the seealso and todo directives.
 %
 % Code adapted from framed.sty's "snugshade" environment.
 % Nesting works (inner frames do not allow page breaks).
 \newenvironment{sphinxheavybox}{\par
-   % 6.2.0 allows to not have to distinguish here between warning type notices
-   % which always use sphinxheavybox or note type notices which might use it.
    % (MEMO: it is not a problem here if there is no sphinx<type>ShadowColor,
    %  as it used only if set)
    \spx@boxes@fcolorbox@setup{\spx@noticetype}%
@@ -205,16 +196,80 @@
 % Example:
 % \renewcommand{\sphinxwarningtitle}[1]{\textbf{#1}\par\smallskip
 %   {\color{sphinxwarningBorderColor}\hrule height1pt}\smallskip}
+%
+% - Since 7.4.0, all types of notices use sphinxheavybox and the default
+% for \sphinxstyle<type>title is mapped to using \sphinxdotitlerowwithicon{<type>}
+%
+% MEMO: except for the generic admonition directive (which uses "note" type)
+% the argument #1 in these environments has a postfixed colon originating
+% in Sphinx LaTeX writer legacy code.  The
+% \sphinxremovefinalcolon utility in sphinxlatexstyletext.sty can be used as
+% \sphinxremovefinalcolon{#1} from inside the definitions of
+% \sphinxstylenotetitle et al. commands.
+
+% Important: even prior to 5.1.0 it was not really possible to use directly
+% sphinxheavybox if not triggered from sphinxadmonition, because some
+% parameters were defined in sphinxadmonition.  This meant that the
+% sphinxwarning, sphinxcaution etc... environments (defined below) could not
+% be used directly in a document, they had to be triggered via
+% sphinxadmonition.  The sole data since 5.1.0 needed by sphinxheavybox is the
+% type of the notice which sphinxadmonition stores into \spx@noticetype.
+%
+% In order to facilitate recycling or imitation of the sphinx<type>
+% environments, 7.4.0 inserts an extra \def\spx@noticetype{<type>} in their
+% definitions, so that they can be used independently of sphinxadmonition
+% dispatcher.
+%
+% MEMO: direct usage of these environments does not execute the div.<type>_TeXextras
+% and div.<type>_TexColor code, there are only done from the sphinxadmonition wrapper.
+\newenvironment{sphinxnote}[1]
+  {\def\spx@noticetype{note}\begin{sphinxheavybox}\sphinxstylenotetitle{#1}}
+  {\end{sphinxheavybox}}
+\newenvironment{sphinxhint}[1]
+  {\def\spx@noticetype{hint}\begin{sphinxheavybox}\sphinxstylehinttitle{#1}}
+  {\end{sphinxheavybox}}
+\newenvironment{sphinxtip}[1]
+  {\def\spx@noticetype{tip}\begin{sphinxheavybox}\sphinxstyletiptitle{#1}}
+  {\end{sphinxheavybox}}
+\newenvironment{sphinximportant}[1]
+  {\def\spx@noticetype{important}\begin{sphinxheavybox}\sphinxstyleimportanttitle{#1}}
+  {\end{sphinxheavybox}}
 \newenvironment{sphinxwarning}[1]
-  {\begin{sphinxheavybox}\sphinxstylewarningtitle{#1}}{\end{sphinxheavybox}}
+  {\def\spx@noticetype{warning}\begin{sphinxheavybox}\sphinxstylewarningtitle{#1}}
+  {\end{sphinxheavybox}}
 \newenvironment{sphinxcaution}[1]
-  {\begin{sphinxheavybox}\sphinxstylecautiontitle{#1}}{\end{sphinxheavybox}}
+  {\def\spx@noticetype{caution}\begin{sphinxheavybox}\sphinxstylecautiontitle{#1}}
+  {\end{sphinxheavybox}}
 \newenvironment{sphinxattention}[1]
-  {\begin{sphinxheavybox}\sphinxstyleattentiontitle{#1}}{\end{sphinxheavybox}}
+  {\def\spx@noticetype{attention}\begin{sphinxheavybox}\sphinxstyleattentiontitle{#1}}
+  {\end{sphinxheavybox}}
 \newenvironment{sphinxdanger}[1]
-  {\begin{sphinxheavybox}\sphinxstyledangertitle{#1}}{\end{sphinxheavybox}}
+  {\def\spx@noticetype{danger}\begin{sphinxheavybox}\sphinxstyledangertitle{#1}}
+  {\end{sphinxheavybox}}
 \newenvironment{sphinxerror}[1]
-  {\begin{sphinxheavybox}\sphinxstyleerrortitle{#1}}{\end{sphinxheavybox}}
+  {\def\spx@noticetype{error}\begin{sphinxheavybox}\sphinxstyleerrortitle{#1}}
+  {\end{sphinxheavybox}}
+% The "see also" was quite plain until 7.4.0 as it simply did
+% \newenvironment{sphinxseealso}[1]{\sphinxstyleseealsotitle{#1}}{}
+% Here we need to manually insert execution of div.seealso_TeX{color,extras} values
+\newenvironment{sphinxseealso}[1]
+  {\def\spx@noticetype{seealso}%
+   \begin{sphinxheavybox}\sphinxstyleseealsotitle{#1}%
+   \ifspx@seealso@withtextcolor\color{sphinxseealsoTextColor}\fi
+   \spx@seealso@TeXextras
+  }
+  {\end{sphinxheavybox}}
+% There was no sphinxtodo environment until 7.4.0 because sphinx.ext.todo
+% generated \begin{sphinxadmonition}{note}{Todo:} mark-up.
+\newcounter{sphinxtodo}% to provide targets from todolist directive output
+\newenvironment{sphinxtodo}[1]
+  {\refstepcounter{sphinxtodo}\def\spx@noticetype{todo}%
+   \begin{sphinxheavybox}\sphinxstyletodotitle{#1}%
+   \ifspx@todo@withtextcolor\color{sphinxtodoTextColor}\fi
+   \spx@todo@TeXextras
+  }
+  {\end{sphinxheavybox}}
+
 
 % the main dispatch for all types of notices
 \newenvironment{sphinxadmonition}[2]{% #1=type, #2=heading
@@ -227,16 +282,104 @@
   % the more bulky "sphinx\spx@noticetype BgColor".
   \sphinxcolorlet{spx@notice@bordercolor}{sphinx#1BorderColor}%
   \sphinxcolorlet{spx@notice@bgcolor}{sphinx#1BgColor}%
-  \spx@notice@border \dimexpr\csname spx@#1@border\endcsname\relax
+  % At 7.4.0 there are no \spx@<type>@boder macros anymore only top, left,
+  % bottom, right.  For this legacy \spx@notice@border only needed by
+  % sphinxlightbox (which is not used by own Sphinx environments anymore)
+  % we thus use here @top
+  \spx@notice@border \dimexpr\csname spx@#1@border@top\endcsname\relax
   % trigger the sphinx<type> environment, #2=heading is passed as argument
   \begin{sphinx#1}{#2}%
+  % MEMO: the heading #2 will be typeset before the next lines are executed
   % 6.2.0 support of div.<type>_TeX{color,extras} options
   \csname ifspx@\spx@noticetype @withtextcolor\endcsname
          \color{sphinx\spx@noticetype TextColor}%
   \fi
+  % Other code to be executed at start of contents (after title)
   \csname spx@\spx@noticetype @TeXextras\endcsname
   }
-  % workaround some LaTeX "feature" of \end command (can't use "sphinx#1" here)
+  % workaround some LaTeX "feature" of \end command (i.e. can't use "sphinx#1" here)
   {\edef\spx@temp{\noexpand\end{sphinx\spx@noticetype}}\spx@temp}
 
+\newcommand\sphinxtitlerowtoppadding{5pt}
+\newcommand\sphinxtitlerowbottompadding{3pt}
+\newcommand\sphinxtitlerowaftericonspacecmd{\hskip0.5em\relax}
+\newcommand\sphinxdotitlerowwithicon[2]{% #1=type, #2=heading (without final colon)
+   \begingroup
+     \kern-\spx@boxes@padding@top
+     \parskip\z@skip % the \parskip business is a workaround to a vertical
+                     % glue issue showing in LaTeX earlier than 2023-06-01
+     \noindent
+     \kern-\spx@boxes@padding@left % must have been configured by a prior
+                                   % \spx@boxes@fcolorbox@setup{<type>}
+     % inherit settings from the enclosing box and modify what is needed
+     \spx@boxes@border@top    =\z@
+     \spx@boxes@border@right  =\z@
+     \spx@boxes@border@bottom =\z@
+     \spx@boxes@border@left   =\z@
+     \spx@boxes@radius@bottomright@x=\z@
+     \spx@boxes@radius@bottomright@y=\z@
+     \spx@boxes@radius@bottomleft@x=\z@
+     \spx@boxes@radius@bottomleft@x=\z@
+     \spx@boxes@padding@top   =\sphinxtitlerowtoppadding\relax
+     \spx@boxes@padding@bottom=\sphinxtitlerowbottompadding\relax
+     \spx@boxes@withshadowfalse
+     \sphinxcolorlet{spx@boxes@backgroundcolor}{sphinx#1TtlBgColor}%
+     \spx@boxes@fcolorbox{%
+        \makebox[\linewidth][l]{%
+         \textcolor{sphinx#1TtlFgColor}{%
+            \@nameuse{sphinx#1TtlIcon}%
+            % This macro is located here and not after the closing brace
+            % for reasons of fall-back \spx@faIcon definition in sphinx.sty
+            % in case fontawesome5 package not found.
+            \sphinxtitlerowaftericonspacecmd
+         }%
+         \sphinxstrong{#2}%
+         \strut}%
+      }%
+     \kern-\spx@boxes@padding@right
+     \par
+   \endgroup
+   \vskip-\parskip
+   \kern\spx@boxes@padding@top
+}
+
+% #1 holds the localized name of the notice, postfixed with a colon.
+% \sphinxremovefinalcolon{#1} will typeset #1 without the colon.
+% Legacy definitions (done in sphinxlatexstyletext.sty) were all using
+% a boring plain \sphinxstrong{#1}, now we use a coloured title row.
+\newcommand\sphinxstylenotetitle     [1]{\sphinxdotitlerowwithicon{note}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstylehinttitle     [1]{\sphinxdotitlerowwithicon{hint}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleimportanttitle[1]{\sphinxdotitlerowwithicon{important}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyletiptitle      [1]{\sphinxdotitlerowwithicon{tip}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstylewarningtitle  [1]{\sphinxdotitlerowwithicon{warning}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstylecautiontitle  [1]{\sphinxdotitlerowwithicon{caution}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleattentiontitle[1]{\sphinxdotitlerowwithicon{attention}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyledangertitle   [1]{\sphinxdotitlerowwithicon{danger}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleerrortitle    [1]{\sphinxdotitlerowwithicon{error}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleseealsotitle  [1]{\sphinxdotitlerowwithicon{seealso}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyletodotitle     [1]{\sphinxdotitlerowwithicon{todo}{\sphinxremovefinalcolon{#1}}}
+%
+% A utility to remove a final colon.  Removing last token is not easy in
+% LaTeX, and there are additional complications:
+% - some languages will make the : "active" in document body,
+% - the generic admonition ends up using "note", so for \sphinxnotetitle to
+%   use it safely, the utility has to allow an input not having any final colon.
+% - a bit far-fetched but maybe there is more than one colon inside the input
+%   (possible from a generic admonition title).
+% Hence the scary code.
+\newcommand\sphinxremovefinalcolon[1]{% #1 is the "active" : TeX token
+% Prior to 7.4.0 this was defined with \protected\def but we do not
+% see what usefulness this could have.
+\renewcommand\sphinxremovefinalcolon[1]{%
+   % complications due to : possibly "active"
+   \begingroup\ifnum\catcode`:=\active
+                    \def\x####1#1\relax{####1}%
+               \else\def\x####1:\relax{####1}\fi
+   \expandafter\endgroup\x##1\relax
+   % trick to let \x work also if input ##1 has no ending colon
+   \@gobblefour#1\relax:\relax\relax\relax
+   }%
+}% end of wrapper to inject active :
+\begingroup\catcode`:\active\expandafter\endgroup\sphinxremovefinalcolon:
+
 \endinput

sphinx/texinputs/sphinxlatexliterals.sty

@@ -1,7 +1,7 @@
 %% LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexliterals.sty}[2023/04/01 code-blocks and parsed literals]
+\ProvidesFile{sphinxlatexliterals.sty}[2024/07/01 v7.4.0 code-blocks and parsed literals]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
@@ -34,6 +34,7 @@
 % - needspace
 % - sphinxpackageboxes
 \RequirePackage{sphinxpackageboxes}
+% 7.4.0 removes unneeded usage of \spx@boxes@border
 
 % also in sphinxlatexadmonitions.sty:
 % This is a workaround to a "feature" of French lists, when literal block
@@ -224,7 +225,6 @@
        \spx@boxes@border@right\z@
        \spx@boxes@border@bottom\z@
        \spx@boxes@border@left\z@
-       \spx@boxes@border\z@
        % MEMO: rounded corners still make sense in presence of a background
        % color, so we do not force the fcolorbox@rectangle here
     \fi
@@ -670,25 +670,18 @@
        \def\sphinxVerbatim@Before
            {\sphinxVerbatim@Title\nointerlineskip
             \kern\dimexpr-\dp\strutbox+\sphinxbelowcaptionspace
-                 % if no frame (code-blocks inside table cells), remove
-                 % the top padding (better visually)
-                 \ifspx@opt@verbatimwithframe\else
-                    % but we must now check if there is a background color
-                    % MEMO: "fcolorbox@setup" will have been done by time of use
-                    \ifspx@boxes@withbackgroundcolor\else-\spx@boxes@padding@top\fi
-                \fi
+                 % MEMO: prior to 7.4.0 a test was done for presence or
+                 % not of a frame and if not top padding was removed if
+                 % no background color.  A background color is now always
+                 % assumed, so this got removed.
                  % caption package adds \abovecaptionskip vspace, remove it
-                 \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax}%
+            \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax}%
      \else
        \vskip\sphinxverbatimsmallskipamount
        \def\sphinxVerbatim@After
           {\nointerlineskip\kern\dimexpr\dp\strutbox
-            \ifspx@opt@verbatimwithframe\else
-                    % but we must now check if there is a background color
-                    % MEMO: "fcolorbox@setup" will have been done by time of use
-                    \ifspx@boxes@withbackgroundcolor\else-\spx@boxes@padding@bottom\fi
-            \fi
-            \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax
+           % MEMO: 7.4.0 removes here too an optional removal of bottom padding
+           \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax
            \sphinxVerbatim@Title}%
      \fi
      \def\@captype{literalblock}%

sphinx/texinputs/sphinxlatexstyletext.sty

@@ -1,45 +1,11 @@
 %% TEXT STYLING
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstyletext.sty}[2023/07/23 text styling]
+\ProvidesFile{sphinxlatexstyletext.sty}[2024/07/01 v7.4.0 text styling]
 
-% Basically everything here consists of macros which are part of the latex
-% markup produced by the Sphinx latex writer
-
-% But those arise rather from the default definitions of the respective
-% latex environments done in sphinxlatexadmonitions.sty
-\def\sphinxstylenotetitle   #1{\sphinxstrong{#1} }
-\let\sphinxstylehinttitle     \sphinxstylenotetitle % #1 holds the localized notice name
-\let\sphinxstyleimportanttitle\sphinxstylenotetitle % followed by a colon
-\let\sphinxstyletiptitle      \sphinxstylenotetitle
-\let\sphinxstylewarningtitle  \sphinxstylenotetitle
-\let\sphinxstylecautiontitle  \sphinxstylenotetitle
-\let\sphinxstyleattentiontitle\sphinxstylenotetitle
-\let\sphinxstyledangertitle   \sphinxstylenotetitle
-\let\sphinxstyleerrortitle    \sphinxstylenotetitle
-\def\sphinxstyleseealsotitle#1{\sphinxstrong{#1}\par\nopagebreak}
-%
-% A utility to remove a final colon.  Removing last token is not easy in
-% LaTeX, and there are additional complications:
-% - some languages will make the : "active" in document body,
-% - the generic admonition ends up using "note", so for \sphinxnotetitle to
-%   use it safely, the utility has to allow an input not having any final colon.
-% - a bit far-fetched but maybe there is more than one colon inside the input
-%   (possible from a generic admonition title).
-% Hence the scary code.
-\def\sphinxremovefinalcolon#1{% #1 is the "active" : TeX token
-\protected\def\sphinxremovefinalcolon ##1{%
-   % complications due to : possibly "active"
-   \begingroup\ifnum\catcode`:=\active
-                    \def\x####1#1\relax{####1}%
-               \else\def\x####1:\relax{####1}\fi
-   \expandafter\endgroup\x##1\relax
-   % trick to let \x work also if input ##1 has no ending colon
-   \@gobblefour#1\relax:\relax\relax\relax
-   }%
-}% end of wrapper to inject active :
-\begingroup\catcode`:\active\expandafter\endgroup\sphinxremovefinalcolon:
-% See doc/latex.rst for an example.
+% 7.4.0 has moved all that is related to admonitions to sphinxlatexadmonitions.sty
+% Most everything left here consists of macros which are part of the latex markup
+% produced by the Sphinx LaTeX writer.
 
 % Some custom font markup commands.
 \protected\def\sphinxstrong#1{\textbf{#1}}

sphinx/texinputs/sphinxlatextables.sty

@@ -1,7 +1,7 @@
 %% TABLES (WITH SUPPORT FOR MERGED CELLS OF GENERAL CONTENTS)
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatextables.sty}[2022/08/15 tables]%
+\ProvidesFile{sphinxlatextables.sty}[2024/07/01 v7.4.0 tables]%
 
 % Provides support for this output mark-up from Sphinx latex writer
 % and table templates:
@@ -42,6 +42,11 @@
 % - \sphinxthistablewithnocolorrowsstyle
 % - \sphinxthistablewithvlinesstyle
 % - \sphinxthistablewithnovlinesstyle
+% 
+% Also provides user command (see docs)
+% - \sphixncolorblend
+%   (Sphinx 7.4.0 now requires xcolor, so \sphinxcolorblend does not check
+%    its availability anymore) 
 %
 % Executes \RequirePackage for:
 %
@@ -513,19 +518,6 @@
     \fi
 }
 \def\sphinxcolorblend#1{\gdef\spx@colorblendparam{{#1}}\spx@table@hackCT@colorblend}
-% Either xcolor.sty exists on user system and has been loaded by sphinx.sty,
-% or it does not exist, so we can use \@ifpackageloaded without delaying.
-\@ifpackageloaded{xcolor}%
-  {}%
-  {\def\sphinxcolorblend#1{%
-\PackageWarning{sphinx}{This table uses \string\sphinxcolorblend\space
-  but xcolor is not in\MessageBreak
-  the TeX/LaTeX installation, the command will be\MessageBreak
-  ignored in this and the next tables}%
-   \global\let\sphinxcolorblend\@gobble
-   \sphinxbuildwarning{colorblend}%
-   }%
-  }
 
 
 %%%%%%%%%%%%%%%%%%

sphinx/texinputs/sphinxpackageboxes.sty

@@ -1,7 +1,12 @@
 %% COLOURED BOXES
 %
 % change this info string if making any custom modification
-\ProvidesPackage{sphinxpackageboxes}[2023/03/19 v6.2.0 advanced colored boxes]
+\ProvidesPackage{sphinxpackageboxes}[2024/07/01 v7.4.0 advanced colored boxes]
+% 7.4.0 removes usage of some booleans "...withbackgroundcolor" and
+% "...withbordercolor" as well as \spx@boxes@border dimen which was
+% actually really needed nowhere.  This was done in sync with changes in
+% sphinx.sty, sphinxlatexadmonitions.sty and sphinxlatexliterals.sty.
+%
 % Optionally executes \RequirePackage for:
 %
 % - pict2e.  Ideally we would like to use the v0.4a 2020/08/16 release of this
@@ -78,15 +83,13 @@
 %%%%%%%%%%%%%%%%
 % Internal registers, conditionals, colors to be configured by each caller
 % via a preliminary "setup" call
-%
 \newif\ifspx@boxes@withshadow
 \newif\ifspx@boxes@insetshadow
-\newif\ifspx@boxes@withbackgroundcolor
+%%% \newif\ifspx@boxes@withbackgroundcolor % removed at 7.4.0
 \newif\ifspx@boxes@withshadowcolor
-\newif\ifspx@boxes@withbordercolor
+%%% \newif\ifspx@boxes@withbordercolor     % removed at 7.4.0
 \newif\ifspx@boxes@shadowinbbox
 %
-\newdimen\spx@boxes@border
 \newdimen\spx@boxes@border@top
 \newdimen\spx@boxes@border@right
 \newdimen\spx@boxes@border@bottom
@@ -150,7 +153,6 @@
   \spx@boxes@border@right \dimexpr\@nameuse{spx@#1@border@right}\relax
   \spx@boxes@border@bottom\dimexpr\@nameuse{spx@#1@border@bottom}\relax
   \spx@boxes@border@left  \dimexpr\@nameuse{spx@#1@border@left}\relax
-  \spx@boxes@border       \dimexpr\@nameuse{spx@#1@border}\relax
   %
   \spx@boxes@padding@top   \dimexpr\@nameuse{spx@#1@padding@top}\relax
   \spx@boxes@padding@right \dimexpr\@nameuse{spx@#1@padding@right}\relax
@@ -200,19 +202,9 @@
      \spx@boxes@insetshadowfalse
   \fi
   %
-  \@nameuse{ifspx@#1@withbordercolor}%
-    \spx@boxes@withbordercolortrue
     \sphinxcolorlet{spx@boxes@bordercolor}{sphinx#1BorderColor}%
-  \else
-    \spx@boxes@withbordercolorfalse
-  \fi
   %
-  \@nameuse{ifspx@#1@withbackgroundcolor}%
-    \spx@boxes@withbackgroundcolortrue
     \sphinxcolorlet{spx@boxes@backgroundcolor}{sphinx#1BgColor}%
-  \else
-    \spx@boxes@withbackgroundcolorfalse
-  \fi
   %
   \@nameuse{ifspx@#1@withshadowcolor}%
     \spx@boxes@withshadowcolortrue
@@ -447,14 +439,12 @@
   \fi
   % BACKGROUND
   % draw background and move back to reference point
-  \ifspx@boxes@withbackgroundcolor
    {\color{spx@boxes@backgroundcolor}%
     \vrule\@height\ht\spx@tempboxa
           \@depth\dp\spx@tempboxa
           \@width\wd\spx@tempboxa
     \kern-\wd\spx@tempboxa
     }%
-  \fi
   % BOX SHADOW
   % draw shadow and move back to reference point
   \ifspx@boxes@withshadow
@@ -494,13 +484,8 @@
        }% end of \vbox
   \fi % end of shadow drawing, and we are back to horizontal reference point
   % BOX BORDER
-  \vbox{\ifspx@boxes@withbordercolor
-            \color{spx@boxes@bordercolor}%
-        \else
-            % 6.2.0: guard against a \color command in contents whose effect
-            % could leak to border at a pagebreak
-            \normalcolor
-        \fi
+  % 7.4.0 requires a set border color
+  \vbox{\color{spx@boxes@bordercolor}%
         \hrule\@height\spx@boxes@border@top
            \kern-\spx@boxes@border@top
         \setbox\spx@tempboxb\hb@xt@\wd\spx@tempboxa
@@ -540,14 +525,13 @@
 \def\spx@boxes@fcolorbox@insetshadow{%
   % BACKGROUND
   % draw background and move back to reference point
-  \ifspx@boxes@withbackgroundcolor
+  % 7.4.0 always assumes a background color
    {\color{spx@boxes@backgroundcolor}%
     \vrule\@height\ht\spx@tempboxa
           \@depth\dp\spx@tempboxa
           \@width\wd\spx@tempboxa
     \kern-\wd\spx@tempboxa
     }%
-  \fi
   % BOX SHADOW
   % draw shadow and move back to reference point
   \ifspx@boxes@withshadow
@@ -589,13 +573,8 @@
          }% end of \hbox, attention its depth is only |yoffset| if yoffset<0
   \fi % end of inset shadow drawing, and we are back to horizontal reference point
   % BOX BORDER
-  \vbox{\ifspx@boxes@withbordercolor
-            \color{spx@boxes@bordercolor}%
-        \else
-            % 6.2.0: guard against a \color command in contents whose effect
-            % could leak to border at a pagebreak
-            \normalcolor
-        \fi
+  % 7.4.0 requires a set border color
+  \vbox{\color{spx@boxes@bordercolor}%
         \hrule\@height\spx@boxes@border@top
            \kern-\spx@boxes@border@top
         \setbox\spx@tempboxb\hb@xt@\wd\spx@tempboxa
@@ -807,17 +786,11 @@
       \fi
       \spx@boxes@border@defpath% must be redone after each \fillpath! (even if
                                % was in a  \put)
-      \ifspx@boxes@withbordercolor
+      % 7.4.0 requires a set border color
          \color{spx@boxes@bordercolor}%
-      \else
-         \normalcolor
-      \fi
       \fillpath
-      \ifspx@boxes@withbackgroundcolor
+      % and backgroundcolor command
          \color{spx@boxes@backgroundcolor}%
-      \else
-         \color{white}%
-      \fi
       \edef\spx@width{\number\dimexpr\spx@width-\spx@boxes@border@left
                                                -\spx@boxes@border@right sp}%
       \edef\spx@height{\number\dimexpr\spx@height-\spx@boxes@border@top

sphinx/texinputs/sphinxpackagefootnote.sty

@@ -1,6 +1,6 @@
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{sphinxpackagefootnote}%
- [2022/08/15 v5.3.0 Sphinx custom footnotehyper package (Sphinx team)]
+ [2024/05/17 v7.3.x Sphinx custom footnotehyper package (Sphinx team)]
 %%
 %% Package: sphinxpackagefootnote
 %% Version: based on footnotehyper.sty 2021/02/04 v1.1d
@@ -409,9 +409,10 @@
     {\gdef\@thefnmark{?}% on first LaTeX run
      \refstepcounter{sphinxfootnotemark}\label{footnotemark.\thesphinxfootnotemark}%
     }%
-    {\sphinx@xdef@thefnmark{#1}% also defines \spx@footrefHref
-     \def\@makefnmark{% will be used by \H@@footnotemark
+    {\def\@makefnmark{% will be used by \H@@footnotemark
        \refstepcounter{sphinxfootnotemark}\label{footnotemark.\thesphinxfootnotemark}%
+       \sphinx@xdef@thefnmark{#1}% also defines \spx@footrefHref
+                                 % must be executed after \refstepcounter
        \hyper@linkstart{link}{\spx@footrefHref}%
        \spx@saved@makefnmark
        \hyper@linkend