[latex3-commits] [git/LaTeX3-latex3-latex3] master: Note on why the "[" PostScript syntax is not used (13cce3a)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : master
Link       : https://github.com/latex3/latex3/commit/13cce3a4fd2c3aa38a3294e04301782b01b7c192

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

commit 13cce3a4fd2c3aa38a3294e04301782b01b7c192
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Fri Apr 12 15:24:56 2019 +0100

    Note on why the "[" PostScript syntax is not used


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

13cce3a4fd2c3aa38a3294e04301782b01b7c192
 l3kernel/l3drivers-pdf.dtx |    6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/l3kernel/l3drivers-pdf.dtx b/l3kernel/l3drivers-pdf.dtx
index bc4966d..1d78502 100644
--- a/l3kernel/l3drivers-pdf.dtx
+++ b/l3kernel/l3drivers-pdf.dtx
@@ -315,7 +315,11 @@
 %     driver.ury, driver.ury
 %   }
 %   Links are crated like annotations but with dedicated code to allow for
-%   adjusting the size of the rectangle.
+%   adjusting the size of the rectangle. In contrast to \pkg{hyperref},
+%   we use the approach of creating an object explicitly here rather than
+%   use the |[| syntax. % ]
+%   That has the advantage of allowing us to provide a reference to the link
+%   later: that is not possible if one uses the shortcut syntax.
 %
 %  Taking the idea of |evenboxes| from \pkg{hypdvips}, we implement a minimum
 %  box height and depth for link placement. This means that \enquote{underlining}