From 26fdf6e8d8d273185f664cfc3e4066b52a65797e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 30 Aug 2017 23:01:11 +0000 Subject: forms16be (30aug17) git-svn-id: svn://tug.org/texlive/trunk@45178 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/forms16be/README.md | 2 +- .../doc/latex/forms16be/doc/forms16be-man.pdf | Bin 742092 -> 744530 bytes .../doc/latex/forms16be/doc/forms16be-man.tex | 34 ++++++++++++++++++--- .../doc/latex/forms16be/examples/forms16b3-ef.pdf | Bin 572468 -> 593930 bytes .../doc/latex/forms16be/examples/forms16b3-ef.tex | 11 ++++--- 5 files changed, 37 insertions(+), 10 deletions(-) (limited to 'Master/texmf-dist/doc/latex/forms16be') diff --git a/Master/texmf-dist/doc/latex/forms16be/README.md b/Master/texmf-dist/doc/latex/forms16be/README.md index c1431866eec..f28fb2d8c3b 100644 --- a/Master/texmf-dist/doc/latex/forms16be/README.md +++ b/Master/texmf-dist/doc/latex/forms16be/README.md @@ -1,6 +1,6 @@ The forms16b3 Package Author: D. P. Story -Dated: 2017-08-11 +Dated: 2017/08/28 The forms16be package provides support for UTF-16BE Unicode character encoding (called a big-endian character string) for the text string diff --git a/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.pdf b/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.pdf index 67b1af67869..ab9dc57544b 100644 Binary files a/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.pdf and b/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.pdf differ diff --git a/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.tex b/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.tex index ec3e3057aab..67fbad2ae61 100644 --- a/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.tex +++ b/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.tex @@ -40,7 +40,7 @@ email={dpstory@acrotex.net}, subject=Documentation for the forms16be package, talksite={\url{www.acrotex.net}}, - version={1.0, 2017/08/11}, + version={1.2, 2017/08/28}, Keywords={LaTeX, form fields, UTF-16BE, AcroTeX}, copyrightStatus=True, copyrightNotice={Copyright (C) \the\year, D. P. Story}, @@ -116,7 +116,7 @@ document information, and so forth'' (to partially quote page~158). The particular application is to set property values of form fields, at least those properties that take the text strings as its value. The package contains support for Basic Latin plus the ability to enter any unicode -character using the notation \cs{uXXXX}, where `\texttt{XXXX}' are four hex +character using the notation \cs{uXXXX} or \cs{u(XXXX)}, where `\texttt{XXXX}' are four hex digits. The code was originally designed to be used with the \pkg{eforms} package, @@ -138,7 +138,7 @@ First define the unicode string to be used. name of the unicode string you are defining, it is used later to refer to this string. The \ameta{string} argument is a combination of Basic Latin characters and unicode characters (more specifically, expressions of the form -\cs{uXXXX}, where `\texttt{XXXX}' are hex digits). In the example below, we +\cs{uXXXX} or \cs{u(XXXX)}, where `\texttt{XXXX}' are hex digits). In the example below, we declare, \begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small] \defUniStr{VDV}{\u03B1 cos(\u03B8)} @@ -168,7 +168,6 @@ Notice the first four hex digits, `\texttt{FEFF}', these are `marker digits'. As the PDF Specification describes, the markers are used to signal the beginning of a big-endian hex string. - For \pkg{eforms}, incorporating these ideas into field creation is easy: \begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small] \textField[\TU{\unicodeStr(TU)} @@ -178,6 +177,33 @@ The result is \textField[\textSize{8}\TU{\unicodeStr(TU)} \DV{\unicodeStr(VDV)}\V{\unicodeStr(VDV)}]{tst16be}{1.5in}{11bp}\!\cgBdry. Pass your mouse over the field to see the tool tip as well. +Within the argument of \ameta{string}, backslash, left and right braces are +not defined in the \texttt{uni4basic-latin.def} file. They, therefore, +cannot appear as literals within \ameta{string}. Should you need these +characters, use the following: +\begin{itemize} + \item \cs{u005C} or \cs{u\cs{BSLASH}} for backslash (\verb~\~). + \item \cs{u007B} or \cs{u\cs{LBRACE}} for left brace (\texttt{\{}); + \item \cs{u007D} or \cs{u\cs{RBRACE}} for right brace (\texttt{\}}); +\end{itemize} +(Other definitions within the \texttt{uni4basic-latin.def} file are +\cs{EURO} and \cs{DQUOTE}.) The introduction of the command versions of +unicode brings up another problem, that of obeying spaces. + +Suppose you wanted to initialize a field property with `\cs{LaTeX}'. To obtain +this value we would type `\cs{u\string\BSLASH\space LaTeX}'. But, because \ameta{string} is under the +influence of \cs{obeyspaces}, the specified initialization appears as `\texttt{\string\ LaTeX}', that is, +there is a space that follows the backslash; of course, we cannot specify \cs{u\string\BSLASHLaTeX} as that would +get an undefined command error. The solution is to enclose \cs{BSLASH} in parentheses; if we type +\cs{u(\string\BSLASH)LaTeX} we obtain the desired result: +\begin{Verbatim}[xleftmargin=\amtIndent,fontsize=\small] +\defUniStr{LaTeX}{\u(\BSLASH)LaTeX} +\textField[\V{\unicodeStr(LaTeX)} + \DV{\unicodeStr(LaTeX)}]{tstLaTeX}{1in}{11bp} +\end{Verbatim} +The above code results in +\defUniStr{LaTeX}{\u(\BSLASH)LaTeX}\textField[\V{\unicodeStr(LaTeX)}\DV{\unicodeStr(LaTeX)}]{tstLaTeX}{1in}{11bp}\cgBdry\!. + \section{List of field properties that take a text string} The property entries in a form field that support the text string type are diff --git a/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.pdf b/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.pdf index 8c558630f37..c06d4e7bfdf 100644 Binary files a/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.pdf and b/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.pdf differ diff --git a/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.tex b/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.tex index c7bf9e92f57..0faece2fb5b 100644 --- a/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.tex +++ b/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.tex @@ -1,5 +1,5 @@ \documentclass{article} -\usepackage[designv,forcolorpaper,tight*]{web} +\usepackage[designi,tight*]{web} \usepackage{eforms} \usepackage{forms16be} @@ -19,6 +19,7 @@ Initialize a text field using unicode character strings, \defUniStr{TU}{Don \u\EURO Story "\u03B1 cos(\u03B8)"} \textField[\TU{\unicodeStr(TU)}\DV{\unicodeStr(VDV)}\V{\unicodeStr(VDV)}]{tst}{1.5in}{11bp}\olBdry + \pushButton[\CA{\unicodeStr(VDV)}\AAmouseup{app.alert("Initialized to \\"\\u03B1 cos(\\u03B8)\\"");}]{btn}{1in}{11bp}\cgBdry[1em] \pushButton[\CA{Reset}\AAmouseup{this.resetForm();}]{reset}{}{11bp} @@ -36,10 +37,10 @@ Initialize a combo box using unicode character strings. \comboBox[\Ff\FfEdit\DV{Euro}\V{Euro}\textFont{Arial} \BG{0.98 0.92 0.73}\BC{0 .6 0}]{myCombo}{1in}{11bp} -{*{[(Euro)<\unicodeStr(myEuro)>]% - [(Yen)<\unicodeStr(myYen)>]% - [(Sheqel)<\unicodeStr(mySheqel)>]% - [(Pound)<\unicodeStr(myPound)>]% +{*{[(Euro)<\unicodeStr(myEuro)>] + [(Yen)<\unicodeStr(myYen)>] + [(Sheqel)<\unicodeStr(mySheqel)>] + [(Pound)<\unicodeStr(myPound)>] [(Franc)<\unicodeStr(myFranc)>]} } -- cgit v1.2.3