latex3 / latex3

The expl3 (LaTeX3) Development Repository
https://latex-project.org/latex3.html
LaTeX Project Public License v1.3c
1.87k stars 179 forks source link

l3luatex documentation #1300

Open jlaurens opened 8 months ago

jlaurens commented 8 months ago

The \lua_load_module:n roughly reads "It is not easy to use \lua_now:n so you'd better use \lua_load_module:n". This advice should also be part of the \lua_now:n documentation.

In the introduction, "the “internals” of TEX" do not mean really much than a dark black box to the average user. May be "more control on the material and the typesetting process" is clearer, and makes it more accessible.

The end of the introduction reads "Details on using Lua with the LuaTEX engine are given in the LuaTEX manual.", It may be interpreted by newcomers as a documentation about Lua itself. Something like "See https://www.lua.org for general documentation about Lua and see the LuaTEX manual for details on using Lua with the LuaTEX engine." seems better to me.

jlaurens commented 8 months ago

To be compliant with Lua 5.3

"This is a wrapper around the Lua call require ’⟨module⟩’."

should read

"This is a wrapper around the Lua call require(’⟨module⟩’)."