summaryrefslogtreecommitdiff
path: root/macros/optex/doc/optex-userdoc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/optex/doc/optex-userdoc.tex')
-rw-r--r--macros/optex/doc/optex-userdoc.tex40
1 files changed, 23 insertions, 17 deletions
diff --git a/macros/optex/doc/optex-userdoc.tex b/macros/optex/doc/optex-userdoc.tex
index 3fefc22657..3e623faa24 100644
--- a/macros/optex/doc/optex-userdoc.tex
+++ b/macros/optex/doc/optex-userdoc.tex
@@ -1343,7 +1343,7 @@ using this empty internal name.
\sec Graphics
%%%%%%%%%%%%%
-\secc Colors
+\secc Colors, transparency
%%%%%%%%%%%
\OpTeX/ provides a small number of color selectors:
@@ -1369,7 +1369,8 @@ or one grey component (using \^`\setgreycolor`). For example
\def \DarkGrey {\setgreycolor{.1}}
\endtt
-\new
+The color selectors work locally in groups like font selectors.
+
The command \^`\morecolors` reads more definitions of color selectors from
the \LaTeX/ file `x11nam.def`.
There are about 300 color names like
@@ -1377,10 +1378,6 @@ There are about 300 color names like
name, then the letters B, C, etc. are appended to the name in \OpTeX/. For example
`\Chocolate` is Chocolate1, `\ChocolateB` is Chocolate2 etc.
-\new
-The color selectors work locally in groups by default. See
-the technical documentation, section~\ref[colors] for more information.
-
The basic colors \^`\Blue`, \^`\Red`, \^`\Cyan`, \^`\Yellow` etc.\ are defined
with CMYK components using \^`\setcmykcolor`.
On the other hand, you can define a color with three
@@ -1397,7 +1394,6 @@ presentations). On the other hand, CMYK makes colors more true\fnote
using ICC profile for your printer.}
for printing.
-\new
You can define your color by a linear combination of previously defined colors using
\^`\colordef`. For example:
@@ -1435,6 +1431,14 @@ The `\coloron` macro can be defined as follows:
\coloron\Yellow\Brown{Brown text on yellow background}
\endtt
+The \^`\transparency``<number>` sets the transparency amount of following
+typesetting material until the current group is closed.
+The <number> must be in the range 0..255,
+zero means no transparency (solid objects), 255 means
+full transparency (invisible objects). You can see the effect when
+overlapping one object over another.
+
+
\secc Images
%%%%%%%%%%%
@@ -1613,12 +1617,12 @@ available in your \TeX/ system.
\new
Only USenglish patterns (original from Plain \TeX/) are preloaded.
Hyphenation patterns of all other languages are loaded on demand when you first use
-the `\<iso-code>lang` command in your document.
+the `\<lang-id>lang` command in your document.
For example \^`\delang` for German, \^`\cslang` for
-Czech, \^`\pllang` for Polish. The <iso-code> is a shortcut
+Czech, \^`\pllang` for Polish. The <lang-id> is a shortcut
of the language (mostly from ISO 639-1).
-You can list all available languages by \^`\langlist`
-macro. This macro prints now:
+You can list all available languages including their <lang-id>'s by the
+\^`\langlist` macro. It prints now:
\medskip
{\typosize[8.5/11.5]\emergencystretch=4em \hbadness=4000
@@ -1741,7 +1745,7 @@ macros if you need them. On the other hand, if your source document is structure
to more files (with individual chapters or sections), use simply the `\input` primitive.
The macro packages intended to \OpTeX/ have the name `*.opm`.
-The following packages are distributed as part of \OpTeX/:
+The list of packages supported by \OpTeX/ follows. Most of them are directly part of \OpTeX/:
\begitems
* `qrcode.opm` enables to create QR codes.
* `tikz.opm` does `\input tikz.tex`, i.e.\ loads Ti{\it k\/}Z. It adds \OpTeX/-specific code.
@@ -1749,7 +1753,9 @@ The following packages are distributed as part of \OpTeX/:
includes settings for microtypographic extensions (protrusions+expanding fonts).
* `vlna.opm` enables to protect of one-letter prepositions and more things automatically.
* `emoji.opm` defines `\emoji{<name>}` command for colored emoticons.
-* `plain-at.opm` defines the old names from plain \TeX/.
+* \ulink[https://github.com/vlasakm/optex-minim]{\tt minim-mp.opm} enables
+ `\directmetapost` using \ulink[https://ctan.org/pkg/minim-mp]{\tt minim-mp}
+ and \ulink[https://ctan.org/pkg/minim]{\tt minim} packages.
* \ulink[https://ctan.org/tex-archive/macros/luatex/optex/pdfextra/pdfextra-doc.pdf]{\tt pdfextra.opm}
allows the use of many extra features from PDF standard (by M. Vlasák).
\enditems
@@ -1956,10 +1962,10 @@ documentation.
All macros of Plain \TeX/ are re-written in \OpTeX/. Common macros should
work in the same sense as in original Plain \TeX. Internal control sequences
-like `\p@` or `\f@@t` are removed and mostly replaced by control sequences
-prefixed by `_` (like `\_this`). If you need to use the basic set of old Plain
-\TeX/ control sequences like `\p@` (for example you are reading an old macro file),
-use `\load[plain-at]`.
+like `\f@@t` are removed and mostly replaced by control sequences
+prefixed by `_` (like `\_this`). Only a basic set of old Plain
+\TeX/ control sequences like `\p@`, `\z@`, `\dimen@` are provided
+but not recommended for new macros.
All primitives and common macros have two
control sequences with the same meaning: in prefixed and unprefixed form.