[latex3-commits] [latex3/latex3] main: Extend comments (7d9774476)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/7d97744766c39bc28a11a16e0fde8748202faf58

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

commit 7d97744766c39bc28a11a16e0fde8748202faf58
Author: Joseph Wright <joseph at texdev.net>
Date:   Tue Mar 12 06:57:50 2024 +0000

    Extend comments


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

7d97744766c39bc28a11a16e0fde8748202faf58
 l3backend/l3backend-draw.dtx | 16 +++++-----------
 1 file changed, 5 insertions(+), 11 deletions(-)

diff --git a/l3backend/l3backend-draw.dtx b/l3backend/l3backend-draw.dtx
index 6b6630e94..2dd100810 100644
--- a/l3backend/l3backend-draw.dtx
+++ b/l3backend/l3backend-draw.dtx
@@ -352,17 +352,11 @@
 %   \texttt{dvips}, but fails if there the box is used inside a scope
 %   (see \url{https://github.com/latex3/latex3/issues/1504}). Instead,
 %   we use the same method as \pkg{pgf}, which means tracking the position
-%   at the PostScript level.
-%   
-%   The implementation here was suggested by Tom Rokici
-%   (author of \texttt{dvips}). We end the current special placement, then
-%   set the current point with a literal |[begin]|. As for general
-%   literals, we then use the stack to store the current point and move to
-%   it. To insert the required transformation, we have to flip the $y$-axis,
-%   once before and once after it. Then we get back to the \TeX{} reference
-%   point to insert our content. The clean up has to happen in the right
-%   places, hence the |[begin]|/|[end]| pair around |restore|. Finally,
-%   we can return to \enquote{normal} drawing mode.
+%   at the PostScript level. Also note that using |@endspecial| would
+%   close the scope it creates, meaning that after a box insertion, any
+%   local changes would be lost.  Keeping \texttt{dvips} on track is
+%   non-trivial, hence the |[begin]|/|[end]| pair before the
+%   |save| and around the |restore|.
 %    \begin{macrocode}
 \cs_new_protected:Npn \@@_backend_box_use:Nnnnn #1#2#3#4#5
   {