summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/forms16be
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-08-30 23:01:11 +0000
committerKarl Berry <karl@freefriends.org>2017-08-30 23:01:11 +0000
commit26fdf6e8d8d273185f664cfc3e4066b52a65797e (patch)
treecc77448f21d9e042dfcfedd593d2720095673d3d /Master/texmf-dist/doc/latex/forms16be
parent96aac111c7824c49a05e48fdbb2a1eba6313d062 (diff)
forms16be (30aug17)
git-svn-id: svn://tug.org/texlive/trunk@45178 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/forms16be')
-rw-r--r--Master/texmf-dist/doc/latex/forms16be/README.md2
-rw-r--r--Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.pdfbin742092 -> 744530 bytes
-rw-r--r--Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.tex34
-rw-r--r--Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.pdfbin572468 -> 593930 bytes
-rw-r--r--Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.tex11
5 files changed, 37 insertions, 10 deletions
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
--- a/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.pdf
+++ b/Master/texmf-dist/doc/latex/forms16be/doc/forms16be-man.pdf
Binary files 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
--- a/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.pdf
+++ b/Master/texmf-dist/doc/latex/forms16be/examples/forms16b3-ef.pdf
Binary files 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)>]}
}