texlive[57551] Master/texmf-dist: footnotehyper (29jan21)

commits+karl at tug.org commits+karl at tug.org
Fri Jan 29 23:31:58 CET 2021


Revision: 57551
          http://tug.org/svn/texlive?view=revision&revision=57551
Author:   karl
Date:     2021-01-29 23:31:57 +0100 (Fri, 29 Jan 2021)
Log Message:
-----------
footnotehyper (29jan21)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/footnotehyper/README.md
    trunk/Master/texmf-dist/doc/latex/footnotehyper/footnotehyper.pdf
    trunk/Master/texmf-dist/doc/latex/footnotehyper/footnotehyper.tex
    trunk/Master/texmf-dist/source/latex/footnotehyper/footnotehyper.dtx
    trunk/Master/texmf-dist/tex/latex/footnotehyper/footnotehyper.sty

Modified: trunk/Master/texmf-dist/doc/latex/footnotehyper/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/footnotehyper/README.md	2021-01-29 22:31:38 UTC (rev 57550)
+++ trunk/Master/texmf-dist/doc/latex/footnotehyper/README.md	2021-01-29 22:31:57 UTC (rev 57551)
@@ -1,6 +1,6 @@
 <!-- -->
 
-    Source:  footnotehyper.dtx (v1.1b 2021/01/26)
+    Source:  footnotehyper.dtx (v1.1c 2021/01/29)
     Author:  Jean-Francois Burnol
     Info:    hyperref aware footnote.sty
     License: LPPL 1.3c

Modified: trunk/Master/texmf-dist/doc/latex/footnotehyper/footnotehyper.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/footnotehyper/footnotehyper.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/footnotehyper/footnotehyper.tex	2021-01-29 22:31:38 UTC (rev 57550)
+++ trunk/Master/texmf-dist/doc/latex/footnotehyper/footnotehyper.tex	2021-01-29 22:31:57 UTC (rev 57551)
@@ -1,13 +1,13 @@
 %%
 %% Package: footnotehyper
-%% Version: 1.1b (2021/01/26)
+%% Version: 1.1c (2021/01/29)
 %% License: LPPL 1.3c
 %% Copyright (C) 2016-2021 Jean-Francois Burnol <jfbu at free dot fr>.
 %%
 \def\pkgname        {footnotehyper}
-\def\pkgdate        {2021/01/26}
-\def\docdate        {2021/01/26}
-\def\pkgversion     {v1.1b}
+\def\pkgdate        {2021/01/29}
+\def\docdate        {2021/01/29}
+\def\pkgversion     {v1.1c}
 \def\pkgdescription {hyperref aware footnote.sty (JFB)}
 %%
 %% run latex twice on this file footnotehyper.tex then dvipdfmx on

Modified: trunk/Master/texmf-dist/source/latex/footnotehyper/footnotehyper.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/footnotehyper/footnotehyper.dtx	2021-01-29 22:31:38 UTC (rev 57550)
+++ trunk/Master/texmf-dist/source/latex/footnotehyper/footnotehyper.dtx	2021-01-29 22:31:57 UTC (rev 57551)
@@ -1,11 +1,11 @@
 % -*- coding: utf-8; time-stamp-format: "%02d-%02m-%:y at %02H:%02M:%02S %Z" -*-
 %<*none>
-\def\dtxtimestamp {Time-stamp: <26-01-2021 at 15:33:03 CET>}
+\def\dtxtimestamp {Time-stamp: <29-01-2021 at 19:18:01 CET>}
 %</none>
 %<*!readme>
 %%
 %% Package: footnotehyper
-%% Version: 1.1b (2021/01/26)
+%% Version: 1.1c (2021/01/29)
 %% License: LPPL 1.3c
 %% Copyright (C) 2016-2021 Jean-Francois Burnol <jfbu at free dot fr>.
 %%
@@ -12,9 +12,9 @@
 %</!readme>
 %<*tex>
 \def\pkgname        {footnotehyper}
-\def\pkgdate        {2021/01/26}
-\def\docdate        {2021/01/26}
-\def\pkgversion     {v1.1b}
+\def\pkgdate        {2021/01/29}
+\def\docdate        {2021/01/29}
+\def\pkgversion     {v1.1c}
 \def\pkgdescription {hyperref aware footnote.sty (JFB)}
 %</tex>
 %<*none>
@@ -25,7 +25,7 @@
     \catcode32=13\catcode`\\=12^^Brelax^^A
 ^^Bfirstofone{^^Bendgroup^^Bdef^^BpkgLicense^^A
 {% Package: footnotehyper
-% Version: 1.1b (2021/01/26)
+% Version: 1.1c (2021/01/29)
 % License: LPPL 1.3c
 % Copyright (C) 2016-2021 Jean-Francois Burnol <jfbu at free dot fr>.
 %
@@ -54,7 +54,7 @@
 %<*readme>
 <!-- -->
 
-    Source:  footnotehyper.dtx (v1.1b 2021/01/26)
+    Source:  footnotehyper.dtx (v1.1c 2021/01/29)
     Author:  Jean-Francois Burnol
     Info:    hyperref aware footnote.sty
     License: LPPL 1.3c
@@ -249,7 +249,8 @@
    \PassOptionsToPackage{dvipdfm}{geometry}
    \PassOptionsToPackage{bookmarks=true}{hyperref}
    \PassOptionsToPackage{dvipdfmx-outline-open}{hyperref}
-   \PassOptionsToPackage{dvipdfmx-outline-open}{bookmark}
+% obsolète
+%   \PassOptionsToPackage{dvipdfmx-outline-open}{bookmark}
    %
    \def\pgfsysdriver{pgfsys-dvipdfm.def}
 \else
@@ -353,41 +354,62 @@
            \obeyspaces\obeylines %
 \pkgLicense\endgroup
 
-\section{Usage}
+\section{Changes}
 
-Since |v0.99|, \fnh does not
-load package
-|footnote.sty|\footnote{\url{http://ctan.org/pkg/footnote}}
-anymore, and is even incompatible with it at it uses the same user
-interface.
+\begin{description}
+\item[v0.9c (2016/04/19)] First release: adapt original package to be
+  |hyperref| and |color/xcolor| compatible.
 
-Since |v1.0|, \fnh is usable also in absence of |hyperref| or when
-the latter was passed |hyperfootnotes=false| option.
+\item[v0.9e (2016/04/30)] Abort in absence of |hyperref|. Compatibility with
+  |babel-french|.
 
-Version |v1.1| fixes a bug which arose when |savenotes| environment was used
-\emph{inside} a minipage: footnotes were disappearing!%
+\item[v0.99 (2017/02/16)] Do not load package
+  |footnote.sty|\footnote{\url{http://ctan.org/pkg/footnote}} anymore. 
+
+  From then on \fnh is
+  incompatible with it at it uses the same user interface.
+
+\item[v1.0 (2017/03/07)] Be usable also in absence of |hyperref| or when the
+  latter was passed |hyperfootnotes=false| option.
+
+\item[v1.1 (2018/01/23)] Fix bug which arose when |savenotes| environment was used
+  \emph{inside} a minipage: footnotes were disappearing!%
 %
-\footnote{Thanks to François Pantigny for reporting the bug.
-  A later suggestion of the same is to let the package do nothing under
-  Beamer class, and this is what |v1.1a 2019/11/07| does.}
+\footnote{Thanks to François Pantigny for reporting the bug. A later
+  suggestion of the same is to let the package do nothing under Beamer class,
+  and this is what |v1.1a 2019/11/07| does.}
 %
 See related remarks at end of \autoref{sec:notes}.
 
-The package thus provides:
-\begin{itemize}
-\item a |savenotes| environment which re-routes footnotes and delivers them at
-  the end (there is also the |\savenotes/\spewnotes| syntax; it does create a
-  group like the environment),
-\item |footnote| and |footnotetext| environments to allow footnotes
-  with verbatim material.
-\end{itemize}
+\item[v1.1a (2019/11/07)] Abort under |beamer| (difficulty with |@makefntext|
+  and suspicion |beamer| does not need \fnh).
 
+\item[v1.1b (2021/01/26)] Fix incompatibility with the combination |memoir| +
+  |babel-french|.
+
+\item[v1.1c (2021/01/29)] Fix legacy bug of original package interfering with
+  \LaTeX2e mechanism to suppress indentation after mid-paragraph lists (when
+  |savenotes| environment directly wraps the enclosed list environment,
+  mid-paragraph).
+
+\end{description}
+\section{Usage}
+
+As summarized in the abstract, the package provides:
+\begin{savenotes}% juste pour vérifier le fix à 1.1c
+  \begin{itemize}
+  \item a |savenotes| environment which re-routes footnotes and delivers them
+    at the end (there is also the |\savenotes/\spewnotes| syntax; which does
+    create a group like the environment),
+  \item |footnote| and |footnotetext| environments to allow footnotes with
+    verbatim material.
+  \end{itemize}
+\end{savenotes}
 But the constructability of the |footnote/footnotetext| environments depends
 on how |\@makefntext| has been customized by the class or other packages; a
 warning is issued if the situation appears to be desperate.\footnote{original
   |footnote.sty| could end up in a low level \TeX\ error.}
 
-\begin{framed}
   Some details: \fnh inherits from |footnote| original package the aim to
   convert the macro |\@makefntext| into two parts, the first one to be inserted
   at the start of a footnote in environment form, the second one at its end.
@@ -394,6 +416,8 @@
   It thus hopes that the replacement text of |\@makefntext| contains only once
   its parameter token |#1|, and that it is used unbraced.
 
+\begin{savenotes}
+\begin{framed}
   \fnh has a more robust, but still naive, way of analysing this than the
   original package. But even seemingly innocent redefinitions such as the one
   of |beamer| which was last time I checked (that was in 2019):
@@ -406,12 +430,18 @@
 
   The package could possibly be much improved here, but at update |v1.1b| it
   simply adds a specific fix to handle a problem of another type arising with
-  |memoir| together with |babel-french|. This specific fix uses a bit daring
-  |\scantokens| so we have limited it to these exact circumstances. It has not
-  been thoroughly tested, please make bug reports if needed.
+  |memoir| together with |babel-french|%
+  \begin{footnote}
+    In the |babel-french| context, \fnh attempts to analyse |\@makefntextFB|
+    rather than |\@makefntext| itself. The problem arose in that (automated)
+    analysis.
+  \end{footnote}
+  This fix uses a bit daring |\scantokens| which could be useful to solve
+  other incompatibilities of the similar nature, but we have limited the fix
+  to those exact circumstances, until we get alerted by some bug report.
 \end{framed}
+\end{savenotes}
 
-
 It should be recalled that in case of |\footnotemark[N]| and
 |\footnotetext[N]{...}| mark-up |hyperref| creates no hyperlink. This is not
 changed by \fnh and applies also to the |\begin{footnotetext}[N]| case.
@@ -448,10 +478,10 @@
 {\centering
   \begin{tabular}{|c|c|}
     \hline
-    \strut Inside\footnote{Notice that as  frame
-      extended to the next page,
-      the end of the *savenotes* environment delivered its
-      footnotes only here.} a & tabular\begin{footnote}Alternatively a
+    \strut Inside\footnote{If the frame
+      extends to the next page,
+      the end of the *savenotes* environment delivers its intercepted
+      footnotes only there.} a & tabular\begin{footnote}Alternatively a
       *\savenotes/\spewnotes* pair
       could have been used.\end{footnote}\\\hline
 \end{tabular}\par}
@@ -593,6 +623,8 @@
    \fi\fi
   }%
 \end{verbatim}
+On |2021/01/29| the interference (lost of some |babel-french| customization)
+is still there, as I checked now. This has nothing to do with \fnh.
 % \endgroup
 \item some environments typeset multiple times their contents,
   which causes issues; \fnh takes provisions only to handle the
@@ -694,6 +726,7 @@
 %    \begin{macrocode}
 \newbox\FNH at notes
 \newdimen\FNH at width
+\newtoks\FNH at toks % 1.1c
 \let\FNH at colwidth\columnwidth
 \newif\ifFNH at savingnotes
 \AtBeginDocument {%
@@ -835,9 +868,37 @@
 % |v1.1| fixes the bug about disappearing footnotes if |savenotes| environment
 % is used inside a minipage. I had never really considered such usage, hence
 % missed realizing there was a bug.
+%
+% |v1.1c 2021/01/29| fixes a legacy bug from |footnote| package: if used
+% to enclose a list environment inside a paragraph, it broke the
+% mechanism which suppresses indentation following the list.
+%
+% Now, situation would be far simpler here if we did not have this extra
+% |\begingroup| |\endgroup| pair in |\FNH at savenotes/\FNG at spewnotes|.
+%
+% A priori, as far as I understand, testing the |\if at endpe| flag should be
+% enough, but let's be extra cautious and check that |\par| is not |\@@par|.
+% Attention here that this is not necessarily followed by |\end{savenotes}| and
+% we have to support the |\savenotes/\spewnotes| syntax. The complication is
+% added from it creating a group without being a genuine \LaTeX2e environment.
 %    \begin{macrocode}
 \def\FNH at spewnotes {%
-  \endgroup
+  \if at endpe\ifx\par\@@par\FNH at toks{}\else
+     \FNH at toks\expandafter{\expandafter
+              \def\expandafter\par\expandafter{\par}\@endpetrue}%
+     \expandafter\expandafter\expandafter
+     \FNH at toks
+     \expandafter\expandafter\expandafter
+     {\expandafter\the\expandafter\FNH at toks
+      \expandafter\def\expandafter\@par\expandafter{\@par}}%
+     \expandafter\expandafter\expandafter
+     \FNH at toks
+     \expandafter\expandafter\expandafter
+     {\expandafter\the\expandafter\FNH at toks
+      \expandafter\everypar\expandafter{\the\everypar}}\fi
+  \else\FNH at toks{}\fi
+  \expandafter
+  \endgroup\the\FNH at toks
   \ifFNH at savingnotes\else
    \ifvoid\FNH at notes\else
     \begingroup

Modified: trunk/Master/texmf-dist/tex/latex/footnotehyper/footnotehyper.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/footnotehyper/footnotehyper.sty	2021-01-29 22:31:38 UTC (rev 57550)
+++ trunk/Master/texmf-dist/tex/latex/footnotehyper/footnotehyper.sty	2021-01-29 22:31:57 UTC (rev 57551)
@@ -23,10 +23,10 @@
 %%
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{footnotehyper}%
- [2021/01/26 v1.1b hyperref aware footnote.sty (JFB)]
+ [2021/01/29 v1.1c hyperref aware footnote.sty (JFB)]
 %%
 %% Package: footnotehyper
-%% Version: 1.1b (2021/01/26)
+%% Version: 1.1c (2021/01/29)
 %% License: LPPL 1.3c
 %% Copyright (C) 2016-2021 Jean-Francois Burnol <jfbu at free dot fr>.
 %%
@@ -40,6 +40,7 @@
     {}%
 \newbox\FNH at notes
 \newdimen\FNH at width
+\newtoks\FNH at toks % 1.1c
 \let\FNH at colwidth\columnwidth
 \newif\ifFNH at savingnotes
 \AtBeginDocument {%
@@ -129,7 +130,22 @@
   \fi
 }%
 \def\FNH at spewnotes {%
-  \endgroup
+  \if at endpe\ifx\par\@@par\FNH at toks{}\else
+     \FNH at toks\expandafter{\expandafter
+              \def\expandafter\par\expandafter{\par}\@endpetrue}%
+     \expandafter\expandafter\expandafter
+     \FNH at toks
+     \expandafter\expandafter\expandafter
+     {\expandafter\the\expandafter\FNH at toks
+      \expandafter\def\expandafter\@par\expandafter{\@par}}%
+     \expandafter\expandafter\expandafter
+     \FNH at toks
+     \expandafter\expandafter\expandafter
+     {\expandafter\the\expandafter\FNH at toks
+      \expandafter\everypar\expandafter{\the\everypar}}\fi
+  \else\FNH at toks{}\fi
+  \expandafter
+  \endgroup\the\FNH at toks
   \ifFNH at savingnotes\else
    \ifvoid\FNH at notes\else
     \begingroup



More information about the tex-live-commits mailing list.