diff options
Diffstat (limited to 'doc')
21 files changed, 182 insertions, 6 deletions
diff --git a/doc/context/documents/general/manuals/luatex.pdf b/doc/context/documents/general/manuals/luatex.pdf Binary files differindex d2d8d4472..12cf14af5 100644 --- a/doc/context/documents/general/manuals/luatex.pdf +++ b/doc/context/documents/general/manuals/luatex.pdf diff --git a/doc/context/documents/general/manuals/math-mkiv.pdf b/doc/context/documents/general/manuals/math-mkiv.pdf Binary files differindex a494cc5e1..1cc15b97a 100644 --- a/doc/context/documents/general/manuals/math-mkiv.pdf +++ b/doc/context/documents/general/manuals/math-mkiv.pdf diff --git a/doc/context/documents/general/qrcs/setup-cs.pdf b/doc/context/documents/general/qrcs/setup-cs.pdf Binary files differindex 54cc322f5..cb58ca22d 100644 --- a/doc/context/documents/general/qrcs/setup-cs.pdf +++ b/doc/context/documents/general/qrcs/setup-cs.pdf diff --git a/doc/context/documents/general/qrcs/setup-de.pdf b/doc/context/documents/general/qrcs/setup-de.pdf Binary files differindex 5294f7a00..6578249a6 100644 --- a/doc/context/documents/general/qrcs/setup-de.pdf +++ b/doc/context/documents/general/qrcs/setup-de.pdf diff --git a/doc/context/documents/general/qrcs/setup-en.pdf b/doc/context/documents/general/qrcs/setup-en.pdf Binary files differindex 7e2e1b944..98476832c 100644 --- a/doc/context/documents/general/qrcs/setup-en.pdf +++ b/doc/context/documents/general/qrcs/setup-en.pdf diff --git a/doc/context/documents/general/qrcs/setup-fr.pdf b/doc/context/documents/general/qrcs/setup-fr.pdf Binary files differindex da3ad295b..36d1d688f 100644 --- a/doc/context/documents/general/qrcs/setup-fr.pdf +++ b/doc/context/documents/general/qrcs/setup-fr.pdf diff --git a/doc/context/documents/general/qrcs/setup-it.pdf b/doc/context/documents/general/qrcs/setup-it.pdf Binary files differindex 4abc650cf..55b44659c 100644 --- a/doc/context/documents/general/qrcs/setup-it.pdf +++ b/doc/context/documents/general/qrcs/setup-it.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf Binary files differindex d6d89b13d..56b09e762 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-de.pdf b/doc/context/documents/general/qrcs/setup-mapping-de.pdf Binary files differindex 599fa5d4d..ce3b9d0ef 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-de.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-de.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-en.pdf b/doc/context/documents/general/qrcs/setup-mapping-en.pdf Binary files differindex fb22c21d5..c60067c45 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-en.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-en.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf Binary files differindex 35238467e..a17470393 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-it.pdf b/doc/context/documents/general/qrcs/setup-mapping-it.pdf Binary files differindex 7b11665db..0cd7d9a18 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-it.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-it.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf Binary files differindex 50e566d8a..d861a77e7 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf Binary files differindex fe7de7dc7..ce0f9058e 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf diff --git a/doc/context/documents/general/qrcs/setup-nl.pdf b/doc/context/documents/general/qrcs/setup-nl.pdf Binary files differindex b39ba452e..052233d61 100644 --- a/doc/context/documents/general/qrcs/setup-nl.pdf +++ b/doc/context/documents/general/qrcs/setup-nl.pdf diff --git a/doc/context/documents/general/qrcs/setup-ro.pdf b/doc/context/documents/general/qrcs/setup-ro.pdf Binary files differindex 3311cab3e..3a26bc804 100644 --- a/doc/context/documents/general/qrcs/setup-ro.pdf +++ b/doc/context/documents/general/qrcs/setup-ro.pdf diff --git a/doc/context/sources/general/manuals/luatex/luatex-introduction.tex b/doc/context/sources/general/manuals/luatex/luatex-introduction.tex index 196a9af4f..d0899147d 100644 --- a/doc/context/sources/general/manuals/luatex/luatex-introduction.tex +++ b/doc/context/sources/general/manuals/luatex/luatex-introduction.tex @@ -72,11 +72,10 @@ code in \TEX\ engines (especially code that is not needed any longer). \IO\ can be intercepted. \stopitem \startitem - We currently use \LUA\ 5.2.*. At some point we might decide to move to - 5.3.* but that is yet to be decided. There are few \LUA\ libraries that - we consider part of the core \LUA\ machinery, for instance \type {lpeg}. + We currently use \LUA\ 5.3.*. There are few \LUA\ libraries that we + consider part of the core \LUA\ machinery, for instance \type {lpeg}. There are additional \LUA\ libraries that interface to the internals of - \TEX. + \TEX. We also keep the \LUA\ 5.2 \type {bit32} library around. \stopitem \startitem There are various \TEX\ extensions but only those that cannot be done diff --git a/doc/context/sources/general/manuals/luatex/luatex-lua.tex b/doc/context/sources/general/manuals/luatex/luatex-lua.tex index d95415b05..82b060440 100644 --- a/doc/context/sources/general/manuals/luatex/luatex-lua.tex +++ b/doc/context/sources/general/manuals/luatex/luatex-lua.tex @@ -213,7 +213,7 @@ the right|-|hand side of an assignment to a \type {\dimen} or \type {\count}. Loading dynamic \LUA\ libraries will fail if there are two \LUA\ libraries loaded at the same time (which will typically happen on \type {win32}, because there is -one \LUA\ 5.2 inside \LUATEX, and another will likely be linked to the \DLL\ file +one \LUA\ 5.3 inside \LUATEX, and another will likely be linked to the \DLL\ file of the module itself). \LUATEX\ is able to use the kpathsea library to find \type {require()}d modules. diff --git a/doc/context/sources/general/manuals/luatex/luatex.tex b/doc/context/sources/general/manuals/luatex/luatex.tex index b31b87598..33a2327c0 100644 --- a/doc/context/sources/general/manuals/luatex/luatex.tex +++ b/doc/context/sources/general/manuals/luatex/luatex.tex @@ -45,7 +45,7 @@ \startdocument [status=beta, - version=1.06.0] + version=1.07.0] \startnotmode[*export] \component luatex-titlepage diff --git a/doc/context/sources/general/manuals/math/math-mkiv.tex b/doc/context/sources/general/manuals/math/math-mkiv.tex index 93409fd79..11fb4ca1c 100644 --- a/doc/context/sources/general/manuals/math/math-mkiv.tex +++ b/doc/context/sources/general/manuals/math/math-mkiv.tex @@ -41,6 +41,7 @@ \component math-alignments \component math-suboptimal \component math-tricks + \component math-oddities \stopbodymatter \stopdocument diff --git a/doc/context/sources/general/manuals/math/math-oddities.tex b/doc/context/sources/general/manuals/math/math-oddities.tex new file mode 100644 index 000000000..015a30126 --- /dev/null +++ b/doc/context/sources/general/manuals/math/math-oddities.tex @@ -0,0 +1,176 @@ +% language=uk + +\environment math-layout + +\startcomponent math-oddities + +\startchapter[title=Things you might forget] + +\startsection[title=Ampersands] + +You can skip this, but if you continue reading, here is some low level plain code +(don't use this in \CONTEXT): + +\starttyping +\def\matrix#1% + {\null + \, + \vcenter + {\normalbaselines + \ialign{\hfil$##$\hfil && \quad\hfil$##$\hfil\crcr + \mathstrut\crcr + \noalign{\kern-\baselineskip} + #1\crcr + \mathstrut\crcr + \noalign{\kern-\baselineskip}}}% + \,} +\stoptyping + +You see the \type {&} here and it's the alignment cell separator. The special +meaning of these characters is determined by the so called catcode. Here we have: + +\starttyping +\catcode"26=4 +\stoptyping + +Character \type {0x26} is the ampersand. In \CONTEXT\ this character can be used +in text mode because we never use it as alignment character, which is something +typical \TEX. The same is true for \type {^} and \type {_}. So, effectively we +have (for instance): + +\starttyping +\catcode"26=12 +\stoptyping + +In order to still get this \type {&} supported as alignment character in math +mode, we have to jump through some hoops. Think of this (again, don't do this in +\CONTEXT): + +\starttyping +\bgroup + \global\mathcode"26="8000 + + \catcode"26=4 + + \xdef\normalmathaligntab{&} + + \catcode"26=13 + + \global\everymath{\def&{\normalmathaligntab}} +\egroup +\stoptyping + +Before we go on you should realize that we never use the \type {&} in \CONTEXT\ +as separator. The sole reason for dealing with this issue is that users can have +their own code that uses the ampersand that way. In \CONTEXT\ we do things like: + +\starttyping +\startformula + \startmatrix + \NC 1 \NC 2 \NR + \NC 3 \NC 4 \NR + \stopmatrix +\stopformula +\stoptyping + +Where \type {\NC} can be more powerful than a \type {&}. Anyhow, the reason for +discussing this here is that there can be surprises. In a running text you can do +this: + +\starttyping +A & B +\stoptyping + +Which procces okay and gives the ampersand as glyph. The following is also okay: + +\starttyping +$A \Umathchar"2"0"26 B$ +\stoptyping + +However, the next one: + +\starttyping +$A \char"26 B$ +\stoptyping + +fails with a \type {Misplaced alignment tab character &}. The reason is that +where in text mode \TEX's parser will turn the \type {\char} into a character +node and carry on afterwards, in math mode it will treat this inpout as were it a +directly input character, so the above is like, where the \type {&} has active +properties and becomes the sparator ampersand which then triggers the error: + +\starttyping +$A & B$ +\stoptyping + +This means that we cannot have a definition like: + +\starttyping +\def\AND{\char"26\relax} +\stoptyping + +that can be used in math mode, which is why the \CWEB\ macros do: + +\starttyping +\def\AND{\def\AND{\mathchar"2026\relax}\AND} +\stoptyping + +Back to the plain example. The \type {\matrix} command has to be wrapped in +math mode and therefore the \type {&} will adapt, while in most \CONTEXT\ +constructs that use alignment, we're not in math mode at all when we start +with the alignment. Therefore the \type {&} will be just an ampersand in most +\CONTEXT\ cases. + +So to summarize: don't expect \type {\char"26} to work out well in math mode +because all kind of magic kicks in. These are the more obscure features and side +effects of \TEX\ dealing with input and it's really hard to predict how \TEX\ +will see the ampersand you entered. You need to know the internals and even then +it's non trivial. Take + +\starttyping +\startformula +\startalign + \NC x \NR + \NC x \NR +\stopalign +\stopformula +\stoptyping + +versus: + +\starttyping +\startformula +\startalign + & x \NR + & x \NR +\stopalign +\stopformula +\stoptyping + +versus: + +\starttyping +\startformula +\startalign + \NC x & y \NR + \NC x & y \NR +\stopalign +\stopformula +\stoptyping + +The first case works as expected, the second one treats the \type {&} as text and +the third one, as we enter math mode with \type {\NC}, depends on circumstances. +If you use just \CONTEXT\ math coding, you can say: + +\starttyping +\setupmathematics + [ampersand=normal] +\stoptyping + +And always render an ampersand (although a math one in math mode). + +\stopsection + +\stopchapter + +\stopcomponent |