Sphinx 8.0.2__py3-none-any.whl → 8.1.1__py3-none-any.whl

sphinx/texinputs/sphinxlatexadmonitions.sty

@@ -1,15 +1,12 @@
 %% NOTICES AND ADMONITIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexadmonitions.sty}[2024/07/01 v7.4.0 admonitions]
+\ProvidesPackage{sphinxlatexadmonitions}[2024/10/11 v8.1.1 admonitions]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
 % - 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)
@@ -19,16 +16,21 @@
 %     sphinxheavybox since 6.2.0),
 %   - warning, caution, attention, danger, error to use sphinxheavybox.
 %
-% At 7.4.0 all admonitions use sphinxheavybox.
+%   Since 7.4.0 all admonitions use sphinxheavybox.
 %
 % - 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)
+% - Also redefinable by user are the one-argument commands
+%   * \sphinxstylenotetitle,
+%   * \sphinxstylewarningtitle,
+%   * etc.... one for each admonition type (also seealso and todo).
+%
+% - At 7.4.0, all commands of previous item use \sphinxdotitlerow.
+%   (the 7.4.0 name, still usable, was \sphinxdotitlerowwithicon; the 8.1.0
+%   version is also used for topic, contents and sidebar directives, see
+%   sphinxlatexshadowbox.sty, and handles both "with icon" and "without
+%   icon" situations).
 %
 % The sphinxlightbox environment is kept for backward compatiblity, for user
 % custom code which used it via custom definitions done in preamble or via
@@ -42,20 +44,21 @@
 % (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):
 %
 % - of course the various colour and dimension options handled via sphinx.sty
-%
 % - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty
+% - \savenotes/\spewnotes from sphinxpackagefootnote.sty
+% - \ifspx@inframed defined in sphinx.sty
+% - \spx@boxes@fcolorbox@setup from sphinxpackageboxes.sty
+%
+\RequirePackage{framed}
+% Those are required either before or after by sphinx.sty anyhow, but for
+% clarity we list them here:
+\RequirePackage{sphinxlatexgraphics}
+\RequirePackage{sphinxpackagefootnote}
+\RequirePackage{sphinxpackageboxes}
 %
-% - \savenotes/\spewnotes from sphinxpackagefootnote (for sphinxheavybox)
-
 % Provides: (also in sphinxlatexliterals.sty)
 % Only needed here by legacy (deprecated) sphinxlightbox environment.
 \providecommand*\sphinxvspacefixafterfrenchlists{%
@@ -300,10 +303,15 @@
   % 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}
 
+% TODO: allow these next three settings to be customized individually.
+%       This can however already be done at user level by \renewcommand
+%       inside renew'ed environments sphinxnote, sphinxhint etc...
 \newcommand\sphinxtitlerowtoppadding{5pt}
 \newcommand\sphinxtitlerowbottompadding{3pt}
 \newcommand\sphinxtitlerowaftericonspacecmd{\hskip0.5em\relax}
-\newcommand\sphinxdotitlerowwithicon[2]{% #1=type, #2=heading (without final colon)
+% 7.4.0 used this longer name:
+\newcommand\sphinxdotitlerowwithicon{\sphinxdotitlerow}
+\newcommand\sphinxdotitlerow[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
@@ -325,16 +333,26 @@
      \spx@boxes@withshadowfalse
      \sphinxcolorlet{spx@boxes@backgroundcolor}{sphinx#1TtlBgColor}%
      \spx@boxes@fcolorbox{%
-        \makebox[\linewidth][l]{%
-         \textcolor{sphinx#1TtlFgColor}{%
+        \parbox[t]{\linewidth}{% 7.4.0 used \makebox, but wrapping of long titles
+                               % is needed for generic admonition or topic box.
+         \sphinxAtStartPar
+         % 8.1.0 auto-drops extra space if no icon
+         \sbox\z@{\@nameuse{sphinx#1TtlIcon}}%
+         \ifdim\wd\z@>\z@
+          \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.
+            % The next macro is located here for legacy reasons of earlier
+            % functioning of \spx@faIcon.  When fontawesome{5,}.sty both
+            % are unavailable, it (formerly) gobbled this next macro.
+            % We leave it here now although it could be moved to after
+            % the closing brace.
             \sphinxtitlerowaftericonspacecmd
-         }%
+          }%
+         \fi
          \sphinxstrong{#2}%
-         \strut}%
+         \strut
+         \par
+        }%
       }%
      \kern-\spx@boxes@padding@right
      \par
@@ -347,17 +365,17 @@
 % \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}}}
+\newcommand\sphinxstylenotetitle     [1]{\sphinxdotitlerow{note}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstylehinttitle     [1]{\sphinxdotitlerow{hint}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleimportanttitle[1]{\sphinxdotitlerow{important}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyletiptitle      [1]{\sphinxdotitlerow{tip}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstylewarningtitle  [1]{\sphinxdotitlerow{warning}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstylecautiontitle  [1]{\sphinxdotitlerow{caution}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleattentiontitle[1]{\sphinxdotitlerow{attention}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyledangertitle   [1]{\sphinxdotitlerow{danger}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleerrortitle    [1]{\sphinxdotitlerow{error}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyleseealsotitle  [1]{\sphinxdotitlerow{seealso}{\sphinxremovefinalcolon{#1}}}
+\newcommand\sphinxstyletodotitle     [1]{\sphinxdotitlerow{todo}{\sphinxremovefinalcolon{#1}}}
 %
 % A utility to remove a final colon.  Removing last token is not easy in
 % LaTeX, and there are additional complications:

sphinx/texinputs/sphinxlatexcontainers.sty

@@ -1,7 +1,7 @@
 %% CONTAINER DIRECTIVES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexcontainers.sty}[2021/05/03 containers]
+\ProvidesPackage{sphinxlatexcontainers}[2021/05/03 containers]
 
 % The purpose of this file is to provide a dummy environment sphinxclass which
 % will be inserted for each class in each container directive. The class name

sphinx/texinputs/sphinxlatexgraphics.sty

@@ -1,7 +1,7 @@
 %% GRAPHICS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexgraphics.sty}[2021/01/27 graphics]
+\ProvidesPackage{sphinxlatexgraphics}[2024/08/13 v8.1.0 graphics]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
@@ -84,7 +84,8 @@
     \ifin@
       \setbox\spx@image@box
       \hbox{\includegraphics
-            [%#1,% contained only width and/or height and overruled anyhow
+            [#1,% contains only width and/or height which are overruled next
+                % but in future may contain page=N hence must be kept
             width=\spx@image@requiredwidth,height=\spx@image@requiredheight]%
             {#2}}%
       % \includegraphics does not set box dimensions to the exactly

sphinx/texinputs/sphinxlatexindbibtoc.sty

@@ -1,7 +1,7 @@
 %% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexindbibtoc.sty}[2021/01/27 index, bib., toc]
+\ProvidesPackage{sphinxlatexindbibtoc}[2021/01/27 index, bib., toc]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %

sphinx/texinputs/sphinxlatexlists.sty

@@ -1,7 +1,7 @@
 %% ALPHANUMERIC LIST ITEMS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexlists.sty}[2021/12/20 lists]
+\ProvidesPackage{sphinxlatexlists}[2021/12/20 lists]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 % - \sphinxsetlistlabels

sphinx/texinputs/sphinxlatexliterals.sty

@@ -1,7 +1,7 @@
 %% LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexliterals.sty}[2024/07/01 v7.4.0 code-blocks and parsed literals]
+\ProvidesPackage{sphinxlatexliterals}[2024/07/01 v7.4.0 code-blocks and parsed literals]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
@@ -512,6 +512,9 @@
     \setbox\spx@tempboxa
     \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@
           \doublehyphendemerits\z@\finalhyphendemerits\z@
+% Avoid TeX reporting Overfull \hbox'es during this measuring phase. Setting
+% \hbadness to \@M to avoid Underfull reports is unneeded due to \raggedright.
+          \hfuzz\maxdimen
           \spx@everypar{}\noindent\strut\FV@Line\strut\spx@par
           \spx@verb@getwidths}%
     \ifdim\spx@verb@maxwidth>

sphinx/texinputs/sphinxlatexnumfig.sty

@@ -1,7 +1,7 @@
 %% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexnumfig.sty}[2021/01/27 numbering]
+\ProvidesPackage{sphinxlatexnumfig}[2024/07/31 v8.1.0 numbering]
 
 % Requires: remreset (old LaTeX only)
 % relates to numfig and numfig_secnum_depth configuration variables
@@ -37,7 +37,11 @@
       \def\theequation{\arabic{equation}}%
     \fi
 \else
-\let\spx@preAthefigure\@empty
+% See apologetic comments on TeX wizardry at bottom of file.
+% The reason for this one is to catch case where there will be only
+% the number with no prefix from enclosing sectioning (can happen
+% with latex_toplevel_sectioning='part').
+\def\spx@preAthefigure{\expandafter\spx@magicsep@s\romannumeral-`0}
 \let\spx@preBthefigure\@empty
 % \ifspx@opt@usespart  % <-- LaTeX writer could pass such a 'usespart' boolean
 %                      %     as sphinx.sty package option
@@ -51,7 +55,7 @@
 \ifnum\spx@opt@numfigreset>0
     \ltx@ifundefined{c@chapter}
       {}
-      {\g@addto@macro\spx@preAthefigure{\ifnum\c@chapter>\z@\arabic{chapter}.}%
+      {\g@addto@macro\spx@preAthefigure{\ifnum\c@chapter>\z@\arabic{chapter}\spx@magicsep}%
        \g@addto@macro\spx@preBthefigure{\fi}}%
 \fi
 \ifnum\spx@opt@numfigreset>1
@@ -61,7 +65,7 @@
     \ifspx@opt@mathnumfig
       \@addtoreset{equation}{section}%
     \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@section>\z@\arabic{section}.}%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@section>\z@\arabic{section}\spx@magicsep}%
     \g@addto@macro\spx@preBthefigure{\fi}%
 \fi
 \ifnum\spx@opt@numfigreset>2
@@ -71,7 +75,7 @@
     \ifspx@opt@mathnumfig
       \@addtoreset{equation}{subsection}%
     \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsection>\z@\arabic{subsection}.}%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsection>\z@\arabic{subsection}\spx@magicsep}%
     \g@addto@macro\spx@preBthefigure{\fi}%
 \fi
 \ifnum\spx@opt@numfigreset>3
@@ -81,7 +85,7 @@
     \ifspx@opt@mathnumfig
       \@addtoreset{equation}{subsubsection}%
     \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubsection>\z@\arabic{subsubsection}.}%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubsection>\z@\arabic{subsubsection}\spx@magicsep}%
     \g@addto@macro\spx@preBthefigure{\fi}%
 \fi
 \ifnum\spx@opt@numfigreset>4
@@ -91,7 +95,7 @@
     \ifspx@opt@mathnumfig
       \@addtoreset{equation}{paragraph}%
     \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subparagraph>\z@\arabic{subparagraph}.}%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subparagraph>\z@\arabic{subparagraph}\spx@magicsep}%
     \g@addto@macro\spx@preBthefigure{\fi}%
 \fi
 \ifnum\spx@opt@numfigreset>5
@@ -101,7 +105,7 @@
     \ifspx@opt@mathnumfig
       \@addtoreset{equation}{subparagraph}%
     \fi%
-    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubparagraph>\z@\arabic{subsubparagraph}.}%
+    \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubparagraph>\z@\arabic{subsubparagraph}\spx@magicsep}%
     \g@addto@macro\spx@preBthefigure{\fi}%
 \fi
 \expandafter\g@addto@macro
@@ -114,9 +118,18 @@
 \g@addto@macro\theliteralblock{\arabic{literalblock}}%
   \ifspx@opt@mathnumfig
     \let\theequation\spx@preAthefigure
-    \g@addto@macro\theequation{\arabic{equation}}%
+    \g@addto@macro\theequation{E}%
   \fi
 \fi
 }% end of big \AtBeginDocument
 
+% Sorry for TeX wizardry here.  We need to keep expandability.  Explaining
+% the mechanism is not really feasible to non TeX-experts, but the idea
+% is to force next `\ifnum` conditional so we can check what comes next.
+% All cases are accounted for (i.e. not an equation, or an equation at top
+% level, or an equation in some section at some depth).
+\def\spx@magicsep{\expandafter\spx@magicsep@i\romannumeral-`0}
+\def\spx@magicsep@i#1{\if#1E\spx@opt@mathnumsep\arabic{equation}\else.#1\fi}
+%
+\def\spx@magicsep@s#1{\if#1E\arabic{equation}\else#1\fi}
 \endinput

sphinx/texinputs/sphinxlatexobjects.sty

@@ -1,7 +1,7 @@
 %% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexobjects.sty}[2023/07/23 documentation environments]
+\ProvidesPackage{sphinxlatexobjects}[2023/07/23 documentation environments]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %

sphinx/texinputs/sphinxlatexshadowbox.sty

@@ -1,21 +1,37 @@
 %% TOPIC AND CONTENTS BOXES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexshadowbox.sty}[2023/03/19 sphinxShadowBox]
+\ProvidesPackage{sphinxlatexshadowbox}[2024/07/28 v8.1.0 sphinxShadowBox]
 
 % Provides support for this output mark-up from Sphinx latex writer:
 %
-% - sphinxShadowBox (environment)
+% - Environments: sphinxtopic, sphinxcontents, and sphinxsidebar.
+%
+%   These wrappers replace at 8.1.0 former direct use of sphinxShadowBox
+%   environment which did not allow separate styling.
+%
+% - Commands: \sphinxstyletopictitle, \sphinxstylecontentstitle, and
+%   \sphinxstylesidebartitle.
+%
+%   At 8.1.0 they default to use \sphinxdotitlerow whose definiion is done in
+%   sphinxlatexadmonitions.sty.  There is also  \sphinxstylesidebarsubtitle
+%   which does not use \sphinxdotitlerow.
 %
 % Dependencies (they do not need to be defined at time of loading):
 %
 % - of course the various colour and dimension options handled via sphinx.sty
 % - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty
-% - \savenotes/\spewnotes from sphinxpackagefootnote
+% - \savenotes/\spewnotes from sphinxpackagefootnote.sty
 % - \ifspx@inframed defined in sphinx.sty
+% - \sphinxdotitlerow from sphinxlatexadmonitions.sty
+% - \spx@boxes@fcolorbox@setup from sphinxpackageboxes.sty
 %
-% Requires:
 \RequirePackage{framed}
+% Those are required either before or after by sphinx.sty anyhow, but for
+% clarity we list them here:
+\RequirePackage{sphinxlatexgraphics}
+\RequirePackage{sphinxpackagefootnote}
+\RequirePackage{sphinxlatexadmonitions}
 \RequirePackage{sphinxpackageboxes}
 
 % At 5.1.0 the code formerly here in a definition of \spx@ShadowFBox has been
@@ -45,9 +61,28 @@
 %   in contrast with the framing used for literal blocks, also based, but in a
 %   more sophisticated way on usage of \MakeFramed/\endMakeFramed, and
 %   adjusting to current text indentation.
-\newenvironment{sphinxShadowBox}
+%
+% At 8.1.0, sphinxShadowBox takes an optional argument #1 and uses it as
+% \spx@boxes@fcolorbox@setup{#1} rather than \spx@boxes@fcolorbox@setup{topic}.
+% Some hesitation whether to move this line to newly added sphinxtopic,
+% sphinxcontents and sphinxsidebar environmments.  But anyhow the environment
+% also requires later knowing a few more things: sphinx<type>TextColor and
+% spx@<type>@texextras.
+%
+% The #1 defaulting to topic must be such that all parameters expected by
+% \spx@boxes@fcolorbox@setup actually do exist, see CSS options in sphinx.sty
+% which is what defines them for contents, topic, and sidebar.
+%
+% Fortunately the #1 is not needed in \end{sphinxShadowBox} so we don't have
+% to work around a LaTeX conception bug that such #1 can not be used as is in
+% the definition of the \end part of an environment.
+%
+% MEMO: the "shadow" is not really drawn directly by this environment but
+% indirectly via the configuration which is passed over to \spx@boxes@fcolorbox,
+% which is the macro creating frame and (perhaps but not necessarily) a shadow.
+\newenvironment{sphinxShadowBox}[1][topic]%
   {%
-   \spx@boxes@fcolorbox@setup{topic}%
+   \spx@boxes@fcolorbox@setup{#1}%
    % we will use the dimen registers from sphinxpackageboxes.sty which now hold
    % the values from options related to topic/contents
    % MEMO: \spx@boxes@fcolorbox creates an \hbox but does not quit vertical
@@ -56,7 +91,7 @@
    \def\FrameCommand {\spx@boxes@fcolorbox}%
    % 6.2.0 adds support for div.topic_box-decoration-break=slice.
    % (it is yet undecided if slice style should inhibit a bottom shadow)
-   \ifspx@topic@border@open
+   \@nameuse{ifspx@#1@border@open}%
      \def\FirstFrameCommand
                {\spx@boxes@fcolorbox@setup@openbottom\FrameCommand}%
      \def\MidFrameCommand
@@ -97,10 +132,10 @@
     \@setminipage
     }%
     \color@begingroup % workaround upstream framed.sty bug
-    \ifspx@topic@withtextcolor
-      \color{sphinxtopicTextColor}%
+    \@nameuse{ifspx@#1@withtextcolor}%
+      \color{sphinx#1TextColor}%
     \fi
-    \spx@topic@TeXextras
+    \@nameuse{spx@#1@TeXextras}%
   }%
   {% insert the "endminipage" code
     \par\unskip
@@ -113,4 +148,31 @@
    \spewnotes
   }
 
+% 8.1.0
+\newenvironment{sphinxtopic}
+               {\begin{sphinxShadowBox}[topic]}{\end{sphinxShadowBox}}
+\newenvironment{sphinxcontents}
+               {\begin{sphinxShadowBox}[contents]}{\end{sphinxShadowBox}}
+% Arguably sphinxsidebar should rather use a wrapfig or similar environment
+% but this is so dysfunctional in LaTeX (except for self-written documents)
+% so we prefer to not venture into such a potential quagmire and keep the
+% legacy rendering using a full width display.
+\newenvironment{sphinxsidebar}
+               {\begin{sphinxShadowBox}[sidebar]}{\end{sphinxShadowBox}}
+
+% TODO: decide if this should be in sphinxlatexstyletext.sty rather
+%
+% 8.1.0 styles topic/contents/sidebar with a title row, too.
+% Prior to 8.1.0, definitions use \protected\def but there does not seem
+% to be any reason so back to \newcommand.
+\newcommand*\sphinxstyletopictitle[1]{\sphinxdotitlerow{topic}{#1}}
+\newcommand*\sphinxstylecontentstitle[1]{\sphinxdotitlerow{contents}{#1}}
+\newcommand*\sphinxstylesidebartitle[1]{\sphinxdotitlerow{sidebar}{#1}}
+% No default color background for subtitle.  The contents next are injected by
+% LaTeX writer after a blank line in source hence will start a new paragrpah.
+% The \sphinxAtStartPar here is only for coherence with other text paragraphs,
+% but does not have serious necessity (its general role is to allow hyphenation
+% for first word in narrow table cells).
+\newcommand*\sphinxstylesidebarsubtitle[1]{\sphinxAtStartPar\textbf{#1}}
+
 \endinput

sphinx/texinputs/sphinxlatexstyleheadings.sty

@@ -1,9 +1,15 @@
 %% TITLES
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstyleheadings.sty}[2023/02/11 headings]
+\ProvidesPackage{sphinxlatexstyleheadings}[2023/02/11 headings]
 
 \RequirePackage[nobottomtitles*]{titlesec}
+% tests showed that this setting guarantees \section title has
+% 3 lines of text following it on same page if near bottom.
+\renewcommand\bottomtitlespace{6\baselineskip}
+% the default setting of 0.2\textheight is about 11\baselineskip
+% (for 10pt letterpaper documents) and may create large voids.
+
 \@ifpackagelater{titlesec}{2016/03/15}%
  {\@ifpackagelater{titlesec}{2016/03/21}%
   {}%
@@ -47,7 +53,6 @@
 \titleformat{\subparagraph}{\normalsize\py@HeaderFamily}%
             {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor}
 
-
 % Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather
 % than defining their own \py@HeaderFamily command (which is still possible).
 % Memo: \py@HeaderFamily is also used by \maketitle as defined in

sphinx/texinputs/sphinxlatexstylepage.sty

@@ -1,16 +1,10 @@
 %% PAGE STYLING
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstylepage.sty}[2021/01/27 page styling]
+\ProvidesPackage{sphinxlatexstylepage}[2021/01/27 page styling]
 
 % Separate paragraphs by space by default.
-\IfFileExists{parskip-2001-04-09.sty}% since September 2018 TeXLive update
-% new parskip.sty, but let it rollback to old one.
-% hopefully TeX installation not broken and LaTeX kernel not too old
-   {\RequirePackage{parskip}[=v1]}
-% standard one from 1989. Admittedly \section of article/book gives possibly
-% anomalous spacing, but we can't require September 2018 release for some time.
-   {\RequirePackage{parskip}}
+\RequirePackage{parskip}
 
 % Style parameters and macros used by most documents here
 \raggedbottom

sphinx/texinputs/sphinxlatexstyletext.sty

@@ -1,9 +1,10 @@
 %% TEXT STYLING
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxlatexstyletext.sty}[2024/07/01 v7.4.0 text styling]
+\ProvidesPackage{sphinxlatexstyletext}[2024/07/28 v8.1.0 text styling]
 
 % 7.4.0 has moved all that is related to admonitions to sphinxlatexadmonitions.sty
+% 8.1.0 has moved topic/contents/sidebar to sphinxlatexshadowbox.sty
 % Most everything left here consists of macros which are part of the latex markup
 % produced by the Sphinx LaTeX writer.
 
@@ -39,10 +40,7 @@
     {{\Large\sffamily#1}\nopagebreak\vspace{1mm}}
 \def\sphinxstyleindexlettergroupDefault #1%
     {{\Large\sffamily\sphinxnonalphabeticalgroupname}\nopagebreak\vspace{1mm}}
-\protected\def\sphinxstyletopictitle   #1{\textbf{#1}\par\medskip}
-\let\sphinxstylesidebartitle\sphinxstyletopictitle
 \protected\def\sphinxstyleothertitle   #1{\textbf{#1}}
-\protected\def\sphinxstylesidebarsubtitle #1{~\\\textbf{#1} \smallskip}
 % \text.. commands do not allow multiple paragraphs
 % attention, this one is not self-delimiting
 \protected\def\sphinxstyletheadfamily    {\sffamily}

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}[2024/07/01 v7.4.0 tables]%
+\ProvidesPackage{sphinxlatextables}[2024/07/01 v7.4.0 tables]%
 
 % Provides support for this output mark-up from Sphinx latex writer
 % and table templates:

sphinx/texinputs/sphinxoptionsgeometry.sty

@@ -1,7 +1,7 @@
 %% OPTIONS FOR GEOMETRY
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxoptionsgeometry.sty}[2021/01/27 geometry]
+\ProvidesPackage{sphinxoptionsgeometry}[2021/01/27 geometry]
 
 % geometry
 \ifx\kanjiskip\@undefined

sphinx/texinputs/sphinxoptionshyperref.sty

@@ -1,7 +1,7 @@
 %% Bookmarks and hyperlinks
 %
 % change this info string if making any custom modification
-\ProvidesFile{sphinxoptionshyperref.sty}[2021/01/27 hyperref]
+\ProvidesPackage{sphinxoptionshyperref}[2021/01/27 hyperref]
 
 % to make pdf with correct encoded bookmarks in Japanese
 % this should precede the hyperref package

sphinx/themes/agogo/layout.html

@@ -1,13 +1,4 @@
-{#
-    agogo/layout.html
-    ~~~~~~~~~~~~~~~~~
-
-    Sphinx layout template for the agogo theme, originally written
-    by Andi Albrecht.
-
-    :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-#}
+{# Sphinx layout template for the agogo theme. #}
 {%- extends "basic/layout.html" %}
 
 {% block header %}

sphinx/themes/agogo/static/agogo.css.jinja

@@ -1,12 +1,5 @@
 /*
- * agogo.css_t
- * ~~~~~~~~~~~
- *
  * Sphinx stylesheet -- agogo theme.
- *
- * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
  */
 
 * {

sphinx/themes/basic/defindex.html

@@ -1,11 +1,4 @@
-{#
-    basic/defindex.html
-    ~~~~~~~~~~~~~~~~~~~
-
-    Default template for the "index" page.
-
-    :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
+{# Default template for the "index" page.
 #}{{ warn('Now base template defindex.html is deprecated.') }}
 {%- extends "layout.html" %}
 {% set title = _('Overview') %}

sphinx/themes/basic/domainindex.html

@@ -1,12 +1,4 @@
-{#
-    basic/domainindex.html
-    ~~~~~~~~~~~~~~~~~~~~~~
-
-    Template for domain indices (module index, ...).
-
-    :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-#}
+{# Template for domain indices (module index, ...). #}
 {%- extends "layout.html" %}
 {% set title = indextitle %}
 {% block extrahead %}

sphinx/themes/basic/genindex-single.html

@@ -1,12 +1,4 @@
-{#
-    basic/genindex-single.html
-    ~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Template for a "single" page of a split index.
-
-    :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-#}
+{# Template for a "single" page of a split index. #}
 {% macro indexentries(firstname, links) %}
   {%- if links -%}
     <a href="{{ links[0][1] }}">

sphinx/themes/basic/genindex-split.html

@@ -1,12 +1,4 @@
-{#
-    basic/genindex-split.html
-    ~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    Template for a "split" index overview page.
-
-    :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-#}
+{# Template for a "split" index overview page. #}
 {%- extends "layout.html" %}
 {% set title = _('Index') %}
 {% block body %}

sphinx/themes/basic/genindex.html

@@ -1,12 +1,4 @@
-{#
-    basic/genindex.html
-    ~~~~~~~~~~~~~~~~~~~
-
-    Template for an "all-in-one" index.
-
-    :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-#}
+{# Template for an "all-in-one" index. #}
 {%- extends "layout.html" %}
 {% set title = _('Index') %}