====== caption ======

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

None.

===== Syntax =====

  * ''**caption** always|splitonly [//string//]''
  * ''**caption** string [//string//]''

===== Description =====

This command controls the display of the window captions.  Normally a
caption is only used if more than one window is shown on the display
(split screen mode).  But if the type is set to "always", ''screen'' shows
a caption even if only one window is displayed.  The default is
"splitonly".

The second form changes the text used for the caption. You can use all
escapes from the [[man:String Escapes]] chapter.  ''screen'' uses a
default of "''%3n %t''".

You can mix both forms by providing a string as an additional argument.
===== Examples =====
* ''caption splitonly "%{= kc}%H--%n (%t)%-5=%{= .m}%0c"''

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

  * [[:appearance]]