'\" t
.\"     Title: kakoune
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 11/16/2018
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH KAK_FACES 1 "" "" "faces"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
faces \- a
.SH "DECLARATION"
.sp
A \fIface\fR refers how the specified text is displayed, it has a foreground color, a background color, and some attributes\&. The value of a face has the following format:
.sp
.if n \{\
.RS 4
.\}
.nf
fg_color[,bg_color][+attributes]
.fi
.if n \{\
.RE
.\}
.PP
\fIfg_color\fR, \fIbg_color\fR
.RS 4
a color whose value can be expressed in the following formats:
.PP
\fBblack\fR, \fBred\fR, \fBgreen\fR, \fByellow\fR, \fBblue\fR, \fBmagenta\fR, \fBcyan\fR, \fBwhite\fR
.RS 4
a named color
.RE
.PP
\fBdefault\fR
.RS 4
keep the existing color
.RE
.PP
\fBrgb:RRGGBB\fR
.RS 4
hexadecimal value
.RE
.RE
.PP
\fIattributes\fR
.RS 4
string whose individual letters set an attribute:
.PP
\fBu\fR
.RS 4
underline
.RE
.PP
\fBr\fR
.RS 4
reverse
.RE
.PP
\fBb\fR
.RS 4
bold
.RE
.PP
\fBB\fR
.RS 4
blink
.RE
.PP
\fBd\fR
.RS 4
dim
.RE
.PP
\fBi\fR
.RS 4
italic
.RE
.PP
\fBe\fR
.RS 4
exclusive, override previous faces instead of merging with them
.RE
.RE
.SH "BUILTIN FACES"
.sp
The following default faces are used by color schemes to highlight certain areas of the user interface:
.PP
\fBDefault\fR
.RS 4
default colors
.RE
.PP
\fBPrimarySelection\fR
.RS 4
main selection face for every selected character except the cursor
.RE
.PP
\fBSecondarySelection\fR
.RS 4
secondary selection face for every selected character except the cursor
.RE
.PP
\fBPrimaryCursor\fR
.RS 4
cursor of the primary selection
.RE
.PP
\fBSecondaryCursor\fR
.RS 4
cursor of the secondary selection
.RE
.PP
\fBLineNumbers\fR
.RS 4
face used by the number_lines highlighter
.RE
.PP
\fBLineNumberCursor\fR
.RS 4
face used to highlight the line number of the main selection
.RE
.PP
\fBMenuForeground\fR
.RS 4
face for the selected element in menus
.RE
.PP
\fBMenuBackground\fR
.RS 4
face for the not selected elements in menus
.RE
.PP
\fBMenuInfo\fR
.RS 4
face for additional information for elements in menus
.RE
.PP
\fBInformation\fR
.RS 4
face for the information windows and information messages
.RE
.PP
\fBError\fR
.RS 4
face of error messages
.RE
.PP
\fBStatusLine\fR
.RS 4
face used for the status line
.RE
.PP
\fBStatusLineMode\fR
.RS 4
face used for the current mode except the normal mode
.RE
.PP
\fBStatusLineInfo\fR
.RS 4
face used for special information
.RE
.PP
\fBStatusLineValue\fR
.RS 4
face used for special values (numeric prefixes, registers, etc\&.)
.RE
.PP
\fBStatusCursor\fR
.RS 4
face used for the status line cursor
.RE
.PP
\fBPrompt\fR
.RS 4
face used prompt displayed on the status line
.RE
.PP
\fBMatchingChar\fR
.RS 4
face used by the show_matching highlighter
.RE
.PP
\fBBufferPadding\fR
.RS 4
face applied on the characters that follow the last line of a buffer
.RE
.PP
\fBWhitespace\fR
.RS 4
face used by the show_whitespaces highlighter
.RE