[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.