====== hardstatus ======

===== Default Keybindings =====

None.

===== Syntax =====

  * ''**hardstatus** [on|off]''
  * ''**hardstatus** [always]lastline|message|ignore [//string//]''
  * ''**hardstatus** string [//string//]''

===== Description =====

This command configures the use and emulation of the terminal’s hardstatus
line.  The first form toggles whether ''screen'' will use the hardware
status line to display messages.  If the flag is set to "off", these
messages are overlaid in reverse video mode at the display line.  The
default setting is "on".

The second form tells ''screen'' what to do if the terminal doesn’t have a
hardstatus line (i.e. the termcap/terminfo capabilities ''hs'', ''ts'',
''fs'' and ''ds'' are not set).  If the type "lastline" is used,
''screen'' will reserve the last line of the display for the hardstatus.
"message" uses ''screen''’s message mechanism and "ignore" tells
''screen'' never to display the hardstatus.  If you prepend the word
"always" to the type (e.g.  "alwayslastline"), ''screen'' will use the
type even if the terminal supports a hardstatus.

The third form specifies the contents of the hardstatus line.  "''%h''" is
used as default string, i.e. the stored hardstatus of the current window
(settable via "''ESC]0;<string>^G''", "''ESC_<string>ESC\''", or the ''[[hstatus]]'' command) is
displayed.  You can customize this to any string you like including the
escapes from the [[man:String Escapes]] chapter.  If you leave out the
argument //string//, the current string is displayed.

You can mix the second and third form by providing the string as
additional argument.


===== Examples =====

''hardstatus alwayslastline '%{= kG}[ %{G}%H %{g}][%= %{= kw}%?%-Lw%?%{r}(%{W}%n*%f%t%?(%u)%?%{r})%{w}%?%+Lw%?%?%= %{g}][%{B} %d/%m %{W}%c %{g}]' ''

===== See Also =====

  * ''[[hstatus]]''
  * [[:Appearance]]