Hi,

I discovered the manuals in the context distribution. My general way to
built the manuals were these steps:
```
# execute one time
git clone https://github.com/contextgarden/context.git
cd context/doc/context/sources/general/manuals/

# for every manual
cd $MANUALFOLDER
context $MAIN_MANUAL_FILE.tex
```
Is there a way to speed this up, so to build all manuals with one
command (some make file or shell script for example)?

I saw some problems within the manuals:
- In units/units-mkiv.tex the spacing seems not to work with current
  LMTX. See the attached screenshot (units-mkiv.png) for my rendering.
  In my understanding the spaces should differ.
- I changed some typos(?) and other stuff in that file. The patch is
  attached (0001-units-mkiv-improve.patch).
- math/math-mkiv.tex seems not to compile. The last lines of the log:
        system          >
        system          > ConTeXt  ver: 2024.01.08 11:23 LMTX  fmt: 2024.1.16  
int: english/english
        system          >
        system          > 'cont-new.mkxl' loaded
        open source     > level 1, order 1, name 
'/home/gerion/context/tex/texmf-context/tex/context/base/mkxl/cont-new.mkxl'
        system          > beware: some patches loaded from cont-new.mkiv
        close source    > level 1, order 1, name 
'/home/gerion/context/tex/texmf-context/tex/context/base/mkxl/cont-new.mkxl'
        system          > jobfiles > using path: 
/home/gerion/src/context/doc/context/sources/general/manuals/math
        system          > files > jobname 
'./math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0', input 
'./math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0.tmp', result 
'./math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0'
        fonts           > latin modern fonts are not preloaded
        languages       > language 'en' is active
        open source     > level 1, order 2, name 
'./math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0.tmp'
        fonts           > preloading latin modern fonts (second stage)
        fonts           > 'fallback modern rm 12pt' is loaded
        visualize       > enabled
        open source     > level 2, order 3, name 'math-spacing-001.tex'
        close source    > level 2, order 3, name 'math-spacing-001.tex'
        pages           > flushing realpage 1, userpage 1, subpage 1
        close source    > level 1, order 3, name 
'./math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0.tmp'
        backend         > xmp > using file 
'/home/gerion/context/tex/texmf-context/tex/context/base/mkiv/lpdf-pdx.xml'
        mkiv lua stats  > used config file: 
selfautoparent:/texmf/web2c/texmfcnf.lua
        mkiv lua stats  > used cache path: 
/home/gerion/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e
        mkiv lua stats  > resource resolver: loadtime 0.003 seconds, 0 scans 
with scantime 0.000 seconds, 0 shared scans, 15 found files, scanned paths: 
<none>
        mkiv lua stats  > stored bytecode data: 515 modules (0.131 sec), 105 
tables (0.007 sec), 620 chunks (0.139 sec)
        mkiv lua stats  > traced context: maxstack: 1743, freed: 0, 
unreachable: 1743
        mkiv lua stats  > cleaned up reserved nodes: 103 nodes, 7 lists of 437
        mkiv lua stats  > node memory usage: 6649 attribute, 1 glue, 144 
gluespec, 4868 glyph, 1220 hlist, 1 kern, 645 mathspec, 2 penalty, 616 rule, 2 
temp, 7 whatsit
        mkiv lua stats  > node list callback tasks: 16 unique task lists, 12 
instances (re)created, 235 calls
        mkiv lua stats  > driver time: 0.021 seconds
        mkiv lua stats  > used backend: pdf
        mkiv lua stats  > jobdata time: 0.000 seconds saving, 0.000 seconds 
loading
        mkiv lua stats  > callbacks: file: 137, saved: 1212, direct: 2, 
function: 814, value: 429, message: 0, bytecode: 620, late 0, total: 3214 (3214 
per page)
        mkiv lua stats  > randomizer: resumed with value 0.82928645897044
        mkiv lua stats  > loaded patterns: en::1, load time: 0.000
        mkiv lua stats  > loaded fonts: 4 files: latinmodernmath-companion.otf, 
latinmodern-math.otf, lmmonoltcond10-regular.otf, lmroman10-regular.otf
        mkiv lua stats  > font engine: otf 3.135, afm 1.513, tfm 1.000, 27 
instances, 21 shared in backend, 4 common vectors, 17 common hashes, load time 
0.299 seconds
        mkiv lua stats  > visualization time: 0.005 seconds
        mkiv lua stats  > math tweaking time: 0.145 seconds, 24 math goodie 
tables
        mkiv lua stats  > page group warning: transparencies are used but no 
pagecolormodel is set
        mkiv lua stats  > font embedding time: 0.003 seconds, 3 fonts
        mkiv lua stats  > result saved in file: 
math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0.pdf, compresslevel 1, 
objectcompresslevel 3, 14 streams, 0 uncompressed, 9 compressed, 5 not 
compressed, threshold 40
        mkiv lua stats  > positions: 4 collected, 0 deltas, 0 shared partials, 
0 partial entries
        mkiv lua stats  > used platform: linux-64, type: unix, binary subtree: 
texmf-linux-64
        mkiv lua stats  > used engine: luametatex version: 2.10.11, 
functionality level: 20231231, format id: 698, compiler: gcc
        mkiv lua stats  > tex properties: 807097 hash slots used of 2097152, 
50666 control sequences, approximate memory usage: 49 MB
        mkiv lua stats  > lua properties: engine: lua 5.4, used memory: 84 MB, 
ctx: 80 MB, max: 80 MB, symbol mask: utf (τεχ)
        mkiv lua stats  > runtime: 0.528 seconds, 1 processed pages, 1 shipped 
pages, 1.895 pages/second
        mtx-context     | purged files: 
math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0.log, 
math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0.tmp, 
math-mkiv-t-b-ce3b35636ef01ee62897a2beb76049e0.tuc
        system          | total runtime: 1.044 seconds of 1.071 seconds

        buffers         > typeset > no changes in 'demo-4', processing skipped
        floatblocks     > '3' limited
        floatblocks     > 3 saved
        pages           > flushing realpage 14, userpage 12, subpage 14
        floatblocks     > 1 moved
        floatblocks     > 2 moved
        floatblocks     > 3 moved
        pages           > flushing realpage 15, userpage 13, subpage 15
        pages           > flushing realpage 16, userpage 14, subpage 16
        pages           > flushing realpage 17, userpage 15, subpage 17
        pages           > flushing realpage 18, userpage 16, subpage 18
        pages           > flushing realpage 19, userpage 17, subpage 19
        structure       > sectioning > section @ level 3 : 0.3.1 -> Scripts
        tex error       > tex error on line 370 in file 
/home/gerion/src/context/doc/context/sources/general/manuals/math/math-spacing.tex:
 Math error: parameter 'subshiftdown' with id 49 in style 2 is not set

        <macro> \math_m_nop
            #1->\relax \ifmmode #1\else \normalstartimath 
\usemathstyleparameter \mathematicsparameter \c!mathstyle \expand 
\everyinsidemathematics \relax \begingroup #1\endgroup \normalstopimath
            \fi
        <line 6.370>
                    {\switchtobodyfont [cambria]\math{F_j = \int\nolimits _a^b}
            } {Cambria}

        360     font can be very detailed in where italic correction is to be 
applied and how
        361     advanced stepwise kerns are used, but not many fonts have 
extensive information.
        362     Here are some differences in rendering. In \OPENTYPE\ the 
super- and subscript of
        363     an integral are moved right and left half of the italic 
correction.
        364
        365     \startlinecorrection
        366         \startcombination[6*1]
        367             {\switchtobodyfont  [modern]\math{F_j = \int\nolimits 
_a^b}} {Latin Modern}
        368             {\switchtobodyfont [pagella]\math{F_j = \int\nolimits 
_a^b}} {Pagella}
        369             {\switchtobodyfont  [dejavu]\math{F_j = \int\nolimits 
_a^b}} {Dejavu}
        370 >>          {\switchtobodyfont [cambria]\math{F_j = \int\nolimits 
_a^b}} {Cambria}
        371             {\switchtobodyfont[lucidaot]\math{F_j = \int\nolimits 
_a^b}} {Lucida OT}
        372             {\switchtobodyfont    [xits]\math{F_j = \int\nolimits 
_a^b}} {Xits}
        373         \stopcombination
        374     \stoplinecorrection
        375
        376     \stopsection
        377
        378     \startsection[title=Bad fonts]
        379
        380     There might be fonts out there where the italic correction is 
supposed to be
        Sorry, but I can't typeset math unless various parameters have been 
set. This is
        normally done by loading special math fonts into the math family slots. 
Your font
        set is lacking at least the parameter mentioned earlier.
        mtx-context     | fatal error: return code: 1
- I tried to find a prebuild version and found 
https://mirror.contextgarden.net/general/manuals/math-mkiv.pdf.
  However, this document seems to be from 2021 and has a kind of wobbly
  rendering in Okular/Poppler (I remember the same phenomena with early
  LMTX). See the screenshot attached (math-mkiv-online.png). Is there a
  newer version somewhere? Maybe it is meaningful to delete the old
  version.


Best
Gerion
From 187f2bf0901d414bf55869054d29ee2c4bec1a64 Mon Sep 17 00:00:00 2001
From: Gerion Entrup <gerion.ent...@flump.de>
Date: Tue, 16 Jan 2024 23:40:40 +0100
Subject: [PATCH] units-mkiv: improve

- typos
- remove getbuffer without context
- demonstrate usage of pm and to
---
 doc/context/sources/general/manuals/units/units-mkiv.tex | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/doc/context/sources/general/manuals/units/units-mkiv.tex b/doc/context/sources/general/manuals/units/units-mkiv.tex
index d70c7221f..a1631aadb 100644
--- a/doc/context/sources/general/manuals/units/units-mkiv.tex
+++ b/doc/context/sources/general/manuals/units/units-mkiv.tex
@@ -347,12 +347,10 @@ we give an example below.
 \stoptabulate
 
 The \type {_} character serves as placeholders. There are some
-assumptions to how numbers are constructed. In principe the input
+assumptions to how numbers are constructed. In principal, the input
 assumes a comma to separate thousands and a period to separate the
 fraction.
 
-\getbuffer
-
 You can swap periods and commas in the output. In fact there are a
 few methods available. For instance we can separate the thousands
 with a small space instead of a symbol.
@@ -516,8 +514,8 @@ Here are some goodies:
 \type{1 } : \unit  {30^2            meter per second}
 \type{2a} : \unit  {30    ± 10      meter per second}
 \type{2b} : \unit  {30    – 10      meter per second}
-\type{3a} : \unit  {30^2  ± 10^2    meter per second}
-\type{3b} : \unit  {30^2  – 10^2    meter per second}
+\type{3a} : \unit  {30^2  pm 10^2   meter per second}
+\type{3b} : \unit  {30^2  to 10^2   meter per second}
 \type{4 } : \unit  {30   (10)       meter per second}
 \type{5a} : \unit  {30   (± 10)     meter per second}
 \type{5b} : \unit  {30^2 (± 10^2)   meter per second}
-- 
2.41.0

Attachment: signature.asc
Description: This is a digitally signed message part.

___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the 
Wiki!

maillist : ntg-context@ntg.nl / 
https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage  : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive  : https://github.com/contextgarden/context
wiki     : https://wiki.contextgarden.net
___________________________________________________________________________________

Reply via email to