module TermBuf::CapabilityOverrides

Overview

The TERMBUF_CAPS escape hatch, which has the last word over everything detection worked out.

TERMBUF_CAPS=+truecolor,-kitty_graphics,+osc8_links
TERMBUF_CAPS=none,+color16
TERMBUF_CAPS=all

A bare name turns a capability on, a leading - turns it off, and anything not mentioned keeps whatever it was detected as. none and all set a starting point for the rest of the list.

Names are the Capability members in snake case. An unknown one is reported rather than raised on: a typo in an environment variable should not stop an application from starting, and it must not print to the screen the application is about to take over.

Extended Modules

• TermBuf::CapabilityOverrides

Defined in:

termbuf/caps/overrides.cr

Constant Summary

VARIABLE = "TERMBUF_CAPS"

The variable itself, deliberately not application specific.

Instance Method Summary

• #apply(base : Capabilities, env : Hash(String, String)) : Result

  Applies VARIABLE from env to base.

• #apply(base : Capabilities, spec : String | Nil) : Result

  Applies a +name,-name list to base.

Instance Method Detail