summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/optex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-02-09 21:13:26 +0000
committerKarl Berry <karl@freefriends.org>2023-02-09 21:13:26 +0000
commit8e0a627bb31e2495bca858b5c44e63e510c3448c (patch)
treede89817c8a0600c0389a47b4259f736a63046b66 /Master/texmf-dist/doc/optex
parent151bcdb5be17d5cd47c6b6128602294a6835f119 (diff)
optex (9feb23)
git-svn-id: svn://tug.org/texlive/trunk@65766 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/optex')
-rw-r--r--Master/texmf-dist/doc/optex/base/README6
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-doc.pdfbin1484007 -> 1505109 bytes
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-doc.tex4
-rw-r--r--Master/texmf-dist/doc/optex/base/optex-userdoc.tex26
4 files changed, 21 insertions, 15 deletions
diff --git a/Master/texmf-dist/doc/optex/base/README b/Master/texmf-dist/doc/optex/base/README
index f6a86e51d2e..36c2c98bb18 100644
--- a/Master/texmf-dist/doc/optex/base/README
+++ b/Master/texmf-dist/doc/optex/base/README
@@ -22,6 +22,12 @@ doc/ ... PDF version of the OpTeX documentation and sources.
History:
+<1.10> Feb 2022:
+ key-values improved: \iskv, \kvx, \nokvx introduced.
+ unimath-codes: control sequences are macros, no \chardef.
+ \bp, \expr: optional syntax for setting the number of digits after decimal point.
+ \isnextchar is expandable.
+ math.opm: various improvements.
<1.09> Dec 2022:
New math.opm package: doing math more comfortable.
The math.opm package can be a package template for macro writers.
diff --git a/Master/texmf-dist/doc/optex/base/optex-doc.pdf b/Master/texmf-dist/doc/optex/base/optex-doc.pdf
index 666e8793e6e..ed937d191ec 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 de9639a5767..bbb19e44f2d 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.09
+\hfill Version 1.10
-\centerline{\it Petr Olšák, 2020, 2021, 2022}
+\centerline{\it Petr Olšák, 2020, 2021, 2022, 2023}
\bigskip
\centerline{\url{http://petr.olsak.net/optex}}
diff --git a/Master/texmf-dist/doc/optex/base/optex-userdoc.tex b/Master/texmf-dist/doc/optex/base/optex-userdoc.tex
index e04014b991f..937952079af 100644
--- a/Master/texmf-dist/doc/optex/base/optex-userdoc.tex
+++ b/Master/texmf-dist/doc/optex/base/optex-userdoc.tex
@@ -961,7 +961,7 @@ verbatim text is \~`\code{<text>}` (see below).
If the numerical register \^`\ttline` is set to the non-negative value then
display verbatim will number the lines. The first line has the number
\^`\ttline+1` and when the verbatim ends then the \^`\ttline` value is equal to the
-number of the last line printed. Next \^`\begtt...`\^`\endtt` environment will follow
+number of the last line printed. Next \^`\begtt``...`\^`\endtt` environment will follow
the line numbering. \OpTeX/ sets \^`\ttline=-1` by default.
The indentation of each line in display verbatim is controlled by
@@ -991,7 +991,7 @@ There is an alternative to \^`\everytt` named \^`\everyintt` which is used for
in-line verbatim surrounded by an \^`\verbchar` or processed by the \~`\code`
command.
-The \^`\everytt` is applied to all \^`\begtt...`\^`\endtt` environments (if it is not
+The \^`\everytt` is applied to all \^`\begtt``...`\^`\endtt` environments (if it is not
declared in a group). There are tips for such global `\everytt` definitions here:
\begtt \adef!{\char9251 }
@@ -1001,7 +1001,7 @@ declared in a group). There are tips for such global `\everytt` definitions here
\endtt
\new
-If you want to apply a special code only for one \^`\begtt...`\^`\endtt`
+If you want to apply a special code only for one \^`\begtt``...`\^`\endtt`
environment then don't set any \^`\everytt` but put desired material at the
same line where \^`\begtt` is. For example:
@@ -1051,12 +1051,12 @@ the first opening bracket. They are processed in the local group.
For example, `\verbinput \hsize=20cm (-) program.c`.
The \~`\ttline` influences the line numbering by the same way as in
-\~`\begtt...`\~`\endtt` environment. If \~`\ttline=-1` then real line numbers are
+\~`\begtt``...`\~`\endtt` environment. If \~`\ttline=-1` then real line numbers are
printed (this is the default). If \code{\\ttline<-1} then no line
numbers are printed.
The \^`\verbinput` can be controlled by \^`\everytt`, \^`\ttindent` just like
-in \~`\begtt...`\~`\endtt`.
+in \~`\begtt``...`\~`\endtt`.
The \~`\begtt`...\~`\endtt` pair or \~`\verbinput` can be used for listings of
codes. Automatic syntax highlighting is possible, for example
@@ -1760,7 +1760,7 @@ The list of packages supported by \OpTeX/ follows. Most of them are directly par
* \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}
+* \ulink[https://ctan.org/tex-archive/macros/luatex/generic/pdfextra/pdfextra-doc.pdf]{\tt pdfextra.opm}
allows the use of many extra features from PDF standard (by M. Vlasák).
\enditems
See these files in `optex/pkg/` or `optex/<pkgname>` for more information about
@@ -1890,9 +1890,9 @@ put it as the first command in your document:
%%%%%%%%%%%%%%%%%%%%%%%%%%
All \TeX/ primitives and almost all \OpTeX/ macros are accesible by two
-names: `\foo` (public or user name space) and `\_foo` (private name space).
+names: `\foo` (public or user namespace) and `\_foo` (private name space).
For example `\hbox` and `\_hbox` means the same \TeX/ primitive. More about
-it is documented in section~\ref[prefixed].
+it is documented in section~\ref[namespaces].
If this manual refers `\foo` then `\_foo` equivalent exists too. For example,
we mention the `\addto` macro below. The `\_addto` equivalent exists too, but it
@@ -1901,10 +1901,10 @@ equivalent does not exist. For example, we mention the `\_codedecl` macro below,
this macro is not available as `\codedecl`.
If you are writing a document or macros specific for the document, then use
-simply user namespace (`\foo`). If you are writing more general macros,
-then use private namespace (`\_foo`), but you should declare your own namespace
+simply public namespace (`\foo`). If you are writing more general macros,
+then you should declare your own namespace
by \~`\_namespace` macro and you have to follow the naming discipline described in
-section~\ref[pkg-namespace].
+sections~\ref[namespaces] and \ref[pkg-namespace].
The alphabetically sorted list of macros typically usable for macro writers follows.
More information about such macros can be found in the technical documentation.
@@ -1944,7 +1944,8 @@ documentation.
Example: \~`\isinlist\list{<text>}\iftrue` does `\iftrue` if <text> is in `\list`.\nl
\^`\isnextchar`` <char>{<text1>}{<text2>}` performs <text1> if next
character is <char>, else <text2>.\nl
-\~`\kv` `{<key>}` expands to value when key-value parameters are used.\nl
+\~`\kv` `{<key>}` expands to value when key-value parameters are used.
+ See also \~`\iskv`, \~`\readkv`, \~`\kvx`, \~`\nokvx`.\nl
\^`\loop` `...` \^`\repeat` is classical Plain \TeX/ loop.\nl
\^`\mathstyles`` {<math list>}` enables to create macros dependent on current math style.\nl
\~`\_namespace`` {<pkg>}` declares name space used by package writers.\nl
@@ -1959,7 +1960,6 @@ documentation.
provide coordinates of absolute position of the \~`\setpos``[<label>]`.
\~`\private`` <sequence> <sequence> ... ;` declares <sequence>s for private name space.\nl
\~`\public`` <sequence> <sequence> ... ;` declares <sequence>s for public name space.\nl
-\~`\readkv` `\macro` reads parameters from `\macro` in key-value format.\nl
\^`\replstring`` \macro{<stringA>}{<stringB>}` replaces all <stringA> to <stringB> in `\macro`.\nl
\^`\sdef` `{<string>}<parameters>{<body>}` behaves like `\def\<string><parameters>{<body>}`.\nl
\^`\setctable` and \^`\restorectable` manipulate with stack of catcode tables.\nl