# The jcolname Colour Selection Panel

## Introduction

The `jcolname` application is just a wrapper around the `j:prompt_colour_name` procedure in the jprompts.tcl library. It's intended to make it easy to ask the user to select a colour from shell scripts.

This document describes `jcolname` version 1998.11.04.

Copyright and contact information is available in the jstools documentation.

## Invocation and Usage

`jcolname` [`-prompt` prompt]`` [`-title` title]

Invoking `jcolname` causes a panel to appear that lets the user select a colour by name from a listbox. A patch of the current colour is displayed. When the user clicks OK, or doubleclicks a colour, the current colour is written to standard output. A label displaying prompt will be at the top of the panel, and it's windowmanager title will be title.

Both prompt and title are localisable.

If the X11 colour database is not in `/usr/lib/X11/rgb.txt`, then only a small hardcoded list of colours will be displayed.

For more details, see the documentation for `j:prompt_colour_name` in the jprompts.tcl library.

## Example

`xsetroot -solid `jcolname -prompt "Root Window Colour:"`
`

## Evolution

Feel free to report bugs (and feature requests) to me, `<js@aq.org>`, and I will try to deal with them. Also, feel free to fix bugs or add features on your own and let me know how you did it.`

`