summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/ocgx2
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-12-17 03:01:08 +0000
committerNorbert Preining <norbert@preining.info>2022-12-17 03:01:08 +0000
commit7b88c25271448cb717bea52abc52e2c8ec033dd9 (patch)
treea7426f0f4c86b506e536350fd35f8bd9e36f59fa /macros/latex/contrib/ocgx2
parent14c4ab52b25f4384f6db7938c2666fdd0f75a723 (diff)
CTAN sync 202212170301
Diffstat (limited to 'macros/latex/contrib/ocgx2')
-rw-r--r--macros/latex/contrib/ocgx2/ChangeLog6
-rw-r--r--macros/latex/contrib/ocgx2/README.md29
-rw-r--r--macros/latex/contrib/ocgx2/ocgx2.sty4
3 files changed, 26 insertions, 13 deletions
diff --git a/macros/latex/contrib/ocgx2/ChangeLog b/macros/latex/contrib/ocgx2/ChangeLog
index 6a05dbbcb9..5b61a6ee13 100644
--- a/macros/latex/contrib/ocgx2/ChangeLog
+++ b/macros/latex/contrib/ocgx2/ChangeLog
@@ -1,7 +1,11 @@
+2022-12-16
+ * v0.56: ocgx2.sty
+ * fix: documentation
+
2022-08-04
* v0.55: ocgx2.sty
* v0.22: ocgbase.sty
- * fix : pkg option processing acc. to new LaTeX format 22-06-01
+ * fix: pkg option processing acc. to new LaTeX format 22-06-01
2022-04-01
* v0.54: ocgx2.sty
diff --git a/macros/latex/contrib/ocgx2/README.md b/macros/latex/contrib/ocgx2/README.md
index 1f33d755ed..b74fe96291 100644
--- a/macros/latex/contrib/ocgx2/README.md
+++ b/macros/latex/contrib/ocgx2/README.md
@@ -127,15 +127,15 @@ document.
A `<visibility policy>` can be *one* of
````latex
-\AllOn{<OCG id 1>, <OCG id 2>, ...}
-\AnyOn{<OCG id 1>, <OCG id 2>, ...}
-\AnyOff{<OCG id 1>, <OCG id 2>, ...}
-\AllOff{<OCG id 1>, <OCG id 2>, ...}
+\AllOn{<OCG id 1> [, <OCG id 2>, ...]}
+\AnyOn{<OCG id 1> [, <OCG id 2>, ...]}
+\AnyOff{<OCG id 1> [, <OCG id 2>, ...]}
+\AllOff{<OCG id 1> [, <OCG id 2>, ...]}
````
All four directives take a list of OCG ids from wich the OCMD visibility is
calculated. If the condition represented by the policy is met, the content
associated with the OCMD is shown. The listed OCGs can be defined anywhere in
-the document. These directives can neither be combined nor nested in order to
+the document. These directives *can neither be combined nor nested* in order to
define the policy. Thus, a visibility policy has limited capabilities.
A `<visibility expression>` is much more flexible than a policy. Arbitrarily
@@ -149,12 +149,21 @@ functions
````
In the argument list, items represent OCG/OCMD ids and nested Boolean
functions. As nesting of the three functions is possible, any thinkable
-visibility relationship can be defined. Note that `\Not{...}` accepts only
-one item, either an OCG/OCMD id or a nested function. Also note that Boolean
-functions and policy directives cannot be intermixed.
+visibility relationship can be defined.
-As a trivial example, the visibility expression equivalent of the policy
-directive `\AllOff{...}` is written as `\Not{ \Or{ ... } }`.
+Note that `\Not{...}` accepts only one item, either an OCG/OCMD id or a nested
+function. Besides that, a single, isolated OCG/OCMD item is not allowed as an
+expression, it must always be embedded in one of the Boolean functions listed
+above. In the simple case of an OCMD depending on a single OCG in a positive
+way, it is better to use a policy, such as `\AllOn{<OCG id>}`, or to put it as
+`\And{<OCG id>}`.
+
+Thus, simple OCMD visibilities can be expressed in an equivalent way by a
+policy or an expression. For example, the visibility expression equivalent of
+the policy directive `\AllOff{...}` is written by means of Boolean functions as
+`\Not{ \Or{ ... } }`.
+
+Note that Boolean functions and policy directives cannot be intermixed.
----
diff --git a/macros/latex/contrib/ocgx2/ocgx2.sty b/macros/latex/contrib/ocgx2/ocgx2.sty
index 16319e52a3..c3b91609cd 100644
--- a/macros/latex/contrib/ocgx2/ocgx2.sty
+++ b/macros/latex/contrib/ocgx2/ocgx2.sty
@@ -43,8 +43,8 @@
%
% The Current Maintainer of this work is A. Grahn.
- \def\g@ocgxii@date@tl{2022/08/04}
- \def\g@ocgxii@version@tl{0.55}
+ \def\g@ocgxii@date@tl{2022/12/16}
+ \def\g@ocgxii@version@tl{0.56}
\ProvidesExplPackage{ocgx2}{\g@ocgxii@date@tl}{\g@ocgxii@version@tl}
{ports `ocgx' functionality to dvips+ps2pdf, xelatex and dvipdfmx}