2023-04-01 09:31:00

8 files changed, 90 insertions, 8 deletions

diff --git a/doc/context/scripts/mkiv/mtx-pdf.html b/doc/context/scripts/mkiv/mtx-pdf.html
index 2932b942c..52c6b5608 100644
--- a/doc/context/scripts/mkiv/mtx-pdf.html
+++ b/doc/context/scripts/mkiv/mtx-pdf.html
@@ -44,6 +44,7 @@
         <tr><th>--pretty</th><td></td><td>replace newlines in metadata</td></tr>
         <tr><th>--fonts</th><td></td><td>show used fonts (--detail)</td></tr>
         <tr><th>--object</th><td></td><td>show object"/></td></tr>
+        <tr><th>--linkjs</th><td></td><td>show links"/></td></tr>
         <tr><th/><td/><td/></tr>
     </table>
 <br/>
diff --git a/doc/context/scripts/mkiv/mtx-pdf.man b/doc/context/scripts/mkiv/mtx-pdf.man
index 54fdb6d14..a8fbade52 100644
--- a/doc/context/scripts/mkiv/mtx-pdf.man
+++ b/doc/context/scripts/mkiv/mtx-pdf.man
@@ -25,6 +25,9 @@ show used fonts (--detail)
 .TP
 .B --object
 show object"/>
+.TP
+.B --linkjs
+show links"/>
 .SH AUTHOR
 More information about ConTeXt and the tools that come with it can be found at:
 
diff --git a/doc/context/scripts/mkiv/mtx-pdf.xml b/doc/context/scripts/mkiv/mtx-pdf.xml
index 08b04d85e..c4779d876 100644
--- a/doc/context/scripts/mkiv/mtx-pdf.xml
+++ b/doc/context/scripts/mkiv/mtx-pdf.xml
@@ -13,6 +13,7 @@
     <flag name="pretty"><short>replace newlines in metadata</short></flag>
     <flag name="fonts"><short>show used fonts (<ref name="detail)"/></short></flag>
     <flag name="object"><short>show object"/></short></flag>
+    <flag name="linkjs"><short>show links"/></short></flag>
    </subcategory>
    <subcategory>
     <example><command>mtxrun --script pdf --info foo.pdf</command></example>
diff --git a/doc/context/sources/general/manuals/luametatex/luametatex-introduction.tex b/doc/context/sources/general/manuals/luametatex/luametatex-introduction.tex
index 08b7d94bc..142f18c32 100644
--- a/doc/context/sources/general/manuals/luametatex/luametatex-introduction.tex
+++ b/doc/context/sources/general/manuals/luametatex/luametatex-introduction.tex
@@ -130,7 +130,7 @@ Hans Hagen
 \NC \LUAMETATEX\ Version  \EQ \currentdate \NC \NR
 \NC \CONTEXT\    Version  \EQ LMTX \contextversion \NC \NR
 \NC \LUATEX\     Team     \EQ Hans Hagen, Hartmut Henkel, Taco Hoekwater, Luigi Scarso \NC \NR
-\NC \LUAMETATEX\ Team     \EQ Hans Hagen, Alan Braslau, Mojca Miklavec and Wolfgang Schuster, Mikael Sundqvist \NC \NR
+\NC \LUAMETATEX\ Team     \EQ Hans Hagen, Alan Braslau, Mojca Miklavec, Wolfgang Schuster and Mikael Sundqvist \NC \NR
 \NC resources and info at \EQ www.contextgarden.net\space\vl\space
                               www.pragma-ade.nl\space\vl\space
                               www.luametatex.org\space\vl\space
diff --git a/doc/context/sources/general/manuals/luametatex/luametatex-nodes.tex b/doc/context/sources/general/manuals/luametatex/luametatex-nodes.tex
index c3ac0a294..bccb899c0 100644
--- a/doc/context/sources/general/manuals/luametatex/luametatex-nodes.tex
+++ b/doc/context/sources/general/manuals/luametatex/luametatex-nodes.tex
@@ -1381,14 +1381,14 @@ The \type {traversechar} iterator loops over the \nod {glyph} nodes in a list.
 Only nodes with a subtype less than 256 are seen.
 
 \startfunctioncall
-<direct> n, font, char = node.direct.traversechar(<direct> n)
+<direct> n, char, font = node.direct.traversechar(<direct> n)
 \stopfunctioncall
 
 The \type{traverseglyph} iterator loops over a list and returns the list and
 filters all glyphs:
 
 \startfunctioncall
-<direct> n, font, char = node.traverseglyph(<direct> n)
+<direct> n, char, font = node.traverseglyph(<direct> n)
 \stopfunctioncall
 
 These functions are only available for direct nodes.
diff --git a/doc/context/sources/general/manuals/luametatex/luametatex-pdf.tex b/doc/context/sources/general/manuals/luametatex/luametatex-pdf.tex
index 1394df9f5..b08433b29 100644
--- a/doc/context/sources/general/manuals/luametatex/luametatex-pdf.tex
+++ b/doc/context/sources/general/manuals/luametatex/luametatex-pdf.tex
@@ -83,12 +83,12 @@ pdfe.getstatus(<pdfe document>)
 The returned codes are:
 
 \starttabulate[|c|l|]
-\DB value       \BC explanation \NC \NR
+\DB value      \BC explanation \NC \NR
 \TB
-\NC \type {-2}  \NC the document failed to open \NC \NR
-\NC \type {-1}  \NC the document is (still) protected \NC \NR
-\NC \type {0}   \NC the document is not encrypted \NC \NR
-\NC \type {2}   \NC the document has been unencrypted \NC \NR
+\NC \type {-2} \NC the document is (still) protected \NC \NR
+\NC \type {-1} \NC the document failed to open \NC \NR
+\NC \type  {0} \NC the document is not encrypted \NC \NR
+\NC \type  {1} \NC the document has been unencrypted \NC \NR
 \LL
 \stoptabulate
 
diff --git a/doc/context/sources/general/manuals/musings/musings-hownotto.tex b/doc/context/sources/general/manuals/musings/musings-hownotto.tex
new file mode 100644
index 000000000..48e9adcf3
--- /dev/null
+++ b/doc/context/sources/general/manuals/musings/musings-hownotto.tex
@@ -0,0 +1,76 @@
+% language=us runpath=texruns:manuals/musings
+
+\startcomponent musings-hownotto
+
+\environment musings-style
+
+\startchapter[title={How not to install \CONTEXT}]
+
+\startalign[flushleft]
+
+Installing LuaMetaTeX can be a complex process that requires some technical
+expertise, but the following steps should give you a general idea of what is
+involved:
+
+\startitemize[n]
+
+\startitem
+    First, you need to ensure that you have a recent version of the Lua
+    programming language installed on your system. You can download the latest
+    version of Lua from the official website at http://www.lua.org/download.html.
+    \footnote {The \LUA\ code needed is part of the source tree that can be
+    downloaded from GitHub or websites.}
+\stopitem
+
+\startitem
+    Next, you need to download the latest version of the MetaTeX distribution,
+    which includes the LuaMetaTeX engine, from the official ConTeXt Garden
+    website at https://wiki.contextgarden.net/ConTeXt_Standalone. \footnote
+    {There is no \METATEX, although we sometimes joke about it.}
+\stopitem
+
+\startitem
+    Once you have downloaded the MetaTeX distribution, extract the files to a
+    directory on your system. \footnote {So here one is stuck.}
+\stopitem
+
+\startitem
+    You can then run the LuaMetaTeX engine by opening a command prompt or
+    terminal window and navigating to the directory where you extracted the
+    MetaTeX files. From there, you can run the command "luametatex" followed by
+    the name of the TeX file you want to process. \footnote {Shouldn't it be
+    compiled first? And even then it needs some format, so one needs \type
+    {context} and \type {mtxrun}.}
+\stopitem
+
+\startitem
+    To make it easier to use LuaMetaTeX with your favorite text editor, you may
+    also want to install a TeX distribution such as TeX Live or MiKTeX, which
+    includes support for LuaMetaTeX. These distributions typically include a
+    graphical user interface that makes it easier to manage your TeX installation
+    and configure your system for use with LuaMetaTeX. \footnote {Indeed
+    installing \TEXLIVE\ is easier, as is installing the smaller reference
+    installation which uses \LUAMETATEX\ as its own installer. As far as we know,
+    \MIKTEX\ doesn't include \LMTX. And yes, consulting the documentation might
+    be best.}
+\stopitem
+
+\stopitemize
+
+It's worth noting that the exact steps for installing LuaMetaTeX may vary
+depending on your operating system and the specific TeX distribution you are
+using. For more detailed instructions, you may want to consult the official
+documentation for LuaMetaTeX and the TeX distribution you are using. \footnote
+{So here is the way out of the proposed mess.}
+
+\start \blank
+\bf by ChatGPT
+\footnote {Queried by Mikael Sundqvist.}
+\footnote {Which (at least here) is more about well formed sentences than about
+verified content. We can only hope that new \TEX\ users are able to recognize
+a fake.}
+\stop
+
+\stopalign
+
+\stoptext
diff --git a/doc/context/sources/general/manuals/musings/musings.tex b/doc/context/sources/general/manuals/musings/musings.tex
index bccab890a..2d0e7c094 100644
--- a/doc/context/sources/general/manuals/musings/musings.tex
+++ b/doc/context/sources/general/manuals/musings/musings.tex
@@ -29,6 +29,7 @@
     \component musings-dontusetex
     \component musings-speed
     \component musings-texlive
+    \component musings-hownotto
 \stopbodymatter
 
 \stopproduct