optex (11mar22)

git-svn-id: svn://tug.org/texlive/trunk@62640 c570f23f-e606-0410-a88d-b1316a301751

6 files changed, 63 insertions, 40 deletions

diff --git a/Master/texmf-dist/doc/optex/base/README b/Master/texmf-dist/doc/optex/base/README
index bd8d5824e87..bb17d1359c1 100644
--- a/Master/texmf-dist/doc/optex/base/README
+++ b/Master/texmf-dist/doc/optex/base/README
@@ -1,6 +1,9 @@
 OpTeX: the LuaTeX format based on Plain TeX and OPmac
 
-Author: Petr Olsak, <petr@olsak.net>
+Author:    Petr Olsak, <petr@olsak.net>
+
+Co-author: Michal Vlasák, <lahcim8@gmail.com>
+           (Lua code, colors by attributes, interface to tikz, minim)
 
 This software is in public domain.
 
@@ -19,6 +22,16 @@ doc/   ... PDF version of the OpTeX documentation and sources.
 
 History:
 
+<1.06> Mar. 2022:
+       \transparency selector using attributes implemented.
+       Interface to minim (minim-mp.opm, minim-pdf.opm) introduced.
+       Interface to TikZ (tikz.opm) improved.
+       PDF page resources: management by Lua code implemented.
+       Possibility of preloading no fonts to the format by \let\fontspreload=\relax.
+       hisyntax-lua.opm introduced.
+       plain-at.opm macros included to the format.
+       Language/hyphenations macros reimplemented, phrases file introduced.
+       Font selection: low level macros reimplemented, \fontsel introduced.
 <1.05> Jan. 2022:
        \_par used internally instead \par if \partokenname is available.
        Extended format \ref[label]{text} and \pgref[label]{text} introduced.
diff --git a/Master/texmf-dist/doc/optex/base/optex-doc.pdf b/Master/texmf-dist/doc/optex/base/optex-doc.pdf
index 85260e0fdc2..00e43671f9e 100644
--- a/Master/texmf-dist/doc/optex/base/optex-doc.pdf
+++ b/Master/texmf-dist/doc/optex/base/optex-doc.pdf
diff --git a/Master/texmf-dist/doc/optex/base/optex-doc.tex b/Master/texmf-dist/doc/optex/base/optex-doc.tex
index 1c9af23aa9f..daed675cd8c 100644
--- a/Master/texmf-dist/doc/optex/base/optex-doc.tex
+++ b/Master/texmf-dist/doc/optex/base/optex-doc.tex
@@ -21,9 +21,9 @@
 \tit Format Based on Plain \TeX/ and OPmac\fnotemark1
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\hfill Version 1.05
+\hfill Version 1.06
 
-\centerline{\it Petr Olšák, 2020, 2021}
+\centerline{\it Petr Olšák, 2020, 2021, 2022}
 
 \bigskip
 \centerline{\url{http://petr.olsak.net/optex}}
diff --git a/Master/texmf-dist/doc/optex/base/optex-math.tex b/Master/texmf-dist/doc/optex/base/optex-math.tex
index 4c9d5dd01ff..dbdd7800cfc 100644
--- a/Master/texmf-dist/doc/optex/base/optex-math.tex
+++ b/Master/texmf-dist/doc/optex/base/optex-math.tex
@@ -576,6 +576,17 @@ There are more scalable accents in Unicode math fonts:
 \x`\overleftrightarrow` $\overleftrightarrow{abc}$,
 \x`\overleftharpoon` $\overleftharpoon{abc}$,
 \x`\overrightharpoon` $\overrightharpoon{abc}$,
+\x`\wideoverbar` $\wideoverbar{abc}$,
+\x`\widebreve` $\widebreve{abc}$,
+\x`\widecheck` $\widecheck{abc}$,\nl
+\x`\wideutilde` $\wideutilde{abc}$,
+\x`\mathunderbar` $\mathunderbar{abc}$,
+\x`\underleftrightarrow` $\underleftrightarrow{abc}$,
+\x`\widebridgeabove` $\widebridgeabove{abc}$,\nl
+\x`\underrightharpoondown` $\underrightharpoondown{abc}$,
+\x`\underleftharpoondown` $\underleftharpoondown{abc}$,
+\x`\underleftarrow` $\underleftarrow{abc}$,\nl
+\x`\underrightarrow` $\underrightarrow{abc}$.
 
 
 \secc Fixed math accents
@@ -703,19 +714,17 @@ previous listing of math alphabets and sets as default:
 Moreover, it defines the alphabet selectors at user level (see section 1.3.3
 of the \OpTeX/ manual). For example
 \begtt \typosize[10/12]
-\def\rm {\_tryload\_tenrm \_inmath{\_rmavariables \_rmdigits}}
+\_def\_marm {\_inmath{\_rmavariables \_rmdigits}} % \_mamrm is used in \rm
 \endtt
 %
-The first part
-\new \OpTeX/
-`\_tryload\_tenrm` is applicable for text fonts and the
-`\_inmath` part is processed only in math mode and sets the math alphabets.
-You can see the file `unimath-codes.opm` where all user-level selectors are
+`\_inmath` runs it parameter only in math mode and sets the math alphabets.
+You can see the file `unimath-codes.opm` where all these selectors are
 defined. You can redefine them. For example, \OpTeX/ defines `\bf` as a math
 alphabet selector that selects sans serif bold in math. This is the common
-notation for vectors, tensors, and matrices. If you dislike this, then you can define:
+notation for vectors, tensors, and matrices. If you dislike this (maybe
+because plain \TeX/ has different defaults), then you can define:
 \begtt \typosize[10/12]
-\def\bf {\_tryloadbf\_tenbf \_inmath{\_bfvariables\_bfdigits\_bfgreek\_bfGreek}}
+\_def\_mabf {\_inmath{\_bfvariables\_bfdigits\_bfgreek\_bfGreek}} % used in \bf
 \endtt
 
 
diff --git a/Master/texmf-dist/doc/optex/base/optex-techdoc.tex b/Master/texmf-dist/doc/optex/base/optex-techdoc.tex
index 1748e9f3eaa..5a51ba4d8ac 100644
--- a/Master/texmf-dist/doc/optex/base/optex-techdoc.tex
+++ b/Master/texmf-dist/doc/optex/base/optex-techdoc.tex
@@ -117,7 +117,7 @@ The second bundle of \OpTeX/ macros is here.
 \printdoctail keyval.opm
 \printdoc     keyval.opm
 
-\sec Plain \TeX/ macros
+\sec[plain] Plain \TeX/ macros
 All macros from plain \TeX/ are rewritten here.
 Differences are mentioned in the documentation below.
 \printdoc plain-macros.opm
@@ -128,8 +128,8 @@ Differences are mentioned in the documentation below.
 
 \printdoctail fonts-resize.opm
 \secc[fresize] Implementation of resizing
-Only \"resizing" macros are implemented here. Other aspects of Font
-Selection System and their implementation are desribed in
+Only \"resizing" macros and \^`\initunifonts` are implemented here.
+Other aspects of Font Selection System and their implementation are desribed in
 section~\ref[fselect].
 \printdoc     fonts-resize.opm
 
@@ -248,11 +248,12 @@ The `\margins` macro is documented in the section~\ref[marg].
 \sec Multilingual support
 \secc Lowercase, uppercase codes
 \printdoctail uni-lcuc.opm
-\secc Hyphenations
-\printdoc     hyphen-lan.opm
-\printdoctail hyphen-lan.opm
+%\printdoc     hyphen-lan.opm
+%\printdoctail hyphen-lan.opm
 \secc[langphrases] Multilingual phrases and quotation marks
 \printdoc languages.opm
+\secc[langdecl] Languages declaration
+\printdoc lang-decl.opm
 
 \sec[others] Other macros
 Miscellaneous macros are here.
@@ -273,12 +274,6 @@ The allocations are declared in subsection~\ref[lua-alloc], calbacks are
 implemented in subsection~\ref[callbacks] and handling with colors can be
 found in the subsection~\ref[lua-colors].
 
-\newtoks \_hisyntaxlua
-\_hisyntaxlua={%
-   \_hicolor C \Green
-   \_replfromto {--}{^^J}   {\z C{--#1}^^J}%
-}
-
 {\everytt={\typosize[8/10]\_let\_printverbline=\_printcodeline \medskip}
   \commentchars-- \def\docfile{optex.lua} \ttline=-1
   \_def\_printcomments{\_medskip
diff --git a/Master/texmf-dist/doc/optex/base/optex-userdoc.tex b/Master/texmf-dist/doc/optex/base/optex-userdoc.tex
index 3fefc226573..3e623faa244 100644
--- a/Master/texmf-dist/doc/optex/base/optex-userdoc.tex
+++ b/Master/texmf-dist/doc/optex/base/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.