pdftex[909] branches/stable/doc/manual: tweak

[commits+karl at tug.org]

Revision: 909
          http://tug.org/svn/pdftex?view=revision&revision=909
Author:   karl
Date:     2023-05-01 00:33:18 +0200 (Mon, 01 May 2023)
Log Message:
-----------
tweak \pdfglyphtounicode{tfm:...} description

Modified Paths:
--------------
    branches/stable/doc/manual/ChangeLog
    branches/stable/doc/manual/pdftex-t.tex
    branches/stable/doc/manual/pdftex-w.pdf

Modified: branches/stable/doc/manual/ChangeLog
===================================================================
--- branches/stable/doc/manual/ChangeLog	2023-04-27 09:51:41 UTC (rev 908)
+++ branches/stable/doc/manual/ChangeLog	2023-04-30 22:33:18 UTC (rev 909)
@@ -1,3 +1,10 @@
+2023-04-30  Karl Berry  <karl at freefriends.org>
+	and Han The Thanh  <hanthethanh at gmail.com>
+
+	* pdftex-t.tex (\pdfglyphtounicode): describe the
+	\pdfglyphtounicode{tfm:foo/abc}{5678}
+	feature to define abc=U+5678 for only the font foo.tfm.
+
 2023-02-26  Karl Berry  <karl at freefriends.org>
 
 	* pdftex-t.tex (\introducedplural): new macro.

Modified: branches/stable/doc/manual/pdftex-t.tex
===================================================================
--- branches/stable/doc/manual/pdftex-t.tex	2023-04-27 09:51:41 UTC (rev 908)
+++ branches/stable/doc/manual/pdftex-t.tex	2023-04-30 22:33:18 UTC (rev 909)
@@ -2591,10 +2591,10 @@
 \stoptyping
 
 \noindent maps the \type{ff} ligature to a pair of \type{f}'s (whose
-code is \type{U+0066}).
+code is \type{U+0066}, that is, \ASCII\ \type{0x66}).
 
 Once a single \type{\pdfglyphtounicode} definition is made, whether it
-is used or not, another feature comes into play: glyph names of the form
+is used or not, another feature comes into play: all glyph names of the form
 \type{uniXXXX} or \type{uXXXX} are mapped to the natural \type{U+XXXX}.
 Many fonts use this style of naming.
 
@@ -2608,24 +2608,27 @@
 \pdfgentounicode=1
 \stoptyping
 
-pdftex keeps the glyph-name->unicode mappings globally. It means
-that
+(\LATEX\ users could load the \type{cmap} package to achieve the same
+effect.)
+
+By default, these glyph name-to-unicode mappings are global. Thus,
+
 \starttyping
 \pdfglyphtounicode{abc}{1234}
 \stoptyping
-would map glyph 'abc' to '1234' for every font. However it's possible to
-say
+
+\noindent would map the glyph named \type{abc} to \type{U+1234} for
+every font. However, it's possible to make a mapping for a single font
+using a \code{tfm:} prefix:
+
 \starttyping
 \pdfglyphtounicode{tfm:foo/abc}{5678}
 \stoptyping
-which means glyph 'abc' is mapped to '5678', but only for font 'foo.tfm'
 
+\noindent means that for the font \type{foo.tfm}, only, the glyph
+\type{abc} is mapped to \type{U+5678}.
 
 
-\LATEX\ users could load the \type{cmap} package to achieve the same
-effect.
-
-
 \pdftexprimitive{\Syntax{\Tex{\pdfnobuiltintounicode} \Something{font}}}
 \bookmark{\tex{pdfnobuiltintounicode}}
 
@@ -2632,9 +2635,9 @@
 The primary purpose of this command is to prevent \PDFTEX\ from
 generating the \type{ToUnicode}/CMap resource for the given font when
 \type{\pdfgentounicode=1}, most likely because the CMap resource is
-already generated by some other method (for example, the \LATEX\
+already generated by some other method. Notably, the \LATEX\
 \type{cmap} package uses \type{\pdffontattr} to generate a CMap
-resource).
+resource.
 
 Minimal example: 
 \starttyping

Modified: branches/stable/doc/manual/pdftex-w.pdf
===================================================================
(Binary files differ)