Skip to content

v0.19.0 — a toolbar you can read, and a choice about how it opens

Latest

Choose a tag to compare

@JYPochez JYPochez released this 03 Aug 20:32

New: Home

A button left of Back that puts you back where a fresh launch would: the search field cleared, the
whole tree restored, its first topic open. Useful after a search has replaced the tree and you want
your bearings back without quitting.

New: copy this page's address

Beside the globe, at the right of the toolbar. The globe opens the current page on
documentation.xojo.com; the new button puts that same address on the clipboard instead. Both are
available only for the Sphinx-era releases that are still served online, so they enable and disable
together, and the copy is acknowledged by the button itself rather than by a dialog.

New: Settings ▸ At launch

"Reopen the last page read", on by default, which is exactly what the app already did. Turn it
off and every launch starts fresh — the newest documentation set in the popup, opened on its first
topic. The choice takes effect at the next launch.

The toolbar is icons now

Home, back, forward, copy-address and the globe carry Material Design Icons (Google, Apache
License 2.0) rather than text glyphs, so the row reads as one set. Each is supplied at 1×, 2× and 3×
so it stays sharp on a Retina screen, in a light and a dark set that follow the system appearance.
The buttons are square and the row is aligned to the height macOS actually renders its popups at.
The About window credits the icons, as the licence asks.

Fixed

  • The window reopens at its saved position and size again. A constant added during the Linux
    investigation to skip the bounds restore for a single test build was left behind switched off, so
    the app went on saving the bounds and stopped reading them. The rest of that investigation's
    scaffolding went with it, which also stops five redundant layout passes at startup and five more
    after every page load, on every platform.

  • A tab is named after the member, not the class page it lives on. Opening
    DesktopListBox.AddRow, .AddRowAt and .AddExpandableRow gave three tabs all captioned
    DesktopListBox, because in the Sphinx era every live member is a section of its class's page.

Linux works

Two Xojo issues stood between this app and a usable Linux build, and both are now worked around by
the app itself — nothing to configure.

  • The pane rendered blank on some hardware. Xojo documents this and recommends turning WebKit's
    hardware acceleration off, which the app now does at startup. It is also why the pane behaved
    differently under GNOME and XFCE: acceleration defaults off on Wayland and on elsewhere.
  • The pane was drawn at the window's top-left corner rather than in its own pane. The cause was
    not the layout: filling a popup menu and setting its selection before the window is fully
    presented
    displaces the viewer. That is Xojo issue #81717 — confirmed by Xojo, a fix promised
    in a future release, and their suggested workaround is to defer that work, which the app now does.

Confirmed on Ubuntu on ARM under XFCE: the tree, the splitter, the tab strip, search and the reading
pane all behave as they do on macOS.

Download

macOS only, signed and notarised, universal. Windows and Linux compile from source and work — no
download is offered for either, because the Chromium runtime they embed puts the Windows build at
~118 MB compressed, over GitHub's file limit.