[latex3-commits] [latex3/latex3] main: Add \coffin_(g)reset_poles:N (40c32bf3c)

github at latex-project.org github at latex-project.org
Fri May 19 00:23:09 CEST 2023


Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/40c32bf3c69c9b30ff13841ed756ea9d6e0c0176

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

commit 40c32bf3c69c9b30ff13841ed756ea9d6e0c0176
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Wed May 17 10:04:21 2023 +0100

    Add \coffin_(g)reset_poles:N


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

40c32bf3c69c9b30ff13841ed756ea9d6e0c0176
 l3kernel/CHANGELOG.md  |  1 +
 l3kernel/l3coffins.dtx | 33 ++++++++++++++++++++++-----------
 2 files changed, 23 insertions(+), 11 deletions(-)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index e5c86d73f..a3de90b30 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -10,6 +10,7 @@ this project uses date-based 'snapshot' version identifiers.
 ### Added
 - Rounded out the `\use_i:nn...` functions to cover all cases taking
   one argument from up to nine arguments
+- `\coffin_(g)reset_poles:N`
 - `\int_if_zero:n(TF)`
 
 ### Fixed
diff --git a/l3kernel/l3coffins.dtx b/l3kernel/l3coffins.dtx
index 759672403..1e9046fdc 100644
--- a/l3kernel/l3coffins.dtx
+++ b/l3kernel/l3coffins.dtx
@@ -187,6 +187,17 @@
 %   \meta{offset} should be given as a dimension expression.
 % \end{function}
 %
+% \begin{function}[added = 2023-05-17]{\coffin_reset_poles:N, \coffin_greset_poles:N}
+%   \begin{syntax}
+%     \cs{coffin_reset_poles:N} \meta{coffin}
+%   \end{syntax}
+%   Resets the poles of the \meta{coffin} to the standard set, removing any
+%   custom or inherited poles. The poles will therefore be equal to those that
+%   would be obtained from \cs{hcoffin_set:Nn} or similar; the bounding box
+%   of the coffin is not reset, so any material outside of the formal bounding box
+%   will not influence the poles.
+% \end{function}
+%
 % \section{Coffin affine transformations}
 %
 % \begin{function}[updated = 2019-01-23]
@@ -666,7 +677,7 @@
             \color_ensure_current:
             #2
           }
-        \@@_update:N #1
+        \coffin_reset_poles:N #1
       }
   }
 \cs_generate_variant:Nn \hcoffin_set:Nn { c }
@@ -679,7 +690,7 @@
             \color_ensure_current:
             #2
           }
-        \@@_gupdate:N #1
+        \coffin_greset_poles:N #1
       }
   }
 \cs_generate_variant:Nn \hcoffin_gset:Nn { c }
@@ -704,13 +715,13 @@
 \cs_new_protected:Npn \vcoffin_set:Nnn #1#2#3
   {
     \@@_set_vertical:NnnNN #1 {#2} {#3}
-      \vbox_set:Nn \@@_update:N
+      \vbox_set:Nn \coffin_reset_poles:N
   }
 \cs_generate_variant:Nn \vcoffin_set:Nnn { c }
 \cs_new_protected:Npn \vcoffin_gset:Nnn #1#2#3
   {
     \@@_set_vertical:NnnNN #1 {#2} {#3}
-      \vbox_gset:Nn \@@_gupdate:N
+      \vbox_gset:Nn \coffin_greset_poles:N
   }
 \cs_generate_variant:Nn \vcoffin_gset:Nnn { c }
 \cs_new_protected:Npn \@@_set_vertical:NnnNN #1#2#3#4#5
@@ -767,7 +778,7 @@
           \cs_set_protected:Npn \hcoffin_set_end:
             {
               \hbox_set_end:
-              \@@_update:N #1
+              \coffin_reset_poles:N #1
             }
       }
   }
@@ -780,7 +791,7 @@
           \cs_set_protected:Npn \hcoffin_gset_end:
             {
               \hbox_gset_end:
-              \@@_gupdate:N #1
+              \coffin_greset_poles:N #1
             }
       }
   }
@@ -801,14 +812,14 @@
   {
     \@@_set_vertical:NnNNNNw #1 {#2} \vbox_set:Nw
       \vcoffin_set_end:
-      \vbox_set_end: \@@_update:N
+      \vbox_set_end: \coffin_reset_poles:N
   }
 \cs_generate_variant:Nn \vcoffin_set:Nnw { c }
 \cs_new_protected:Npn \vcoffin_gset:Nnw #1#2
   {
     \@@_set_vertical:NnNNNNw #1 {#2} \vbox_gset:Nw
       \vcoffin_gset_end:
-      \vbox_gset_end: \@@_gupdate:N
+      \vbox_gset_end: \coffin_greset_poles:N
   }
 \cs_generate_variant:Nn \vcoffin_gset:Nnw { c }
 \cs_new_protected:Npn \@@_set_vertical:NnNNNNw #1#2#3#4#5#6
@@ -1033,16 +1044,16 @@
 % \end{macro}
 % \end{macro}
 %
-% \begin{macro}{\@@_update:N, \@@_gupdate:N}
+% \begin{macro}{\coffin_reset_poles:N, \coffin_greset_poles:N}
 %   Simple shortcuts.
 %    \begin{macrocode}
-\cs_new_protected:Npn \@@_update:N #1
+\cs_new_protected:Npn \coffin_reset_poles:N #1
   {
     \@@_reset_structure:N #1
     \@@_update_corners:N #1
     \@@_update_poles:N #1
   }
-\cs_new_protected:Npn \@@_gupdate:N #1
+\cs_new_protected:Npn \coffin_greset_poles:N #1
   {
     \@@_greset_structure:N #1
     \@@_gupdate_corners:N #1





More information about the latex3-commits mailing list.