proposed color.map.5 man page

color.map.5 (text/plain), 1.74 KB, created by Benno Schulenberg on 2006-06-21 15:39:20 UTC

.TH "COLOR.MAP" "5" "June 2006" "Portage 2.1" "portage"
.SH "NAME"
color.map \- custom color settings for emerge and other tools
.SH "SYNOPSIS"
.B /etc/portage/color.map
.SH "DESCRIPTION"
This file can be used to map the colors used by \fBemerge\fR (and other
Portage\-based tools) to different colors.  The definitions can be of
the form 'color_name = color_name' or 'color_name = ansi_codes'.
.SH "COLOR NAMES"
The following color names are used by Portage:
.br

\fBred\fR \- for errors, strong warnings, and USE flags that are set;
.br
\fBblue\fR \- for the previous package version, and USE flags that are unset;
.br
\fBgreen\fR \- for USE flags that have changed, and highlights in help texts;
.br
\fByellow\fR \- for USE flags that are new;
.br
\fBdarkgreen\fR \- for the package name and version;
.br
\fBdarkblue\fR \- for the package version when not merging to /;
.br
\fBdarkred\fR \- for an rsync warning;
.br
\fBturquoise\fR \- for highlights in help texts;
.br
\fBteal\fR \- for marking an overlay;
.br
\fBbold\fR \- for emphasis in some messages.
.br

The colors \fBfuchsia\fR, \fBpurple\fR, \fBbrown\fR, \fBwhite\fR,
\fBlightgray\fR, \fBdarkgray\fR and \fBblack\fR are currently not used
by Portage, but these names can be used in the remappings.
For an overview of the ANSI color codes that can be used instead of
color names, see \fBdir_colors\fR(5).
.SH EXAMPLE
.TP
A \fBcolor.map\fR for light backgrounds:

# Map the three brightest to their darker forms:
.br
yellow = brown
.br
turquoise = teal
.br
green = darkgreen
.br
# Some touches of Gentoo:
.br
bold = fuchsia
.br
darkgreen = purple
.br
.SH "REPORTING BUGS"
Report any bugs via \fIhttp://bugs.gentoo.org/\fR.
.SH "AUTHOR"
.nf
Benno Schulenberg <[e-mail]>
.fi
.SH "SEE ALSO"
.BR dir_colors (5)