EPIC Enhanced Programmable IRC-II Client

set status_format1

Synopsis

/set status_format1 [<text>]
/set -status_format1

With no text, set displays the format. Unsetting removes its text, not the allocated status row.

Description

When window double is on, this is the top line of the two-line status bar. The bottom line uses status_format2. With double status off, the window uses status_format instead; assigning status_format1 does not enable double status.

In other respects it uses the same syntax and rendering rules as status_format: case-sensitive percent fields, numeric maps, wrapper settings, optional dollar expansion, right alignment, and repeated fill. See that page for the field list and limits, including the maximum of 40 recognized fields per line. Each status row is formatted separately.

The compiled default begins with a reverse-video control character followed by:

%T [%R] %*%=%@%N%#%S%{1}H%H%B%Q%A%C%+%I%O%M%F%L %U

The retired %L field inserts nothing in EPIC6. Startup scripts can modify this default. Custom text is not automatically made reverse-video.

Window overrides and updates

A defined window status_format1 overrides this global default for that window. Changing the global setting recompiles status formats and requests updates, but preserves defined per-window overrides. Shared status_* wrapper settings still control their corresponding fields.

Field visibility follows the window's state, not which of the two rows contains the field. For example, show_status_all still governs current-only fields, and %T still requires clock on. Dollar expressions evaluated by status_does_expandos use the displayed window's context. Changing this format sends no IRC request.

Example

/set status_format1 [%R] %N%C%+%Q%A %>%T
/set status_format2 %W %U %X %Y %Z 
/window double on

This configures global defaults and enables two status rows for the selected window. Existing per-window overrides can prevent these global formats from being used there.

History

Double-status support was ported by archon from ircII to EPIC3.003.

Source references