Paging and Pausing

This feature is experimental. It requires “back-end” support, which has not been implemented yet for qtdomterm or DomHttpServer. It also requires libwebsockets version 2.2 or greater.

Key-bindings and other aspects are likely to change.

DomTerm includes a builtin “pager” that gives you functionality similar to programs like less. You can set “auto-pause” which enters the pager each time a full screen has been displayed.

We will discuss two related modes. Pager mode does the following:

  1. The key-bindings are changed to be more like the less program or Emacs “view mode”.

  2. Automatically scrolling (on output) is turned off.

Pause mode additionally does the following:

  1. Suspends additional output from updating the display. Any not-yet-displayed output is queued up, and the sending (client process) will suspend too.

You enter pause mode in two basic ways

To enable automatic-pause mode on Electron you can check the Automatic Pager option in the right-click (context) menu. (You can also type ctrl-shift-P (to enter pause mode); then shift-A (to enable auto-pause); and then ctrl-shift-P (to exit pause mode). This is obviously too awkward and needs to change.)

To enter pager mode, you first have to enter pause mode, and then type P.

The following key-bindings are in effect in pager or paused mode. Some other these may be prefixed by a numeric count.

Shift-A

Toggle automatic-pause mode on and off. (This is a klunky way tro do it and is likely to change.)

P

Toggle between pager and pause mode.

Control-Shift-P

Return to normal mode. If paused, allow further output.

Space

Scroll count screenfuls down. If we go past the bottom of the current output, leave pause or pager mode, and allow further output. Temporarily set automatic-pause mode, so that we pause again if the screen fills up again.

Enter

Scroll count lines down. Otherwise similar to Space.

PageUp
PageDown

Scroll count screenfuls up/down.

Home

Scroll to the current “pager home”. (Details needed ...)

Home

Scroll to the current “pager home”. (Details needed ...)

DomTerm does not yet implement a search command, but most browsers have a find-in-page command, commonly bound to Ctrl-F.

In addition the following work as in all other modes:

Control-Shift-Home
Control-Shift-End

Scroll to top/bottom.

Control-Shift-PageUp
Control-Shift-PageDown

Scroll one “page” up or down.

Control-Shift-Up
Control-Shift-Down

Scroll one line up or down.