[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: ltpara clean-up NOW (21c81070)

[Chris Rowley]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/21c81070dc725e40f2197245e43961ef2943dab8

>---------------------------------------------------------------

commit 21c81070dc725e40f2197245e43961ef2943dab8
Author: Chris Rowley <car222222 at users.noreply.github.com>
Date:   Thu Nov 11 10:26:19 2021 +0700

    ltpara clean-up NOW
    
    Mostly very temporary (a few hours only).
    But includes tweaks.
    and Local fix for "no hooks please!"


>---------------------------------------------------------------

21c81070dc725e40f2197245e43961ef2943dab8
 base/ltpara.dtx | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/base/ltpara.dtx b/base/ltpara.dtx
index 9802bfd6..51bf9ce3 100644
--- a/base/ltpara.dtx
+++ b/base/ltpara.dtx
@@ -23,10 +23,13 @@
 %\usepackage{ltpara}
 
 % Fixing footnotes in  functions and variables: this should be in l3doc!
+
 \newcommand\fixfootnote[2]{\footnotemark
   \AddToHookNext{env/#1/after}{\footnotetext{#2}}}
+  \iffalse
 \AddToHook{env/function/begin}{\def\footnote{\fixfootnote{function}}}
 \AddToHook{env/variable/begin}{\def\footnote{\fixfootnote{variable}}}
+\fi
 
 \EnableCrossrefs
 \CodelineIndex
@@ -429,6 +432,8 @@
 %    \cs{endgraf} was changed to provide this additional functionality
 %    (along with \cs{par} remaining subject to its current meaning).
 %
+%    CCC: update with suggested text.
+%
 %    TEMP NOTE: Maybe endgraf should not be changed by LaTeX as it is 
 %    essentially not at all a part of LaTeX.  
 %    If it is too dangerous to leave it as 
@@ -613,8 +618,8 @@
 %
 % \subsubsection{Mark the first paragraph of each \env{itemize}}
 %
-%    The code for this is rather simple. We apply  hook code that is
-%    executed only once inside a hook that is executed at the begin of
+%    The code for this is rather simple. We supply some code that is
+%    executed only once inside a hook at the start of
 %    each \env{itemize}. We explicitly change the color back and
 %    forth so that we don't introduce grouping around the paragraph.
 %\begin{verbatim}
@@ -953,7 +958,8 @@
 %    default meaning (in the past this was the initex primitive) while
 %    \cs{par} is the current meaning which maybe does something else.
 %
-%    TEMP NOTE: See earlier note re endgraf.
+%    CCC  TEMP NOTE: See earlier note re endgraf.  
+%      Maybe change above para a bit?
 %
 %    We are now going to change this default meaning to instead run
 %    \cs{para_end:}, which ultimately executes the initex
@@ -970,6 +976,7 @@
 \cs_new_protected:Npn \para_end: {
 %    \end{macrocode}
 %
+%    CCC Needs more.
 %    TEMP NOTE: What should happen if in outer hmode with an empty hlist? 
 %
 %    The only case we care about is when we are in horizontal mode
@@ -1028,7 +1035,7 @@
 %    it should get removed before the hook code gets added so we have
 %    to arrange for this removal.  
 %
-%    TEMP NOTE: maybe a ‘nobreak’ should also be added?
+%    TEMP NOTE: maybe a \cs{nobreak} should also be added?
 %
 %    [FMi:]
 %      sounds wrong to me, why?  
@@ -1039,7 +1046,7 @@
 %
 %    There is not much point in checking if there was really a glue
 %    item at the end of the horizontal list, instead we simply try to
-%    remove one using \cs{tex_unskip:D}, if there wasn't one this will
+%    remove one using \cs{tex_unskip:D}: if there wasn't one this will
 %    do nothing.
 %    \begin{macrocode}
          \tex_unskip:D
@@ -1076,6 +1083,7 @@
 %    simply goes silently to vmode. 
 %
 %    TEMP NOTE: Is this actually how it works? 
+%    CCC Essentially keep
 %       For any current definition of par?
 %
 %    Now if we would have added something (to
@@ -1196,7 +1204,7 @@
 %    occasionally) and \cs{endgraf}, which is another name for the
 %    ``default'' action of \cs{par}.
 %
-%    TEMP NOTE: re endgraf again.
+%    TEMP NOTE: re endgraf again.  CCC change above
 %
 %    \begin{macrocode}
 \cs_set_eq:NN \par     \para_end: