ntg-context - mailing list for ConTeXt users
 help / color / mirror / Atom feed
* [NTG-context] Suggestions and problems of the manuals
@ 2024-01-17 12:44 Gerion Entrup
  2024-01-25  8:24 ` [NTG-context] " Gerion Entrup
  0 siblings, 1 reply; 3+ messages in thread
From: Gerion Entrup @ 2024-01-17 12:44 UTC (permalink / raw)
  To: ntg-context


[-- Attachment #1.1.1: Type: text/plain, Size: 8592 bytes --]

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

[-- Attachment #1.1.2: 0001-units-mkiv-improve.patch --]
[-- Type: text/x-patch, Size: 1873 bytes --]

From 187f2bf0901d414bf55869054d29ee2c4bec1a64 Mon Sep 17 00:00:00 2001
From: Gerion Entrup <gerion.entrup@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 #1.1.3: math-mkiv-online.png --]
[-- Type: image/png, Size: 6708 bytes --]

[-- Attachment #1.1.4: units-mkiv.png --]
[-- Type: image/png, Size: 56012 bytes --]

[-- Attachment #1.2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 659 bytes --]

[-- Attachment #2: Type: text/plain, Size: 511 bytes --]

___________________________________________________________________________________
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
___________________________________________________________________________________

^ permalink raw reply	[flat|nested] 3+ messages in thread

* [NTG-context] Re: Suggestions and problems of the manuals
  2024-01-17 12:44 [NTG-context] Suggestions and problems of the manuals Gerion Entrup
@ 2024-01-25  8:24 ` Gerion Entrup
  2024-01-26 17:47   ` Wolfgang Schuster
  0 siblings, 1 reply; 3+ messages in thread
From: Gerion Entrup @ 2024-01-25  8:24 UTC (permalink / raw)
  To: ntg-context


[-- Attachment #1.1: Type: text/plain, Size: 1869 bytes --]

Am Mittwoch, 17. Januar 2024, 13:44:51 CET schrieb Gerion Entrup:
> 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
> 	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.

It also does not compile with the newest upload:
ConTeXt  ver: 2024.01.24 22:39 LMTX  fmt: 2024.1.25

[-- Attachment #1.2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 659 bytes --]

[-- Attachment #2: Type: text/plain, Size: 511 bytes --]

___________________________________________________________________________________
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
___________________________________________________________________________________

^ permalink raw reply	[flat|nested] 3+ messages in thread

* [NTG-context] Re: Suggestions and problems of the manuals
  2024-01-25  8:24 ` [NTG-context] " Gerion Entrup
@ 2024-01-26 17:47   ` Wolfgang Schuster
  0 siblings, 0 replies; 3+ messages in thread
From: Wolfgang Schuster @ 2024-01-26 17:47 UTC (permalink / raw)
  To: mailing list for ConTeXt users, Gerion Entrup

Gerion Entrup schrieb am 25.01.2024 um 09:24:
> Am Mittwoch, 17. Januar 2024, 13:44:51 CET schrieb Gerion Entrup:
>> 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
>> 	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.
> It also does not compile with the newest upload:
> ConTeXt  ver: 2024.01.24 22:39 LMTX  fmt: 2024.1.25

I found two problematic sections in the document.

1. The section "Choices" (line 694 -- 741) in math-spacing.tex describes 
the removed \setdisplaymathspacemodel command.

2. The section "Script kerning" (line 127 -- 203) in math-features.tex 
descibes the \mathscriptboxmode primitive which was removed in Luametatex.

Wolfgang

___________________________________________________________________________________
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
___________________________________________________________________________________

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2024-01-26 17:50 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-01-17 12:44 [NTG-context] Suggestions and problems of the manuals Gerion Entrup
2024-01-25  8:24 ` [NTG-context] " Gerion Entrup
2024-01-26 17:47   ` Wolfgang Schuster

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).