SILE v0.10.10 Is Released

14 Aug 2020 — Caleb Maclennan

Version v0.10.10 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

This release is the first to fully support LuaJIT. For systems with a LuaJIT interpreter available this brings a full 2× speed improvement to rendering your documents over standard Lua interpreters. This speed increase is not without downsides though. Most available JIT versions do not have full Lua debugging functionality built in, limiting the usefulness of some of SILE’s warning messages and especially the trace functionality. A LuaJIT build is probably what you want to use when working on content and re-rendering your documents over and over, but it may not be the best choice for doing development work, coding up your classes and functions, and so forth. To make the switch, add the configuration flag ./configure --with-luajit, then compile and install as usual. In the event you want to keep both versions around, it is actually possible to install both. SILE fully supports GNU Automake’s program name transformations, you can specify a prefix, suffix, or complete alternate name to install under. See ./configure --help for details, but --program-suffix=-luajit is one way to get a sile-luajit executable that could be used alongside sile.

A few functions have been renamed and their old versions deprecated. If any of your code calls outputter functions directly these calls will need to be modified to be uniformly serf-referential method calls (i.e. :method() instead of .method()). This makes the outputter API consistent between backends, but may be a breaking change for some. Several other functions have been renamed and their old names deprecated. For these warning messages will be thrown for now, and the next version series (0.11.x) will deprecate them entirely. The most notable rename is \include-svg-file is now just \svg. In addition to the rename you can now specify a desired size by width instead of only by height.

In smaller news a large number of small fixes now draw frame debugging lines in exactly the right place instead of next to the right place, mark PDF bookmark locations at the top of the current line instead of the bottom, draw rules in the correct writing and advance directions for RTL and BTT frames. Other fixes include keeping Japanese language and tate functions from taking over documents. The \center command now disables line indentation so content is centered as expected, and attempting to set indentation after the start of a paragraph will throw a useful warning.

Features

  • build: Detect and use luajit first (601dfc4)
  • build: Detect LuaJIT if explicitly configured to want it (c3e8089)
  • classes: Add warning to \noindent if called after input (f29b9d9)
  • packages: Allow scaling SVGs by width or height (44588b5)
  • settings: Add a way to reset single setting to defaults (f318cdf)
  • settings: Bring Lua settings.set to parity with \set (d73b08c)

Bug Fixes

  • classes: Reset parindent’s inside \center command (7b62f74)
  • core: Always compare like-types so LuaJIT can run (c608090)
  • core: Don’t read zero-length name table entries (bcd9a9e), closes #1015
  • examples: Properly center title in showoff document (55717fb)
  • frames: Discard content (usually whitespace) inside \pagetemplate (3b7085b)
  • frames: Draw frame debug lines exactly on frame lines (db92edc)
  • languages: Stop Japanese resetting global chapter post macro (836f199)
  • packages: Align pullquote ending mark with outside margin (8b808db)
  • packages: Draw rules in the writing direction (18bca68)
  • packages: Error if asked to add bogus dependencies (59e2b56)
  • packages: Fix indentation of second paragraph in pullquotes (a8525e5)
  • packages: List \include files in makedeps (bf670ab)
  • packages: Orient rules for all 8 directions (bc4a33a)
  • packages: Place PDF bookmarks at top of current line (ce30d83)

  • utilities: Use deterministic sort for sorted pairs (99e2b59)

SILE v0.10.9 Is Released

24 Jul 2020 — Caleb Maclennan

Version v0.10.9 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

This is the first version of SILE to officially support Lua 5.4! If your OS or distro is migrating to the latest Lua, this release is for you. The changes in this Lua release are not very significant in relation to SILE, but it took a bit of time and effort for all the modules we use to be compatible. Additionally in this release how we handle bundling LuaRocks modules has changed. We no longer include the full source and prebuilt rocks in the source packages. For most platforms and installations this will not change anything at all, using --with-system-luarocks still skips anything to do with bundling and just requires the dependencies be available on the host system. This is used by all platforms to date that have SILE packages. For people building from source using the default configuration of --without-system-luarocks the bundling still happens using Luarocks to download and build all the required dependencies when you run make. Previously it copied the sources for your version of Lua out of the source package, but with 4 supported versions of Lua and many variation in how different platforms build them this was getting too cumbersome. LuaRocks does this job already, we just leverage it.

Still on the topic of packaging, a minor change is that make install will not install the PDF manual and examples by default, but if you add --with-manual and/or --with-examples it will not only install them, but it will install them to your platform’s default location for PDF documentation (previously they were just stuffed in alongside the SILE code, wherever that was). The PDF documentation directory is the same as for other documentation on most platforms, but it does go to the right place for those system that have special handling for PDF documentation.

As for the typesetter itself, if you ever used inputfilter() functions and your content randomly came out in the wrong order, we fixed that non-determinism. Additionally Unicode combining diacritic marks can be now be added with \unichar{}. If you’re trying to figure out what is what on a page, --debug hboxes also works again after being broken some time back.

For developers, adding multiple debug flags from the CLI is easier than ever, and fewer things need to be rebuilt from scratch every time you touch something in SILE’s source code.

Features

  • build: Install manual to $(pdfdir) if configure –with-manual (ee33ff7)
  • core: Allow adding –debug flag multiple times (9ac2838)

Bug Fixes

  • build: Correct typo in dependencies for building docs (ad548a5)
  • build: Ship blank lua_modules install list in source packages (7939970)
  • build: Touch Makefile.in to avoid automake errors (e7f4627)
  • build: Work around src/libtexpdf subdirs using side-effects (26d6769)
  • core: Iterate on sequential data with ipairs() or SU.sortedpairs() (9db0a28)
  • debug: Fix math in hbox debugging (6c0029d)
  • packages: Combine unichar output with existing unshaped node (712bc92)
  • packages: Use sortedpairs to avoid non-determinism (a28ef06)

  • utilities: Add sorted pairs function (5aad397)

SILE v0.10.8 Is Released

19 Jul 2020 — Caleb Maclennan

Version v0.10.8 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

This release addresses the Docker builds which came out broken in the previous release. Some Lua modules shuffled to make way for Lua 5.4 support (which is almost ready, just waiting on one more upstream dependency). Additionally some build issues on BSD have been smoothed over.

Note I accidentally pushed this release tag along with a bad commit that was never supposed to be released. Hence the v0.10.8 tag was briefly attached to a different commit (but with no packages attached). I apologize for any inconvenience for any inconvenience this caused.

Features

  • build: Output hints about how to compile from repo snapshots (596cd9f)

Bug Fixes

  • build: Avoid possible race condition on first bulid (b937c95)
  • build: Use BSD compatible find syntax (c96683e)
  • build: Use BSD compatible touch syntax (25eb6fd)
  • docker: Make sure Lua modules installation works on the first pass (f0c3e26)

Performance Improvements

  • build: Save a ./configure cycle by bootstraping the version (2997d05)

Reverts

  • Revert “chore(build): Save a double-configure on first download/build” (ef56de4)

SILE v0.10.7 Is Released

17 Jul 2020 — Caleb Maclennan

Version v0.10.7 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

This release is substantially the same as v0.10.6, except the release packages were published fully automatically. This was supposed to happen in the last release too, but some issues just don’t surface until you do the real thing. This time it actually worked.

Bug Fixes

  • build: Merge Github Actions release step with build (b2d77ab)

SILE v0.10.6 Is Released

16 Jul 2020 — Caleb Maclennan

Version v0.10.6 of SILE has been released and is available for download! See the included CHANGELOG.md or review the commit history for more explicit details.

Summary of Improvements

Most of the changes in this maintenance release are related to the build and packaging system, with a notable exception of the manual. Many more packages have been documented and the manual has seen quite a bit of copy-editing. For users of the docbook class, the default monospace font has changed from Dejavu Sans to Hack.

One new feature added to the TeXlike input language now allows single quotes to be escaped (\") to appear in the value of options passed to a command.

In the installation department, two new option flags for ./configure have been added, --with-manual and --with-examples. Both are off by default. Enabling these flags will cause a copy of the manual and examples respectively to be installed to your system’s $docsdir. These PDFs are included pre-built in the source package, but not installed anywhere by default.

Features

  • build: Add –with-examples option to configure & make (245e8a6)
  • build: Add –with-manual option to configure & make (3415b3a)
  • inputs: Allow (escaped) quote mark in quoted command options (2e9d1b5)

Bug Fixes

  • build: Always distribute Lua_modules even if build uses system (e75ece7)
  • build: Correct typo in test dependencies causing no font downloads (ad49a85)
  • build: Correct typo in test dependencies causing no font downloads (09a653a)
  • build: Explicitly filter packaging *.lua and *.sil to avoid cruft (a89773d)
  • build: Fix conflations between Lua source types (163959f)
  • build: Handle any combo of –with-manual and –with-examples flags (145a86e)
  • build: Mark make busted as PHONY so it always runs (23b81ac)
  • build: Move dynamically generated file lists out of automake (f626867)
  • classes: Use Hack as default monospace font (0e61067)
  • core: Handle empty content in macros using \process (2dc6d66)
  • frames: Reset font to Gentium to output frame IDs (102dd09), closes #915
  • inputs: Disallow ‘begin’ and ‘end’ as environment names (b13b99a)
  • inputs: Only allow reserved characters as 1-char commands (2a4c095)
  • packages: Assure PDF initialization first-output can be rotated (0613ab1)
  • packages: Cast measurements to numbers before use in PDF functions (5f2d2e3)
  • packages: Fix measurement-to-number issue in SVG (168dffc)
  • packages: Improve multi-paragraph pullquotes (7d3f355), closes #865
  • packages: Ruby class should not affect document language (#926) (8034aa1)
  • packages: Tate should not affect document language (#932) (193fded)

  • tooling: Allow make dist on systems without native lua packages (5758085)