[back] [prev] [next] [index] [root]

<p>&nbsp;<p>
<hr noshade size="5">
<h2><a name="Colors"></a>
Colors
</h2>

Activate or deactivate color mode and customize colors.

<p><p>

<h3>
Syntax:
</h3>
<pre>Colors(flag);
Colors(s1, ..., sn);
Colors(L);</pre>

<p>

<table>
<tr>
<td>boolean</td>
<td><pre>  flag  </pre></td>
<td>switch color mode on or off</td>
</tr>
<tr>
<td>string</td>
<td><pre>  s1, ..., sn  </pre></td>
<td>resource strings</td>
</tr>
<tr>
<td>list</td>
<td><pre>  L  </pre></td>
<td>list of lists of resource strings</td>
</tr>
</table>

<p>


<h3>
Description:
</h3>
This function can be used to switch on or off a color
mode in KASH  compatible with <tt> ANSI/ISO 6429</tt> standards.
The resource
strings consist first of one of the strings <tt> "normal"</tt>, <tt> "prompt"</tt>,
<tt> "command"</tt>, <tt> "result"</tt> or <tt> "error"</tt> to indicate
for which
type of output a color should be defined. The other strings
can be <tt> "black"</tt>, <tt> "red"</tt>, <tt> "green"</tt>, <tt> "yellow"</tt>,
<tt> "blue"</tt>, <tt> "magenta"</tt>,
<tt> "cyan"</tt> or <tt> "white"</tt> and additionally <tt> "bold"</tt> or
<tt> "light"</tt>. The color mode works only for terminals
which can display colored letters like "<tt> color_xterm</tt>" or
"<tt> rxvt</tt>". See the instructions for your terminal.

The default colors can be customized via the <tt> _ColorTable</tt>
array.

<b>\tt _ColorTable</b> is a list with exacly 5 entries defining
(in this order)
the "normal", "prompt", "command", "result", "error" colors.
Each entry is a list as described in <tt> ColorString</tt>.


<p><p>

<p>
<hr>
<p>
<h3>
Example:
</h3>

<pre>

kash> Colors(true);
kash> Colors("error", "red", "bold");
kash> Colors([ [ "error", "red" ], [ "result", "green", "bold" ] ]);
kash> Colors(false);
> 
</pre>

<p>


<hr>

<p>
<a href="../kashref.html"><- back</a>[back] [prev] [next] [index] [root]