[latex3-commits] [git/LaTeX3-latex3-latex3] master: Code comments (8770ef4)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : master
Link       : https://github.com/latex3/latex3/commit/8770ef4582f9fc51b75f29c3ca6f0995f8450813

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

commit 8770ef4582f9fc51b75f29c3ca6f0995f8450813
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Tue Apr 16 11:32:03 2019 +0100

    Code comments


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

8770ef4582f9fc51b75f29c3ca6f0995f8450813
 l3kernel/l3drivers-pdf.dtx |    6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/l3kernel/l3drivers-pdf.dtx b/l3kernel/l3drivers-pdf.dtx
index 178abcb..f8dc7e9 100644
--- a/l3kernel/l3drivers-pdf.dtx
+++ b/l3kernel/l3drivers-pdf.dtx
@@ -712,6 +712,12 @@
 %   this to be negative (contrast \pkg{hypdvips} approach). The result should
 %   be similar to \pdfTeX{} in the vast majority of foreseeable cases.
 %
+%  The object number for a link is saved separately from the rest of the
+%  dictionary as this allows us to insert it just once, at either an
+%  unbroken link or only in the first line of a broken one. That makes the
+%  code clearer but also avoids a low-level PostScript error with the code
+%  as taken from \pkg{hypdvips}.
+%
 %  Getting the outer dimensions of the text area may be better using a two-pass
 %  approach and |\tex_savepos:D|. That plus format mode are still to re-examine.
 %    \begin{macrocode}