summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Master/texmf-dist/doc/luatex/lua-widow-control/README.md2
-rw-r--r--Master/texmf-dist/doc/luatex/lua-widow-control/lua-widow-control.pdfbin385495 -> 403738 bytes
-rw-r--r--Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex15
-rw-r--r--Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkiv48
-rw-r--r--Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkxl48
-rw-r--r--Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control-2022-02-22.sty9
-rw-r--r--Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control.sty32
-rw-r--r--Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.lua637
-rw-r--r--Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.tex22
-rw-r--r--Master/texmf-dist/tex/optex/lua-widow-control/lua-widow-control.opm21
10 files changed, 580 insertions, 254 deletions
diff --git a/Master/texmf-dist/doc/luatex/lua-widow-control/README.md b/Master/texmf-dist/doc/luatex/lua-widow-control/README.md
index 77dd7734da0..cc6aed7ba00 100644
--- a/Master/texmf-dist/doc/luatex/lua-widow-control/README.md
+++ b/Master/texmf-dist/doc/luatex/lua-widow-control/README.md
@@ -48,4 +48,4 @@ Lua-widow-control is licensed under the [_Mozilla Public License_, version 2.0](
Please note that a compiled document is absolutely **not** considered to be an "Executable Form" as defined by the MPL. The use of lua-widow-control in a document does not place **any** obligations on the document's author or distributors. The MPL and CC-BY-SA licenses **only** apply to you if you distribute the lua-widow-control source code or documentation.
---
-_v2.0.6 (2022-04-23)_ <!--%%version %%dashdate-->
+_v2.1.0 (2022-05-14)_ <!--%%version %%dashdate-->
diff --git a/Master/texmf-dist/doc/luatex/lua-widow-control/lua-widow-control.pdf b/Master/texmf-dist/doc/luatex/lua-widow-control/lua-widow-control.pdf
index 3ab6e518861..709042c553c 100644
--- a/Master/texmf-dist/doc/luatex/lua-widow-control/lua-widow-control.pdf
+++ b/Master/texmf-dist/doc/luatex/lua-widow-control/lua-widow-control.pdf
Binary files differ
diff --git a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex
index 7f05a344f05..23b13c02506 100644
--- a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex
+++ b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex
@@ -5,7 +5,10 @@
% SPDX-License-Identifier: MPL-2.0+ OR CC-BY-SA-4.0+
% SPDX-FileCopyrightText: 2022 Max Chernoff
-% Warning: Compiles slowly
+\doifnot{\contextmark}{LMTX}{
+ \errhelp{LMTX/MkXL is required to compile this file.}
+ \errmessage{Fatal error, exiting.}
+}
\environment lwc-documentation
@@ -37,7 +40,7 @@
\startdocument[
title=lua-widow-control,
author=Max Chernoff,
- version=2.0.6, %%version
+ version=2.1.0, %%version
github=https://github.com/gucci-on-fleek/lua-widow-control,
ctan=https://www.ctan.org/pkg/lua-widow-control,
]
@@ -316,7 +319,7 @@ Note that the \LaTeX{} option does not \emph{append} commands to the disable lis
\startTABLE
\NC \plainop/
- \NC \inlineTEX{\lwcdisablecmd{$\meta{\backslash macro}$}}
+ \NC \inlineTEX{\lwcdisablecmd $\meta{\backslash macro}$}
\NC\NR
\NC \LaTeX{}
\NC \inlineTEX{\lwcsetup{disablecmds = {$\meta{macronameone}$, $\meta{macronametwo}$}}}
@@ -363,7 +366,7 @@ When \lwc/ encounters an orphan, it removes it by removing the orphaned line to
\startTABLE
\NC \plainop/
- \NC\inlineTEX{\directlua{lwc.nobreak_behaviour = "$\meta{value}$"}}
+ \NC\inlineTEX{\lwcnobreak{$\meta{value}$}}
\NC\NR
\NC \LaTeX{}
\NC\inlineTEX{\lwcsetup{nobreak = $\meta{value}$}}
@@ -409,8 +412,8 @@ Very advanced users may also set a custom cost function by redefining the \inlin
\startTABLE
\NC \plainop/
- \NC\inlineTEX{\directlua{lwc.debug = true}}
- \NC\NR\NC\NC\inlineTEX{\directlua{lwc.debug = false}}
+ \NC\inlineTEX{\lwcdebug 1}
+ \NC\NR\NC\NC\inlineTEX{\lwcdebug 0}
\NC\NR
\NC \LaTeX{}
\NC\inlineTEX{\lwcsetup{debug = true}}
diff --git a/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkiv b/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkiv
index 1e52f8d9012..090ff5aa809 100644
--- a/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkiv
+++ b/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkiv
@@ -1,10 +1,10 @@
%D \module
%D [ file=t-lua-widow-control,
-%D version=2.0.6, %%version
+%D version=2.1.0, %%version
%D title=lua-widow-control,
%D subtitle=\ConTeXt module for lua-widow-control,
%D author=Max Chernoff,
-%D date=2022-04-23, %%dashdate
+%D date=2022-05-14, %%dashdate
%D copyright=Max Chernoff,
%D license=MPL-2.0+,
%D url=https://github.com/gucci-on-fleek/lua-widow-control]
@@ -16,39 +16,36 @@
\installcommandhandler \????lwc {lwc} \????lwc
\newdimen\lwc_emergency_stretch
+\newcount\lwc_max_cost
\appendtoks
\lwc_emergency_stretch=\lwcparameter{emergencystretch}
-\to\everysetuplwc
-\appendtoks
\doifelse{\lwcparameter{\c!state}}\v!start{
- \ctxlua{lwc.enable_callbacks()}
+ \lwc_enable
}{
- \ctxlua{lwc.disable_callbacks()}
+ \lwc_disable
}
-\to\everysetuplwc
-\appendtoks
- \doifelse{\lwcparameter{debug}}\v!start{
- \ctxlua{lwc.debug = true}
- }{
- \ctxlua{lwc.debug = false}
- }
-\to\everysetuplwc
+ \lwc_debug{\lwcparameter{debug}}
-\appendtoks
- \ctxlua{lwc.nobreak_behaviour = "\lwcparameter{nobreak}"}
-\to\everysetuplwc
+ \lwc_nobreak{\lwcparameter{nobreak}}
-\newcount\lwc_max_cost
-\appendtoks
\lwc_max_cost=\lwcparameter{maxcost}
-\to\everysetuplwc
-\appendtoks
% We can't just set the penalties because they will be reset automatically
% at \\starttext.
\startsetups[*default]
+ \directsetup{*reset}
+
+ \clubpenalty=\lwcparameter{orphanpenalty}
+ \widowpenalty=\lwcparameter{widowpenalty}
+ \displaywidowpenalty=\lwcparameter{widowpenalty}
+ \brokenpenalty=\lwcparameter{brokenpenalty}
+ \stopsetups
+
+ \startsetups[grid][*default]
+ \directsetup{*reset}
+
\clubpenalty=\lwcparameter{orphanpenalty}
\widowpenalty=\lwcparameter{widowpenalty}
\displaywidowpenalty=\lwcparameter{widowpenalty}
@@ -58,8 +55,6 @@
\setups[*default]
\to\everysetuplwc
-\define\iflwc{\ctxlua{lwc.if_lwc_enabled()}}
-
\ctxloadluafile{lua-widow-control}
\setuplwc[
@@ -86,14 +81,14 @@
\newcount\lwc_disable_count
\define\lwc_patch_pre{%
- \iflwc%
+ \lwc_if_enabled%
\advance\lwc_disable_count by 1%
\setuplwc[\c!state=\v!stop]%
\fi%
}
\define\lwc_patch_post{
- \ifnum\lwc_disable_count>0%
+ \ifnum\lwc_disable_count>0\relax%
\setuplwc[\c!state=\v!start]%
\advance\lwc_disable_count by -1%
\fi%
@@ -102,5 +97,8 @@
\prependtoks\lwc_patch_pre\to\everybeforesectionheadhandle % Sectioning
\prependtoks\lwc_patch_post\to\everyaftersectionheadhandle
+% Make the commands public
+\let\iflwc=\lwc_if_enabled
+
\protect
\stopmodule
diff --git a/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkxl b/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkxl
index 1e52f8d9012..090ff5aa809 100644
--- a/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkxl
+++ b/Master/texmf-dist/tex/context/third/lua-widow-control/t-lua-widow-control.mkxl
@@ -1,10 +1,10 @@
%D \module
%D [ file=t-lua-widow-control,
-%D version=2.0.6, %%version
+%D version=2.1.0, %%version
%D title=lua-widow-control,
%D subtitle=\ConTeXt module for lua-widow-control,
%D author=Max Chernoff,
-%D date=2022-04-23, %%dashdate
+%D date=2022-05-14, %%dashdate
%D copyright=Max Chernoff,
%D license=MPL-2.0+,
%D url=https://github.com/gucci-on-fleek/lua-widow-control]
@@ -16,39 +16,36 @@
\installcommandhandler \????lwc {lwc} \????lwc
\newdimen\lwc_emergency_stretch
+\newcount\lwc_max_cost
\appendtoks
\lwc_emergency_stretch=\lwcparameter{emergencystretch}
-\to\everysetuplwc
-\appendtoks
\doifelse{\lwcparameter{\c!state}}\v!start{
- \ctxlua{lwc.enable_callbacks()}
+ \lwc_enable
}{
- \ctxlua{lwc.disable_callbacks()}
+ \lwc_disable
}
-\to\everysetuplwc
-\appendtoks
- \doifelse{\lwcparameter{debug}}\v!start{
- \ctxlua{lwc.debug = true}
- }{
- \ctxlua{lwc.debug = false}
- }
-\to\everysetuplwc
+ \lwc_debug{\lwcparameter{debug}}
-\appendtoks
- \ctxlua{lwc.nobreak_behaviour = "\lwcparameter{nobreak}"}
-\to\everysetuplwc
+ \lwc_nobreak{\lwcparameter{nobreak}}
-\newcount\lwc_max_cost
-\appendtoks
\lwc_max_cost=\lwcparameter{maxcost}
-\to\everysetuplwc
-\appendtoks
% We can't just set the penalties because they will be reset automatically
% at \\starttext.
\startsetups[*default]
+ \directsetup{*reset}
+
+ \clubpenalty=\lwcparameter{orphanpenalty}
+ \widowpenalty=\lwcparameter{widowpenalty}
+ \displaywidowpenalty=\lwcparameter{widowpenalty}
+ \brokenpenalty=\lwcparameter{brokenpenalty}
+ \stopsetups
+
+ \startsetups[grid][*default]
+ \directsetup{*reset}
+
\clubpenalty=\lwcparameter{orphanpenalty}
\widowpenalty=\lwcparameter{widowpenalty}
\displaywidowpenalty=\lwcparameter{widowpenalty}
@@ -58,8 +55,6 @@
\setups[*default]
\to\everysetuplwc
-\define\iflwc{\ctxlua{lwc.if_lwc_enabled()}}
-
\ctxloadluafile{lua-widow-control}
\setuplwc[
@@ -86,14 +81,14 @@
\newcount\lwc_disable_count
\define\lwc_patch_pre{%
- \iflwc%
+ \lwc_if_enabled%
\advance\lwc_disable_count by 1%
\setuplwc[\c!state=\v!stop]%
\fi%
}
\define\lwc_patch_post{
- \ifnum\lwc_disable_count>0%
+ \ifnum\lwc_disable_count>0\relax%
\setuplwc[\c!state=\v!start]%
\advance\lwc_disable_count by -1%
\fi%
@@ -102,5 +97,8 @@
\prependtoks\lwc_patch_pre\to\everybeforesectionheadhandle % Sectioning
\prependtoks\lwc_patch_post\to\everyaftersectionheadhandle
+% Make the commands public
+\let\iflwc=\lwc_if_enabled
+
\protect
\stopmodule
diff --git a/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control-2022-02-22.sty b/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control-2022-02-22.sty
index e8b2eefb0a4..d67c68d2fd3 100644
--- a/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control-2022-02-22.sty
+++ b/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control-2022-02-22.sty
@@ -7,6 +7,15 @@
\ProvidesPackage{lua-widow-control}%
[2022/02/22 v1.1.6]
+% The version number above is somewhat-misleading: I will make bugfixes to this file
+% from time to time, but the core of the file will not change. Therefore, we should
+% report a real version number here for debugging.
+\PackageInfo{lua-widow-control}{%
+ Real version:
+ 2022/05/14 %%dashdate
+ v2.1.0 %%version
+}
+
\PackageWarning{lua-widow-control}{%
Old LaTeX format detected!\MessageBreak\MessageBreak
Lua-widow-control prefers a LaTeX format\MessageBreak
diff --git a/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control.sty b/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control.sty
index a44b5af1dab..e7179e6a9e5 100644
--- a/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control.sty
+++ b/Master/texmf-dist/tex/lualatex/lua-widow-control/lua-widow-control.sty
@@ -13,7 +13,7 @@
\DeclareRelease{}{0000-00-00}{lua-widow-control-2022-02-22.sty}
\DeclareRelease{v1.1.6}{2022-02-22}{lua-widow-control-2022-02-22.sty}
-\DeclareCurrentRelease{v2.0.6}{2022-04-23} %%version %%dashdate
+\DeclareCurrentRelease{v2.1.0}{2022-05-14} %%version %%dashdate
% If this version of LaTeX doesn't support command hooks, then we load
% the last v1.1.X version of the package.
@@ -23,8 +23,8 @@
\ProvidesExplPackage
{lua-widow-control}
- {2022/04/23} %%slashdate
- {v2.0.6} %%version
+ {2022/05/14} %%dashdate
+ {v2.1.0} %%version
{Use Lua to remove widows and orphans}
% Unconditional Package Loads
@@ -105,6 +105,7 @@
disablecmds .clist_gset:N = \g__lwc_disablecmds_cl,
disablecmds .value_required:n = false,
disablecmds .initial:n = { \@sect, % LaTeX default
+ \@ssect, % LaTeX starred
\M@sect, % Memoir
\@mem@old@ssect, % Memoir Starred
\ttl@straight@ii, % titlesec normal
@@ -112,11 +113,6 @@
\ttl@part@ii, % titlesec part
},
disablecmds .usage:n = preamble,
-
- nobreak .choice:,
- nobreak / keep .code:n = \lua_now:n { lwc.nobreak_behaviour = "keep" },
- nobreak / split .code:n = \lua_now:n { lwc.nobreak_behaviour = "split" },
- nobreak / warn .code:n = \lua_now:n { lwc.nobreak_behaviour = "warn" },
}
% Load the Lua code
@@ -138,16 +134,10 @@
}
% Core Function Definitions
-\cs_new:Npn \__lwc_enable: {
- \lua_now:n { lwc.enable_callbacks() }
-}
+\cs_new_eq:NN \iflwc \__lwc_iflwc:
-\cs_new:Npn \__lwc_disable: {
- \lua_now:n { lwc.disable_callbacks() }
-}
-
-\prg_set_conditional:Nnn \__lwc_if_enabled: { T, F, TF } {
- \lua_now:n { lwc.if_lwc_enabled() }
+\prg_new_conditional:Nnn \__lwc_if_enabled: { T, F, TF } {
+ \__lwc_if_enabled:
\prg_return_true:
\else
\prg_return_false:
@@ -230,8 +220,12 @@
disable .value_forbidden:n = true,
debug .choice:,
- debug / true .code:n = \lua_now:n { lwc.debug = true },
- debug / false .code:n = \lua_now:n { lwc.debug = false },
+ debug / true .code:n = \__lwc_debug:n { true },
+ debug / false .code:n = \__lwc_debug:n { false },
+
+ nobreak .code:n = \__lwc_nobreak:n { #1 },
+ nobreak .value_required:n = true,
+ nobreak .initial:n = keep,
strict .meta:n = { emergencystretch = 0pt,
max-cost = 5000,
diff --git a/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.lua b/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.lua
index 94dd85e1451..45360db2092 100644
--- a/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.lua
+++ b/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.lua
@@ -5,21 +5,45 @@
SPDX-FileCopyrightText: 2022 Max Chernoff
]]
+--- Tell the linter about node attributes
+--- @class node
+--- @field prev node
+--- @field next node
+--- @field id integer
+--- @field subtype integer
+--- @field penalty integer
+--- @field height integer
+--- @field depth integer
+
+-- Set some default variables
lwc = lwc or {}
lwc.name = "lua-widow-control"
lwc.nobreak_behaviour = "keep"
+-- Locals for `debug_print`
local write_nl = texio.write_nl
local string_rep = string.rep
+local write_log
+if status.luatex_engine == "luametatex" then
+ write_log = "logfile"
+else
+ write_log = "log"
+end
+
+--- Prints debugging messages to the log, only if `debug` is set to `true`.
+--- @param title string The "title" to use
+--- @param text string? The "content" to print
+--- @return nil
local function debug_print(title, text)
if not lwc.debug then return end
+ -- The number of spaces we need
local filler = 15 - #title
if text then
- write_nl("log", "LWC (" .. title .. string_rep(" ", filler) .. "): " .. text)
+ write_nl(write_log, "LWC (" .. title .. string_rep(" ", filler) .. "): " .. text)
else
- write_nl("log", "LWC: " .. string_rep(" ", 18) .. title)
+ write_nl(write_log, "LWC: " .. string_rep(" ", 18) .. title)
end
end
@@ -31,16 +55,16 @@ end
local format = tex.formatname
local context, latex, plain, optex, lmtx
-if format:find('cont') then -- cont-en, cont-fr, cont-nl, ...
+if format:find("cont") then -- cont-en, cont-fr, cont-nl, ...
context = true
if status.luatex_engine == "luametatex" then
lmtx = true
end
-elseif format:find('latex') then -- lualatex, lualatex-dev, ...
+elseif format:find("latex") then -- lualatex, lualatex-dev, ...
latex = true
-elseif format == 'luatex' then -- Plain
+elseif format == "luatex" then -- Plain
plain = true
-elseif format == 'optex' then -- OpTeX
+elseif format == "optex" then -- OpTeX
optex = true
end
@@ -48,46 +72,81 @@ end
Save some local copies of the node library to reduce table lookups.
This is probably a useless micro-optimization, but it can't hurt.
]]
-local last = node.slide
-local copy = node.copy_list or node.copylist
-local par_id = node.id("par") or node.id("local_par")
+-- Node ID's
+local baselineskip_subid = 2
local glue_id = node.id("glue")
local glyph_id = node.id("glyph")
-local penalty_id = node.id("penalty")
local hlist_id = node.id("hlist")
-local traverse = node.traverse
-local set_attribute = node.set_attribute or node.setattribute
+local line_subid = 1
+local linebreakpenalty_subid = 1
+local par_id = node.id("par") or node.id("local_par")
+local penalty_id = node.id("penalty")
+
+-- Local versions of globals
+local copy = node.copy_list or node.copylist
local find_attribute = node.find_attribute or node.findattribute
local flush_list = node.flush_list or node.flushlist
local free = node.free
+local getattribute = node.get_attribute or node.getattribute
+local insert_token = token.put_next or token.putnext
+local last = node.slide
+local new_node = node.new
local node_id = node.is_node or node.isnode
+local set_attribute = node.set_attribute or node.setattribute
+local string_char = string.char
+local traverse = node.traverse
+local traverseid = node.traverse_id or node.traverseid
+
+-- Misc. Constants
+local iffalse = token.create("iffalse")
+local iftrue = token.create("iftrue")
+local INFINITY = 10000
local min_col_width = tex.sp("250pt")
+local SINGLE_LINE = 50
+local PAGE_MULTIPLE = 100
--[[
Package/module initialization
]]
-local warning, info, attribute, contrib_head, stretch_order, pagenum, emergencystretch, max_cost
+local attribute,
+ contrib_head,
+ emergencystretch,
+ info,
+ max_cost,
+ pagenum,
+ stretch_order,
+ warning
if lmtx then
+ -- LMTX has removed underscores from most of the Lua parts
debug_print("LMTX")
- contrib_head = 'contributehead'
+ contrib_head = "contributehead"
stretch_order = "stretchorder"
else
- contrib_head = 'contrib_head'
+ contrib_head = "contrib_head"
stretch_order = "stretch_order"
end
if context then
debug_print("ConTeXt")
- warning = logs.reporter("module", lwc.name)
- info = logs.reporter("module", lwc.name)
+
+ warning = logs.reporter(lwc.name, "warning")
+ local _info = logs.reporter(lwc.name, "info")
+ info = function (text)
+ logs.pushtarget("logfile")
+ _info(text)
+ logs.poptarget()
+ end
attribute = attributes.public(lwc.name)
pagenum = function() return tex.count["realpageno"] end
+
+ -- Dimen names
emergencystretch = "lwc_emergency_stretch"
max_cost = "lwc_max_cost"
elseif plain or latex or optex then
pagenum = function() return tex.count[0] end
+ -- Dimen names
if tex.isdimen("g__lwc_emergencystretch_dim") then
emergencystretch = "g__lwc_emergencystretch_dim"
max_cost = "g__lwc_maxcost_int"
@@ -100,8 +159,8 @@ elseif plain or latex or optex then
debug_print("Plain/LaTeX")
luatexbase.provides_module {
name = lwc.name,
- date = "2022/04/23", --%%slashdate
- version = "2.0.6", --%%version
+ date = "2022/05/14", --%%dashdate
+ version = "2.1.0", --%%version
description = [[
This module provides a LuaTeX-based solution to prevent
@@ -114,11 +173,12 @@ paragraphs.]],
attribute = luatexbase.new_attribute(lwc.name)
elseif optex then
debug_print("OpTeX")
+
warning = function(str) write_nl(lwc.name .. " Warning: " .. str) end
info = function(str) write_nl("log", lwc.name .. " Info: " .. str) end
attribute = alloc.new_attribute(lwc.name)
end
-else -- uh oh
+else -- This shouldn't ever happen
error [[Unsupported format.
Please use LaTeX, Plain TeX, ConTeXt or OpTeX.]]
@@ -126,6 +186,8 @@ end
local paragraphs = {} -- List to hold the alternate paragraph versions
+--- Gets the current paragraph and page locations
+--- @return string
local function get_location()
return "At " .. pagenum() .. "/" .. #paragraphs
end
@@ -134,78 +196,22 @@ end
Function definitions
]]
---- Create a table of functions to enable or disable a given callback
---- @param t table Parameters of the callback to create
---- callback: str = The \LuaTeX{} callback name
---- func: function = The function to call
---- name: str = The name/ID of the callback
---- category: str = The category for a \ConTeXt{} "Action"
---- position: str = The "position" for a \ConTeXt{} "Action"
---- lowlevel: bool = If we should use a lowlevel \LuaTeX{} callback instead of a
---- \ConTeXt{} "Action"
---- @return table t Enablers/Disablers for the callback
---- enable: function = Enable the callback
---- disable: function = Disable the callback
-local function register_callback(t)
- if plain or latex then -- Both use \LuaTeX{}Base for callbacks
- return {
- enable = function()
- luatexbase.add_to_callback(t.callback, t.func, t.name)
- end,
- disable = function()
- luatexbase.remove_from_callback(t.callback, t.name)
- end,
- }
- elseif context and not t.lowlevel then
- return {
- -- Register the callback when the table is created,
- -- but activate it when `enable()` is called.
- enable = nodes.tasks.appendaction(t.category, t.position, "lwc." .. t.name)
- or function()
- nodes.tasks.enableaction(t.category, "lwc." .. t.name)
- end,
- disable = function()
- nodes.tasks.disableaction(t.category, "lwc." .. t.name)
- end,
- }
- elseif context and t.lowlevel then
- --[[
- Some of the callbacks in \ConTeXt{} have no associated "actions". Unlike
- with \LuaTeX{}base, \ConTeXt{} leaves some \LuaTeX{} callbacks unregistered
- and unfrozen. Because of this, we need to register some callbacks at the
- engine level. This is fragile though, because a future \ConTeXt{} update
- may decide to register one of these functions, in which case
- \lwc/ will crash with a cryptic error message.
- ]]
- return {
- enable = function() callback.register(t.callback, t.func) end,
- disable = function() callback.register(t.callback, nil) end,
- }
- elseif optex then
- return {
- enable = function()
- callback.add_to_callback(t.callback, t.func, t.name)
- end,
- disable = function()
- callback.remove_from_callback(t.callback, t.name)
- end,
- }
- end
-end
-
+--- Prints the initial glyphs and glue of an hlist
+--- @param head node
+--- @return nil
local function get_chars(head)
if not lwc.debug then return end
local chars = ""
for n in traverse(head) do
if n.id == glyph_id then
- if n.char < 127 then
- chars = chars .. string.char(n.char)
+ if n.char < 127 then -- Only ASCII
+ chars = chars .. string_char(n.char)
else
- chars = chars .. "#"
+ chars = chars .. "#" -- Replacement for an unknown glyph
end
elseif n.id == glue_id then
- chars = chars .. " "
+ chars = chars .. " " -- Any glue goes to a space
end
if #chars > 25 then
break
@@ -215,14 +221,56 @@ local function get_chars(head)
debug_print(get_location(), chars)
end
+--- The "cost function" to use. See the manual.
+--- @param demerits number The demerits of the broken paragraph
+--- @param lines number The number of lines in the broken paragraph
+--- @return number The cost of the broken paragraph
function lwc.paragraph_cost(demerits, lines)
return demerits / math.sqrt(lines)
end
+--- Checks if the ConTeXt "grid snapping" is active
+--- @return boolean
+local function grid_mode_enabled()
+ -- Compare the token "mode" to see if `\\ifgridsnapping` is `\\iftrue`
+ return token.create("ifgridsnapping").mode == iftrue.mode
+end
+
+--- Gets the next node of a type/subtype in a node list
+--- @param head node The head of the node list
+--- @param id number The node type
+--- @param args table?
+--- subtype: number = The node subtype
+--- reverse: bool = Whether we should iterate backwards
+--- @return node
+local function next_of_type(head, id, args)
+ args = args or {}
+ if lmtx or not args.reverse then
+ for n, subtype in traverseid(id, head, args.reverse) do
+ if (subtype == args.subtype) or (args.subtype == nil) then
+ return n
+ end
+ end
+ else -- Only LMTX has the built-in backwards traverser
+ while head do
+ if head.id == id and
+ (head.subtype == args.subtype or args.subtype == nil)
+ then
+ return head
+ end
+ head = head.prev
+ end
+ end
+end
+
--- Saves each paragraph, but lengthened by 1 line
+---
+--- Called by the `pre_linebreak_filter` callback
+---
+--- @param head node
+--- @return node
function lwc.save_paragraphs(head)
- -- Ensure that we were actually given a par (only under \ConTeXt{} for some reason)
- if (head.id ~= par_id and context) or
+ if (head.id ~= par_id and context) or -- Ensure that we were actually given a par
status.output_active -- Don't run during the output routine
then
return head
@@ -231,23 +279,34 @@ function lwc.save_paragraphs(head)
-- Prevent the "underfull hbox" warnings when we store a potential paragraph
local renable_box_warnings
if (context or optex) or
- #luatexbase.callback_descriptions("hpack_quality") == 0
+ #luatexbase.callback_descriptions("hpack_quality") == 0
then -- See #18 and michal-h21/linebreaker#3
renable_box_warnings = true
lwc.callbacks.disable_box_warnings.enable()
end
-
-- We need to return the unmodified head at the end, so we make a copy here
local new_head = copy(head)
-- Prevent ultra-short last lines (\TeX{}Book p. 104), except with narrow columns
- local parfillskip = last(new_head)
- if parfillskip.id == glue_id and tex.hsize > min_col_width then
+ -- Equivalent to \\parfillskip=0pt plus 0.8\\hsize
+ local parfillskip
+ if lmtx or last(new_head).id ~= glue_id then
+ -- LMTX does not automatically add the \\parfillskip glue
+ parfillskip = new_node("glue", "parfillskip")
+ else
+ parfillskip = last(new_head)
+ end
+
+ if tex.hsize > min_col_width then
parfillskip[stretch_order] = 0
parfillskip.stretch = 0.8 * tex.hsize -- Last line must be at least 20% long
end
+ if lmtx or last(new_head).id ~= glue_id then
+ last(new_head).next = parfillskip
+ end
+
-- Break the paragraph 1 line longer than natural
local long_node, long_info = tex.linebreak(new_head, {
looseness = 1,
@@ -255,25 +314,41 @@ function lwc.save_paragraphs(head)
})
-- Break the natural paragraph so we know how long it was
- local natural_node, natural_info = tex.linebreak(copy(head))
+ nat_head = copy(head)
+
+ if lmtx then
+ parfillskip = new_node("glue", "parfillskip")
+ parfillskip[stretch_order] = 1
+ parfillskip.stretch = 1 -- 0pt plus 1fil
+ last(nat_head).next = parfillskip
+ end
+
+ local natural_node, natural_info = tex.linebreak(nat_head)
flush_list(natural_node)
if renable_box_warnings then
lwc.callbacks.disable_box_warnings.disable()
end
- -- Offset the accumulated \\prevdepth
- local prevdepth = node.new("glue")
- prevdepth.width = natural_info.prevdepth - long_info.prevdepth
- last(long_node).next = prevdepth
+ if not grid_mode_enabled() then
+ -- Offset the accumulated \\prevdepth
+ local prevdepth = new_node("glue")
+ prevdepth.width = natural_info.prevdepth - long_info.prevdepth
+ last(long_node).next = prevdepth
+ end
+
+ local long_cost = lwc.paragraph_cost(long_info.demerits, long_info.prevgraf)
- if long_info.prevgraf == natural_info.prevgraf + 1 then
+ if long_info.prevgraf == natural_info.prevgraf + 1 and
+ long_cost > 10 -- Any paragraph that is "free" to expand is suspicious
+ then
table.insert(paragraphs, {
- cost = lwc.paragraph_cost(long_info.demerits, long_info.prevgraf),
- node = long_node
+ cost = long_cost,
+ node = next_of_type(long_node, hlist_id, { subtype = line_subid })
})
end
+ -- Print some debugging information
get_chars(head)
debug_print(get_location(), "nat lines " .. natural_info.prevgraf)
debug_print(
@@ -288,21 +363,45 @@ function lwc.save_paragraphs(head)
lwc.paragraph_cost(long_info.demerits, long_info.prevgraf)
)
- -- \LuaMetaTeX{} crashes if we return `true`
+ -- \ConTeXt{} crashes if we return `true`
return head
end
-local last_paragraph = 0
--- Tags the beginning and the end of each paragraph as it is added to the page.
---
--- We add an attribute to the first and last node of each paragraph. The ID is
--- some arbitrary number for \lwc/, and the value corresponds to the
---- paragraphs index, which is negated for the end of the paragraph.
+--- paragraphs index, which is negated for the end of the paragraph. Called by the
+--- `post_linebreak_filter` callback.
+---
+--- @param head node
+--- @return node
function lwc.mark_paragraphs(head)
- if not status.output_active then
- set_attribute(head, attribute, #paragraphs + (100 * pagenum()))
- set_attribute(last(head), attribute, -1 * (#paragraphs + (100 * pagenum())))
- last_paragraph = #paragraphs
+ if not status.output_active then -- Don't run during the output routine
+ -- Get the start and end of the paragraph
+ local top_para = next_of_type(head, hlist_id, { subtype = line_subid })
+ local bottom_para = last(head)
+
+ if top_para ~= bottom_para then
+ set_attribute(
+ top_para,
+ attribute,
+ #paragraphs + (PAGE_MULTIPLE * pagenum())
+ )
+ set_attribute(
+ bottom_para,
+ attribute,
+ -1 * (#paragraphs + (PAGE_MULTIPLE * pagenum()))
+ )
+ else
+ -- We need a special tag for a 1-line paragraph since the node can only
+ -- have one attribute value
+ set_attribute(
+ top_para,
+ attribute,
+ #paragraphs + (PAGE_MULTIPLE * pagenum()) + SINGLE_LINE
+ )
+ end
end
return head
@@ -313,7 +412,11 @@ end
--- Sometimes the node list can form a loop. Since there is no last element
--- of a looped linked-list, the `last()` function will never terminate. This
--- function provides a "safe" version of the `last()` function that will break
---- the loop at the end if the list is circular.
+--- the loop at the end if the list is circular. Called by the `pre_output_filter`
+--- callback.
+---
+--- @param head node The start of a node list
+--- @return node The last node in a list
local function safe_last(head)
local ids = {}
local prev
@@ -341,24 +444,15 @@ recover, but your output may be corrupted.
return head
end
---- Remove the widows and orphans from the page, just after the output routine.
----
---- This function holds the "meat" of the module. It is called just after the
---- end of the output routine, before the page is shipped out. If the output
---- penalty indicates that the page was broken at a widow or an orphan, we
---- replace one paragraph with the same paragraph, but lengthened by one line.
---- Then, we can push the bottom line of the page to the next page.
-function lwc.remove_widows(head)
- local head_save = head -- Save the start of the `head` linked-list
-
- local penalty = tex.outputpenalty - tex.interlinepenalty
+--- Checks to see if a penalty matches the widow/orphan/broken penalties
+--- @param penalty number
+--- @return boolean
+function is_matching_penalty(penalty)
local widowpenalty = tex.widowpenalty
local clubpenalty = tex.clubpenalty
local displaywidowpenalty = tex.displaywidowpenalty
local brokenpenalty = tex.brokenpenalty
- debug_print("outputpenalty", tex.outputpenalty .. " " .. #paragraphs)
-
--[[
We only need to process pages that have orphans or widows. If `paragraphs`
is empty, then there is nothing that we can do.
@@ -366,26 +460,47 @@ function lwc.remove_widows(head)
The list of penalties is from:
https://tug.org/TUGboat/tb39-3/tb123mitt-widows-code.pdf#subsection.0.2.1
]]
- if penalty ~= 0 and
- penalty < 10000 and
- (penalty == widowpenalty or
- penalty == displaywidowpenalty or
- penalty == clubpenalty or
- penalty == clubpenalty + widowpenalty or
- penalty == clubpenalty + displaywidowpenalty or
- penalty == brokenpenalty or
- penalty == brokenpenalty + widowpenalty or
- penalty == brokenpenalty + displaywidowpenalty or
- penalty == brokenpenalty + clubpenalty or
- penalty == brokenpenalty + clubpenalty + widowpenalty or
- penalty == brokenpenalty + clubpenalty + displaywidowpenalty) and
- #paragraphs >= 1 then
- else
+ penalty = penalty - tex.interlinepenalty
+
+ return penalty ~= 0 and
+ penalty < INFINITY and (
+ penalty == widowpenalty or
+ penalty == displaywidowpenalty or
+ penalty == clubpenalty or
+ penalty == clubpenalty + widowpenalty or
+ penalty == clubpenalty + displaywidowpenalty or
+ penalty == brokenpenalty or
+ penalty == brokenpenalty + widowpenalty or
+ penalty == brokenpenalty + displaywidowpenalty or
+ penalty == brokenpenalty + clubpenalty or
+ penalty == brokenpenalty + clubpenalty + widowpenalty or
+ penalty == brokenpenalty + clubpenalty + displaywidowpenalty
+ )
+end
+
+--- Remove the widows and orphans from the page, just after the output routine.
+---
+--- This function holds the "meat" of the module. It is called just after the
+--- end of the output routine, before the page is shipped out. If the output
+--- penalty indicates that the page was broken at a widow or an orphan, we
+--- replace one paragraph with the same paragraph, but lengthened by one line.
+--- Then, we can push the bottom line of the page to the next page.
+---
+--- @param head node
+--- @return node
+function lwc.remove_widows(head)
+ local head_save = head -- Save the start of the `head` linked-list
+
+ debug_print("outputpenalty", tex.outputpenalty .. " " .. #paragraphs)
+
+ if not is_matching_penalty(tex.outputpenalty) or
+ #paragraphs == 0
+ then
paragraphs = {}
return head_save
end
- info("Widow/orphan detected. Attempting to remove.")
+ info("Widow/orphan/broken hyphen detected. Attempting to remove")
--[[
Find the paragraph on the page with the least cost.
@@ -393,10 +508,38 @@ function lwc.remove_widows(head)
local paragraph_index = 1
local best_cost = paragraphs[paragraph_index].cost
+ local last_paragraph
+ local head_last = last(head)
+ -- Find the last paragraph on the page, starting at the end, heading in reverse
+ while head_last do
+ local value = getattribute(head_last, attribute)
+ if value then
+ last_paragraph = value % PAGE_MULTIPLE
+ break
+ end
+
+ head_last = head_last.prev
+ end
+
+ local first_paragraph
+ -- Find the first paragraph on the page, from the top
+ local first_attribute_val, first_attribute_head = find_attribute(head, attribute)
+ if first_attribute_val // 100 == pagenum() - 1 then
+ -- If the first complete paragraph on the page was initially broken on the
+ -- previous page, then we can't expand it here so we need to skip it.
+ first_paragraph = find_attribute(
+ first_attribute_head.next,
+ attribute
+ ) % PAGE_MULTIPLE
+ else
+ first_paragraph = first_attribute_val % PAGE_MULTIPLE
+ end
+
-- We find the current "best" replacement, then free the unused ones
for i, paragraph in pairs(paragraphs) do
if paragraph.cost < best_cost and
- i ~= last_paragraph
+ i < last_paragraph and
+ i >= first_paragraph
then
-- Clear the old best paragraph
flush_list(paragraphs[paragraph_index].node)
@@ -421,10 +564,10 @@ function lwc.remove_widows(head)
)
if best_cost > tex.getcount(max_cost) or
- paragraph_index == last_paragraph
+ paragraph_index == last_paragraph
then
-- If the best replacement is too bad, we can't do anything
- warning("Widow/Orphan NOT removed on page " .. pagenum())
+ warning("Widow/Orphan/broken hyphen NOT removed on page " .. pagenum())
paragraphs = {}
return head_save
end
@@ -434,12 +577,13 @@ function lwc.remove_widows(head)
-- Start of final paragraph
debug_print("remove_widows", "moving last line")
+ -- Here we check to see if the widow/orphan was preceded by a large penalty
head = last(head_save).prev
local big_penalty_found, last_line, hlist_head
while head do
if head.id == glue_id then
-- Ignore any glue nodes
- elseif head.id == penalty_id and head.penalty >= 10000 then
+ elseif head.id == penalty_id and head.penalty >= INFINITY then
-- Infinite break penalty
big_penalty_found = true
elseif big_penalty_found and head.id == hlist_id then
@@ -451,7 +595,7 @@ function lwc.remove_widows(head)
head = last(head_save)
break
elseif lwc.nobreak_behaviour == "warn" then
- warning("Widow/Orphan NOT removed on page " .. pagenum())
+ warning("Widow/Orphan/broken hyphen NOT removed on page " .. pagenum())
paragraphs = {}
return head_save
end
@@ -467,6 +611,17 @@ function lwc.remove_widows(head)
head = head.prev
end
+ local potential_penalty = head.prev.prev
+
+ if potential_penalty and
+ potential_penalty.id == penalty_id and
+ potential_penalty.subtype == linebreakpenalty_subid and
+ is_matching_penalty(potential_penalty.penalty)
+ then
+ warning("Making a new widow/orphan/broken hyphen on page " .. pagenum())
+ end
+
+
last_line = copy(head)
last(last_line).next = copy(tex.lists[contrib_head])
@@ -489,18 +644,50 @@ function lwc.remove_widows(head)
debug_print("remove_widows", "found " .. value)
-- Insert the start of the replacement paragraph
- if value == paragraph_index + (100 * pagenum()) then
+ if value == paragraph_index + (PAGE_MULTIPLE * pagenum()) or
+ value == paragraph_index + (PAGE_MULTIPLE * pagenum()) + SINGLE_LINE
+ then
debug_print("remove_widows", "replacement start")
safe_last(target_node) -- Remove any loops
+ -- Fix the `\\baselineskip` glue between paragraphs
+ height_difference = (
+ next_of_type(head, hlist_id, { subtype = line_subid }).height -
+ next_of_type(target_node, hlist_id, { subtype = line_subid }).height
+ )
+
+ local prev_bls = next_of_type(
+ head,
+ glue_id,
+ { subtype = baselineskip_subid, reverse = true }
+ )
+
+ if prev_bls then
+ prev_bls.width = prev_bls.width + height_difference
+ end
+
head.prev.next = target_node
free_next_nodes = true
end
-- Insert the end of the replacement paragraph
- if value == -1 * (paragraph_index + (100 * pagenum())) then
+ if value == -1 * (paragraph_index + (PAGE_MULTIPLE * pagenum())) or
+ value == paragraph_index + (PAGE_MULTIPLE * pagenum()) + SINGLE_LINE
+ then
debug_print("remove_widows", "replacement end")
- safe_last(target_node).next = head.next
+ local target_node_last = safe_last(target_node)
+
+ if grid_mode_enabled() then
+ -- Account for the difference in depth
+ local after_glue = new_node("glue")
+ after_glue.width = head.depth - target_node_last.depth
+ target_node_last.next = after_glue
+
+ after_glue.next = head.next
+ else
+ target_node_last.next = head.next
+ end
+
break
end
@@ -512,11 +699,10 @@ function lwc.remove_widows(head)
end
info(
- "Widow/orphan successfully removed at paragraph "
+ "Widow/orphan/broken hyphen successfully removed at paragraph "
.. paragraph_index
.. " on page "
.. pagenum()
- .. "."
)
paragraphs = {} -- Clear paragraphs array at the end of the page
@@ -524,31 +710,90 @@ function lwc.remove_widows(head)
return head_save
end
+--- Create a table of functions to enable or disable a given callback
+--- @param t table Parameters of the callback to create
+--- callback: string = The \LuaTeX{} callback name
+--- func: function = The function to call
+--- name: string = The name/ID of the callback
+--- category: string = The category for a \ConTeXt{} "Action"
+--- position: string = The "position" for a \ConTeXt{} "Action"
+--- lowlevel: boolean = If we should use a lowlevel \LuaTeX{} callback instead of a
+--- \ConTeXt{} "Action"
+--- @return table t Enablers/Disablers for the callback
+--- enable: function = Enable the callback
+--- disable: function = Disable the callback
+local function register_callback(t)
+ if plain or latex then -- Both use \LuaTeX{}Base for callbacks
+ return {
+ enable = function()
+ luatexbase.add_to_callback(t.callback, t.func, t.name)
+ end,
+ disable = function()
+ luatexbase.remove_from_callback(t.callback, t.name)
+ end,
+ }
+ elseif context and not t.lowlevel then
+ return {
+ -- Register the callback when the table is created,
+ -- but activate it when `enable()` is called.
+ enable = nodes.tasks.appendaction(t.category, t.position, "lwc." .. t.name)
+ or function()
+ nodes.tasks.enableaction(t.category, "lwc." .. t.name)
+ end,
+ disable = function()
+ nodes.tasks.disableaction(t.category, "lwc." .. t.name)
+ end,
+ }
+ elseif context and t.lowlevel then
+ --[[
+ Some of the callbacks in \ConTeXt{} have no associated "actions". Unlike
+ with \LuaTeX{}base, \ConTeXt{} leaves some \LuaTeX{} callbacks unregistered
+ and unfrozen. Because of this, we need to register some callbacks at the
+ engine level. This is fragile though, because a future \ConTeXt{} update
+ may decide to register one of these functions, in which case
+ \lwc/ will crash with a cryptic error message.
+ ]]
+ return {
+ enable = function() callback.register(t.callback, t.func) end,
+ disable = function() callback.register(t.callback, nil) end,
+ }
+ elseif optex then -- Op\TeX{} is very similar to luatexbase
+ return {
+ enable = function()
+ callback.add_to_callback(t.callback, t.func, t.name)
+ end,
+ disable = function()
+ callback.remove_from_callback(t.callback, t.name)
+ end,
+ }
+ end
+end
+
-- Add all of the callbacks
lwc.callbacks = {
disable_box_warnings = register_callback({
callback = "hpack_quality",
- func = function() end,
- name = "disable_box_warnings",
+ func = function() end,
+ name = "disable_box_warnings",
lowlevel = true,
}),
remove_widows = register_callback({
callback = "pre_output_filter",
- func = lwc.remove_widows,
- name = "remove_widows",
+ func = lwc.remove_widows,
+ name = "remove_widows",
lowlevel = true,
}),
save_paragraphs = register_callback({
callback = "pre_linebreak_filter",
- func = lwc.save_paragraphs,
- name = "save_paragraphs",
+ func = lwc.save_paragraphs,
+ name = "save_paragraphs",
category = "processors",
position = "after",
}),
mark_paragraphs = register_callback({
callback = "post_linebreak_filter",
- func = lwc.mark_paragraphs,
- name = "mark_paragraphs",
+ func = lwc.mark_paragraphs,
+ name = "mark_paragraphs",
category = "finalizers",
position = "after",
}),
@@ -556,6 +801,7 @@ lwc.callbacks = {
local enabled = false
+--- Enable the paragraph callbacks
function lwc.enable_callbacks()
debug_print("callbacks", "enabling")
if not enabled then
@@ -568,6 +814,7 @@ function lwc.enable_callbacks()
end
end
+--- Disable the paragraph callbacks
function lwc.disable_callbacks()
debug_print("callbacks", "disabling")
if enabled then
@@ -588,12 +835,88 @@ end
function lwc.if_lwc_enabled()
debug_print("iflwc")
if enabled then
- tex.sprint("\\iftrue")
+ insert_token(iftrue)
else
- tex.sprint("\\iffalse")
+ insert_token(iffalse)
+ end
+end
+
+--- Mangles a macro name so that it's suitable for a specific format
+--- @param name string The plain name
+--- @param args table<string> The TeX types of the function arguments
+--- @return string The mangled name
+local function mangle_name(name, args)
+ if plain then
+ return "lwc@" .. name:gsub("_", "@")
+ elseif optex then
+ return "_lwc_" .. name
+ elseif context then
+ return "lwc_" .. name
+ elseif latex then
+ return "__lwc_" .. name .. ":" .. string_rep("n", #args)
+ end
+end
+
+--- Creates a TeX command that evaluates a Lua function
+--- @param name string The name of the csname to define
+--- @param func function
+--- @param args table<string> The TeX types of the function arguments
+--- @return nil
+local function register_tex_cmd(name, func, args)
+ local scanning_func
+ name = mangle_name(name, args)
+
+ if not context then
+ local scanners = {}
+ for _, arg in ipairs(args) do
+ scanners[#scanners+1] = token['scan_' .. arg]
+ end
+
+ scanning_func = function()
+ local values = {}
+ for _, scanner in ipairs(scanners) do
+ values[#values+1] = scanner()
+ end
+
+ func(table.unpack(values))
+ end
+ end
+
+ if optex then
+ define_lua_command(name, scanning_func)
+ return
+ elseif plain or latex then
+ local index = luatexbase.new_luafunction(name)
+ lua.get_functions_table()[index] = scanning_func
+ token.set_lua(name, index)
+ elseif context then
+ interfaces.implement {
+ name = name,
+ public = true,
+ arguments = args,
+ actions = func
+ }
end
end
+register_tex_cmd("if_enabled", lwc.if_lwc_enabled, {})
+register_tex_cmd("enable", lwc.enable_callbacks, {})
+register_tex_cmd("disable", lwc.disable_callbacks, {})
+register_tex_cmd(
+ "nobreak",
+ function(str)
+ lwc.nobreak_behaviour = str
+ end,
+ { "string" }
+)
+register_tex_cmd(
+ "debug",
+ function(str)
+ lwc.debug = str ~= "0" and str ~= "false" and str ~= "stop"
+ end,
+ { "string" }
+)
+
--- Silence the luatexbase "Enabling/Removing <callback>" info messages
---
--- Every time that a paragraph is typeset, \lwc/ hooks in
@@ -612,12 +935,12 @@ end
local function silence_luatexbase()
local nups = debug.getinfo(luatexbase.add_to_callback).nups
- for x = 1, nups do
- local name, func = debug.getupvalue(luatexbase.add_to_callback, x)
+ for i = 1, nups do
+ local name, func = debug.getupvalue(luatexbase.add_to_callback, i)
if name == "luatexbase_log" then
debug.setupvalue(
luatexbase.add_to_callback,
- x,
+ i,
function(text)
if text:match("^Inserting") or text:match("^Removing") then
return
diff --git a/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.tex b/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.tex
index b667d05c111..78385ad698d 100644
--- a/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.tex
+++ b/Master/texmf-dist/tex/luatex/lua-widow-control/lua-widow-control.tex
@@ -3,7 +3,7 @@
% SPDX-License-Identifier: MPL-2.0+
% SPDX-FileCopyrightText: 2022 Max Chernoff
-\wlog{lua-widow-control v2.0.6} %%version
+\wlog{lua-widow-control v2.1.0} %%version
\ifx\directlua\undefined
\errmessage{%
@@ -35,13 +35,8 @@
\expandglyphsinfont\the\font 20 20 5
\adjustspacing=2
-% Define \TeX{} wrappers for Lua functions
-\def\lwcenable{\directlua{lwc.enable_callbacks()}}
-\def\lwcdisable{\directlua{lwc.disable_callbacks()}}
-\def\iflwc{\directlua{lwc.if_lwc_enabled()}}
-
% Enable \lwc/ by default when the package is loaded.
-\lwcenable
+\lwc@enable
% Expansion of some parts of the document, such as section headings, is quite
% undesirable, so we'll disable \lwc/ for certain commands.
@@ -50,15 +45,15 @@
\newcount\lwc@disable@count
\def\lwc@patch@pre{%
- \iflwc%
+ \lwc@if@enabled%
\advance\lwc@disable@count by 1%
- \lwcdisable%
+ \lwc@disable%
\fi%
}
\def\lwc@patch@post{
\ifnum\lwc@disable@count>0%
- \lwcenable%
+ \lwc@enable%
\advance\lwc@disable@count by -1%
\fi
}
@@ -89,6 +84,13 @@
\lwcdisablecmd{\beginsection} % Sectioning
\endgroup
+% Make the commands public
+\let\lwcenable=\lwc@enable
+\let\lwcdisable=\lwc@disable
+\let\lwcdebug=\lwc@debug
+\let\iflwc=\lwc@if@enabled
+\let\lwcnobreak=\lwc@nobreak
+
\catcode`@=12
\endinput
diff --git a/Master/texmf-dist/tex/optex/lua-widow-control/lua-widow-control.opm b/Master/texmf-dist/tex/optex/lua-widow-control/lua-widow-control.opm
index afae1aa6a60..cb6f4c06f97 100644
--- a/Master/texmf-dist/tex/optex/lua-widow-control/lua-widow-control.opm
+++ b/Master/texmf-dist/tex/optex/lua-widow-control/lua-widow-control.opm
@@ -3,7 +3,7 @@
% SPDX-License-Identifier: MPL-2.0+
% SPDX-FileCopyrightText: 2022 Max Chernoff
-\_codedecl\lwcenable{lua-widow-control <v2.0.6>} %%version
+\_codedecl\lwcenable{lua-widow-control <v2.1.0>} %%version
\_namespace{lwc}
\_clubpenalty=1
@@ -19,14 +19,6 @@
\_directlua{require "lua-widow-control"}
-% Define \TeX{} wrappers for Lua functions
-\_def\.enable{\_directlua{lwc.enable_callbacks()}}
-\_def\.disable{\_directlua{lwc.disable_callbacks()}}
-\_def\.iflwc{\_directlua{lwc.if_lwc_enabled()}}
-
-\_let\lwcenable=\.enable
-\_let\lwcdisable=\.disable
-
% Enable \lwc/ by default when the package is loaded.
\.enable
@@ -37,7 +29,7 @@
\_newcount\.disable_count
\_def\.patch_pre{%
- \.iflwc%
+ \.if_enabled%
\_advance\.disable_count by 1%
\.disable%
\_fi%
@@ -70,11 +62,18 @@
\_endgroup%
\_fi%
}
-\_let\lwcdisablecmd=\.disable_cmd
\.disable_cmd{\_printchap}
\.disable_cmd{\_printsec}
\.disable_cmd{\_printsecc}
+% Make the commands public
+\_let\lwcenable=\.enable
+\_let\lwcdisable=\.disable
+\_let\lwcdisablecmd=\.disable_cmd
+\_let\lwcdebug=\.debug
+\_let\iflwc=\.if_enabled
+\_let\lwcnobreak=\.nobreak
+
\_endnamespace
\_endcode