XCOLORS(1)

NAME
xcolors - X window system color database display

SYNOPSIS
xcolors [ option ] ...

DESCRIPTION
xcolors displays the colors defined in X window system color database. xcolors creates a window in which each color in the database is displayed along with its name and hexadecimal rgb representation. The colors are roughly sorted by color type. The mouse is used to change the colors of the text, border and background by placing the cursor on the color desired and clicking the left, middle or right button.

xcolors understands the following options:

-bd color
    Specify the border color; black is the default.

-bg color
    Specify the background color; black is the default.

-bw pixels
    Specify the width in pixels of the border around the xcolors window. The default value is 3 pixels.

-fg color
    Specify the text color; white is the default.

-fn fontname
    The text will be displayed in the specified font (if none is specified, this defaults to 6x10).

=geometry
    The xcolors window is created with the specified size and location determined by the supplied geometry specification. See X(1) for a full explanation.

:   Normally, xcolors gets the host and display number to use from the environment variable ``DISPLAY''. Either or both can be specified with this option. host specifies which machine to create the xcolors window on, and display specifies the display number. For example, ``hoser:0'' creates an xcolors on display 0 on machine hoser. Either value can be defaulted by omission but ``:'' is necessary to specify one or both.

X DEFAULTS

Background
    Set the background color.

BodyFont
    Set the text font.

Highlight
    Set the text color.

BorderWidth
    Set the border width.

BorderColor
    Set the border color.

ENVIRONMENT
DISPLAY - to get the default host and display number.

FILES
/usr/lib/rgb.txt

SEE ALSO
X(1), xwm(1), X(8C)

DIAGNOSTICS
Unable to open display or create window. Unable to query window for dimensions. Various X errors.

RESTRICTIONS
xcolors will fail if there are fewer colors available than there are color entries in the database.

AUTHOR
John Tonry