Document inter-dependencies between optional terminal features

- document that we currently require "cursor position report" if
  either of both click_events or XTGETTCAP+indn is implemented.
  One of the following patches will remove this requirement.
- document properly that scrollback-push currently only works
  when XTGETTCAP+indn is implemented. There are still a few terminals
  that don't support SCROLL UP, for example the Linux Console,
  and there is no better way to find out if it's supported.
This commit is contained in:
Johannes Altmanninger
2025-05-02 10:37:24 +02:00
parent 6f01c7b707
commit 064a45635c
3 changed files with 44 additions and 12 deletions

View File

@@ -183,9 +183,14 @@ The following special input functions are available:
``clear-screen``
clears the screen and redraws the prompt.
.. _special-input-functions-scrollback-push:
``scrollback-push``
pushes earlier output to the terminal scrollback, positioning the prompt at the top.
For compatibility with terminals that do not provide the ECMA-48 ``SCROLL UP`` command,
this command does nothing unless the terminal advertises support for that command via :ref:`XTGETTCAP <term-compat-xtgettcap>`.
``complete``
guess the remainder of the current token