[latex3-commits] [git/LaTeX3-latex3-latex3] case-exceptions, main: Rename \box_clip:N to \box_set_clipped:N (200a382d8)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branches: case-exceptions,main
Link       : https://github.com/latex3/latex3/commit/200a382d8be36d98b9036ed036de22e37494c10b

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

commit 200a382d8be36d98b9036ed036de22e37494c10b
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Fri Apr 14 14:06:43 2023 +0100

    Rename \box_clip:N to \box_set_clipped:N


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

200a382d8be36d98b9036ed036de22e37494c10b
 l3kernel/CHANGELOG.md                         |  6 ++++++
 l3kernel/l3candidates.dtx                     | 16 ++++++++--------
 l3kernel/testfiles-backend/support/driver.tex |  8 ++++----
 3 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index addfd8533..aa748468d 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -7,9 +7,15 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Added
+- `\box_set_clipped:N` and variants
+
 ### Fixed
 - Incorrect internal name in `\pdf_pagesize_gset:nn`
 
+### Removed
+- Experimental `\box_clip:N` and variants
+
 ## [2023-03-30]
 
 ### Added
diff --git a/l3kernel/l3candidates.dtx b/l3kernel/l3candidates.dtx
index 9e2120882..b8e6c94f9 100644
--- a/l3kernel/l3candidates.dtx
+++ b/l3kernel/l3candidates.dtx
@@ -86,10 +86,10 @@
 %
 % \section{Additions to \pkg{l3box}}
 %
-% \begin{function}[updated = 2019-01-23]
-%   {\box_clip:N, \box_clip:c, \box_gclip:N, \box_gclip:c}
+% \begin{function}[updated = 2023-04-14]
+%   {\box_set_clipped:N, \box_set_clipped:c, \box_gset_clipped:N, \box_gset_clipped:c}
 %   \begin{syntax}
-%     \cs{box_clip:N} \meta{box}
+%     \cs{box_set_clipped:N} \meta{box}
 %   \end{syntax}
 %   Clips the \meta{box} in the output so that only material inside the
 %   bounding box is displayed in the output. The updated \meta{box} is an
@@ -674,15 +674,15 @@
 %
 % \subsubsection{Viewing part of a box}
 %
-% \begin{macro}{\box_clip:N, \box_clip:c, \box_gclip:N, \box_gclip:c}
+% \begin{macro}{\box_set_clipped:N, \box_set_clipped:c, \box_gset_clipped:N, \box_gset_clipped:c}
 %   A wrapper around the driver-dependent code.
 %    \begin{macrocode}
-\cs_new_protected:Npn \box_clip:N #1
+\cs_new_protected:Npn \box_set_clipped:N #1
   { \hbox_set:Nn #1 { \@@_backend_clip:N #1 } }
-\cs_generate_variant:Nn \box_clip:N { c }
-\cs_new_protected:Npn \box_gclip:N #1
+\cs_generate_variant:Nn \box_set_clipped:N { c }
+\cs_new_protected:Npn \box_gset_clipped:N #1
   { \hbox_gset:Nn #1 { \@@_backend_clip:N #1 } }
-\cs_generate_variant:Nn \box_gclip:N { c }
+\cs_generate_variant:Nn \box_gset_clipped:N { c }
 %    \end{macrocode}
 % \end{macro}
 %
diff --git a/l3kernel/testfiles-backend/support/driver.tex b/l3kernel/testfiles-backend/support/driver.tex
index 5d936a57c..4d0a6f284 100644
--- a/l3kernel/testfiles-backend/support/driver.tex
+++ b/l3kernel/testfiles-backend/support/driver.tex
@@ -13,19 +13,19 @@
   {
     \hbox_set:Nn \l_tmpa_box { Going~up~and~down }
     \box_set_dp:Nn \l_tmpa_box { 1 pt }
-    \box_clip:N \l_tmpa_box
+    \box_set_clipped:N \l_tmpa_box
     \box_show:N \l_tmpa_box
     \hbox_set:Nn \l_tmpa_box { Going~up~and~down }
     \box_set_dp:Nn \l_tmpa_box { 0 pt }
-    \box_clip:N \l_tmpa_box
+    \box_set_clipped:N \l_tmpa_box
     \box_show:N \l_tmpa_box
     \hbox_set:Nn \l_tmpa_box { Going~up~and~down }
     \box_set_dp:Nn \l_tmpa_box { 1 pt }
-    \box_clip:N \l_tmpa_box
+    \box_set_clipped:N \l_tmpa_box
     \box_show:N \l_tmpa_box
     \hbox_set:Nn \l_tmpa_box { Going~up~and~down }
     \box_set_wd:Nn \l_tmpa_box { 20 pt }
-    \box_clip:N \l_tmpa_box
+    \box_set_clipped:N \l_tmpa_box
     \box_show:N \l_tmpa_box
   }