From 8e0a627bb31e2495bca858b5c44e63e510c3448c Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 9 Feb 2023 21:13:26 +0000 Subject: optex (9feb23) git-svn-id: svn://tug.org/texlive/trunk@65766 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/optex/base/README | 6 +++++ Master/texmf-dist/doc/optex/base/optex-doc.pdf | Bin 1484007 -> 1505109 bytes Master/texmf-dist/doc/optex/base/optex-doc.tex | 4 ++-- Master/texmf-dist/doc/optex/base/optex-userdoc.tex | 26 ++++++++++----------- 4 files changed, 21 insertions(+), 15 deletions(-) (limited to 'Master/texmf-dist/doc/optex') 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 Binary files a/Master/texmf-dist/doc/optex/base/optex-doc.pdf and b/Master/texmf-dist/doc/optex/base/optex-doc.pdf 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{}` (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/` 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{}\iftrue` does `\iftrue` if is in `\list`.\nl \^`\isnextchar`` {}{}` performs if next character is , else .\nl -\~`\kv` `{}` expands to value when key-value parameters are used.\nl +\~`\kv` `{}` 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`` {}` enables to create macros dependent on current math style.\nl \~`\_namespace`` {}` declares name space used by package writers.\nl @@ -1959,7 +1960,6 @@ documentation. provide coordinates of absolute position of the \~`\setpos``[}` behaves like `\def\{}`.\nl \^`\setctable` and \^`\restorectable` manipulate with stack of catcode tables.\nl -- cgit v1.2.3