diff options
| author | Hans Hagen <pragma@wxs.nl> | 2021-07-30 01:27:40 +0200 |
|---|---|---|
| committer | Context Git Mirror Bot <phg@phi-gamma.net> | 2021-07-30 01:27:40 +0200 |
| commit | 6db2cd924d26ade933812f90701343f06c8653f2 (patch) | |
| tree | 5aaa37e6fe8e03b827c60a81f66700fde3b971e9 /doc | |
| parent | df12f144a2cb09cec29a95df26bdfc5ccad58aff (diff) | |
| download | context-6db2cd924d26ade933812f90701343f06c8653f2.tar.gz | |
2021-07-30 00:43:00
Diffstat (limited to 'doc')
110 files changed, 1833 insertions, 139 deletions
diff --git a/doc/context/documents/general/manuals/charts-mkiv.pdf b/doc/context/documents/general/manuals/charts-mkiv.pdf Binary files differindex 1a0289aa5..775cdab5d 100644 --- a/doc/context/documents/general/manuals/charts-mkiv.pdf +++ b/doc/context/documents/general/manuals/charts-mkiv.pdf diff --git a/doc/context/documents/general/manuals/followingup.pdf b/doc/context/documents/general/manuals/followingup.pdf Binary files differindex d7812d563..4d55b772d 100644 --- a/doc/context/documents/general/manuals/followingup.pdf +++ b/doc/context/documents/general/manuals/followingup.pdf diff --git a/doc/context/documents/general/manuals/notnow.pdf b/doc/context/documents/general/manuals/notnow.pdf Binary files differindex e597a48bd..f809c093a 100644 --- a/doc/context/documents/general/manuals/notnow.pdf +++ b/doc/context/documents/general/manuals/notnow.pdf diff --git a/doc/context/documents/general/manuals/ontarget.pdf b/doc/context/documents/general/manuals/ontarget.pdf Binary files differnew file mode 100644 index 000000000..c4d0077e4 --- /dev/null +++ b/doc/context/documents/general/manuals/ontarget.pdf diff --git a/doc/context/documents/general/manuals/primitives.pdf b/doc/context/documents/general/manuals/primitives.pdf Binary files differindex d42e72970..00ac18528 100644 --- a/doc/context/documents/general/manuals/primitives.pdf +++ b/doc/context/documents/general/manuals/primitives.pdf diff --git a/doc/context/documents/general/manuals/templates-mkiv.pdf b/doc/context/documents/general/manuals/templates-mkiv.pdf Binary files differindex 47a0d70a6..15aa4f900 100644 --- a/doc/context/documents/general/manuals/templates-mkiv.pdf +++ b/doc/context/documents/general/manuals/templates-mkiv.pdf diff --git a/doc/context/documents/general/manuals/xtables-mkiv.pdf b/doc/context/documents/general/manuals/xtables-mkiv.pdf Binary files differindex 255a730b8..d877a44fd 100644 --- a/doc/context/documents/general/manuals/xtables-mkiv.pdf +++ b/doc/context/documents/general/manuals/xtables-mkiv.pdf diff --git a/doc/context/sources/general/manuals/charts/charts-mkiv.tex b/doc/context/sources/general/manuals/charts/charts-mkiv.tex index 2081b872b..e3d05d7cb 100644 --- a/doc/context/sources/general/manuals/charts/charts-mkiv.tex +++ b/doc/context/sources/general/manuals/charts/charts-mkiv.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/charts + % author : Hans Hagen % copyright : PRAGMA ADE & ConTeXt Development Team % license : Creative Commons Attribution ShareAlike 4.0 International diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-bitwise.tex b/doc/context/sources/general/manuals/evenmore/evenmore-bitwise.tex new file mode 100644 index 000000000..030229413 --- /dev/null +++ b/doc/context/sources/general/manuals/evenmore/evenmore-bitwise.tex @@ -0,0 +1,194 @@ +% language=us runpath=texruns:manuals/evenmore + +\environment evenmore-style + +\startcomponent evenmore-bitwise + +\startchapter[title={Bitwise operations}] + +Occasionally we use a bit set to pass (or store) options and one way of doing +that is to add up some constants. However, what you would like to do is to set a +specific bit. Of course one can write macros for that but performance wise one +can wonder if there are other ways. One solution is to extend the engine but that +has its own pitfalls. For instance, I played with additions to \type {\numexpr} +and although they worked okay and brought now performance degradation, I decided +to remove that experiment. One problem is that we have no real 32 bit cardinals +(unsigned integers) in \TEX\ and the engine makes sure that we never exceed the +minima and maxima. Another problem is that in expressions we then need either +verbose \type {and}, \type {or}, \type {xor}, \type {not} and other verbose +operators, if only because the usual symbols can have catcodes that are +unsuitable. + +So in the end I decided to come up with a set of primitive like commands that +do the job. It is no problem to have a set of dedicated verbose commands and we +can extend the repertoire if needed. So this is what we have now: + +\starttabulate[||i2c||] +\NC command \NC operator equivalent \NC optional \NC \NR +\NC \type {\bitwiseset a} \NC \type {a} \NC \NC \NR +\NC \type {\bitwisenot a} \NC \type {~a} \NC \NC \NR +\NC \type {\bitwisenil a b} \NC \type {a & (~ b)} \NC \type {with} \NC \NR +\NC \type {\bitwiseand a b} \NC \type {a & b} \NC \type {with} \NC \NR +\NC \type {\bitwiseor a b} \NC \type {a | b} \NC \type {with} \NC \NR +\NC \type {\bitwisexor a b} \NC \type {a ~ b} \NC \type {with} \NC \NR +\NC \type {\bitwiseshift a b} \NC \type {a >> b} \NC \type {by} \NC \NR +\NC \type {\bitwiseshift a -b} \NC \type {a << b} \NC \type {by} \NC \NR +\NC \type {\ifbitwiseand a b} \NC \type {(a & b) ~= 0} \NC \NC \NR +\stoptabulate + +Here a some examples: + +\startbuffer +\scratchcounter = \bitwiseand "01 "02 \uchexnumbers{\scratchcounter} \quad +\scratchcounter = \bitwiseand "01 with "02 \uchexnumbers{\scratchcounter} \quad +\scratchcounter = \bitwiseand "03 "02 \uchexnumbers{\scratchcounter} \qquad +\scratchcounter = \bitwiseor "01 "02 \uchexnumbers{\scratchcounter} \quad +\scratchcounter = \bitwiseor "01 with "02 \uchexnumbers{\scratchcounter} \quad +\scratchcounter = \bitwiseor "03 "02 \uchexnumbers{\scratchcounter} \qquad +\scratchcounter = \bitwisexor "01 "02 \uchexnumbers{\scratchcounter} \quad +\scratchcounter = \bitwisexor "01 with "02 \uchexnumbers{\scratchcounter} \quad +\scratchcounter = \bitwisexor "03 "02 \uchexnumbers{\scratchcounter} +\stopbuffer + +\typebuffer + +This gives the nine values: + +{\tt\getbuffer} + +Because they are numeric operations you can chain them, as in: + +\starttyping +\scratchcounter = \bitwisenil \bitwisenil "0F "02 "01 \relax +\scratchcounter = \bitwisenil \bitwisenil "0F with "02 with "01 \relax +\stoptyping + +We try as good as possible to support all bits in the range from zero upto \type +{0xFFFFFFFF}; + +\startbuffer +\scratchcounter \bitwiseset "FFFFFFFF + +\ifbitwiseand \scratchcounter "80000000 YES \else NOP \fi +\ifbitwiseand \scratchcounter "F0000000 YES \else NOP \fi +\ifbitwiseand \scratchcounter "10000000 YES \else NOP \fi + +\scratchcounter \bitwisenot \scratchcounter + +\ifbitwiseand \scratchcounter "80000000 YES \else NOP \fi +\ifbitwiseand \scratchcounter "F0000000 YES \else NOP \fi +\ifbitwiseand \scratchcounter "10000000 YES \else NOP \fi +\stopbuffer + +\typebuffer + +and we get: + +\startpacked \tt \getbuffer \stoppacked + +Of course you can just use normal counters and \TEX\ integers but using the bit +commands have the advantage that they do some checking and can do real \type {or} +etc operations. Here is some food for thought: + +\startbuffer +\scratchcounter \bitwiseand "01 "02 +\scratchcounter \numexpr "01+"02\relax + +\ifcase \bitwiseand \scratchcounterone \plusone \else \fi +\ifbitwiseand \scratchcounterone \plusone \else \fi +\ifnum \scratchcounterone=\plusone \else \fi +\stopbuffer + +\typebuffer + +and we get: + +\startpacked \tt \getbuffer \stoppacked + +You can also go real binary, but we only provide a combined setter|/|getter for +that, but you can mix that one with the other commands: + +\startbuffer +\scratchcounterone = \bitwise 1101 +\scratchcountertwo = \bitwise 11011101110111011101110111011101 +\scratchcounterthree = \bitwiseor \bitwise 0001 \bitwise 1100 + +{0x\uchexnumber{\scratchcounterone} \bitwise\scratchcounterone }\par +{0x\uchexnumber{\scratchcountertwo} \bitwise\scratchcountertwo }\par +{0x\uchexnumber{\scratchcounterthree} \bitwise\scratchcounterthree}\par +\stopbuffer + +\typebuffer + +We get bits back: + +\startpacked \tt \getbuffer \stoppacked + +The above commands are typical for the things we can do with \LUAMETATEX\ and +\LMTX\ and are unlikely to become available in \MKIV. + +There is a special command for (re)setting a bit in a register: + +\startbuffer + \scratchcounter 0 +\bitwiseflip \scratchcounter 1 [\the\scratchcounter] +\bitwiseflip \scratchcounter 4 [\the\scratchcounter] +\bitwiseflip \scratchcounter 8 [\the\scratchcounter] +\bitwiseflip \scratchcounter -5 [\the\scratchcounter] +\stopbuffer + +\typebuffer + +This gives: \inlinebuffer. Of course a global assignment works too: + +\startbuffer + \global \globalscratchcounter 0 +{\global \bitwiseflip \globalscratchcounter 2 } [\the\globalscratchcounter] +{\global \bitwiseflip \globalscratchcounter 4 } [\the\globalscratchcounter] +{\global \bitwiseflip \globalscratchcounter 8 } [\the\globalscratchcounter] +{\global \bitwiseflip \globalscratchcounter -6 } [\the\globalscratchcounter] +\stopbuffer + +\typebuffer + +Here we get: \inlinebuffer. A side effect of it being an number makes that +this is also valid: + +\starttyping +\scratchcounterone\bitwiseflip \scratchcountertwo -16 +\stoptyping + +\stopchapter + +\stopcomponent + +% (\scratchcounterone \bitwiseset "F \uchexnumber{\scratchcounterone})\par +% (\scratchcounterone \bitwiseset "FF \uchexnumber{\scratchcounterone})\par +% (\scratchcounterone \bitwiseset "FFF \uchexnumber{\scratchcounterone})\par +% (\scratchcounterone \bitwiseset "FFFF \uchexnumber{\scratchcounterone})\par +% (\scratchcounterone \bitwiseset "FFFFF \uchexnumber{\scratchcounterone})\par +% (\scratchcounterone \bitwiseset "FFFFFF \uchexnumber{\scratchcounterone})\par +% (\scratchcounterone \bitwiseset "FFFFFFF \uchexnumber{\scratchcounterone})\par +% (\scratchcounterone \bitwiseset "FFFFFFFF \uchexnumber{\scratchcounterone})\par +% +% (\scratchcounterone \bitwiseset "0000FFFF +% \scratchcounterone \bitwiseshift \scratchcounterone -16 +% \uchexnumber{\scratchcounterone})\par +% +% \scratchcounterone \bitwiseset "FFFFFFFF +% \scratchcountertwo \bitwiseset "FFFFFFFE +% +% \the\scratchcounterone : \uchexnumber{\scratchcounterone}\par +% \the\scratchcountertwo : \uchexnumber{\scratchcountertwo}\par + +% I need to check this on the garden run as it looks like that server is some 50% +% faster than my (in terms of computers) old laptop. + +% \testfeatureonce{10000}{\scratchcounter \bitwiseand "01 "02 } \elapsedtime\par +% \testfeatureonce{10000}{\scratchcounter \numexpr "01+"02\relax} \elapsedtime\par +% \testfeatureonce{10000}{\ifcase\bitwiseand \scratchcounterone \plusone \else \fi} \elapsedtime\par +% \testfeatureonce{10000}{\ifbitwiseand \scratchcounterone \plusone \else \fi} \elapsedtime\par +% %testfeatureonce{10000}{\ifnum \scratchcounterone=\plusone \else \fi} \elapsedtime\par +% +% \testfeatureonce{100000}{\scratchcounter = \bitwise 1101 } \elapsedtime\par +% \testfeatureonce{100000}{\scratchcounter = \bitwise 11011101110111011101110111011101 } \elapsedtime\par diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-contents.tex b/doc/context/sources/general/manuals/evenmore/evenmore-contents.tex index d20b45eee..6d617ad5f 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-contents.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-contents.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/evenmore + \startcomponent evenmore-contents \environment evenmore-style diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-expansion.tex b/doc/context/sources/general/manuals/evenmore/evenmore-expansion.tex index 6c67f07d6..3ef5b3402 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-expansion.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-expansion.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \environment evenmore-style diff --git a/doc/context/sources/general/manuals/followingup/followingup-expressions.tex b/doc/context/sources/general/manuals/evenmore/evenmore-expressions.tex index 321496c97..37bb5a5bd 100644 --- a/doc/context/sources/general/manuals/followingup/followingup-expressions.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-expressions.tex @@ -1,8 +1,11 @@ -% language=us runpath=texruns:manuals/followingup +% language=us runpath=texruns:manuals/evenmore -\startcomponent followingup-expressions +% This one accidentally ended up in the older history document followingup, +% btu it's now moved here. -\environment followingup-style +\startcomponent evenmore-expressions + +\environment evenmore-style \startchapter[title={Expressions}] diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-fonts.tex b/doc/context/sources/general/manuals/evenmore/evenmore-fonts.tex index fea3f7ac5..c25f425f1 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-fonts.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-fonts.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \environment evenmore-style diff --git a/doc/context/sources/general/manuals/followingup/followingup-formats.tex b/doc/context/sources/general/manuals/evenmore/evenmore-formats.tex index 9b55c472a..7ec95a7d4 100644 --- a/doc/context/sources/general/manuals/followingup/followingup-formats.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-formats.tex @@ -1,8 +1,11 @@ -% language=us runpath=texruns:manuals/followingup +% language=us runpath=texruns:manuals/evenmore -\environment followingup-style +% This one accidentally ended up in the older history document followingup, +% btu it's now moved here. -\startcomponent followingup-format +\environment evenmore-style + +\startcomponent evenmore-format \startchapter[title={The format file}] diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-hyphenation.tex b/doc/context/sources/general/manuals/evenmore/evenmore-hyphenation.tex new file mode 100644 index 000000000..50113ed27 --- /dev/null +++ b/doc/context/sources/general/manuals/evenmore/evenmore-hyphenation.tex @@ -0,0 +1,426 @@ +% language=us runpath=texruns:manuals/evenmore + +\environment evenmore-style + +\startcomponent evenmore-hyphenation + +\usebodyfont[pagella] + +\startchapter[title=Hyphenation] + +\startsection[title={Introduction}] + +Hyphenation is driven by the character codes. In a traditional \TEX\ such a code +accesses a glyph in a font, which is why the font encoding mattered, but in +\LUATEX\ we use \UNICODE\ and when hyphenation is applied. \footnote {In +\CONTEXT\ \MKII\ we also use \UTF\ patterns, which made it possible to ship +patterns that didn't depend on a font encoding. Mojca and Arthur made \UTF\ the +default when the (upgraded) hyphenation pattern project started.} Later, the +character codes are adapted by the font handler where they become glyphs. There +are moments when you don't want to hyphenate and a cheap trick is to switch to a +language that has no hyphenation patterns. But, in a system like \CONTEXT\ that +doesn't work well because we have lots of language bound properties. Therefore in +\MKIV\ we set the left- and right hyphen minima to extreme values, something that +blocks hyphenation quite well. But this is not a pretty solution at all. Even +worse is that when we have situations where discretionaries (\type +{\discretionary}), automatic (\type{-}) or explicit (\type {\-}) are used these +still kick in. + +For that reason in \LMTX\ we have a mode variable that controls hyphenation. In +\LUATEX\ we have primitives like \type {\compoundhyphenmode}, \type +{\hyphenationbounds} and \type {\hyphenpenaltymode} that controlled how +hyphenation and discretionary injection is handled but when in \LUAMETATEX\ the +more generic \type {\hyphenationmode} parameter was introduced the precursors +were all merged into this one. One can argue that this is a form of regression +but there are good reasons, most noticeably the fact that we keep these +properties with glyph nodes so that we have better control over them in grouped +situations where as some operations happen when the paragraph as whole get +treated local overloads are lost. \footnote {Of course it also is a wink to those +who complain that we add primitives to an otherwise leaner variant of \LUATEX, +but let us not elaborate on that misunderstanding.} It anyway means that in +\LMTX\ we have to set different parameters but that is no big deal because users +are supposed to use the more high level interfaces; instead of setting parameters +to values one flips bits in \type {\hyphenationmode}, which in the end makes more +sense and also permits extensions later without adding much overhead. + +Currently this mode parameter controls the following options: + +\starttabulate[|Tr|||] +\NC \uchexnumber{\normalhyphenationcode} \NC \type{\normalhyphenationcode} \NC honour the (normal) \type{\discretionary} primitive \NC \NR +\NC \uchexnumber{\automatichyphenationcode} \NC \type{\automatichyphenationcode} \NC turn \type {-} into (automatic) discretionaries \NC \NR +\NC \uchexnumber{\explicithyphenationcode} \NC \type{\explicithyphenationcode} \NC turn \type {\-} into (explicit) discretionaries \NC \NR +\NC \uchexnumber{\syllablehyphenationcode} \NC \type{\syllablehyphenationcode} \NC hyphenate (syllable) according to language \NC \NR +\NC \uchexnumber{\uppercasehyphenationcode} \NC \type{\uppercasehyphenationcode} \NC hyphenate uppercase characters too \NC \NR +\NC \uchexnumber{\compoundhyphenationcode} \NC \type{\compoundhyphenationcode} \NC permit break at an explicit hyphen (border cases) \NC \NR +\NC \uchexnumber{\strictstarthyphenationcode} \NC \type{\strictstarthyphenationcode} \NC traditional \TEX\ compatibility wrt the start of a word \NC \NR +\NC \uchexnumber{\strictendhyphenationcode} \NC \type{\strictendhyphenationcode} \NC traditional \TEX\ compatibility wrt the end of a word \NC \NR +\NC \uchexnumber{\automaticpenaltyhyphenationcode} \NC \type{\automaticpenaltyhyphenationcode} \NC use \type {\automatichyphenpenalty} \NC \NR +\NC \uchexnumber{\explicitpenaltyhyphenationcode} \NC \type{\explicitpenaltyhyphenationcode} \NC use \type {\explicithyphenpenalty} \NC \NR +\NC \uchexnumber{\permitgluehyphenationcode} \NC \type{\permitgluehyphenationcode} \NC turn glue in discretionaries into kerns \NC \NR +\stoptabulate + +The default \CONTEXT\ setup is: + +\starttyping +\hyphenationmode \numexpr + \normalhyphenationcode + + \automatichyphenationcode + + \explicithyphenationcode + + \syllablehyphenationcode + + \uppercasehyphenationcode + + \compoundhyphenationcode + % \strictstarthyphenationcode + % \strictendhyphenationcode + + \automaticpenaltyhyphenationcode + + \explicitpenaltyhyphenationcode + + \permitgluehyphenationcode +\relax +\stoptyping + +When a discretionary node is created (triggered by \type {\discretionary}) the +current value is used. Injected glyph nodes on the other hand will store the +current value and use that when it is needed for hyphenating the list. + +\stopsection + +\startsection[title={Controlling hyphenation}] + +We start with an example that has some Dutch words: + +\startbuffer[sample] +NEDERLANDS\par Nederlands\par nederlands\par +\CONTEXT \par test\-test\par test-test \par +\stopbuffer + +\typebuffer[sample] + +\startbuffer[result] +\startlinecorrection +\dontleavehmode \dorecurse{\boxlines\scratchboxone} {% + \setbox\scratchbox\boxline\scratchboxone#1% + \ruledhpack{\strut\unhbox\scratchbox}% + \kern.25\emwidth +} +\stoplinecorrection +\stopbuffer + +When we typeset this with a \type {\hsize} of 2mm we get: + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[sample]} + +\getbuffer[result] + +But when we block hyphenation with \type {\nohyhens} we see: + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \nohyphens \getbuffer[sample]} + +\getbuffer[result] + +The \MKIV\ behavior can be emulated by setting the mode as follows + +\startbuffer[demo] +\bitwiseflip \hyphenationmode \syllablehyphenationcode +\stopbuffer + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[demo] \getbuffer[sample]} + +\getbuffer[result] + +This time the three non|-|syllable variants get hyphenated and that is not what +we want. In this case there is a \type {\discretionary} in the definition of the +macro that generates \CONTEXT\ and, apart from the fact that we might not even +want to hyphenate logos, we have to block it when we apply \type {\nohyphens}. + +This mode setting are directly applied to the three non|-|syllable variants but +delayed in the syllable discretionaries because hyphenation happens later so the +state becomes a property of glyph nodes. Doing the same for the other +discretionaries would demand an adaption of various pieces of the engine code and +plugged in user (\LUA) code also has to consider it which makes no sense. + +\startbuffer[sample] +\nohyphens nederlands {\dohyphens nederlands} nederlands\par +\stopbuffer + +\typebuffer[sample] + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[sample]} +\getbuffer[result] + +Compare this with: + +\startbuffer[sample] +nederlands {\nohyphens nederlands} nederlands\par +\stopbuffer + +\typebuffer[sample] + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[sample]} +\getbuffer[result] + +\stopsection + +\startsection[title={Compound hyphenation}] + +Yet another discretionary related issue is with compound words, that is: cases +where \type {\discretionary} commands sit between words. There are of course +tricks to deal with it like adding a huge penalty combined with a zero skip. This +is okay in a traditional \TEX\ engine but in an opened up one you might not want +this. Just to mention one aspect: when processing \OPENTYPE\ fonts you actually +need to look into discretionaries in order to deal with glyphs that interact. And +you don't want to deal with penalties and skips unless they have an explicit +meaning. We show the four possibilities: + +\startbuffer[sample] +nederlands\discretionary {!}{!}{!}nederlands\blank +\stopbuffer + +\typebuffer[sample] + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[sample]} +\getbuffer[result] + +\startbuffer[sample] +nederlands\discretionary options 1 {!}{!}{!}nederlands\blank +\stopbuffer + +\typebuffer[sample] + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[sample]} +\getbuffer[result] + +\startbuffer[sample] +nederlands\discretionary options 2 {!}{!}{!}nederlands\blank +\stopbuffer + +\typebuffer[sample] + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[sample]} +\getbuffer[result] + +\startbuffer[sample] +nederlands\discretionary options 3 {!}{!}{!}nederlands\blank +\stopbuffer + +\typebuffer[sample] + +\setbox\scratchboxone\vbox{\dontcomplain \nl \hsize 2mm \getbuffer[sample]} +\getbuffer[result] + +Here is an example of such an interference. Of course in practice this happens +seldom and certainly not with ligatures. Some fonts have kerning between certain +glyphs and for instance dashes and there it could matter. + +\startbuffer +ef% +\penalty \plustenthousand +\hskip \zeropoint +\discretionary{-}{f}{f}% +\penalty \plustenthousand +\hskip \zeropoint +e +ef\discretionary options 3 {-}{f}{f}e +\stopbuffer + +\typebuffer + +As you can see, we only get the ligature when we set the options. In the process +of processing \OPENTYPE\ features it can be that one actually looses a +discretionary, although we try to prevent this when possible. + +\startlinecorrection +\scale[height=2cm]{\setupbodyfont[pagella]\showglyphs\getbuffer} +\stoplinecorrection + +But, as said, the fact that we don't need the penalties and glue helps at the +\LUA\ end: the cleaner the node list, the better. + +\stopsection + +\startsection[title={Tracing}] + +The already present tracker command has been extended so handle the options: + +\startbuffer[sample0] +\enabletrackers[discretionaries] +\stopbuffer +\startbuffer[sample1] +test\discretionary {]} {[} {[]}test +\stopbuffer +\startbuffer[sample2] +testing\discretionary {]} {[} {[]}testing +\stopbuffer +\startbuffer[sample3] +testing\discretionary options 3 {]} {[} {[]}testing +\stopbuffer + +\typebuffer[sample0,sample1,sample2,sample3] + +\setbox\scratchboxone\vbox{\dontcomplain \getbuffer[sample0,sample1]} \getbuffer[result] +\setbox\scratchboxone\vbox{\dontcomplain \hsize 2mm \getbuffer[sample0,sample2]} \getbuffer[result] +\setbox\scratchboxone\vbox{\dontcomplain \hsize 2mm \getbuffer[sample0,sample3]} \getbuffer[result] + +\stopsection + +\startsection[title={Glue in discretionaries}] + +In the case you cannot predict what goes into a discretionary you can get run into +an error message with respect to unsupported glue in a disc node. The mode value +\number\permitgluehyphenationcode\space makes glue acceptable and turn into +kern, as demonstrated here; + +\startbuffer +{\hsize 1mm \darkblue \discretionary{potential conspiracy}{prophets}{influencers}\par} +\stopbuffer + +\typebuffer + +The line break occurs but the space in the pre part is of course frozen: + +{\getbuffer} + +As usual \TEX\ users will come up with applications. + +\stopsection + +\startsection[title={Penalties}] + +By default the par builder will use the value of \type {\hyphenpenalty} that gets +stored in the discretionary node. However, when the \type {\discretionary} is +followed by a \type {penalty} keyword and a number, that one will. + +\stopsection + +\startsection[title=Exceptions] + +At some point a user on the \CONTEXT\ mailing list wondered how to deal with a case +like this: + +\startbuffer[example] +\switchtobodyfont[pagella]\mainlanguage[de]auffasse +\stopbuffer + +\typebuffer[example] + +\startlinecorrection +\scale[height=2cm]{\inlinebuffer[example]} +\stoplinecorrection + +\startbuffer +\startexceptions[de] +au{f-}{-f}{ff}(f\zwnj f)asse +\stopexceptions +\stopbuffer + +In \LUAMETATEX\ you can block the unwanted ligature using this trick: + +\typebuffer \getbuffer + +\startlinecorrection +\scale[height=2cm]{\inlinebuffer[example]} +\stoplinecorrection + +The exception mechanism in \LUATEX\ and therefore \LUAMETATEX\ works as follows. +When we have this exception: + +\starttyping +au{f-}{-f}{ff}asse +\stoptyping + +the engine will register that exception under \type {auffasse}, that is: the +replacement part determines the word. When it runs into that word, it will create +a so called discretionary node with a pre, post and replace part. However, it +only uses the \type {ff} for a lookup and keeps the original two glyphs: these +become the replacement text. However, in \LUAMETATEX\ you can add an alternative +replacement: + +\startbuffer +\startexceptions[de] +au{f-}{-f}{ff}(st)asse +\stopexceptions +\stopbuffer + +\typebuffer \getbuffer + +This time the replacement text becomes \type {xx}. So we get \type {austasse} and +it is that sequence that is seen by the font handler when it applies its tricks. +On some fonts however + +\startbuffer[example] +\switchtobodyfont[pagella]\mainlanguage[de]auffasse +\stopbuffer + +\startlinecorrection +\scale[height=2cm]{\showglyphs\showfontkerns\inlinebuffer[example]} +\stoplinecorrection + +But in the Pagella font that we use here, a kern is added between the \type {s} and +the \type {t}. If you don't want that you can say this: + +\startbuffer +\startexceptions[de] +au{f-}{-f}{ff}(s\zwnj t)asse +\stopexceptions +\stopbuffer + +\typebuffer \getbuffer + +\startlinecorrection +\scale[height=2cm]{\showglyphs\showfontkerns\inlinebuffer[example]} +\stoplinecorrection + +A \type {zwj} will block a ligature (some fonts have an \type {st} ligature) and a +\type {zwnj} blocks a ligatures as well as kerns. + +You can actually abuse this mechanism for trickery like this: + +\startbuffer +\startexceptions[nl] +wis-kun-d{e-}{o}{eo}(e-o)n-der-wijs +\stopexceptions +\stopbuffer + +\typebuffer \getbuffer + +The Dutch word \type {wiskundeonderwijs} is found as exception and comes out like +this: + +\startbuffer[example] +\switchtobodyfont[pagella]\mainlanguage[nl]wiskundeonderwijs +\stopbuffer + +\startlinecorrection +\scale[height=1cm]{\showglyphs\showfontkerns\inlinebuffer[example]} +\stoplinecorrection + +Watch the hyphen that makes the compound word more visible! The other hyphens in +the exception are proper hyphenation points and when a break happens there a +hyphen is automatically added. The \type {\nokerning} and \type {\noligaturing} +macros can be used grouped: + +\startbuffer[example] +{every}\quad +{\nokerning every}\quad +{\noligaturing every}\quad +{e{\nokerning v}ery}\quad +{e{\glyphoptions\noleftkernglyphoptioncode v}ery}\quad +{e{\glyphoptions\norightkernglyphoptioncode v}ery}\quad +\stopbuffer + +\typebuffer[example] + +There are several low level control options. In addition to those shown here we +have a pair for ligatures: \typ {\noleftligatureglyphoptioncode} and \typ +{\norightligatureglyphoptioncode}. + +\startlinecorrection[blank] +\scale[width=\textwidth]{\showglyphs\showfontkerns\inlinebuffer[example]} +\stoplinecorrection + +There are alternative mechanism, like a blocker that implements a font feature +and a replacement mechanism, but these are not discussed here. + +\stopsection + +\stopchapter + +\stopcomponent diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-inserts.tex b/doc/context/sources/general/manuals/evenmore/evenmore-inserts.tex new file mode 100644 index 000000000..75c79e888 --- /dev/null +++ b/doc/context/sources/general/manuals/evenmore/evenmore-inserts.tex @@ -0,0 +1,198 @@ +% language=us runpath=texruns:manuals/evenmore + +\environment evenmore-style + +\startcomponent evenmore-inserts + +\startchapter[title=Inserts] + +{\em As in other chapters, this is mostly a wrapup of some developments and nota +manual. What is described here might actually evolve. Normally \CONTEXT\ users +will not notice these details, but it might help them to get an idea of what +complications we're dealing with.} + +\startsection[title=Notes] + +Quite some \TEX\ users love footnotes. These typographical elements have two +properties: + +\startitemize[n] +\startitem + A blob of text, often placed at the bottom of a page or at the end of a + section, chapter or document. A note can be a short one|-|liner but also + a paragraph of text. +\stopitem +\startitem + A symbol in the running text that serves as reference to that blob. It can be + a number of just some unique symbol. +\stopitem +\stopitemize + +When such a note is placed at the bottom of a page, the page builder needs to +take its dimensions into account when calculating an optimal page break. It might +even have to split a note over pages. Preferably the reference and note are on +the same page. In order to achieve this there is a special mechanism that deals +with this: inserts. In this chapter we only discuss them in the perspective of +notes but they can also be used for, for instance, top or bottom figures, tables, +etc. + +\stopsection + +\startsection[title=Global and local] + +Normally notes are placed in the text flow. We call these global inserts. When +they are attached to a specific typographical element we tend to call them local +and there is a good reason for that. For instance, when used in a table, one +might want to keep them with that table when it is moved to a place where it +fits. When notes are packaged {\em with} the table they are flushed on demand and +not handled by the page builder. Actually they don't use inserts then. One +problem with global notes is that the \TEX\ engine has some limitations with +respect to inserts. In traditional \TEX, the following example will only result +in note \quote {a} being placed. The other two are buried too deeply. + +\startbuffer[insert] +test \footnote {a} \hbox {test \footnote{b} \hbox {test \footnote {c}} test} test +\stopbuffer + +\typebuffer[insert] + +There are a few places where \TEX\ will bubble up the notes: when it constructs +lines during a breaking a paragraph into lines, and when constructing alignment +cells. In all other cases they are simply discarded. + +In \CONTEXT\ \MKII\ there is a mechanism that can postpone such notes. Normally a +user will not use boxes directly so when some mechanism is used that does box +its content, \CONTEXT\ can collect the notes and flush them in a spot that +exposes them. This works reasonable well be it that we loose some of the +synchronization with the page builder: flushing can happen after a page break. + +Already early in the \CONTEXT\ \MKIV\ development a more advanced mechanism was +introduced, using \LUA\ callbacks: auto migration. There (optionally) inserts are +bubbled up to a level where they are visible but even that has its limitations. Users +explicitly need to enable automigration in \MKIV. + +In \CONTEXT\ \LMTX\ we do it a bit different because the \LUAMETATEX\ engine has +a feature that helps. More about that next. + +\stopsection + +\startsection[title=Pre and post migration] + +There is another mechanism that moves material from the spot: adjusts. Here is an +example (watch the interline spacing): + +\startbuffer[adjust] +\strut test \vadjust pre {\red \strut before} test \vadjust {\red \strut after} +\stopbuffer + +\typebuffer[adjust] + +This gives: + +\blank {\bf\showstruts \getbuffer[adjust]} \blank + +The \type {pre} variant was introduced in \PDFTEX\ at a time that I actually has +use for it (think of marginal notes) but in \MKIV\ we don't use this adjust +mechanism. + +Inserts on the other hand always end up \quote {post} where they are injected. +Some day I might think about what good there is in injecting them \quote {pre} +where they are injected. It might become an option. + +\blank {\bf \showboxes \getbuffer[insert]} \blank + +In this already shown example the footnotes (that are implemented using inserts) +result indeed in text showing up at the bottom of the page, even when they are +wrapped in boxes. The reason is that we have enabled a mechanism that +automatically bubble them up: + +\starttyping +\automigrationmode = 3 % \numexpr 1 + 2 \relax +\stoptyping + +Here bit~1 controls migration in lists and bit~2 controls migration in the main +vertical list (the page flow). In \CONTEXT\ \LMTX\ we enable both. + +\startbuffer +h: \setbox0\hbox{box \footnote{h: box}}\setbox2\hbox{\box 0}\box2\quad +h: \setbox0\hbox{copy \footnote{h: copy}}\setbox2\hbox{\copy 0}\box2\quad +h: \setbox0\hbox{unbox \footnote{h: unhbox}}\setbox2\hbox{\unhbox 0}\box2\quad +h: \setbox0\hbox{uncopy \footnote{h: unhcopy}}\setbox2\hbox{\unhcopy0}\box2\quad +v: \setbox0\hbox{box \footnote{v: box}}\setbox2\vbox{\box 0}\box2\quad +v: \setbox0\hbox{copy \footnote{v: copy}}\setbox2\vbox{\copy 0}\box2\quad +v: \setbox0\hbox{unbox \footnote{v: unhbox}}\setbox2\vbox{\unhbox 0}\box2\quad +v: \setbox0\hbox{uncopy \footnote{v: unhcopy}}\setbox2\vbox{\unhcopy0}\box2\quad +\stopbuffer + +\typebuffer + +This is a kind of torture test: + +\blank \hbox{\bf \getbuffer} \blank + +It might look kind of trivial to accomplish this but it actually took some +experimenting to get it right. It also must be noted that because in \LUATEX\ and +even more in \LUAMETATEX\ the nodes that store a box are much larger than in +traditional \TEX\ and that the price for adding some additional overhead for +dealing with pre- and post material had not that much impact on the performance +of \LUAMETATEX. + +On the one hand we need to make sure that the inserts are kept with the box but +on the other hand they should really migrate when the boxed material gets boxed +itself. This has to be combined with unboxing and copying. It has to work in +regular boxes but also in the main vertical list (the page flow). + +\stopsection + +\startsection[title=Playground] + +You can play a bit with this mechanism by getting and setting the pre and post +material than relates to a box. + +\startbuffer +\setbox0\ruledhbox{\strut content \footnote {footnote}} + +[flush pre\prelistbox 0] % \prelistcopy 0 +[flush post\postlistbox 0] % \postlistcopy 0 +[set pre\setprelistbox 0\ruledhbox{\strut before}] +[set post\setpostlistbox0\ruledhbox{\strut after}] + +\blank \box0 \blank +\stopbuffer + +\typebuffer + +\getbuffer + +Of course there can be side effects but so far this mechanism works reasonable +well, given what it has to deal with. + +\stopsection + +\startsection[title=Marks] + +The low level marks mechanism can use the same pre and post mechanisms but I +didn't test that yet. We have a different approach to marks but eventually might +revert to using the build in mechanism, be it in adapted form. + +\stopsection + +% \startsection[title=Maybe] +% +% Inserts are implemented in a bit special way. A class of inserts needs a box, +% dimen, count and skip register. So, the macro package has to allocate these +% en|-|block. This puts some constraints on the register allocation macros. On the +% agenda is to investigate if a dedicated compound register makes sense. However, +% this means that the interfaces change, but because a \CONTEXT\ user doesn't use +% the low level inserts directly this is not really a problem. Adapting the +% implementation can have the side effect of using a different insert chaining +% which can give a better interface to \LUA\ because the current interface is not +% really useable. +% +% \stopsection + +\stopchapter + +\stopcomponent + + diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-introduction.tex b/doc/context/sources/general/manuals/evenmore/evenmore-introduction.tex index d5bfbdad7..b66c8a5e4 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-introduction.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-introduction.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \startcomponent evenmore-introduction diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-keywords.tex b/doc/context/sources/general/manuals/evenmore/evenmore-keywords.tex index 1ffacf0ab..ddf3e0f0d 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-keywords.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-keywords.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore % Talking of keywords: Jacob Collier, Count The People is definitely an example % of showing keywords and no way that the fonts used there are done by tex: diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-libraries.tex b/doc/context/sources/general/manuals/evenmore/evenmore-libraries.tex index 5cca165bb..9e003ea2a 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-libraries.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-libraries.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \startcomponent evenmore-libraries diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-normalization.tex b/doc/context/sources/general/manuals/evenmore/evenmore-normalization.tex index 64ceaa353..80e065c48 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-normalization.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-normalization.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore % \enabletrackers[nodes.directions] @@ -102,8 +102,8 @@ The decision making is influenced by quite some factors, like: \starttexdefinition Sample #1#2 \OldNormalizeLineMode\normalizelinemode - \bitwiseflip \normalizelinemode \normalizelinemodecode - \bitwiseflip \normalizelinemode \indentskipmodecode + \bitwiseflip \normalizelinemode \normalizelinenormalizecode + \bitwiseflip \normalizelinemode \parindentskipnormalizecode \startsubsubject[title={#1}] \typebuffer[#2] \startlinecorrection diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-numbers.tex b/doc/context/sources/general/manuals/evenmore/evenmore-numbers.tex index 9b8e10a56..7bbdbdeec 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-numbers.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-numbers.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \startcomponent evenmore-numbers diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-offloading.tex b/doc/context/sources/general/manuals/evenmore/evenmore-offloading.tex new file mode 100644 index 000000000..6a7de5a06 --- /dev/null +++ b/doc/context/sources/general/manuals/evenmore/evenmore-offloading.tex @@ -0,0 +1,127 @@ +% language=us runpath=texruns:manuals/evenmore + +% \showusage + +% This chapter was started when I updated some of the dynamic memory management +% code. The musical timestamp is the discovery (via Sputs & Ghostnote drumming +% sessions) of DOMI & JS BECK (also see: keyscape, nord) and after that Louis +% Cole (Live 2019). So much talent around ... + +\environment evenmore-style + +\startcomponent evenmore-offloading + +\startchapter[title={Offloading}] + +The \LUAMETATEX\ source code started from \LUATEX\ with the idea to make a lean +and mean variant. In the process the whole code base has been overhauled. Because +we develop and maintain \CONTEXT\ in parallel all kind of experiments can be +conducted. \footnote {To my best knowledge macro packages like \LATEX\ have +decided to use the (mostly stable) \LUATEX\ in combination with a built in font +renderer. The wish for stability from developers of other macro packages was one +of the reasons for starting the \LUAMETATEX\ project: \LUATEX\ could no longer +evolve without folks complaining. So, \LUAMETATEX, at least in the short run, is +no reasonable option for other macro packages, unless policies have changed.} + +Already early in the process the decision was made to remove the backend code. I +already had a working \LUATEX\ & \MKIV\ setup with an independent backend so that +was an easy step. Later I removed that code from \MKIV\ because a dualistic model +made for a messy \CONTEXT\ code base, and for \LUATEX\ I like to stick to the +reference implementation. Of course one can wonder if we still have \TEX\ when +there is no backend but you need to keep in mind that \TEX\ always needs some +kind of backend program. If \DVI\ was still a used format (with \CONTEXT) I could +write a \DVI\ backend without much effort, but \PDF\ is kind of the standard now. +The relevant primitives can easily be defined in \LUA. + +What more defines \TEX ? Of course the macro language, but in addition to that we +have the handling of fonts, hyphenation and building various lists, those that +eventually make it into paragraphs and pages. The \ETEX, \PDFTEX\ and \OMEGA\ +engines have added bits and pieces and of course \LUATEX\ added its share. + +In \LUAMETATEX\ the macro part has been extended. Very few things were dropped, +most noticeably \type {\long} and \type {\outer} are no longer effective but +that made for a better \type {\protected} and gave room for \type {\frozen}. + +The handling of fonts is mostly delegated to callbacks but we do have the +original transformation mechanism available. However, loading fonts is now up to +\LUA. If that is done right, there is no difference with \TEX. One can argue that +when a missing piece in the binary is complemented by a \LUA\ solution that gets +plugged in we just are like \TEX. After all, nowhere is said that the engine has +to be written in one language and in the \CWEB\ setup of \TEXLIVE\ we already mix +languages anyway. + +The language part is also upgraded and because handling hyphenation has been +extended we're, as with fonts, going beyond what traditional \TEX\ offers. The +code for hyphenating is slightly different because we permit runtime loading and +extension, compound and weighted patterns, etc. + +Another deviation is the handling of input and output. Although currently the log +file still happens at the engine end, all the reading and writing from files is +delegated to \LUA. This means that primitives like \type {\openin} and \type +{\write} have to be implemented in \LUA, which is not that hard. It makes a lot +of sense because everything already was driven by callbacks so delegating more to +\LUA\ in the end gave a simpler input handler. For the user (or macro package) it +makes no difference. + +So, assuming that the primitives not present in the engine are provided by \LUA\ +driven counterparts, we can speak of \TEX. So how about \ETEX ? We kept the macro +language extensions, but dropped some others, like the direction related code. +Also the querying of internal codes has been adapted to \LUATEX's internals. +Expressions have been extended a bit. The \type {\scantokens} primitive now uses +the same machinery as the \LUA|-|\TEX\ pipe, which made for less code and adds to +consistency. From the \PDFTEX\ engine we only kept a few things, like protrusion +and expansion. From \OMEGA\ only the concept of localpar and part of the +directional model was kept, but because it's the backend that deals with +directions there is not much there. We also dropped some \LUATEX\ features, for +instance first class image handling only stays as concept (a special kind of +rule) but again it is the backend that really needs to deal with it. + +So, in the end we end up, as intended, with a simpler code base indeed. Of course +there is also stuff that is not in a traditional \TEX\ or \LUATEX. In addition to +\LUA\ some libraries are present, but we avoid dependencies on large third party +bodies of code. The continuous updating in \LUATEX\ told me that this dependency +is a bad thing of we want the program to compile in decades from now (as +libraries come and go and often also politics are involved). There is a small +canonical set of what we provide and although one can use extra libraries it +takes some effort. The internals of \LUAMETATEX\ are hidden. + +Just for the record. Because I want to keep as working engine and adapt \CONTEXT\ +in parallel, the process is rather time consuming. Every optimization, removal of +unused code, addition of a feature, etc.\ takes multiple runs of the test suite, +checking with \CONTEXT, generating binaries, updating the distribution, and so +on. When we don't use something in \CONTEXT\ it goes on the todo stack, which +means that testing is delayed to when I wrap up in documentation, which only +happens when I think it's stable. For instance: when \type {\openin} and friends +were delegated to \LUA, the \type {\ifeof} primitive was kept around with a +temporary callback, so that \type {tikz} kept working. We don't use those read +channels in \CONTEXT\ so that was a compromise. A while later the if test was +also delegated and the temporary callback removed. There is no way I could do +this kind of stepwise development were it now within the \CONTEXT\ community +where users are willing to accept this. + +Another example of something that took some time is checking all memory +allocation code, adding safeguards, make it more dynamic, making sure we have +more statistics. It needs some experimenting and the \CONTEXT\ tracking code had +to be extended. The main motivation for this is that there are some users out +there (most noticeably Massimiliano who is involved in typesetting some scholar +encyclopedia work) who run really huge jobs and we can run out of memory or even +crash then. \footnote {I'm not that worried about an occasional bug, because the +number is small compared to what got added, changed and improved, but of course +there are always folks who ignore that fact and stress bug(let)s. But, as said, +the \CONTEXT\ users are a patient lot.} Tracing shows that although \TEX\ +allocates its share of memory, in these thousand plus page documents in small +print the regular few dozen megabytes can grow to hundreds, most noticeably taken +up by fonts. Tracing also gives some insight in how fast token and node memory +grows. Of course in this case \LUA\ takes way more memory, something between 1.5 +and 2~GB. Again this is due to the large amount of font instances and also is a +side effect of massive \XML\ processing (keep in mind that the whole tree is in +memory) and the fact that there are plenty of optimizations wrt typesetting +implemented and multiple large registers are added. It's this kind of +(regression) tests that help in stepwise improving \LUAMETATEX. \footnote {In the +process one sometimes find ways to safe memory. For instance, marks used +preallocated arrays that took 1280 KB memory while of course in practice no one +needs that many mark registers. By making that more dynamic we saved a lot.} + +\stopchapter + +\stopcomponent diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-paragraphs.tex b/doc/context/sources/general/manuals/evenmore/evenmore-paragraphs.tex new file mode 100644 index 000000000..c8958a487 --- /dev/null +++ b/doc/context/sources/general/manuals/evenmore/evenmore-paragraphs.tex @@ -0,0 +1,397 @@ +% language=us runpath=texruns:manuals/evenmore + +% End of July 2020 I decided to look into some of the backlog items and paragraphs +% are on them, as are inserts and so. The usual musical time stamp is buying the +% excellent Prince Live at the Aladdin Las Vegas DVD which I ran between the +% moments that I had enough of coding. Some tracks, like Family Name, fit perfectly +% in mid 2020. + +% https://www.youtube.com/watch?v=f8FAJXPBdOg + +\environment evenmore-style + +\startcomponent evenmore-paragraphs + +\enableexperiments[paragraphs.freeze] + +\startchapter[title=Paragraphs] + +{\em This is mostly a wrapup of some developments, and definitely not a tutorial. +What is described here is experimental and successive version of \CONTEXT\ \LMTX\ +will explore their potential. As long a users stay away from the low level +primitives we can try to guarantee consistent behavior (and catch side effect or +deal with known issues).} + +\startsection[title=Freezing] + +A well known property of paragraphs is that when the moment is there to split +into lines, the current state of variables drives it. There are a lot of quite +some variables involved. The most significant one is the \type {\hsize}. Take +this: + +\startbuffer +\bgroup + {\bf Ward:} + \hsize .25\textwidth + {\bf Ward:} \samplefile{ward} + \hsize .75\textwidth % last value +\egroup +\stopbuffer + +\typebuffer + +This gives: + +{\forgetparagraphfreezing \getbuffer} + +But wait, why do we get the full text width here? The reason is that by the time +the paragraph ends, after the \type {\egroup}, the \type {\hsize} is set back to +what it was before the group started. + +\startbuffer +\bgroup + \hsize .25\textwidth + {\bf Ward:} \samplefile{ward} + \hsize .75\textwidth % last value + \par +\egroup +\stopbuffer + +\typebuffer + +This gives: + +{\forgetparagraphfreezing \getbuffer} + +The last \type {\hsize} specified is used. That is not really a problem, but the +fact that we need to explicitly end a paragraph before the group ends actually +is, and in a moment we will see an example where that matters a lot. First a +general solution to this problem is discussed. In the next example, we do group, +but inside that group we take a snapshot of the \type {\hsize}: + +\startbuffer +\bgroup + \hsize .80\textwidth + \dontleavehmode + \snapshotpar "000001 + {\bf Ward:} \samplefile{ward} +\egroup +\stopbuffer + +\typebuffer + +This time we get: + +{\forgetparagraphfreezing \getbuffer} + +The magic number used in the snapshot relates to the \type {\hsize}. + +\startcolumns[n=2] +\starttabulate[|T||] +\NC 0x\uchexnumbers{\hsizefrozenparcode } \NC hsize \NC \NR +\NC 0x\uchexnumbers{\skipfrozenparcode } \NC leftskip rightskip \NC \NR +\NC 0x\uchexnumbers{\hangfrozenparcode } \NC hangindent hangafter \NC \NR +\NC 0x\uchexnumbers{\indentfrozenparcode } \NC parindent \NC \NR +\NC 0x\uchexnumbers{\parfillfrozenparcode } \NC parfillskip parfillleftskip \NC \NR +\NC 0x\uchexnumbers{\adjustfrozenparcode } \NC adjustspacing adjustspacingstep adjustspacingshrink adjustspacingstretch \NC \NR +\NC 0x\uchexnumbers{\protrudefrozenparcode } \NC protrudechars \NC \NR +\NC 0x\uchexnumbers{\tolerancefrozenparcode } \NC pretolerance tolerance \NC \NR +\NC 0x\uchexnumbers{\stretchfrozenparcode } \NC emergencystretch \NC \NR +\NC 0x\uchexnumbers{\loosenessfrozenparcode } \NC looseness \NC \NR +\NC 0x\uchexnumbers{\lastlinefrozenparcode } \NC lastlinefit \NC \NR +\NC 0x\uchexnumbers{\linepenaltyfrozenparcode } \NC linepenalty interlinepenalty interlinepenalties \NC \NR +\NC 0x\uchexnumbers{\clubpenaltyfrozenparcode } \NC clubpenalty clubpenalties \NC \NR +\NC 0x\uchexnumbers{\widowpenaltyfrozenparcode } \NC widowpenalty widowpenalties displaywidowpenalty displaywidowpenalties \NC \NR +\NC 0x\uchexnumbers{\brokenpenaltyfrozenparcode} \NC brokenpenalty \NC \NR +\NC 0x\uchexnumbers{\demeritsfrozenparcode } \NC adjdemerits doublehyphendemerits finalhyphendemerits \NC \NR +\NC 0x\uchexnumbers{\shapefrozenparcode } \NC parshape \NC \NR +\NC 0x\uchexnumbers{\linefrozenparcode } \NC baselineskip lineskip lineskiplimit \NC \NR +\NC \NC \NC \NR +\NC 0xFFFFFFF \BC all of them \NC \NR +\stoptabulate +\stopcolumns + +In practice you will set them all on one go, so: + +\starttyping +\snapshotpar "FFFFFFF +\stoptyping + +How often do we need such a feature? Actually more often than one thinks, +especially when we have an unpredictable situation. For instance, when you +typeset from an \XML\ source you often don't know what you get, and you can have +cases that end up like this: + +\startbuffer +\placefigure[left,none]{}{} {Ward: \bf \dorecurse{3}{\samplefile{ward}} } \par +\placefigure[left,none]{}{} {\bf Ward:} \dorecurse{3}{\samplefile{ward}} \par +\stopbuffer + +\typebuffer + +This might render as: + +{\forgetparagraphfreezing \getbuffer} \forgetsidefloats % needed due to interference + +The placement of such a figure is hooked into \type {\everypar} and uses hanging +indentation. Like \type {\hsize}, \type {\hangafter} and \type {\hangindent} can +be forgotten before the paragraph ends. In \MKII\ and \MKIV\ the recommended +solution is to always start a paragraph explicitly, with a strut, forced +indentation of preferably: + +\startbuffer +\dontleavehmode {Ward: \bf \dorecurse{3}{\samplefile{ward} } } \par +\dontleavehmode {\bf Ward:} \dorecurse{3}{\samplefile{ward} } \par +\stopbuffer + +\typebuffer + +In an \XML\ mapping we can hide it but in a regular \TEX\ source this is not +pretty. With little effort we can do the snapping automatically, so that we get: + +\placefigure[left,none]{}{} {Ward: \bf \dorecurse{3}{\samplefile{ward} } } \par +\placefigure[left,none]{}{} {\bf Ward:} \dorecurse{3}{\samplefile{ward} } \par + +and this is what \CONTEXT\ \LMTX\ will do once we're sure that the snapshot +feature behaves well and has no side effects. There is of course some overhead +involved in taking snapshots, keeping track of the values and accessing them +later, but it is rewarding. + +In addition to the numeric \type {\snapshotpar} primitive there is also another +way to take s snapshot. As with the numeric variant, it only takes a snapshot when +in horizontal mode: there has to be a so called local par node at the head of the +current list. The next code shows some how to play with some of what \CONTEXT\ +offers: + +\starttyping +\setuplayout[alternative=doublesided] + +\starttext + +\startbuffer + \dorecurse{8}{ + \interlinepenalties 1 \maxcard + CASE 1: \samplefile{tufte} \par + } \page + + \dorecurse{8}{ + CASE 2: \samplefile{tufte} + \interlinepenalties 1 \maxcard \par + } \page + + \dorecurse{8}{ + CASE 3: \samplefile{tufte} + \interlinepenalties 1 \maxcard \freezeparagraphproperties \par + } \page + + \dorecurse{8}{ + CASE 4: \samplefile{tufte} + \frozen \interlinepenalties 1 \maxcard \par + } \page + + \dorecurse{8}{ + CASE 5: \samplefile{tufte} + \frozen \interlinepenalty \maxcard \par + } \page +\stopbuffer + +\typebuffer \page \getbuffer + +\stoptext +\stoptyping + +When you process this you will notice that the \type {\frozen} prefix also +snapshots the parameter that gets set. Now, there is a pitfall here: some for +these settings are persistent, i.e. they are not reset after a paragraph has been +typeset. For instance, \type {\tolerance} is a general setting, but \type +{\hangindent} is a one shot setting: it's value gets reset after the paragraph +has been dealt with. + +Here is another test one can run to see what happens: + +\starttyping +\dontleavehmode +\defrostparagraphproperties +\writestatus{state}{after start \uchexnumbers{\the\snapshotpar}}% +\writestatus{state}{before set hangindent \uchexnumbers{\the\snapshotpar}}% +\frozen\hangindent10pt +\writestatus{state}{after set hangindent \uchexnumbers{\the\snapshotpar}}% +\writestatus{state}{before set looseness \uchexnumbers{\the\snapshotpar}}% +\frozen\looseness 1 +\writestatus{state}{after set looseness \uchexnumbers{\the\snapshotpar}}% +\writestatus{state}{before set hangafter \uchexnumbers{\the\snapshotpar}}% +\frozen\hangafter 2 +\writestatus{state}{after set hangafter \uchexnumbers{\the\snapshotpar}}% +\begingroup +\writestatus{state}{before set rightskip \uchexnumbers{\the\snapshotpar}}% +\frozen\rightskip2cm +\writestatus{state}{after set rightskip \uchexnumbers{\the\snapshotpar}}% +\endgroup +\writestatus{state}{before reset hangindent \uchexnumbers{\the\snapshotpar}}% +\snapshotpar-\frozenhangindentcode +\writestatus{state}{after reset hangindent \uchexnumbers{\the\snapshotpar}}% +\writestatus{state}{before reset hangafter \uchexnumbers{\the\snapshotpar}}% +\snapshotpar-\frozenhangaftercode +\writestatus{state}{after reset hangafter \uchexnumbers{\the\snapshotpar}}% +... content ... +\stoptyping + +You can group an assignment and then take a snapshot. That way the change doesn't +affect following paragraphs, unless of course to did a global assignment. In +\CONTEXT\ we have a bunch of constants that can be used instead of the hard to +remember bit positions. The \type {\frozen} prefix can also be used with for +instance a \type {\advance} operation. Of course it only has effect for those +(internal) parameters that relate to a paragraph. + +Keep in mind that what is show here will evolve: in \CONTEXT\ \LMTX\ we will +snapshot by default and the core macros are aware of this fact. Although the way +\CONTEXT\ is set up makes it relatively easy to make this paradigm shift users +should anyway be aware of this change when they do their own low level tweaking, +but in that case they probably already are aware of possible interferences. + +\stopsection + +\startsection[title=Wrapping up] + +Another new (low level) feature is wrapping up a paragraph. Traditional \TEX\ +comes with the powerful \type {\everypar} and in \LUAMETATEX\ we now have \type +{\wrapuppar}. This primitive collects tokens that will be expanded just before +the paragraph ends. Here is an example: + +\startbuffer +\dontleavehmode +\wrapuppar{\hfill {\bf ONE}}% +\wrapuppar{\crlf\strut\hfill {\bf TWO}\hfill\strut}% +\wrapuppar{\crlf\strut {\bf THREE}\hfill\strut {\bf FOUR}}% +\samplefile{ward} + +\samplefile{ward} +\stopbuffer + +\typebuffer + +We can only wrapup when we are in a paragraph although one can of course use the +\type {\wrapuppar} command inside an \type {\everypar} if needed. + +\getbuffer + +An more useful example is the following. We leave it to the reader to check it +out: + +\starttyping +\dorecurse{10}{ + \bgroup + \advance\hsize by -#1cm\relax + \dontleavehmode + \wrapuppar{\strut\nobreak\hfill\nobreak QED}% + \samplefile{ward} + \egroup + \par +} +\stoptyping + +\stopsection + +\startsection[title=Insertions] + +The concept of inserts is kind of complicated. They are nodes in a list that make +separate streams. An application of inserts are footnotes. In the text flow a +symbol is typeset (like a raised number) and the note itself becomes an insert. +When a paragraph is broken into lines, these inserts end up in to be boxed line, +but when the line is actually wrapped in a box, these inserts are collected and +injected after the line. The page builder will then take their dimensions into +account when it comes to breaking pages. Depending on how strict the rules are +the inserts will end up on the same page, move, of be broken into lines. + +This all works well as long as the inserts are not burried into boxes: they then +are invisible to the mechanism described before. Take the following example: + +\starttyping +\dontleavehmode +l\hbox{h\footnote{h1} test} +l\hbox{h\footnote{h2}} test +l\hbox{h\footnote{h3}} test +l\footnote{l4} test +l\footnote{l5} test +l\hbox{h\footnote{h6} test} +l\hbox{\hbox{\hbox{h\footnote{h7} test}}} +l\footnote{l8} test +\par +\stoptyping + +% \starttabulate +% \NC test \NC test \footnote{before} \samplefile{tufte} \footnote{after}\NC \NR +% ... +% \NC test \NC test \footnote{before} \samplefile{tufte} \footnote{after}\NC \NR +% \stoptabulate + +In the engines used with \MKII\ only a few footnotes actually show up. In \MKIV\ +the situation is slightly better because there we use some trickery to migrate +these notes to the outer level. But even there it's not perfect because the order +changes. We can actually fix that (and do so) but it comes at a performance penalty +so this is why in \MKIV\ dealing with this is optional. + +\start + \def\Hi#1{\high{\tx#1}} + \dontleavehmode + \hbox{lh\H1 test lh\H2 test lh\H3 test l\H4 test l\H5 test lh\H6 test lh\H7 test l\H8 test} + + \starttabulate[|||||||||||] + \NC \MKII \NC \PDFTEX\ & \XETEX \NC \Hi4 l4 \NC \Hi5 l5 \NC \Hi8 l8 \NC \NC \NC \NC \NC \NC \NR + \NC \MKIV \footnote{In older versions.} \NC \LUATEX \NC \Hi1 h1 \NC \Hi2 h2 \NC \Hi3 h3 \NC \Hi6 h6 \NC \Hi7 h7 \NC \Hi4 l4 \NC \Hi5 l5 \NC \Hi8 l8 \NC \NR + \NC \LMTX \NC \LUAMETATEX \NC \Hi1 h1 \NC \Hi2 h2 \NC \Hi3 h3 \NC \Hi4 l4 \NC \Hi5 l5 \NC \Hi6 h6 \NC \Hi7 h7 \NC \Hi8 l8 \NC \NR + \stoptabulate +\stop + +However, when you look at the results of \LMTX\ you will notice that the +situation is better. This is because we have some code to \LUAMETATEX\ that can +better deal with some cases. Combined with some \LUA\ magic (as in \MKIV) we get +the right order at hardly any runtime overhead. It must be noted that the +original \TEX\ engine for good reason works as it does because there the actual +typesetting (read: resolving glyphs, hyphenation, applying ligatures and kerns, +etc.) is interwoven with the main scanning|/|expanding loops in order to be +efficient on the machines of those times. In \LUATEX\ we have these stages +separated but the code dealing with inserts is the same, if only because we have +to be compatible. In \LUAMETATEX\ we have again a bit simpler code because we use +the fact that lists are double linked, which also makes it possible to add some +magic code dealing with nested inserts without obscuring the code. It comes of +course at a bit performance hit and the nodes related to lists also because +larger but they are already much larger than in other engines, so we don't care +too much about that. It is anyway a mechanism that need to be enabled explicitly. + +\stopsection + +\stopchapter + +\stopcomponent + +% \starttext + +% \def\TestA {\registerparwrapper {A} {[\ignorespaces}{\removeunwantedspaces]\showparwrapperstate{A}}} +% \def\TestB#1{\registerparwrapper {B#1}{(\ignorespaces}{\removeunwantedspaces)\showparwrapperstate{B#1}}} +% \def\TestC {\registerparwrapper {C} {<\ignorespaces}{\removeunwantedspaces>\showparwrapperstate{C}\forgetparwrapper}} +% \def\TestR {\registerparwrapperreverse{R} {<\ignorespaces}{\removeunwantedspaces>\showparwrapperstate{R}}} + +% \start +% \TestA +% \dorecurse{3}{1.#1 before \ruledvbox{\hsize2em\raggedcenter\TestB1 !\par} after\par} \blank +% \dorecurse{3}{2.#1 before \ruledvbox{\hsize3em\raggedcenter !\par} after\par} \blank +% \dorecurse{3}{3.#1 before \ruledvbox{\hsize4em\raggedcenter\TestB2 !} after\par} \blank +% \forgetparwrapper +% \dorecurse{3}{4.#1 before \ruledvbox{\hsize5em\raggedcenter\TestB3 !} after\par} \blank +% \TestC +% \dorecurse{3}{5.#1 before \ruledvbox{\hsize2em\raggedcenter\TestA !} after\par} \blank +% \stop + + +% \start +% \TestA +% \dorecurse{3}{6.#1 before after\par} \blank +% \TestB4 +% \dorecurse{3}{7.#1 before after\par} \blank +% \TestB5 +% \TestR +% \dorecurse{3}{8.#1 before after\par} \blank +% \stop + +% \stoptext diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-parameters.tex b/doc/context/sources/general/manuals/evenmore/evenmore-parameters.tex index b07378fae..c20b7bb2a 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-parameters.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-parameters.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore % This feature was done mid May 2020 with Alien Chatter (I really need to find the % original cd's) in the background. diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-parsing.tex b/doc/context/sources/general/manuals/evenmore/evenmore-parsing.tex index d0cc29db1..caed45846 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-parsing.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-parsing.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \environment evenmore-style diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-pi.tex b/doc/context/sources/general/manuals/evenmore/evenmore-pi.tex index 197e86826..7a2dd9bf7 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-pi.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-pi.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \environment evenmore-style diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-style.tex b/doc/context/sources/general/manuals/evenmore/evenmore-style.tex index 07168e57c..0a01679b1 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-style.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-style.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/evenmore + % \enablelmtx % \nopdfcompression diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-threesix.tex b/doc/context/sources/general/manuals/evenmore/evenmore-threesix.tex index d75f9b683..0c0c503ad 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-threesix.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-threesix.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \environment evenmore-style diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-titlepage.tex b/doc/context/sources/general/manuals/evenmore/evenmore-titlepage.tex index 57418800c..44ca10512 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-titlepage.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-titlepage.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/evenmore + \startcomponent evenmore-titlepage \environment evenmore-style diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-tokens.tex b/doc/context/sources/general/manuals/evenmore/evenmore-tokens.tex index 8c1e3ccb0..c30959488 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-tokens.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-tokens.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore % TODO: copy_node_list : return tail % TODO: grabnested diff --git a/doc/context/sources/general/manuals/evenmore/evenmore-whattex.tex b/doc/context/sources/general/manuals/evenmore/evenmore-whattex.tex index 10d3e49f2..0c208839d 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore-whattex.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore-whattex.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/evenmore \startcomponent evenmore-whattex diff --git a/doc/context/sources/general/manuals/evenmore/evenmore.tex b/doc/context/sources/general/manuals/evenmore/evenmore.tex index b351e8c68..f8037b682 100644 --- a/doc/context/sources/general/manuals/evenmore/evenmore.tex +++ b/doc/context/sources/general/manuals/evenmore/evenmore.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/evenmore + \environment evenmore-style \dontcomplain @@ -25,19 +27,13 @@ \component evenmore-parsing \component evenmore-tokens \component evenmore-keywords - - \startchapter[title=Paragraphs] {\em This chapter is not yet public.} \stopchapter - \startchapter[title=Hyphenation] {\em This chapter is not yet public.} \stopchapter - \startchapter[title=Bitwise] {\em This chapter is not yet public.} \stopchapter - \startchapter[title=Offloading] {\em This chapter is not yet public.} \stopchapter - \startchapter[title=Inserts] {\em This chapter is not yet public.} \stopchapter - - % \component evenmore-paragraphs - % \component evenmore-hyphenation - % \component evenmore-bitwise - % \component evenmore-offloading - % \component evenmore-inserts - + \component evenmore-paragraphs + \component evenmore-hyphenation + \component evenmore-bitwise + \component evenmore-offloading + \component evenmore-inserts + \component evenmore-formats + \component evenmore-expressions \stopbodymatter \stopdocument diff --git a/doc/context/sources/general/manuals/followingup/followingup.tex b/doc/context/sources/general/manuals/followingup/followingup.tex index 353b3ddd8..069cfa4eb 100644 --- a/doc/context/sources/general/manuals/followingup/followingup.tex +++ b/doc/context/sources/general/manuals/followingup/followingup.tex @@ -34,8 +34,6 @@ \component followingup-retrospect \component followingup-fonts \component followingup-memory - \component followingup-expressions - \component followingup-formats \stopbodymatter \stopdocument diff --git a/doc/context/sources/general/manuals/graphics/graphics.tex b/doc/context/sources/general/manuals/graphics/graphics.tex index 7c1000c4e..97785c170 100644 --- a/doc/context/sources/general/manuals/graphics/graphics.tex +++ b/doc/context/sources/general/manuals/graphics/graphics.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/graphics \usemodule[article-basic] \usemodule[abbreviations-smallcaps] diff --git a/doc/context/sources/general/manuals/lowlevel/lowlevel-boxes.tex b/doc/context/sources/general/manuals/lowlevel/lowlevel-boxes.tex index cf8b1a51f..8fbd796b4 100644 --- a/doc/context/sources/general/manuals/lowlevel/lowlevel-boxes.tex +++ b/doc/context/sources/general/manuals/lowlevel/lowlevel-boxes.tex @@ -694,3 +694,17 @@ test\quad \stopsection \stopdocument + +% todo: + +% \setbox0\hbox{\strut this is just a\footnote{oeps} test} +% \setbox2\hbox{\strut this is just a\footnote{oeps} test} +% +% \setprelistbox 0\hbox{\strut \quad before: \prelistbox0} +% \setpostlistbox0\hbox{\strut \quad after: \postlistbox0} +% +% \setprelistbox 2\hbox{\strut \quad before} +% \setpostlistbox2\hbox{\strut \quad after} +% +% test \par \box0 \par \box2 \par test + diff --git a/doc/context/sources/general/manuals/lowlevel/lowlevel-paragraphs.tex b/doc/context/sources/general/manuals/lowlevel/lowlevel-paragraphs.tex index 14c2e22a4..1c0264630 100644 --- a/doc/context/sources/general/manuals/lowlevel/lowlevel-paragraphs.tex +++ b/doc/context/sources/general/manuals/lowlevel/lowlevel-paragraphs.tex @@ -992,12 +992,46 @@ examples are visualized in \in {figure} [fig:flow]. \stopsection +\startsection[title=Dirty tricks] + +{\em todo: explain example for combining paragraphs} + +% test\wrapuppar{\crlf\ignorepars} +% +% test +% +% test\wrapuppar{\ignorepars} +% +% test +% +% test\wrapuppar{\removeunwantedspaces\ignorepars} +% +% test + +\stopsection + \stopdocument -\everyhbox \everyvbox : useless unless one resets -\parattr -\snapshotpar -\wrapuppar +% I rewarded myself after writing a section by watching the video "Final Thing On +% My Mind", The Pineapple This, Live, 2020, the usual perfect GH performance, +% wondering if live would turn to normal so that we could go to such concerts once +% again given successive covids. Writing manuals can do with a distraction. +% +% Gavin Harrison: Soundcheck, Drummerworld Jan 27, 2021 ... I wish I could make +% something called a check into pefect solo. Okay, another section and I'll check +% out the latest Simon Phillips and other favourite dummer uploads. + +% todo: + +% \everyhbox \everyvbox : useless unless one resets +% \parattr +% \snapshotpar +% \wrapuppar + +% \normalizelinemode0 +% x\ruledhbox{\parindent 1cm\indent x \indent x} +% \normalizelinemode \parindentskipnormalizecode +% x\ruledhbox{\parindent 1cm\indent x \indent x} % \starttext % \tracingoutput1 \tracingonline1 @@ -1012,14 +1046,3 @@ examples are visualized in \in {figure} [fig:flow]. % \par[newgraf][16=1,17=1], .... pretolerance 6000, .... % \parfillleftskip - -% I rewarded myself after writing a section by watching the video "Final Thing On -% My Mind", The Pineapple This, Live, 2020, the usual perfect GH performance, -% wondering if live would turn to normal so that we could go to such concerts once -% again given successive covids. Writing manuals can do with a distraction. -% -% Gavin Harrison: Soundcheck, Drummerworld Jan 27, 2021 ... I wish I could make -% something called a check into pefect solo. Okay, another section and I'll check -% out the latest Simon Phillips and other favourite dummer uploads. - - diff --git a/doc/context/sources/general/manuals/lua/lua-mkiv.tex b/doc/context/sources/general/manuals/lua/lua-mkiv.tex index 61d7dddad..2fd7e1573 100644 --- a/doc/context/sources/general/manuals/lua/lua-mkiv.tex +++ b/doc/context/sources/general/manuals/lua/lua-mkiv.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/lua % author : Hans Hagen % copyright : PRAGMA ADE & ConTeXt Development Team diff --git a/doc/context/sources/general/manuals/luametatex/luametatex-enhancements.tex b/doc/context/sources/general/manuals/luametatex/luametatex-enhancements.tex index cdea1c69b..d5b491e81 100644 --- a/doc/context/sources/general/manuals/luametatex/luametatex-enhancements.tex +++ b/doc/context/sources/general/manuals/luametatex/luametatex-enhancements.tex @@ -1929,6 +1929,15 @@ kerns, should be handled in the input or macro package because there is no way w can predict the expected behaviour. In fact, the \lpr {linedir} is just a convenience extra which could also have been implemented using node list parsing. +Directions are complicated by the fact that they often need to work over groups +so a separate grouping related stack is used. A side effect is that there can be +paragraphs with only a local par node followed by direction synchronization +nodes. Paragraphs like that are seen as empty paragraphs and therefore ignored. +Because \type {\noindent} doesn't inject anything but a \type {\indent} injects +an box, paragraphs with only an indent and directions are handles and paragraphs +with content. When indentation is normalized a paragraph with an indentation +skip is seen as content. + \stopsubsection \startsubsection[title={Normalizing lines}] diff --git a/doc/context/sources/general/manuals/luatex/luatex-modifications.tex b/doc/context/sources/general/manuals/luatex/luatex-modifications.tex index 7cb14a18f..98f441c41 100644 --- a/doc/context/sources/general/manuals/luatex/luatex-modifications.tex +++ b/doc/context/sources/general/manuals/luatex/luatex-modifications.tex @@ -509,7 +509,7 @@ opened it up. \startsubsection[title=Changes from anywhere] -The \tyep {\partokenname} and \type {\partokencontext} primitives are taken from +The \type {\partokenname} and \type {\partokencontext} primitives are taken from the \PDFTEX\ change file posted on the implementers list. They are explained in the \PDFTEX\ manual and are classified as \ETEX\ extensions. @@ -1137,6 +1137,14 @@ kerns, should be handled in the input or macro package because there is no way w can predict the expected behaviour. In fact, the \lpr {linedir} is just a convenience extra which could also have been implemented using node list parsing. +Directions are complicated by the fact that they often need to work over groups +so a separate grouping related stack is used. A side effect is that there can be +paragraphs with only a local par node followed by direction synchronization +nodes. Paragraphs like that are seen as empty paragraphs and therefore ignored. +Because \type {\noindent} doesn't inject anything but a \type {\indent} injects +an box, paragraphs with only an indent and directions are handles ad paragraphs +with content. + \stopsubsection \startsubsection[title={Controlling glue with \lpr {breakafterdirmode}}] diff --git a/doc/context/sources/general/manuals/metafun/metafun-backgrounds.tex b/doc/context/sources/general/manuals/metafun/metafun-backgrounds.tex index 200620cae..02d1642ef 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-backgrounds.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-backgrounds.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-backpage.tex b/doc/context/sources/general/manuals/metafun/metafun-backpage.tex index 82931d756..5870bbf45 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-backpage.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-backpage.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-basics.tex b/doc/context/sources/general/manuals/metafun/metafun-basics.tex index 479f39602..5208d3ca0 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-basics.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-basics.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-colofon-paper.tex b/doc/context/sources/general/manuals/metafun/metafun-colofon-paper.tex index 1a611a325..d57e6a203 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-colofon-paper.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-colofon-paper.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-colofon-screen.tex b/doc/context/sources/general/manuals/metafun/metafun-colofon-screen.tex index 590c7725f..5df538d32 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-colofon-screen.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-colofon-screen.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-colofon.tex b/doc/context/sources/general/manuals/metafun/metafun-colofon.tex index b4c162a89..4396508b9 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-colofon.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-colofon.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-contents.tex b/doc/context/sources/general/manuals/metafun/metafun-contents.tex index 0767a0248..6a85aa364 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-contents.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-contents.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-conventions.tex b/doc/context/sources/general/manuals/metafun/metafun-conventions.tex index 6a6072c56..f951537c3 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-conventions.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-conventions.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-debugging.tex b/doc/context/sources/general/manuals/metafun/metafun-debugging.tex index f8957b5d8..383b01a77 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-debugging.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-debugging.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-document.tex b/doc/context/sources/general/manuals/metafun/metafun-document.tex index bb5540850..dc6ccb3aa 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-document.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-document.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-effects.tex b/doc/context/sources/general/manuals/metafun/metafun-effects.tex index 16fb4ef6a..f5b772ec2 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-effects.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-effects.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-embedding.tex b/doc/context/sources/general/manuals/metafun/metafun-embedding.tex index 10383fa3a..017dec2c9 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-embedding.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-embedding.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-environment-layout.tex b/doc/context/sources/general/manuals/metafun/metafun-environment-layout.tex index 8a30aad7c..b41cdf771 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-environment-layout.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-environment-layout.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/metafun + \startenvironment metafun-environment-layout \setupsystem diff --git a/doc/context/sources/general/manuals/metafun/metafun-environment-samples.tex b/doc/context/sources/general/manuals/metafun/metafun-environment-samples.tex index 5991a61d5..e9addbc5d 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-environment-samples.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-environment-samples.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/metafun + \startenvironment metafun-environment-sample \startuseMPgraphic{sample setup} diff --git a/doc/context/sources/general/manuals/metafun/metafun-environment-screen.tex b/doc/context/sources/general/manuals/metafun/metafun-environment-screen.tex index afeea7008..58ea5ccdb 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-environment-screen.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-environment-screen.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-environment.tex b/doc/context/sources/general/manuals/metafun/metafun-environment.tex index 57875008d..ebafc6182 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-environment.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-environment.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-examples.tex b/doc/context/sources/general/manuals/metafun/metafun-examples.tex index 5549a3bdd..3c16f96dd 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-examples.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-examples.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-functions.tex b/doc/context/sources/general/manuals/metafun/metafun-functions.tex index 780127408..4d6c47dde 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-functions.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-functions.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-gadgets.tex b/doc/context/sources/general/manuals/metafun/metafun-gadgets.tex index 014bd66e8..f4e887d0e 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-gadgets.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-gadgets.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-graphics.tex b/doc/context/sources/general/manuals/metafun/metafun-graphics.tex index 79c5df0df..ae2e66071 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-graphics.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-graphics.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-index.tex b/doc/context/sources/general/manuals/metafun/metafun-index.tex index 8be313d85..aab028d05 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-index.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-index.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-introduction.tex b/doc/context/sources/general/manuals/metafun/metafun-introduction.tex index e2c33f6f3..59aaf5fdc 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-introduction.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-introduction.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-layout.tex b/doc/context/sources/general/manuals/metafun/metafun-layout.tex index e81800bb4..91a4a3d71 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-layout.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-layout.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-lua.tex b/doc/context/sources/general/manuals/metafun/metafun-lua.tex index e445cef53..1fa399a74 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-lua.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-lua.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-macros.tex b/doc/context/sources/general/manuals/metafun/metafun-macros.tex index 969e7d1b1..cc9d2f05f 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-macros.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-macros.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-positioning.tex b/doc/context/sources/general/manuals/metafun/metafun-positioning.tex index 5a3b1ece0..81fcd171f 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-positioning.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-positioning.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-reference.tex b/doc/context/sources/general/manuals/metafun/metafun-reference.tex index bc59218b0..5e6b7eb77 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-reference.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-reference.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-sneaky.tex b/doc/context/sources/general/manuals/metafun/metafun-sneaky.tex index 56bf5d4d6..b02ce2dab 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-sneaky.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-sneaky.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-styles.tex b/doc/context/sources/general/manuals/metafun/metafun-styles.tex index 6de9a54da..21fa6009e 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-styles.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-styles.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-syntax.tex b/doc/context/sources/general/manuals/metafun/metafun-syntax.tex index 9407b1dd0..89f474418 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-syntax.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-syntax.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-text-lmtx.tex b/doc/context/sources/general/manuals/metafun/metafun-text-lmtx.tex index abdca3c3a..99f46a45b 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-text-lmtx.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-text-lmtx.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-text.tex b/doc/context/sources/general/manuals/metafun/metafun-text.tex index 8229e35db..2870fbb3b 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-text.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-text.tex @@ -1,4 +1,4 @@ -% engine=luatex language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun-titlepage-paper.tex b/doc/context/sources/general/manuals/metafun/metafun-titlepage-paper.tex index 558e3b798..8b5af6054 100644 --- a/doc/context/sources/general/manuals/metafun/metafun-titlepage-paper.tex +++ b/doc/context/sources/general/manuals/metafun/metafun-titlepage-paper.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/metafun.tex b/doc/context/sources/general/manuals/metafun/metafun.tex index 6739b1ed5..cbbc7e3ed 100644 --- a/doc/context/sources/general/manuals/metafun/metafun.tex +++ b/doc/context/sources/general/manuals/metafun/metafun.tex @@ -1,4 +1,4 @@ -% language=uk macros=mkvi +% language=us runpath=texruns:manuals/metafun macros=mkvi % author : Hans Hagen % copyright : PRAGMA ADE & ConTeXt Development Team diff --git a/doc/context/sources/general/manuals/metafun/mfun-700.tex b/doc/context/sources/general/manuals/metafun/mfun-700.tex index e393a34f3..02b9dadfe 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-700.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-700.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-771.tex b/doc/context/sources/general/manuals/metafun/mfun-771.tex index 460c16f2a..484c5949e 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-771.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-771.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-772.tex b/doc/context/sources/general/manuals/metafun/mfun-772.tex index 99dec1551..66ebaff91 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-772.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-772.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-773.tex b/doc/context/sources/general/manuals/metafun/mfun-773.tex index daefcfe66..f70213184 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-773.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-773.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-774.tex b/doc/context/sources/general/manuals/metafun/mfun-774.tex index 725d1199b..1b52069a8 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-774.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-774.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-775.tex b/doc/context/sources/general/manuals/metafun/mfun-775.tex index e9d2b85a7..23cb3257a 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-775.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-775.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-776.tex b/doc/context/sources/general/manuals/metafun/mfun-776.tex index 82b5c18dd..2591e2117 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-776.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-776.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-800.tex b/doc/context/sources/general/manuals/metafun/mfun-800.tex index aa0c1260f..0678fea70 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-800.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-800.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-900.tex b/doc/context/sources/general/manuals/metafun/mfun-900.tex index c295ec908..6a2e65ffb 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-900.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-900.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-901.tex b/doc/context/sources/general/manuals/metafun/mfun-901.tex index 23adf77b4..635f8c3e5 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-901.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-901.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/metafun/mfun-902.tex b/doc/context/sources/general/manuals/metafun/mfun-902.tex index 7c4fed73e..18d87f4ee 100644 --- a/doc/context/sources/general/manuals/metafun/mfun-902.tex +++ b/doc/context/sources/general/manuals/metafun/mfun-902.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/metafun % % copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa diff --git a/doc/context/sources/general/manuals/notnow/notnow-columns-and-notes.tex b/doc/context/sources/general/manuals/notnow/notnow-columns-and-notes.tex index 336c39480..24290fc20 100644 --- a/doc/context/sources/general/manuals/notnow/notnow-columns-and-notes.tex +++ b/doc/context/sources/general/manuals/notnow/notnow-columns-and-notes.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/notnow + \usemodule[art-01] \starttext diff --git a/doc/context/sources/general/manuals/notnow/notnow-sidefloats.tex b/doc/context/sources/general/manuals/notnow/notnow-sidefloats.tex index c7de6c2c5..3c454d367 100644 --- a/doc/context/sources/general/manuals/notnow/notnow-sidefloats.tex +++ b/doc/context/sources/general/manuals/notnow/notnow-sidefloats.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/notnow + \usemodule[art-01] \definefloat diff --git a/doc/context/sources/general/manuals/notnow/notnow.tex b/doc/context/sources/general/manuals/notnow/notnow.tex index e1768db41..d50c10f10 100644 --- a/doc/context/sources/general/manuals/notnow/notnow.tex +++ b/doc/context/sources/general/manuals/notnow/notnow.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/notnow \usemodule[typesetting] @@ -128,6 +128,26 @@ already complex code more than needed. Also, it will never be perfect anyway. \stopchapter +\startchapter[title=Sidefloats] + +Support for side floats is non|-|trivial and no solution will serve all intended +usage. Over the years we have improved on border cases but it is still not +perfect. For that reason the implementation is (apart from solving bugs, mostly) frozen. +Here is an example of a use case that we ran into. We manipulate the spacing with +an offset parameter. + +\typefile{notnow-sidefloats.tex} + +You can best play with these parameters and see what they do. If you use this +mechanism in a long term project, use a frozen instance of \CONTEXT ! + +\TwoPages{notnow-sidefloats} + +The second pages has preceding and trailing whitespace outside the sidefloat +flow. + +\stopchapter + \startpagemakeup[pagestate=stop,page=left,doublesided=no] \scale[width=\paperwidth,height=\paperheight] \bgroup \bTABLE[strut=no,height=29.7pt,width=21pt,align={lohi,middle},foregroundcolor=white,framecolor=white,background=color] @@ -152,24 +172,4 @@ already complex code more than needed. Also, it will never be perfect anyway. \egroup \stoppagemakeup -\startchapter[title=Sidefloats] - -Support for side floats is non|-|trivial and no solution will serve all intended -usage. Over the years we have improved on border cases but it is still not -perfect. For that reason the implementation is (apart from solving bugs, mostly) frozen. -Here is an example of a use case that we ran into. We manipulate the spacing with -an offset parameter. - -\typefile{notnow-sidefloats.tex} - -You can best play with these parameters and see what they do. If you use this -mechanism in a long term project, use a frozen instance of \CONTEXT ! - -\TwoPages{notnow-sidefloats} - -The second pages has preceding and trailing whitespace outside the sidefloat -flow. - -\stopchapter - \stopdocument diff --git a/doc/context/sources/general/manuals/ontarget/ontarget-contents.tex b/doc/context/sources/general/manuals/ontarget/ontarget-contents.tex new file mode 100644 index 000000000..f0a733b01 --- /dev/null +++ b/doc/context/sources/general/manuals/ontarget/ontarget-contents.tex @@ -0,0 +1,13 @@ +% language=us runpath=texruns:manuals/ontarget + +\startcomponent ontarget-contents + +\environment ontarget-style + +\starttitle[title={Table of contents}] + + \placelist[chapter] + +\stoptitle + +\stopcomponent diff --git a/doc/context/sources/general/manuals/ontarget/ontarget-introduction.tex b/doc/context/sources/general/manuals/ontarget/ontarget-introduction.tex new file mode 100644 index 000000000..f7ac0a19d --- /dev/null +++ b/doc/context/sources/general/manuals/ontarget/ontarget-introduction.tex @@ -0,0 +1,104 @@ +% language=us runpath=texruns:manuals/ontarget + +\startcomponent ontarget-introduction + +\environment ontarget-style + +\startchapter[title={Introduction}] + +This is the seventh wrapup of the \LUATEX\ and \LUAMETATEX\ development cycle. It +is dedicated to all those users who kept up with developments and are always +willing to test the new features. Without them a project like this would not be +possible. + +At the time this introduction is written the \LUAMETATEX\ code base is rather +stable and quite a bit of the \MKIV\ code base has been adapted to new situation. +But, as usual, there are always new possibilities to explore, so I expect that +this document will grow over time as did the others. I'm not going to repeat all +that has been done because that's what the previous episodes are about. + +As the title suggest, we're still on target. When the \LUAMETATEX\ project +started there actually was no deadline formulated so in fact we're always on +target. The core components \TEX, \METAPOST, and \LUA\ are all long term efforts +so we're in no hurry at all. However, this is the year that a fast pace will +become a slow pace with respect to the \LUAMETATEX\ code base. There are still +some things on the agenda but in principle the goals are reached. One problem in +today's code development is that useability and quality seems to relate to the +amount of changes in code. No update can mean old, unusable and uninteresting. +It's probably why some sources get this silly yearly copyright year update. +However, the update cycle of good old \TEX\ has an decade interval by now while +it is still a pretty useable program. It would be nice to end up in such a long +term cycle with \LUAMETATEX: bug fixes only. + +Although \CONTEXT\ has always adapted early to new developments (color, graphics, +\PDF, \METAPOST, \ETEX, \PDFTEX, \LUATEX, \UTF, fonts) the effects on the +\CONTEXT\ code base are mostly hidden for users. There have been some changes +between \MKII\ and \MKIV, simply because there has been a shift from specific +eight bit encodings to \UTF\ and \TYPEONE\ to \OPENTYPE\ fonts. Both had an +impact on important subsystems: input encodings, font definitions and features, +language and script support. On other subsystems the impact was hardly +noticeable, like for instance backend related features (these have always been +kind of abstract). That doesn't mean that these haven't changed deep down, they +definitely have. Some mechanisms became better in \MKIV, simply because less +hackery was needed. My experience is that when users see that it gets better or +easier, they are also willing to adapt the few lines in their document source +that benefit from it. Of course the impact on the \METAPOST\ integration in +\CONTEXT\ had a real large impact, especially in terms of performance. + +The upgrade to \LMTX, the version of \CONTEXT\ for \LUAMETATEX, is even less +visible although already some new mechanisms showed up. This time a couple of +engine specific features have been improved and made more flexible. In fact, the +whole code base of the engine has been overhauled. This happened stepwise because +we had to make sure all things kept working. As a first step code was made +independent of the compilation infrastructure and the dependencies, other than a +very few small ones, have been removed. The result is a rather lean and mean +setup, even when we consider what has been added at the primitive level and +traditional subsystems. A benefit is that in the meantime the \LUAMETATEX\ \LMTX\ +combination outperforms \LUATEX\ with \MKIV, something that was not ensured when +the built|-|in \PDF\ backend was removed and delegated to \LUA. By binding +development closely to \CONTEXT\ we also hope that the code base stays clean of +arbitrary extensions. + +Because in the end, \TEX\ is also a programming language, there have been +extensions that make programming easier. There is already a stable middle layer +of auxiliary macros in \CONTEXT\ that help the user who likes to program but +doesn't like real low level primitives and dirty tricks, but by extending the +primitive repertoire a bit users can now stay closer to the original \TEX\ +concepts. Adding more and more layers of indirectness makes no sense if we can +improve the bottom programming layer. It also makes coding a bit more natural +(the \TEX\ look), apart from offering performance benefits. This is where you can +see differences between the \MKIV\ and \LMTX\ code base which for that reason is +now nearly split completely. The \METAPOST\ subsystem has been extended with +proper scanners so that we can enhance the interfaces in a natural way and as a +result we also have an upgraded code base there. We also moved to \LUA 5.4 and +will keep up as long as compatibility is no issue. Some \LUA\ code is likely to +remain common between \MKIV\ and \LMTX, for instance font handling and helpers +but we'll see where that ends. + +The \LUAMETATEX\ engine provides control over most internals and there are all +kind of new interesting features. Decades of \CONTEXT\ development are behind +that. Also, in the days that there were discussions about extending \TEX, +\CONTEXT\ was not that much of influence and on the road to and from user group +meetings, Taco and I often discussed what we'd like to see added (and some was +actually implemented in \type {eetex} but that only lived on our machines. One +can consider \LUATEX\ to be a follow up on that, and \LUAMETATEX\ in turn follows +up on that project, which we both liked doing a lot. In some way \LUATEX\ lowered +the boundary for implementing some of the more intrusive extensions in +\LUAMETATEX\ and the follow up on \MPLIB. And once you start along that road +small steps become large steps and one can as well be try to be as complete as +possible. We've come a long way but eventually arrived at the destination. +Personally I think we got there by not being in a hurry. + +But even targets that are reached can eventually move, + +\blank[2*big] + +\startlines +Hans Hagen +Hasselt NL +August 2021\high{++} +\stoplines + +\stopchapter + +\stopcomponent diff --git a/doc/context/sources/general/manuals/ontarget/ontarget-style.tex b/doc/context/sources/general/manuals/ontarget/ontarget-style.tex new file mode 100644 index 000000000..eac3ffe31 --- /dev/null +++ b/doc/context/sources/general/manuals/ontarget/ontarget-style.tex @@ -0,0 +1,68 @@ +% language=us runpath=texruns:manuals/ontarget + +\startenvironment ontarget-style + +\usemodule[abbreviations-smallcaps] +\usemodule[scite] + +\enableexperiments[fonts.compact] + +\logo [LUAMETATEX] {LuaMeta\TeXsuffix} + +\setupbodyfont[plex,10pt] % not that ok for titling + +\setuplayout + [width=middle, + height=middle, + header=0pt, + footer=1cm, + footerdistance=5mm, + backspace=2cm, + cutspace=15mm, + topspace=2cm, + bottomspace=1cm, + style=bold, + color=maincolor] + +\setuppagenumbering + [alternative=doublesided] + +\setupwhitespace + [big] + +\setupfootertexts + [][{\getmarking[chapter]\quad\pagenumber}] + [{\pagenumber\quad\getmarking[chapter]}][] + +\definecolor + [maincolor] + [darkred] + +\setuphead + [chapter] + [style=\bfc, + color=maincolor] + +\setuphead + [section] + [style=\bfa, + color=maincolor] + +\setuphead + [subsection] + [style=\bf, + color=maincolor] + +\setupalign + [tolerant,stretch] + +\setuptyping + [color=maincolor] + +\setuptype + [color=maincolor] + +\setupitemize + [color=maincolor] + +\stopenvironment diff --git a/doc/context/sources/general/manuals/ontarget/ontarget-titlepage.tex b/doc/context/sources/general/manuals/ontarget/ontarget-titlepage.tex new file mode 100644 index 000000000..516955f7e --- /dev/null +++ b/doc/context/sources/general/manuals/ontarget/ontarget-titlepage.tex @@ -0,0 +1,73 @@ +% language=us runpath=texruns:manuals/ontarget + +\startcomponent ontarget-titlepage + +\environment ontarget-style + +\startMPpage[pagestate=stop] + +StartPage ; + + picture p ; p := image ( + + numeric d ; d := 6.5 ; + + path c ; c := fullcircle scaled 40 shifted (2,7) ; + + path e ; e := + (0,0) -- (3,0) -- + (3,1) -- (1,1) -- + (1,2) -- (3,2) -- + (3,3) -- (1,3) -- + (1,4) -- (3,4) -- + (3,4) -- (3,4) -- + (3,5) -- (0,5) -- cycle ; + + path r ; r := ((0,0) -- (3,0) -- (3,5) -- (0,5)) -- reverse e -- cycle; + + path q ; q := fullsquare xyscaled (3,60) shifted (3/2,0) ; + + fill c withcolor "lightgray" ; + + fill q withpen pencircle scaled 1/5 withcolor "white" ; + + for i=-25 step 5 until 35 : + fill (if (i mod 10) = 0 : e else : r fi) shifted (0,i - d) withcolor "darkred" ; + endfor ; + + draw q withpen pencircle scaled 1/5 withcolor "darkgray" ; + + for i=-25 step 10 until 30 : + draw textext.lft("\tttf " & decimal ((i/10)+21.5)) ysized 3 + shifted (9,19 + i-6.5 - d) withcolor "darkgray" ; + endfor ; + + draw ((-25, 0) -- (25, 0)) shifted center c withpen pencircle scaled 2/10 withcolor "yellow" ; + draw (( 0,-25) -- ( 0,25)) shifted center c withpen pencircle scaled 2/10 withcolor "yellow" ; + + clip currentpicture to c ; + draw c withpen pencircle scaled 4/10 withcolor "yellow" ; + ) ; + + fill Page withcolor "darkred" ; + + p := p shifted - center p ; + + draw p scaled 6mm + shifted center Page + shifted (0mm,50mm) ; + + draw image (draw textext ("\tt\bf on\thinspace target") xsized (16cm) withcolor "yellow") + shifted center bottomboundary Page + shifted (0mm,45mm) ; + + draw image (draw textext ("\tttf luametatex & context lmtx") xsized (13cm) withcolor "yellow") + shifted center bottomboundary Page + shifted (0mm,20mm) ; + +StopPage ; + +\stopMPpage + +\stopcomponent + diff --git a/doc/context/sources/general/manuals/ontarget/ontarget.tex b/doc/context/sources/general/manuals/ontarget/ontarget.tex new file mode 100644 index 000000000..c66318030 --- /dev/null +++ b/doc/context/sources/general/manuals/ontarget/ontarget.tex @@ -0,0 +1,19 @@ +% language=us runpath=texruns:manuals/ontarget + +\environment ontarget-style + +\dontcomplain + +\startdocument + + \component ontarget-titlepage + + \startfrontmatter + \component ontarget-contents + \stopfrontmatter + + \startbodymatter + \component ontarget-introduction + \stopbodymatter + +\stopdocument diff --git a/doc/context/sources/general/manuals/primitives/primitives.tex b/doc/context/sources/general/manuals/primitives/primitives.tex index 30d3815bb..f75736be6 100644 --- a/doc/context/sources/general/manuals/primitives/primitives.tex +++ b/doc/context/sources/general/manuals/primitives/primitives.tex @@ -2583,7 +2583,7 @@ usual (in some cases). Because we mention some \type {def} and \type {let} primitives here, it makes sense to also mention a primitive that will swap two values (meanings). This one has to be used with care. Of course that what gets swapped has to be of the same -type (or at least similar enough to to cause issues). Registers for instance +type (or at least similar enough not to cause issues). Registers for instance store their values in the token, but as soon as we are dealing with token lists we also need to keep an eye on reference counting. So, to some extend this is an experimental feature. diff --git a/doc/context/sources/general/manuals/templates/templates-mkiv.tex b/doc/context/sources/general/manuals/templates/templates-mkiv.tex index e46b1de8a..822954316 100644 --- a/doc/context/sources/general/manuals/templates/templates-mkiv.tex +++ b/doc/context/sources/general/manuals/templates/templates-mkiv.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/templates % author : Hans Hagen % copyright : PRAGMA ADE & ConTeXt Development Team @@ -66,8 +66,8 @@ for j=1 upto m : fill unitsquare - xysized (w,h) - shifted ((i-1)*w,(j-1)*h) + xysized (w+1/5,h+1/5) % a little overlap to get rid of viewer inaccuracies + shifted ((i-1)*w-1/10,(j-1)*h-1/10) withcolor (.5[red,blue] randomized(.75,.75,.75)) ; endfor ; diff --git a/doc/context/sources/general/manuals/units/units-mkiv.tex b/doc/context/sources/general/manuals/units/units-mkiv.tex index 66338497a..34da0e123 100644 --- a/doc/context/sources/general/manuals/units/units-mkiv.tex +++ b/doc/context/sources/general/manuals/units/units-mkiv.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/units % author : Hans Hagen % copyright : PRAGMA ADE & ConTeXt Development Team diff --git a/doc/context/sources/general/manuals/workflows/workflows-contents.tex b/doc/context/sources/general/manuals/workflows/workflows-contents.tex index a32f4737d..0e3c18a38 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-contents.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-contents.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-graphics.tex b/doc/context/sources/general/manuals/workflows/workflows-graphics.tex index 2cff143f4..a24d293df 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-graphics.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-graphics.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-injectors.tex b/doc/context/sources/general/manuals/workflows/workflows-injectors.tex index 5bd9bf057..4b784f7cf 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-injectors.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-injectors.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-introduction.tex b/doc/context/sources/general/manuals/workflows/workflows-introduction.tex index a88640b27..a2d7c0cc0 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-introduction.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-introduction.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex b/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex index dffc7d65c..6b8b172b0 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/workflows + % author : Hans Hagen % copyright : PRAGMA ADE & ConTeXt Development Team % license : Creative Commons Attribution ShareAlike 4.0 International diff --git a/doc/context/sources/general/manuals/workflows/workflows-parallel.tex b/doc/context/sources/general/manuals/workflows/workflows-parallel.tex index 632d2e3e6..a82028de6 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-parallel.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-parallel.tex @@ -1,4 +1,4 @@ -% language=us +% language=us runpath=texruns:manuals/workflows \startcomponent workflows-parallel diff --git a/doc/context/sources/general/manuals/workflows/workflows-resources.tex b/doc/context/sources/general/manuals/workflows/workflows-resources.tex index cbed64864..41de6dc35 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-resources.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-resources.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-running.tex b/doc/context/sources/general/manuals/workflows/workflows-running.tex index 6d3e9f5c4..710714920 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-running.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-running.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-setups.tex b/doc/context/sources/general/manuals/workflows/workflows-setups.tex index e9d120f7b..9ecc46354 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-setups.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-setups.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-style.tex b/doc/context/sources/general/manuals/workflows/workflows-style.tex index f29129fcd..364755443 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-style.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-style.tex @@ -1,3 +1,5 @@ +% language=us runpath=texruns:manuals/workflows + \startenvironment workflows-style \usemodule diff --git a/doc/context/sources/general/manuals/workflows/workflows-suspects.tex b/doc/context/sources/general/manuals/workflows/workflows-suspects.tex index 621fd6f59..d2054bd1f 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-suspects.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-suspects.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-synctex.tex b/doc/context/sources/general/manuals/workflows/workflows-synctex.tex index 8f1fac632..bb2128da4 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-synctex.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-synctex.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-titlepage.tex b/doc/context/sources/general/manuals/workflows/workflows-titlepage.tex index f184152b3..00071a5eb 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-titlepage.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-titlepage.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/workflows/workflows-xml.tex b/doc/context/sources/general/manuals/workflows/workflows-xml.tex index 0f29f5f55..93b03bb7b 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-xml.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-xml.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/workflows \environment workflows-style diff --git a/doc/context/sources/general/manuals/xtables/xtables-mkiv.tex b/doc/context/sources/general/manuals/xtables/xtables-mkiv.tex index d79c14ace..f5a477372 100644 --- a/doc/context/sources/general/manuals/xtables/xtables-mkiv.tex +++ b/doc/context/sources/general/manuals/xtables/xtables-mkiv.tex @@ -1,4 +1,4 @@ -% language=uk +% language=us runpath=texruns:manuals/xtables % author : Hans Hagen % copyright : PRAGMA ADE & ConTeXt Development Team @@ -131,7 +131,7 @@ pages. \startxcell[settings] ... \stopxcell \stopxcellgroup \stopxrow - \startxrowgroup + \stopxrowgroup \stopxtablehead|next|body|foot \stopxtable \stoptyping @@ -954,7 +954,7 @@ The setups themselves are rather simple as we don't capture any attributes. We now process the example. Of course it will also work for files. \startbuffer - \xmlprocessbuffer{main}{test}{} +\xmlprocessbuffer{main}{test}{} \stopbuffer \typebuffer @@ -990,7 +990,6 @@ After that: \eTR \eTABLE \stopbuffer -\stopbuffer \typebuffer @@ -1614,6 +1613,8 @@ in the distribution. \typebuffer \getbuffer +\stopsection + \page % \ruledhbox{\getbuffer[normal,demo]} |