summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/optex/base/README15
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-doc.pdfbin1399602 -> 1409811 bytes
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-doc.tex4
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-math.tex25
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-techdoc.tex19
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-userdoc.tex40
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
Binary files differ
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.